[groff] 03/14: [gt]roff(1): Replace .OP with font style macros.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 041b77c782bed7bd389a422ef98f199cc2b170fd
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sun Jul 18 10:01:55 2021 +1000

    [gt]roff(1): Replace .OP with font style macros.
    
    `OP` is not actually a GNU extension to the man(7) language, but one of
    _many_ extensions (some ill-conceived) from Documenter's Workbench 3.3
    (or earlier).  It does nothing that can't be achieved with two-font
    macros and doesn't support GNU-style long options (or even groff's
    -dNAME=STRING or -rREG=EXPR syntax), thus it is insufficiently adaptable
    to contemporary systems.  It therefore lacks even the saving grace of
    reliably adding semantic information (thin on the ground in man(7)).
    
    See <https://lists.gnu.org/archive/html/groff/2021-04/msg00027.html>.
    
    Use non-breaking adjustable space and output line continuation escape
    sequences \~\c to prevent breaking inside option brackets.
---
 src/roff/groff/groff.1.man | 50 ++++++++++++++++++++++++++++++----------------
 src/roff/troff/troff.1.man | 38 +++++++++++++++++++++++------------
 2 files changed, 58 insertions(+), 30 deletions(-)

diff --git a/src/roff/groff/groff.1.man b/src/roff/groff/groff.1.man
index 2453eb5..8b79b41 100644
--- a/src/roff/groff/groff.1.man
+++ b/src/roff/groff/groff.1.man
@@ -34,23 +34,39 @@ groff \- front end to the GNU roff document formatting 
system
 .\" ====================================================================
 .
 .SY groff
-.OP \-abcegijklpstzCEGNRSUVXZ
-.OP \-d cs
-.OP \-D enc
-.OP \-f fam
-.OP \-F dir
-.OP \-I dir
-.OP \-K enc
-.OP \-L arg
-.OP \-m name
-.OP \-M dir
-.OP \-n num
-.OP \-o list
-.OP \-P arg
-.OP \-r cn
-.OP \-T dev
-.OP \-w name
-.OP \-W name
+.RB [ \-abcegijklpstzCEGNRSUVXZ ]
+.RB [ \-d\~\c
+.IR cs ]
+.RB [ \-D\~\c
+.IR enc ]
+.RB [ \-f\~\c
+.IR fam ]
+.RB [ \-F\~\c
+.IR dir ]
+.RB [ \-I\~\c
+.IR dir ]
+.RB [ \-K\~\c
+.IR enc ]
+.RB [ \-L\~\c
+.IR arg ]
+.RB [ \-m\~\c
+.IR name ]
+.RB [ \-M\~\c
+.IR dir ]
+.RB [ \-n\~\c
+.IR num ]
+.RB [ \-o\~\c
+.IR list ]
+.RB [ \-P\~\c
+.IR arg ]
+.RB [ \-r\~\c
+.IR cn ]
+.RB [ \-T\~\c
+.IR dev ]
+.RB [ \-w\~\c
+.IR name ]
+.RB [ \-W\~\c
+.IR name ]
 .RI [ file
 \&.\|.\|.\&]
 .YS
diff --git a/src/roff/troff/troff.1.man b/src/roff/troff/troff.1.man
index bffd73b..e1e8c11 100644
--- a/src/roff/troff/troff.1.man
+++ b/src/roff/troff/troff.1.man
@@ -32,19 +32,31 @@
 .\" ====================================================================
 .
 .SY @g@troff
-.OP \-abcizCERU
-.OP \-d cs
-.OP \-f fam
-.OP \-F dir
-.OP \-I dir
-.OP \-m name
-.OP \-M dir
-.OP \-n num
-.OP \-o list
-.OP \-r cn
-.OP \-T name
-.OP \-w name
-.OP \-W name
+.RB [ \-abcizCERU ]
+.RB [ \-d\~\c
+.IR cs ]
+.RB [ \-f\~\c
+.IR  fam ]
+.RB [ \-F\~\c
+.IR  dir ]
+.RB [ \-I\~\c
+.IR  dir ]
+.RB [ \-m\~\c
+.IR  name ]
+.RB [ \-M\~\c
+.IR  dir ]
+.RB [ \-n\~\c
+.IR  num ]
+.RB [ \-o\~\c
+.IR  list ]
+.RB [ \-r\~\c
+.IR  cn ]
+.RB [ \-T\~\c
+.IR  dev ]
+.RB [ \-w\~\c
+.IR  name ]
+.RB [ \-W\~\c
+.IR  name ]
 .RI [ file
 \&.\|.\|.\&]
 .YS