To generate HTML man pages for a collection of source files in
/home/me/foo,
do the following:
cd mkdir www mkdir www/man3 cd foo doctext -html -index ../foo.cit \ -indexdir http://www.mcs.anl.gov/me/foo/www/man3 \ -mpath ../www/man3 *.[ch] cd ..This puts the HTML files into the directory www/man3 and the index (in the correct format for the -mapman option of tohtml) into the file foo.cit. The -indexdir option is used to specify the ultimate location for the files (in this case, the directory me/foo/www/man3 at the Web site www.mcs.anl.gov). Once you are sure that the files are correct, you can move them into the Web area with
cp -r www /mcs/www/home/me(assuming that /mcs/www corresponds to http://www.mcs.anl.gov in the -indexdir argument).
To generate an HTML listing of the routines, you can execute the following
script, with, of course, the appropriate changes to the text:
#! /bin/sh echo '<TITLE>Web pages for My Routines</TITLE>' >> www/index.html echo '<H1>Web pages for My Routines</H1>' >> www/index.html echo '<H2>My Routines</H2>' >> www/index.html echo '<MENU>' >> www/index.html ls -1 www/man3 | \ sed -e 's%^\(.*\).html$%<LI><A HREF="man3/\1.html">\1</A>%g' \ >> www/index.html echo '</MENU>' >> www/index.htmlThis example may be found in the file mkhtml.sam in the source directory for doctext.
If you have only a few routines to document, you can dispense with the second directory level above (the man3). However, you might find it valuable to follow (at least loosely) the Unix man page format, with commands and installation instructions in man1 and routines spread across man2 through man8.