X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/868dc49a0b71d5ae083edc2530aa2758020ecc82..7bf56ac7340344f3c5ed9d498509aaf46977478a:/docs/README.manpages diff --git a/docs/README.manpages b/docs/README.manpages index 0976d6c4..412ba9c4 100644 --- a/docs/README.manpages +++ b/docs/README.manpages @@ -27,10 +27,10 @@ Troff Considerations When quoting, use \*(lq and \*(rq. This ensures correct formatting on typesetter-like devices. - Don't use UTF-8 characters in the manpage source. We still - build and run on systems that can't handle this. And most - anything you would want to use has an internal troff character - escape sequence, anyway. + A man page's source is ASCII, not UTF-8. troff has escapes for + non-ASCII characters, e.g. \(em for an em-dash, U+2014, that are + mapped onto whatever the output device supports, e.g. UTF-8 or + PDF. Section Ordering @@ -63,16 +63,8 @@ Dates The DATE in the .TH macro should reflect the most recent *non-trivial* update to the *content* of the manpage; - formatting changes don't count. Spell out the date (no - abbreviations or shortcuts): - - January 2, 1904 - - not the unparseable - - 01/02/04 - - Don't abbreviate the month. + formatting changes don't count, nor does expanding the `SEE + ALSO' list. The date is in `yyyy-mm-dd' format. Program Names