Customizing the Output Format

PreviousUpNext
Up: Contents Next: The Doctext Commands Previous: Making the man Pages Available

The text formating commands that doctext uses for its output are controlled by several files. For each output format (nroff, html, and latex) there are two sets of definitions files. The first set are the ones common to all of the tools in the sowing package, and are in the directory share. The files are

html.def
HTML commands
latex.def
LaTeX commands
nroff.def
Nroff (man) commands

In addition, the directory share/doctext contains special versions of these same files. doctext uses the files in share/doctext by default (see the file sowing/src/doctext/docpath.h). You can override or add to these commands with the -defn filename argument. The environment variable DOCTEXT_PATH may be used to point to a different set of definition files.

Small changes can be made by using the -defn filename switch to load a file that redefines a few of the commands. The file htmlargtbl.def, mentioned above for using the HTML table commands for arguments, is an example. Similarly, the file latexargtbl.def can be used to place the argument definitions in a LaTeX tabular environment. Using the -defn argument to override a few definitions is usually preferable to replacing all of the definitions.


PreviousUpNext
Up: Contents Next: The Doctext Commands Previous: Making the man Pages Available