robodoc(1)

NAME

ROBODoc - Extract documentation from source code.

SYNOPSIS

robodoc --src <source> --doc <destination> [options]

DESCRIPTION

ROBODoc extracts specially formated documentation from the source code. It allows you to maintain a program and its documentation in a single file.

OPTIONS

-c: Show the copyright message.

--version: Print version information and exit.

--doc: Define the documentation directory or documentation file. A directory should start with a '/' or a './' and should not include any '..'.

--src: Define the source directory or source file. A directory should start with a '/' or a './' and should not include any '..'.

--ascii: Generate documentation in ASCII format.

--html: Generate documentation in HTML format.

--dbxml: Generate documentation in XML DocBook format.

--latex: Generate documentation in LaTeX format.

--rtf: Generate documentation in RTF format.

--index: Create an additional master index file.

--multidoc: Store all documentation in separate files.

--singledoc: Store all documentation in a single file.

--singlefile

Generate a single document from a single file

The complete list of options can be found in the HTML documentation. (Reference at the end of this page.)

EXAMPLES

robodoc --src ./ --doc myproject --singledoc --html

Creates a document called myproject.html from all source files in the current directory.

robodoc --src ./myproject/
      --doc ./myprojectdoc --multidoc --html --index

Creates separate documents for all the source files found in the directory ./myproject they are stored in the directory ./myprojectdoc. A master index file called ./myprojectdoc/masterindex.html is also created. This provides links to all the individual files.

COPYRIGHT

This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

AUTHORS

Frans Slothouber, Jacco van Weert, Petteri Kettunen, Bernd Koesling, Thomas Aglassinger, Anthon Pang, Stefan Kost, David Druffner, Sasha Vasko, Nathan Prewitt, Gergely Budai and Dennis Stampfer.