02.03.2014 Views

BSP Developer's Guide

BSP Developer's Guide

BSP Developer's Guide

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

L<br />

Refgen<br />

NOTE: In Tornado 1.0.1 and earlier releases, UNIX-style man pages were<br />

generated from source code using two awk scripts, mg and mangen. As of Tornado<br />

2.0, UNIX-style man pages are no longer distributed. They have been replaced by<br />

HTML files generated by a new Tcl script called refgen, which, like its<br />

predecessors, is run by make as part of the build process. For more information,<br />

see 9. Documentation <strong>Guide</strong>lines.<br />

NAME<br />

SYNOPSIS<br />

DESCRIPTION<br />

refgen – Tornado reference documentation generator<br />

refgen [-book bookName] [-chapter chapterName] [-config configFile]<br />

[-cpp] [-expath pathList] [-exbase basedir] [-h] [-int]<br />

[-l logFile] [-mg] [-out outDir] [-verbose] fileList<br />

This tool implements a table-driven process for the extraction of documentation from<br />

source. Input tables define a “meta-syntax” that specifies the details of how<br />

documentation is embedded in source files for a particular programming language.<br />

Similarly, output tables define the markup details of the documentation output.<br />

OVERALL CONVENTIONS<br />

Some conventions about how documentation is embedded in source code do not depend<br />

on the source language, and can therefore not be changed from the configuration tables.<br />

Overall Input Conventions<br />

Routines are organized into libraries, and each library begins with a DESCRIPTION<br />

section. If a DESCRIPTION heading is not present, the description section is taken to be<br />

the first comment block after the modification history. Some input languages (such as<br />

shellscript) may begin instead with a section headed SYNOPSIS.<br />

415

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

Saved successfully!

Ooh no, something went wrong!