[1750] in Kerberos_V5_Development
manpage formatting
daemon@ATHENA.MIT.EDU (Tom Yu)
Mon Sep 9 23:20:09 1996
Date: Mon, 9 Sep 1996 23:19:57 -0400
To: krbcore@MIT.EDU
From: Tom Yu <tlyu@MIT.EDU>
It appears that in many manpages, we're using
.so man1/header.doc
in a bunch of manpages. I'm not convinced that this will work even if
header.doc is installed. Even man2ps flames about the lack of
header.doc It seems the reason this is here is so that we can set the
header info in the ".TH" man macro as necessary. Nevertheless, from a
quick survey (OSF/1, Ultrix, and Solaris), only the first two
arguments to the ".TH" macro are really guaranteed to be consistent
between operating systems. Might we want to only use the first two
arguments to ".TH" and punt the others, thus eliminating the problem
with using header.doc?
Also, [minor nit] do we want to upcase all the names given on the
".TH" line? I'm of the opinion that they should be not be forced
uppercase, but that's just me.
---Tom
