The input (source) directory. Natural Docs will build the documentation from the files in this directory and all its subdirectories. You can specify it multiple times to include multiple directories. See the list of supported programming languages.
|-o [fmt] [dir]|
--output [fmt] [dir]
The output format and directory. This can also be specified multiple times, so you can build the documentation in multiple formats in a single run. The supported formats are
The project directory. Natural Docs needs a place to store configuration and data files for each project it’s run on, so this is where it will put them. No two projects should share the same directory.
Excludes a subdirectory from being scanned. The output and project directories are automatically excluded.
Adds a directory to search for image files when using
|-s [style] ([style] ...)|
--style [style] ([style] ...)
Selects the CSS style for HTML output. The default styles are
You can use any CSS file in your project directory or Natural Docs’ Styles directory just by using its name without the .css extension. If you include more than one, they will all be included in the HTML that order.
Rebuilds everything from scratch. All source files will be rescanned and all output files will be rebuilt
Rebuilds all output files from scratch.
Sets the number of spaces tabs should be expanded to. This only needs to be set if you use tabs in example code or text diagrams. The default is 4.
Sets the syntax highlighting option used in the output.
Off turns off all syntax highlighting.
Code applies it to prototypes and
(start code) segments.
All applies it to prototypes,
(start code) segments, and lines prefixed with
:. The default is
Tells Natural Docs to only include what you explicitly document in the output, and not to find undocumented classes, functions, and variables. This option is only relevant if you have full language support.
Tells Natural Docs to only use the file name for its menu and page titles. It won’t try to determine one from the contents of the file.
Tells Natural Docs to not automatically create group topics if you don’t add them yourself.
Suppresses all non-error output.
Prints the syntax reference.
|No Longer Supported:|
This used to check only the headers and not the source files in C and C++. Edit
Languages.txt instead and add the line
“Ignore Extensions: c cpp cxx”.
This used to tell Natural Docs not to alter the CSS file in the output directory. Copy your custom CSS file to your project directory and use it with
This used to set the level of auto-grouping between Full, Basic, and None. The algorithm was improved so there’s no need for separate levels anymore. You can use
-nag if you want to turn it off completely.
This used to set the character set property of the generated HTML. Natural Docs now always uses UTF-8.