| John Thompson | 02bad9f | 2013-09-23 17:57:00 +0000 | [diff] [blame^] | 1 | ================ |
| John Thompson | 2d2d45e | 2013-09-20 14:40:52 +0000 | [diff] [blame] | 2 | modularize Usage |
| John Thompson | 02bad9f | 2013-09-23 17:57:00 +0000 | [diff] [blame^] | 3 | ================ |
| John Thompson | 2d2d45e | 2013-09-20 14:40:52 +0000 | [diff] [blame] | 4 | |
| 5 | ``modularize [<modularize-options>] <include-files-list> [<front-end-options>...]`` |
| 6 | |
| 7 | ``<modularize-options>`` is a place-holder for options |
| 8 | specific to modularize, which are described below in |
| 9 | `Modularize Command Line Options`. |
| 10 | |
| 11 | ``<include-files-list>`` specifies the path of a file name for a |
| 12 | file containing the newline-separated list of headers to check |
| 13 | with respect to each other. Lines beginning with '#' and empty |
| 14 | lines are ignored. Header file names followed by a colon and |
| 15 | other space-separated file names will include those extra files |
| 16 | as dependencies. The file names can be relative or full paths, |
| John Thompson | 02bad9f | 2013-09-23 17:57:00 +0000 | [diff] [blame^] | 17 | but must be on the same line. For example:: |
| John Thompson | 2d2d45e | 2013-09-20 14:40:52 +0000 | [diff] [blame] | 18 | |
| John Thompson | 02bad9f | 2013-09-23 17:57:00 +0000 | [diff] [blame^] | 19 | header1.h |
| 20 | header2.h |
| 21 | header3.h: header1.h header2.h |
| John Thompson | 2d2d45e | 2013-09-20 14:40:52 +0000 | [diff] [blame] | 22 | |
| 23 | Note that unless a "-prefix (header path)" option is specified, |
| 24 | non-absolute file paths in the header list file will be relative |
| 25 | to the header list file directory. Use -prefix to specify a different |
| 26 | directory. |
| 27 | |
| 28 | ``<front-end-options>`` is a place-holder for regular Clang |
| 29 | front-end arguments, which must follow the <include-files-list>. |
| 30 | Note that by default, the underlying Clang front end assumes .h files |
| 31 | contain C source, so you might need to specify the ``-x c++`` Clang option |
| 32 | to tell Clang that the header contains C++ definitions. |
| 33 | |
| 34 | Modularize Command Line Options |
| John Thompson | 02bad9f | 2013-09-23 17:57:00 +0000 | [diff] [blame^] | 35 | =============================== |
| John Thompson | 2d2d45e | 2013-09-20 14:40:52 +0000 | [diff] [blame] | 36 | |
| 37 | .. option:: -prefix <header-path> |
| 38 | |
| 39 | Prepend the given path to non-absolute file paths in the header list file. |
| 40 | By default, headers are assumed to be relative to the header list file |
| 41 | directory. Use -prefix to specify a different directory. |