groff
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [Groff] Nesting font macros in man pages


From: Damian McGuckin
Subject: Re: [Groff] Nesting font macros in man pages
Date: Fri, 28 Apr 2017 14:42:47 +1000 (AEST)
User-agent: Alpine 2.02 (LRH 1266 2009-07-14)

On Thu, 27 Apr 2017, James K. Lowden wrote:

The troff system was designed to be typed at a keyboard. The dot-on-the-left rule might be ugly, and the requests/macros terse, but the benefit to the user is relatively few keystrokes above those needed for the text.

A corollary of this is that if you find that a document has a high percentage of troff (macro) commands within it, your document will probably not read so well.

In the case of man-pages, this could mean that the explanation of the command or library/device interface in question is overly complicated.

Regards - Damian

Pacific Engineering Systems International, 277-279 Broadway, Glebe NSW 2037
Ph:+61-2-8571-0847 .. Fx:+61-2-9692-9623 | unsolicited email not wanted here
Views & opinions here are mine and not those of any past or present employer



reply via email to

[Prev in Thread] Current Thread [Next in Thread]