Re: [9fans] Capitalization in man pages.

[Lyndon Nerenberg <lyndon@orthanc.ca>]

On Dec 6, 2005, at 5:41 AM, Charles Forsyth wrote:

> i did look at mdoc(7) and mdoc.samples(7)
> but although the latter provided a useful tutorial on using mdoc,
> it didn't seem to touch significantly on writing style.

They do avoid talking about writing style.  What I was getting at was  
the macros themselves try to enforce a consistent design (i.e.  
consistent use of unique typefaces to highlight function names vs.  
parameters vs. manifest constants, etc.), thus enforcing the visual  
cues I mentioned before.  (And they even work to a limited extent  
with nroffed pages, although most of what I'm alluding to is based on  
the typeset pages.)  But the unwritten style guide for BSD man pages  
says function names (and almost everything else) are case preserved.

--lyndon