- Avoid use of word that Americans don't know how to spell
- Avoid use of capital letters when referring to command names
- Bookmarks do span files
- Use .Qq where appropriate. I didn't use .Sq or .Dq where `' and ``''
appear, since it's not clear to me what modern usage of those two
macros is.
- Say simply: ``See .Xr xxx 1'' rather than ``See the .Xr xxx 1 command''.
This former style has undoubtedly increased in popularity due to
html and hyperlinks, but it's always been around (esp. for manpage
sections other than section 1).
- Use .St
- Dedocument use of `-' to mean that `more` should read from its
standard input. The modern preferred way to read from standard
input is by specifying /dev/stdin. This is not a prelude to changing
more's behaviour within the short term (ie. at least 3-4 years).
1cdf1085c1