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

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Hi, Branden!

`git am` applied it cleanly this time :)

However, the commit message was:

    man-pages.7: Update nonbreaking space advice.

    Taking another crack at this...

The commit message is everything up to the first ---, so if you want to embed a non-commit message, it should go after that, not before. Or you should make use of scissors (see git-am(1)).

I can fix it manually, but if you would like to try it yourself, please sign the patch too :)

Regards,
Alex

On 11/12/21 21:59, G. Branden Robinson wrote:
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


--
Alejandro Colomar
Linux man-pages comaintainer; http://www.kernel.org/doc/man-pages/
http://www.alejandro-colomar.es/



[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux