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
