Re: [PATCH v2] man-pages.7: Update nonbreaking space advice.
flat view
From: Alejandro Colomar (man-pages) <hidden>
Date: 2021-11-12 21:17:50
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:quoted hunk ↗ jump to hunk
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/