gbranden pushed a commit to branch master
in repository groff.
commit f6d1f960dd0ee67b61884d2020dcbbbf63c2962b
Author: G. Branden Robinson <[email protected]>
AuthorDate: Sat Aug 2 18:00:25 2025 -0500
groff_man*(7): Update `OP` macro description.
When groff man(7) adopted the `OP` macro in commit 259929625b, 15
January 2007, its interface matched a DWB man(7) macro name, but
differed in argument interpretation semantics.
Contrast:
https://github.com/n-t-roff/DWB3.3/blob/master/macros/man/an.sr#L33
with:
https://cgit.git.savannah.gnu.org/cgit/groff.git/tree/tmac/an-ext.tmac?h=1.20#n88
---
tmac/groff_man.7.man.in | 19 +++++++++++--------
1 file changed, 11 insertions(+), 8 deletions(-)
diff --git a/tmac/groff_man.7.man.in b/tmac/groff_man.7.man.in
index 709fc4a2f..31348e40f 100644
--- a/tmac/groff_man.7.man.in
+++ b/tmac/groff_man.7.man.in
@@ -3328,18 +3328,21 @@ Square brackets in roman surround both arguments.
.IP
Use of this quasi-semantic macro,
.\" https://github.com/n-t-roff/DWB3.3/blob/master/macros/man/an.sr#L37
-an extension originating in DWB
+an extension whose name originated in DWB
.IR troff ,\" DWB
-is deprecated.
+is deprecated;
+.IR groff 's
+implementation differs.
.
-It cannot easily be used to annotate options that take optional
-arguments or options whose arguments have internal structure
+Neither can easily be used to annotate options
+that take optional arguments
+or options whose arguments have internal structure
(such as a mixture of literal and variable components).
.
-One could work around these limitations with font selection escape
-sequences,
-but it is preferable to use font style alternation macros,
-which afford greater flexibility.
+One could work around these limitations
+with font selection escape sequences,
+but font style alternation macros are preferable;
+they are more flexible and perform italic corrections on typesetters.
.
.
.TP
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
