Capitalization in .SS sections across pages (and sometimes even
within a single page) is wildly inconsistent. Make it consistent.
Capitalize first word in heading, but otherwise use lower case,
except where English usage (e.g., proper nouns) or programming
language requirements (e.g., identifier names) dictate otherwise.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
The syntax .UR http://example.com paired with .UE will create
links which one can interact, if the pager allows that. One
way to see the effect is ask the man(1) command to use browser
display, e.g.:
man -H man7/uri.7
("\:" is optional groff syntax to permit hyphenless line breaks.)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Nowadays mandb has provision to understand a character set
encoding that is explicitly indicated in the first line
of the source. As pointed out by Colin Watson, including
such an explicit indication on pages encoded in anything
other than ISO 8859-1 or UTF-8 is useful for man-pages
that aren't shipped in UTF-8.
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=519209
and for some other background (responded to by Colin Watson
in the above report):
http://thread.gmane.org/gmane.comp.internationalization.linux/6040
("man page encoding", 5 Jul 2005)
Reported-by: Colin Watson <cjwatson@debian.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>