Thread (3 messages) 3 messages, 2 authors, 2021-11-12

[PATCH v2] man-pages.7: Update nonbreaking space advice.

flat view
STALE1789d

From: G. Branden Robinson <hidden>
Date: 2021-11-12 20:59:27
Subsystem: the rest · Maintainer: Linus Torvalds

Taking another crack at this...

---
v2:
 - Stop correcting "nonbreaking" to "non-breaking".
---

* 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.
---
 man7/man-pages.7 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/man7/man-pages.7 b/man7/man-pages.7
index 96c3deb20..23015b00a 100644
--- a/man7/man-pages.7
+++ b/man7/man-pages.7
@@ -689,7 +689,7 @@ If the command is short, then it can be included inline in the text,
 in italic format, for example,
 .IR "man 7 man-pages" .
 In this case, it may be worth using nonbreaking spaces
-("\e\ ") at suitable places in the command.
+(\e\(ti) at suitable places in the command.
 Command options should be written in italics (e.g.,
 .IR \-l ).
 .PP
-- 
2.20.1

Attachments

Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help