ALLEGRO(1)
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
COPYRIGHT
- This manual page was written by Sam Hocevar <sam@zoy.org> for the
Debian system (but may be used by others).