Building a map file for a list of man pages generated by, for example,
doctext, is a daunting prospect. Fortunately, the map file can be
generated automatically when the man pages are created if doctext is
used.
To do this, add the options
-index indexfile -indexdir indexdir
to the doctext command. The indexfile is a file to which entries
in the proper form for -mapman will be appended.
The value of indexdir is the root directory for the generated man pages.
For example, to use http:/www.mcs.anl.gov/home/gropp/man as the root
and the file manref.cit to hold the -mapman references, use
doctext -index foo.cit \ -indexdir "http:/www.mcs.anl.gov/home/gropp/man" ...