Using Project.txt as the primary configuration source:
NaturalDocs [project configuration folder] [additional options]
Using the command line as the primary configuration source:
NaturalDocs -i [input (source) folder]
-p [project configuration folder]
-o [output format] [output (documentation) folder]
Linux and macOS users should substitute "mono NaturalDocs.exe" for "NaturalDocs".
NaturalDocs C:\My Project\Natural Docs Config
mono NaturalDocs.exe -i /project/src
-o html /project/doc
Specifies the folder that stores the configuration files Natural Docs will use for this project. Required. If the folder is empty Natural Docs will generate the configuration files for you.
Specifies an input folder, which is where your source code is. Required either on the command line or in Project.txt. Can be specified multiple times.
Specifies an output format and folder, which is where your generated documentation will go. Currently the only supported format is HTML. Required either on the command line or in Project.txt. Can be specified multiple times.
Excludes an input folder. Natural Docs will not search it or its subfolders for code. Can be specified multiple times.
Excludes input folders by a pattern, which can include * and ? wildcards. Can be specified multiple times.
The pattern must match an entire folder name, so "cli" will not match "client", but "cli*" would.
Specifies an images folder. Files inside it can be referenced in comments with (see filename.jpg). Can be specified multiple times.
Specifies a folder to store temporary data. If this isn't specified it will be a subfolder of the project configuration folder.
Specifies the output style to use. Can be the name of a CSS file in the project configuration folder or a subfolder that contains Style.txt. Do not include ".css" if using a CSS file.
Sets the default character encoding for all input files. Will be Unicode if not set. Run Natural Docs with --list-encodings to see all the character encodings installed on your system.
You can use Project.txt to configure encodings per folder or per file extension.
Specifies how many spaces a tab should be expanded to.
Only include documented code elements in the output.
Turns off automatic grouping. Comments will only be grouped in the output when you manually add Group comments.
Rescans every source file and rebuilds all the output.
Rebuilds all the output without rescanning the source.
Suppresses all non-error output.
Require keyboard input before exiting the program. Only use this if you are running Natural Docs in a pop-up console window that closes automatically and you would like to see the output before that happens.
Require keyboard input before exiting the program if there is an error. Only use this if you are running Natural Docs in a pop-up console window that closes automatically and you would like it to stay open if there are error messages.
Sets the number of worker threads Natural Docs should use for processing. By default it is calculated based on the number of cores present.
Displays the current version of Natural Docs.
Displays the current version of Natural Docs and all supporting systems like .NET or Mono.
Displays this command line reference.
Displays all the character encodings that are available on the current system.
Collects and displays statistics on how long it takes Natural Docs to execute.