Program Options

The name of the program is cxref.

Usage: cxref  
  filename [ ... filename]
  [-Idirname]
  [-Ddefine] [-Udefine]
  [-CPP cpp_program]
  [-Odirname]
  [-Nbasename]
  [-all-comments]
  [-xref[-all][-file][-func][-var][-type]]
  [-warn[-all][-comment][-xref]]
  [-index[-all][-file][-func][-var][-type]]
  [-raw]
  [-latex|-latex2e]
  [-html]

filename
The name of the file to document, any number of files may be documented at a time.
-Idirname
GCC option to specify the path for include files.
-Ddefine
GCC option to define a pre-processor symbol.
-Udefine
GCC option to undefine a pre-processor symbol.
-CPP program
The name of the program to use instead of the compile time default. The program must be able to perform all of the actions that `gcc -E -C -dD' does to work. If the program takes arguments then the whole thing needs to be in quotes so that it is interpreted as a single argument to cxref.
-Odirname
The name of a directory to use for the output LATEXfiles and the location of the cross reference files that are created.
-Nbasename
The name to use for the first part of the output and cross reference files instead of cxref, the file extensions remain the same.
-all-comments
In case you are lazy and think that the existing comments might work, (see below for description of special comments). [Danger! This option can produce weird results.]
-xref
Produce cross referencing information (see below).
-all
All cross references.
-file
Cross references for files.
-func
Cross references for functions.
-var
Cross references for variables.
-type
Cross references for types.
-warn
Produce warnings, the options must be concatenated together:
-all
All warnings.
-comment
Warn of missing comments.
-xref
Warn of missing cross references.
-index
Produce a cross reference index, the options must be concatenated together:
-all
All indexes.
-file
Index of files.
-func
Index of functions.
-var
Index of variables.
-type
Index of types.
-raw
Produce a raw form of output, not really of much use except with -warn.
-latex
Produce a LATEXfile to document each of the source files and also an extra file that includes each of these files.
-latex2e
Produce the LaTeX file for use with the LaTeX2e version.
-html
Produce an HTML file to document each of the source files and a main file to reference each of these files.