With the -latex option of doctext, it is easy to create a reference manual containing the manual pages produced by doctext. The style file refman.sty (in share/refman.sty) provides the necessary LaTeX definitions. Below is an example skeleton for a reference manual:
\documentstyle[refman]{article} ... page size commands ... \begin{document} ... title page commands ... \pagenumbering{roman} \tableofcontents \clearpage \pagenumbering{arabic} \pagestyle{headings} \section{Introduction} ... regular text ... \section{My commands} \input ref/ref1 ... additional sections ... \end{document}To generate the LaTeX files for the individual man pages using doctext, you can use the following commands:
doctext -latex -mpath ref/ref1 *.cfollowed by
cd ref ls ref1 | sort | sed 's/^/\ input /g' > ref1.texIf named replacement blocks of text (.N name) are used, it may be appropriate to use a different definition for the manual from that used for the man page. For example, if the file common.txt contains
/*N defs Definitions are described in Section 2. N*/then changing the doctext command to
doctext -latex -mpath ref/ref1 common.txt *.cwill cause each .N defs command to include the text ``Definitions are described in Section 2.''