From 9196348d2b624de8d594eabe2b85defeff4c5ef4 Mon Sep 17 00:00:00 2001 From: "G. Branden Robinson" Date: Fri, 28 Jul 2023 12:28:06 -0500 Subject: 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 === 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 Signed-off-by: Alejandro Colomar --- 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 @@ with all text up to the following .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 -- cgit v1.2.3