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