robodoc1

Usage

Overview

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.