allegro-makedoc

Langue: en

Version: 257508 (debian - 07/07/09)

Section: 1 (Commandes utilisateur)

NAME

allegro-makedoc - script to generate Allegro documentation

SYNOPSIS

allegro-makedoc [-ascii OUTFILE] [-html OUTFILE|-htm OUTFILE] [-texi OUTFILE|-txi OUTFILE] [-rtf OUTFILE] [-man OUTFILE] [-part] [-warn] INFILE

DESCRIPTION

allegro-makedoc is the Allegro library's documentation generator. It simplifies producing the documentation in various formats (ASCII, HTML, TexInfo, and RTF). It converts from a weird layout that is basically a kind of stripped down HTML with a few extra markers (the _tx files), and automates a few things like constructing indexes and splitting HTML files into multiple parts.

Be warned that allegro-makedoc is not pretty, elegant, or well written, and is liable to get upset if it doesn't like the input data.

EXAMPLE

allegro-makedoc -html output.html -ascii output.txt input._tx

Reads input._tx and output an HTML documentation to output.html and an ASCII documentation to output.txt.

OPTIONS

allegro-makedoc accepts the following options:
-part
Partial output.
-warn
Output warning messages.
-html OUTFILE, -htm OUTFILE
Output HTML documentation to OUTFILE. If no file extension is provided, .html or .htm will be used, depending on the flag used.
-texi OUTFILE, -txi OUTFILE
Output TexInfo documentation to OUTFILE. If no file extension is provided,
 .texi or .txi will be used, depending on the flag used.
-rtf OUTFILE
Output RTF documentation to OUTFILE.
-man OUTFILE
Output documentation in manual page format to OUTFILE.

SEE ALSO

allegro-dev-tools(1)
The allegro info entry This manual page was written by Sam Hocevar <sam@zoy.org> for the Debian system (but may be used by others).