| commit | 6351ebc3829d2411b8d6339bb3129f363fd713b7 | |
| author | G. Branden Robinson <g.branden.robinson@gmail.com> | |
| Fri, 12 Nov 2021 21:50:14 +0000 (13 08:50 +1100) | ||
| committer | Alejandro Colomar <alx.manpages@gmail.com> | |
| Sat, 13 Nov 2021 00:21:15 +0000 (13 01:21 +0100) | ||
| tree | 58eaf6ba66814e441cd7e18749d51b7c6c7140ed | treesnapshot (tar.gz zip) |
| parent | eb50311d94562ce438348a628edb98a700d1d2b2 | commitdiff |
man-pages.7: Update nonbreaking space advice
* Advise usage of \~ escape instead of \SPACE; the former, a groff
extension from circa 1990, has been supported by Heirloom Doctools
troff since 2005 and by mandoc since 2019. The advantage is that
\~ is an _adjustable_ non-breaking space, so it will typeset
non-jarringly both in .EX/.EE examples when filling is off, and in
normal running text (which is filled).
See linux-man@ list discussion at
<https://lore.kernel.org/linux-man/\
20210729115508.pt6btsqd7g5tuhg6@localhost.localdomain/> and follow-ups.
Signed-off-by: G. Branden Robinson <g.branden.robinson@gmail.com>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* Advise usage of \~ escape instead of \SPACE; the former, a groff
extension from circa 1990, has been supported by Heirloom Doctools
troff since 2005 and by mandoc since 2019. The advantage is that
\~ is an _adjustable_ non-breaking space, so it will typeset
non-jarringly both in .EX/.EE examples when filling is off, and in
normal running text (which is filled).
See linux-man@ list discussion at
<https://lore.kernel.org/linux-man/\
20210729115508.pt6btsqd7g5tuhg6@localhost.localdomain/> and follow-ups.
Signed-off-by: G. Branden Robinson <g.branden.robinson@gmail.com>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
| man7/man-pages.7 | diffblobblamehistory |