2013-09-24 01:57:00 +08:00
|
|
|
================
|
2013-09-20 22:40:52 +08:00
|
|
|
modularize Usage
|
2013-09-24 01:57:00 +08:00
|
|
|
================
|
2013-09-20 22:40:52 +08:00
|
|
|
|
|
|
|
|
``modularize [<modularize-options>] <include-files-list> [<front-end-options>...]``
|
|
|
|
|
|
|
|
|
|
``<modularize-options>`` is a place-holder for options
|
|
|
|
|
specific to modularize, which are described below in
|
|
|
|
|
`Modularize Command Line Options`.
|
|
|
|
|
|
|
|
|
|
``<include-files-list>`` specifies the path of a file name for a
|
|
|
|
|
file containing the newline-separated list of headers to check
|
|
|
|
|
with respect to each other. Lines beginning with '#' and empty
|
|
|
|
|
lines are ignored. Header file names followed by a colon and
|
|
|
|
|
other space-separated file names will include those extra files
|
|
|
|
|
as dependencies. The file names can be relative or full paths,
|
2013-09-24 01:57:00 +08:00
|
|
|
but must be on the same line. For example::
|
2013-09-20 22:40:52 +08:00
|
|
|
|
2013-09-24 01:57:00 +08:00
|
|
|
header1.h
|
|
|
|
|
header2.h
|
|
|
|
|
header3.h: header1.h header2.h
|
2013-09-20 22:40:52 +08:00
|
|
|
|
|
|
|
|
Note that unless a "-prefix (header path)" option is specified,
|
|
|
|
|
non-absolute file paths in the header list file will be relative
|
|
|
|
|
to the header list file directory. Use -prefix to specify a different
|
|
|
|
|
directory.
|
|
|
|
|
|
|
|
|
|
``<front-end-options>`` is a place-holder for regular Clang
|
|
|
|
|
front-end arguments, which must follow the <include-files-list>.
|
|
|
|
|
Note that by default, the underlying Clang front end assumes .h files
|
|
|
|
|
contain C source, so you might need to specify the ``-x c++`` Clang option
|
|
|
|
|
to tell Clang that the header contains C++ definitions.
|
|
|
|
|
|
|
|
|
|
Modularize Command Line Options
|
2013-09-24 01:57:00 +08:00
|
|
|
===============================
|
2013-09-20 22:40:52 +08:00
|
|
|
|
|
|
|
|
.. option:: -prefix <header-path>
|
|
|
|
|
|
|
|
|
|
Prepend the given path to non-absolute file paths in the header list file.
|
|
|
|
|
By default, headers are assumed to be relative to the header list file
|
|
|
|
|
directory. Use -prefix to specify a different directory.
|
