[groff] 05/05: [man pages]: Stop using .OP macro.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit c424ecfe90bd597c9c99a6d4dfc5cf91680d8353
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Thu Aug 5 18:36:56 2021 +1000

    [man pages]: Stop using .OP macro.
    
    ...in favor of font style alternation macros.  OP was not well-suited to
    be a semantic macro and was too inflexible to be applicable to the full
    variety of option grammars in use.  (A better design would be to have a
    macro that annotates a part of the input stream as an "option", but
    makes no attempt to do any formatting itself.)
---
 contrib/chem/chem.1.man              |  2 +-
 contrib/eqn2graph/eqn2graph.1.man    |  3 ++-
 contrib/gdiffmk/gdiffmk.1.man        | 14 +++++++++-----
 contrib/glilypond/glilypond.1.man    | 10 +++++-----
 contrib/grap2graph/grap2graph.1.man  |  5 +++--
 contrib/mm/mmroff.1.man              |  2 +-
 contrib/pdfmark/pdfroff.1.man        | 14 +++++++-------
 contrib/pic2graph/pic2graph.1.man    |  8 +++++---
 src/devices/grodvi/grodvi.1.man      | 11 +++++++----
 src/devices/grolj4/grolj4.1.man      | 14 +++++++++-----
 src/devices/gropdf/gropdf.1.man      | 17 +++++++++++------
 src/devices/gropdf/pdfmom.1.man      |  2 +-
 src/devices/grops/grops.1.man        | 23 +++++++++++++++--------
 src/devices/grotty/grotty.1.man      | 10 ++++++----
 src/devices/xditview/gxditview.1.man | 15 ++++++++++-----
 src/preproc/grn/grn.1.man            | 11 +++++++----
 src/preproc/pic/pic.1.man            |  4 ++--
 src/preproc/preconv/preconv.1.man    |  8 +++++---
 src/preproc/refer/refer.1.man        | 29 +++++++++++++++++++----------
 src/preproc/tbl/tbl.1.man            |  2 +-
 src/utils/addftinfo/addftinfo.1.man  | 24 ++++++++++++++++--------
 src/utils/afmtodit/afmtodit.1.man    | 20 +++++++++++++-------
 src/utils/hpftodit/hpftodit.1.man    |  5 +++--
 src/utils/indxbib/indxbib.1.man      | 32 +++++++++++++++++++++-----------
 src/utils/lkbib/lkbib.1.man          | 11 +++++++----
 src/utils/lookbib/lookbib.1.man      |  6 ++++--
 src/utils/tfmtodit/tfmtodit.1.man    |  8 +++++---
 src/utils/xtotroff/xtotroff.1.man    |  6 ++++--
 28 files changed, 199 insertions(+), 117 deletions(-)

diff --git a/contrib/chem/chem.1.man b/contrib/chem/chem.1.man
index 4624bfd..7b6f1d5 100644
--- a/contrib/chem/chem.1.man
+++ b/contrib/chem/chem.1.man
@@ -30,7 +30,7 @@
 .\" ====================================================================
 .
 .SY @g@chem
-.OP \-\-
+.RB [ \-\- ]
 .RI [ file\~ .\|.\|.]
 .YS
 .
diff --git a/contrib/eqn2graph/eqn2graph.1.man 
b/contrib/eqn2graph/eqn2graph.1.man
index 405ae6a..7ad7bf5 100644
--- a/contrib/eqn2graph/eqn2graph.1.man
+++ b/contrib/eqn2graph/eqn2graph.1.man
@@ -20,7 +20,8 @@ eqn2graph \- convert an eqn equation into a cropped image
 .\" ====================================================================
 .
 .SY eqn2graph
-.OP \-format output-format
+.RB [ \-format\~\c
+.IR output-format ]
 .RI [ convert-arguments ]
 .YS
 .
diff --git a/contrib/gdiffmk/gdiffmk.1.man b/contrib/gdiffmk/gdiffmk.1.man
index 91a3fcd..f613319 100644
--- a/contrib/gdiffmk/gdiffmk.1.man
+++ b/contrib/gdiffmk/gdiffmk.1.man
@@ -37,15 +37,19 @@ gdiffmk \- mark differences between groff/nroff/troff files
 .\" ====================================================================
 .
 .SY gdiffmk
-.OP \-a add-mark
-.OP \-c change-mark
-.OP \-d delete-mark
-.OP \-x diff-command
+.RB [ \-a\~\c
+.IR add-mark ]
+.RB [ \-c\~\c
+.IR change-mark ]
+.RB [ \-d\~\c
+.IR delete-mark ]
+.RB [ \-x\~\c
+.IR diff-command ]
 .RB [ \-D
 .RB [ \-B ]
 .RB [ \-M
 .IR "mark1 mark2" ]]
-.OP \-\-
+.RB [ \-\- ]
 .I file1
 .I file2
 .RI [ output ]
diff --git a/contrib/glilypond/glilypond.1.man 
b/contrib/glilypond/glilypond.1.man
index 3e5f52c..befd509 100644
--- a/contrib/glilypond/glilypond.1.man
+++ b/contrib/glilypond/glilypond.1.man
@@ -32,7 +32,7 @@ glilypond \- embed LilyPond musical notation in groff 
documents
 .\" ====================================================================
 .
 .SY glilypond
-.OP \-k
+.RB [ \-k ]
 .RB [{ \-\-ly2eps | \-\-pdf2eps }]
 .RB [ \-e
 .IR directory ]
@@ -43,7 +43,7 @@ glilypond \- embed LilyPond musical notation in groff 
documents
 .RB [ \-t
 .IR tdir ]
 .RB [{ \-v | \-V }]
-.OP \-\-
+.RB [ \-\- ]
 .RI [ file\~ .\|.\|.]
 .
 .
@@ -51,15 +51,15 @@ glilypond \- embed LilyPond musical notation in groff 
documents
 .RB [{ \-\-ly2eps | \-\-pdf2eps }]
 .RB [ \-\-eps_dir
 .IR directory ]
-.OP \-\-keep_all
+.RB [ \-\-keep_all ]
 .RB [ \-\-output
 .IR output-file ]
 .RB [ \-\-prefix
 .IR filename-prefix ]
 .RB [ \-\-temp_dir
 .IR tdir ]
-.OP \-\-verbose
-.OP \-\-
+.RB [ \-\-verbose ]
+.RB [ \-\- ]
 .RI [ file\~ .\|.\|.]
 .YS
 .
diff --git a/contrib/grap2graph/grap2graph.1.man 
b/contrib/grap2graph/grap2graph.1.man
index 2f2bb27..ee92454 100644
--- a/contrib/grap2graph/grap2graph.1.man
+++ b/contrib/grap2graph/grap2graph.1.man
@@ -20,8 +20,9 @@ grap2graph \- convert a GRAP diagram into a cropped image
 .\" ====================================================================
 .
 .SY grap2graph
-.OP \-unsafe
-.OP \-format output-format
+.RB [ \-unsafe ]
+.RB [ \-format\~\c
+.IR output-format ]
 .RI [ convert-arguments ]
 .YS
 .
diff --git a/contrib/mm/mmroff.1.man b/contrib/mm/mmroff.1.man
index b6c39d3..6365b35 100644
--- a/contrib/mm/mmroff.1.man
+++ b/contrib/mm/mmroff.1.man
@@ -35,7 +35,7 @@ mmroff \- cross-referencing front end for GNU roff mm macro 
package
 .\" ====================================================================
 .
 .SY mmroff
-.OP \-x
+.RB [ \-x ]
 .I groff-arguments
 .YS
 .
diff --git a/contrib/pdfmark/pdfroff.1.man b/contrib/pdfmark/pdfroff.1.man
index 7a2f046..0142c62 100644
--- a/contrib/pdfmark/pdfroff.1.man
+++ b/contrib/pdfmark/pdfroff.1.man
@@ -42,19 +42,19 @@ pdfroff \- construct files in Portable Document Format 
using groff
 .
 .SY pdfroff
 .RI [ groff-option ]
-.OP \-\-emit\-ps
-.OP \-\-no\-toc\-relocation
-.OP \-\-no\-kill\-null\-pages
+.RB [ \-\-emit\-ps ]
+.RB [ \-\-no\-toc\-relocation ]
+.RB [ \-\-no\-kill\-null\-pages ]
 .RB [ \-\-stylesheet=\c
 .IR name ]
-.OP \-\-no\-pdf\-output
+.RB [ \-\-no\-pdf\-output ]
 .RB [ \-\-pdf\-output=\c
 .IR name ]
-.OP \-\-no\-reference\-dictionary
+.RB [ \-\-no\-reference\-dictionary ]
 .RB [ \-\-reference\-dictionary=\c
 .IR  name ]
-.OP \-\-report\-progress
-.OP \-\-keep\-temporary\-files
+.RB [ \-\-report\-progress ]
+.RB [ \-\-keep\-temporary\-files ]
 .RI [ file\~ .\|.\|.]
 .YS
 .
diff --git a/contrib/pic2graph/pic2graph.1.man 
b/contrib/pic2graph/pic2graph.1.man
index 7f5b5bd..128d48a 100644
--- a/contrib/pic2graph/pic2graph.1.man
+++ b/contrib/pic2graph/pic2graph.1.man
@@ -20,9 +20,11 @@ pic2graph \- convert a PIC diagram into a cropped image
 .\" ====================================================================
 .
 .SY pic2graph
-.OP \-unsafe
-.OP \-format output-format
-.OP \-eqn delimiters
+.RB [ \-unsafe ]
+.RB [ \-format\~\c
+.IR output-format ]
+.RB [ \-eqn\~\c
+.IR delimiters ]
 .RI [ convert-arguments ]
 .YS
 .
diff --git a/src/devices/grodvi/grodvi.1.man b/src/devices/grodvi/grodvi.1.man
index eaae3df..83b03c2 100644
--- a/src/devices/grodvi/grodvi.1.man
+++ b/src/devices/grodvi/grodvi.1.man
@@ -47,10 +47,13 @@ grodvi \- groff output driver for TeX DVI format
 .\" ====================================================================
 .
 .SY grodvi
-.OP \-dl
-.OP \-F dir
-.OP \-p papersize
-.OP \-w n
+.RB [ \-dl ]
+.RB [ \-F\~\c
+.IR dir ]
+.RB [ \-p\~\c
+.IR papersize ]
+.RB [ \-w\~\c
+.IR n ]
 .RI [ file\~ .\|.\|.]
 .YS
 .
diff --git a/src/devices/grolj4/grolj4.1.man b/src/devices/grolj4/grolj4.1.man
index 5fbc4a6..506741e 100644
--- a/src/devices/grolj4/grolj4.1.man
+++ b/src/devices/grolj4/grolj4.1.man
@@ -35,13 +35,17 @@ grolj4 \- groff output driver for HP LaserJet 4 family 
printers
 .\" ====================================================================
 .
 .SY grolj4
-.OP \-l
-.OP \-c num-copies
+.RB [ \-l ]
+.RB [ \-c\~\c
+.IR num-copies ]
 .RB [ \-d
 .RI [ n ]]
-.OP \-F font-directory
-.OP \-p paper-size
-.OP \-w line-width
+.RB [ \-F\~\c
+.IR font-directory ]
+.RB [ \-p\~\c
+.IR paper-size ]
+.RB [ \-w\~\c
+.IR line-width ]
 .RI [ file\~ .\|.\|.]
 .YS
 .
diff --git a/src/devices/gropdf/gropdf.1.man b/src/devices/gropdf/gropdf.1.man
index 3435278..c5777c3 100644
--- a/src/devices/gropdf/gropdf.1.man
+++ b/src/devices/gropdf/gropdf.1.man
@@ -44,14 +44,19 @@ gropdf \- groff output driver for Portable Document Format
 .\" ====================================================================
 .
 .SY gropdf
-.OP \-dels
-.OP \-F dir
-.OP \-I dir
-.OP \-p paper-size
-\#.OP \-w n
+.RB [ \-dels ]
+.RB [ \-F\~\c
+.IR dir ]
+.RB [ \-I\~\c
+.IR dir ]
+.RB [ \-p\~\c
+.IR paper-size ]
+\#.RB [ \-w\~\c
+\#.IR n ]
 .RB [ \-u
 .RI [ cmapfile ]]
-.OP \-y foundry
+.RB [ \-y\~\c
+.IR foundry ]
 .RI [ file\~ .\|.\|.]
 .YS
 .
diff --git a/src/devices/gropdf/pdfmom.1.man b/src/devices/gropdf/pdfmom.1.man
index 62cc722..82a7628 100644
--- a/src/devices/gropdf/pdfmom.1.man
+++ b/src/devices/gropdf/pdfmom.1.man
@@ -35,7 +35,7 @@ pdfmom \- produce PDF documents using the mom macro package 
for groff
 .\" ====================================================================
 .
 .SY pdfmom
-.OP \-Tpdf
+.RB [ \-Tpdf ]
 .RI [ groff-options ]
 .RI [ file\~ .\|.\|.]
 .YS
diff --git a/src/devices/grops/grops.1.man b/src/devices/grops/grops.1.man
index 137582f..7b582cf 100644
--- a/src/devices/grops/grops.1.man
+++ b/src/devices/grops/grops.1.man
@@ -44,14 +44,21 @@ grops \- groff output driver for PostScript
 .\" ====================================================================
 .
 .SY grops
-.OP \-glm
-.OP \-b n
-.OP \-c n
-.OP \-F dir
-.OP \-I dir
-.OP \-p papersize
-.OP \-P prologue
-.OP \-w n
+.RB [ \-glm ]
+.RB [ \-b\~\c
+.IR  n ]
+.RB [ \-c\~\c
+.IR n ]
+.RB [ \-F\~\c
+.IR dir ]
+.RB [ \-I\~\c
+.IR dir ]
+.RB [ \-p\~\c
+.IR papersize ]
+.RB [ \-P\~\c
+.IR prologue ]
+.RB [ \-w\~\c
+.IR n ]
 .RI [ file\~ .\|.\|.]
 .YS
 .
diff --git a/src/devices/grotty/grotty.1.man b/src/devices/grotty/grotty.1.man
index aa71c97..8f60357 100644
--- a/src/devices/grotty/grotty.1.man
+++ b/src/devices/grotty/grotty.1.man
@@ -35,16 +35,18 @@ grotty \- groff output driver for typewriter-like 
(terminal) devices
 .\" ====================================================================
 .
 .SY grotty
-.OP \-dfho
+.RB [ \-dfho ]
 .RB [ \-i | \-r ]
-.OP \-F dir
+.RB [ \-F\~\c
+.IR dir ]
 .RI [ file\~ .\|.\|.]
 .YS
 .
 .
 .SY "grotty \-c"
-.OP \-bBdfhouU
-.OP \-F dir
+.RB [ \-bBdfhouU ]
+.RB [ \-F\~\c
+.IR dir ]
 .RI [ file\~ .\|.\|.]
 .YS
 .
diff --git a/src/devices/xditview/gxditview.1.man 
b/src/devices/xditview/gxditview.1.man
index 76b3965..f38aa6b 100644
--- a/src/devices/xditview/gxditview.1.man
+++ b/src/devices/xditview/gxditview.1.man
@@ -40,11 +40,16 @@ gxditview \- display groff intermediate output files in X11
 .
 .SY gxditview
 .RI [ X-toolkit-option \~.\|.\|.\&]
-.OP \-backingStore backing-store-type
-.OP \-filename string
-.OP \-page n
-.OP \-printCommand string
-.OP \-resolution res
+.RB [ \-backingStore\~\c
+.IR backing-store-type ]
+.RB [ \-filename\~\c
+.IR string ]
+.RB [ \-page\~\c
+.IR n ]
+.RB [ \-printCommand\~\c
+.IR string ]
+.RB [ \-resolution\~\c
+.IR res ]
 .I file
 .YS
 .
diff --git a/src/preproc/grn/grn.1.man b/src/preproc/grn/grn.1.man
index f6f6ebe..68a5e4c 100644
--- a/src/preproc/grn/grn.1.man
+++ b/src/preproc/grn/grn.1.man
@@ -36,10 +36,13 @@
 .\" ====================================================================
 .
 .SY @g@grn
-.OP \-C
-.OP \-T dev
-.OP \-M dir
-.OP \-F dir
+.RB [ \-C ]
+.RB [ \-T\~\c
+.IR dev ]
+.RB [ \-M\~\c
+.IR dir ]
+.RB [ \-F\~\c
+.IR dir ]
 .RI [ file\~ .\|.\|.]
 .YS
 .
diff --git a/src/preproc/pic/pic.1.man b/src/preproc/pic/pic.1.man
index 93349df..0a6b9f3 100644
--- a/src/preproc/pic/pic.1.man
+++ b/src/preproc/pic/pic.1.man
@@ -52,14 +52,14 @@
 .\" ====================================================================
 .
 .SY @g@pic
-.OP \-nCSU
+.RB [ \-nCSU ]
 .RI [ file\~ .\|.\|.]
 .YS
 .
 .
 .SY @g@pic
 .B \-t
-.OP \-czCSU
+.RB [ \-czCSU ]
 .RI [ file\~ .\|.\|.]
 .YS
 .
diff --git a/src/preproc/preconv/preconv.1.man 
b/src/preproc/preconv/preconv.1.man
index e7bfa84..79089d5 100644
--- a/src/preproc/preconv/preconv.1.man
+++ b/src/preproc/preconv/preconv.1.man
@@ -35,9 +35,11 @@ preconv \- prepare files for typesetting with groff
 .\" ====================================================================
 .
 .SY preconv
-.OP \-dr
-.OP \-D default-encoding
-.OP \-e encoding
+.RB [ \-dr ]
+.RB [ \-D\~\c
+.IR default-encoding ]
+.RB [ \-e\~\c
+.IR encoding ]
 .RI [ file\~ .\|.\|.]
 .YS
 .
diff --git a/src/preproc/refer/refer.1.man b/src/preproc/refer/refer.1.man
index 3e473ea..59eee12 100644
--- a/src/preproc/refer/refer.1.man
+++ b/src/preproc/refer/refer.1.man
@@ -35,19 +35,28 @@
 .\" ====================================================================
 .
 .SY @g@refer
-.OP \-benCPRS
-.OP \-a n
+.RB [ \-benCPRS ]
+.RB [ \-a\~\c
+.IR n ]
 .RB [ \-B
 .IB field . macro\c
 ]
-.OP \-c fields
-.OP \-f n
-.OP \-i fields
-.OP \-k field
-.OP \-l range-expression
-.OP \-p database-file
-.OP \-s fields
-.OP \-t n
+.RB [ \-c\~\c
+.IR fields ]
+.RB [ \-f\~\c
+.IR n ]
+.RB [ \-i\~\c
+.IR fields ]
+.RB [ \-k\~\c
+.IR field ]
+.RB [ \-l\~\c
+.IR range-expression ]
+.RB [ \-p\~\c
+.IR database-file ]
+.RB [ \-s\~\c
+.IR fields ]
+.RB [ \-t\~\c
+.IR n ]
 .RI [ file\~ .\|.\|.]
 .YS
 .
diff --git a/src/preproc/tbl/tbl.1.man b/src/preproc/tbl/tbl.1.man
index 26275da..06b87f6 100644
--- a/src/preproc/tbl/tbl.1.man
+++ b/src/preproc/tbl/tbl.1.man
@@ -38,7 +38,7 @@
 .\" ====================================================================
 .
 .SY @g@tbl
-.OP \-C
+.RB [ \-C ]
 .RI [ file\~ .\|.\|.]
 .YS
 .
diff --git a/src/utils/addftinfo/addftinfo.1.man 
b/src/utils/addftinfo/addftinfo.1.man
index e303985..a9788ec 100644
--- a/src/utils/addftinfo/addftinfo.1.man
+++ b/src/utils/addftinfo/addftinfo.1.man
@@ -35,14 +35,22 @@ addftinfo \- add font metrics to troff fonts for use with 
groff
 .\" ====================================================================
 .
 .SY addftinfo
-.OP \-asc\-height n
-.OP \-body\-depth n
-.OP \-body\-height n
-.OP \-cap\-height n
-.OP \-comma\-depth n
-.OP \-desc\-depth n
-.OP \-fig\-height n
-.OP \-x\-height n
+.RB [ \-asc\-height\~\c
+.IR n ]
+.RB [ \-body\-depth\~\c
+.IR n ]
+.RB [ \-body\-height\~\c
+.IR n ]
+.RB [ \-cap\-height\~\c
+.IR n ]
+.RB [ \-comma\-depth\~\c
+.IR n ]
+.RB [ \-desc\-depth\~\c
+.IR n ]
+.RB [ \-fig\-height\~\c
+.IR n ]
+.RB [ \-x\-height\~\c
+.IR n ]
 .I resolution
 .I unit-width
 .I font
diff --git a/src/utils/afmtodit/afmtodit.1.man 
b/src/utils/afmtodit/afmtodit.1.man
index 13af641..148bf71 100644
--- a/src/utils/afmtodit/afmtodit.1.man
+++ b/src/utils/afmtodit/afmtodit.1.man
@@ -35,13 +35,19 @@ afmtodit \- adapt Adobe Font Metrics files for groff \-Tps 
and \-Tpdf
 .\" ====================================================================
 .
 .SY afmtodit
-.OP \-ckmnsx
-.OP \-a n
-.OP \-d desc-file
-.OP \-e enc-file
-.OP \-f internal-name
-.OP \-i n
-.OP \-o output-file
+.RB [ \-ckmnsx ]
+.RB [ \-a\~\c
+.IR n ]
+.RB [ \-d\~\c
+.IR desc-file ]
+.RB [ \-e\~\c
+.IR enc-file ]
+.RB [ \-f\~\c
+.IR internal-name ]
+.RB [ \-i\~\c
+.IR n ]
+.RB [ \-o\~\c
+.IR output-file ]
 .I afm-file
 .I map-file
 .I font
diff --git a/src/utils/hpftodit/hpftodit.1.man 
b/src/utils/hpftodit/hpftodit.1.man
index bc3e814..21a5779 100644
--- a/src/utils/hpftodit/hpftodit.1.man
+++ b/src/utils/hpftodit/hpftodit.1.man
@@ -35,8 +35,9 @@ hpftodit \- create font description files for use with groff 
\-Tlj4
 .\" ====================================================================
 .
 .SY hpftodit
-.OP \-aqs
-.OP \-i n
+.RB [ \-aqs ]
+.RB [ \-i\~\c
+.IR n ]
 .I tfm-file
 .I map-file
 .I output-font
diff --git a/src/utils/indxbib/indxbib.1.man b/src/utils/indxbib/indxbib.1.man
index 4f6d0ad..388a87d 100644
--- a/src/utils/indxbib/indxbib.1.man
+++ b/src/utils/indxbib/indxbib.1.man
@@ -35,17 +35,27 @@
 .\" ====================================================================
 .
 .SY @g@indxbib
-.OP \-w
-.OP \-c common-words-file
-.OP \-d dir
-.OP \-f list-file
-.OP \-h n
-.OP \-i string
-.OP \-k n
-.OP \-l n
-.OP \-n n
-.OP \-o file
-.OP \-t n
+.RB [ \-w ]
+.RB [ \-c\~\c
+.IR common-words-file ]
+.RB [ \-d\~\c
+.IR dir ]
+.RB [ \-f\~\c
+.IR list-file ]
+.RB [ \-h\~\c
+.IR n ]
+.RB [ \-i\~\c
+.IR string ]
+.RB [ \-k\~\c
+.IR n ]
+.RB [ \-l\~\c
+.IR n ]
+.RB [ \-n\~\c
+.IR n ]
+.RB [ \-o\~\c
+.IR file ]
+.RB [ \-t\~\c
+.IR n ]
 .RI [ file\~ .\|.\|.]
 .YS
 .
diff --git a/src/utils/lkbib/lkbib.1.man b/src/utils/lkbib/lkbib.1.man
index 762f8be..9a435ce 100644
--- a/src/utils/lkbib/lkbib.1.man
+++ b/src/utils/lkbib/lkbib.1.man
@@ -35,10 +35,13 @@ lkbib \- search bibliographic databases
 .\" ====================================================================
 .
 .SY lkbib
-.OP \-n
-.OP \-i fields
-.OP \-p filename
-.OP \-t n
+.RB [ \-n ]
+.RB [ \-i\~\c
+.IR fields ]
+.RB [ \-p\~\c
+.IR filename ]
+.RB [ \-t\~\c
+.IR n ]
 .I key
 \&.\|.\|.\&
 .YS
diff --git a/src/utils/lookbib/lookbib.1.man b/src/utils/lookbib/lookbib.1.man
index 68389a3..977a0ef 100644
--- a/src/utils/lookbib/lookbib.1.man
+++ b/src/utils/lookbib/lookbib.1.man
@@ -35,8 +35,10 @@
 .\" ====================================================================
 .
 .SY @g@lookbib
-.OP \-i string
-.OP \-t n
+.RB [ \-i\~\c
+.IR string ]
+.RB [ \-t\~\c
+.IR n ]
 .I filename
 \&.\|.\|.\&
 .YS
diff --git a/src/utils/tfmtodit/tfmtodit.1.man 
b/src/utils/tfmtodit/tfmtodit.1.man
index d22e42d..26974e6 100644
--- a/src/utils/tfmtodit/tfmtodit.1.man
+++ b/src/utils/tfmtodit/tfmtodit.1.man
@@ -43,9 +43,11 @@ tfmtodit \- adapt TeX Font Metrics files for groff \-Tdvi
 .\" ====================================================================
 .
 .SY tfmtodit
-.OP \-s
-.OP \-g gf-file
-.OP \-k skew-char
+.RB [ \-s ]
+.RB [ \-g\~\c
+.IR gf-file ]
+.RB [ \-k\~\c
+.IR skew-char ]
 .I tfm-file
 .I map-file
 .I font
diff --git a/src/utils/xtotroff/xtotroff.1.man 
b/src/utils/xtotroff/xtotroff.1.man
index 5db5772..3a3c9d2 100644
--- a/src/utils/xtotroff/xtotroff.1.man
+++ b/src/utils/xtotroff/xtotroff.1.man
@@ -35,8 +35,10 @@ xtotroff \- convert X font metrics into groff font metrics
 .\" ====================================================================
 .
 .SY xtotroff
-.OP \-r resolution
-.OP \-s point-size
+.RB [ \-r\~\c
+.IR resolution ]
+.RB [ \-s\~\c
+.IR point-size ]
 .I font-map
 .YS
 .