One of the most useful features of tohtml is its ability to
automatically replace citations and names with hot links into other documents.
This is done by providing one or more -mapref files (for citations)
and -mapman files (for names, currently defined as strings consisting
only of letters).
Currently, the format of this file is fairly ugly but easy to use:
cite:+ cite-name++ cite-text++++ kind+ URL
where the items are as follows.
You can comment out a line in a mapref or mapman file by placing a ``;'' in the first column.
Here is a sample map file for citations. Note that {}\citegropp will turn into gropp@mcs.anl.gov in the text, with a link to the Web home page for gropp.
cite:+sles-user-ref++SLES User Manual++++manual+http://www.mcs.anl.gov/petsc/solvers.html cite:+gropp++gropp@mcs.anl.gov++++person+http://www.mcs.anl.gov/home/gropp/index.html cite:+petsc-man-pages++PETSc Manual Pages++++manual+http://www.mcs.anl.gov/petsc/ref/index.html