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+ URLwhere 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