Hi Branden, On 2023-07-28 20:01, G. Branden Robinson wrote: > Clean up in preparation for "MR sed". > > From 5ce2b67f5e4ba0f52291f515bed0891d7a56d2ea Mon Sep 17 00:00:00 2001 > From: "G. Branden Robinson" <g.branden.robinson@xxxxxxxxx> > Date: Fri, 28 Jul 2023 12:28:06 -0500 > Subject: [PATCH 6/6] man.7: ffix > > The `\c` escape sequence works in an argument to a macro call that is > part of a paragraph tag with font style alternation macros, but not the > ordinary font macros `B` and `I`. This is because `TP`, `B`, and `I` > all set up input traps; the six font style alternation macros do not. > > The old formatting would, for some versions of some formatters, set the > "[trailer]" text as part of the paragraph body, not the tag--like this. > > .UE [trailer] Terminate the link text of the preceding .UR > macro, with the optional trailer (if present, usually a > (and so on) > > This was a poorly understood--and undocumented--interaction of man(7) > features until recently. Gory details involving nroff on Unix Version 7 > (1979) running on a simulated PDP-11/45 are available.[1] > > Here is a comparison of the former and new markup. > > before > ------ > groff 1.22.3: BAD > groff 1.22.4: GOOD > groff 1.23.0: BAD > mandoc 1.14.6: BAD > > now > --- That's problematic. git(1) understands those 3 lines as the end of the commit message. It's interesting to learn that if you write more than 3 it just works. Please reformat. Cheers, Alex > groff 1.22.3: BAD > groff 1.22.4: GOOD > groff 1.23.0: GOOD > mandoc 1.14.6: GOOD > > [1] https://savannah.gnu.org/bugs/?51468 > https://lists.gnu.org/archive/html/groff/2022-06/msg00020.html > > Signed-off-by: G. Branden Robinson <g.branden.robinson@xxxxxxxxx> > --- > man7/man.7 | 2 +- > 1 file changed, 1 insertion(+), 1 deletion(-) > > diff --git a/man7/man.7 b/man7/man.7 > index 258ce25da..583fe354f 100644 > --- a/man7/man.7 > +++ b/man7/man.7 > @@ -249,7 +249,7 @@ .SS Hypertext link macros > .B .UE > macro as the link text. > .TP > -.B .UE \c > +.BR .UE \~\c > .RI [ trailer ] > Terminate the link text of the preceding > .B .UR -- <http://www.alejandro-colomar.es/> GPG key fingerprint: A9348594CE31283A826FBDD8D57633D441E25BB5
Attachment:
OpenPGP_signature
Description: OpenPGP digital signature
