02.03.2014 Views

Tornado

Tornado

Tornado

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

<strong>Tornado</strong> 2.0<br />

User’s Guide<br />

-category<br />

Related to the -book option, this option allows you to set the<br />

documented routine or library category. It can be used for<br />

example to differentiate routines available for different host<br />

platforms.<br />

-config configname Reads configuration information from the file configname if this<br />

optional parameter is present; the default configuration is<br />

C2html.<br />

-cpp<br />

This option specifies that the list of given files is to be treated as<br />

C++ files. Special processing is then done to recover all the class<br />

members.<br />

-expath pathList<br />

Preempts EXPANDPATH settings recorded within files with the<br />

explicitly-supplied colon-delimited path list.<br />

-exbase basedir<br />

To simplify working under incomplete trees, uses basedir rather<br />

than WIND_BASE as the root for expand-file searching.<br />

-int<br />

If this optional parameter is present, formats all available<br />

documentation, even if marked INTERNAL or NOMANUAL,<br />

and even for local routines.<br />

-l logFile Specifies that logFile is to be used to log refgen errors. If -l<br />

option is not specified, standard output is used.<br />

-mg<br />

Converts from mangen markup “on the fly” (in memory,<br />

without saving the converted source file).<br />

-out outputDirectoryName Saves output documentation file in outputDirectoryName.<br />

-verbose<br />

Prints reassuring messages to indicate something is happening.<br />

sourceFileList<br />

Any other parameters are taken as names of source files from<br />

which to extract and format documentation.<br />

EXAMPLE<br />

INCLUDES<br />

SEE ALSO<br />

Generate HTML manual pages for a BSP sysLib.c file:<br />

% cd $WIND_BASE/target/config/myBsp<br />

% refgen -mg -book BSP_Reference -chapter myBsp -category myBsp \<br />

-out $WIND_BASE/vxworks/bsp/myBsp sysLib.c<br />

refLib.tcl<br />

VxWorks Programmer’s Guide: C Coding Conventions, htmlLink, htmlBook, windHelpLib<br />

462

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!