[OpenAFS] Documentation project comments

ted creedon tcreedon@easystreet.com
Fri, 10 Jun 2005 09:07:16 -0700


For what its worth, I think html documentation with hyperlinks is not the
best way to go. It just happened to get done first on the second round of
conversions.

Previous conversions using standard Latex with \label and \ref in place of
the hyperlinks and using "if then else" to include only  the architecture(s)
(AIX, Linux, etc) one is using is far simpler and far less voluminous.

Recompiling with the Springer Verlag sving6.sty document class produces
textbook quality compositions with automatically numbered tables of
contents, indexes and appendicies. The current version uses the article
class to support the hyperref package and the downstream converters.

If printed in pamphlet form, it is easier to use than a web presentation.

tedc