From mboxrd@z Thu Jan 1 00:00:00 1970 Mime-Version: 1.0 (Apple Message framework v746.2) In-Reply-To: <0efa86b8841cd02d62f592d615c7579d@terzarima.net> References: <0efa86b8841cd02d62f592d615c7579d@terzarima.net> Content-Type: text/plain; charset=US-ASCII; delsp=yes; format=flowed Message-Id: <67E460A9-15ED-4A18-97DD-69415399CEB1@orthanc.ca> Content-Transfer-Encoding: 7bit From: Lyndon Nerenberg Subject: Re: [9fans] Capitalization in man pages. Date: Tue, 6 Dec 2005 05:54:43 -0800 To: Fans of the OS Plan 9 from Bell Labs <9fans@cse.psu.edu> Topicbox-Message-UUID: ba46d17c-ead0-11e9-9d60-3106f5b1d025 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