[groff] 03/09: man pages: Regularize synopses.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 8457d9dba354d9d42a83e03479872122727c2d47
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Wed Aug 19 18:36:44 2020 +1000

    man pages: Regularize synopses.
    
    Document formerly-overlooked command-line options in synopses.
    
    * src/devices/grops/grops.1.man:
    * src/preproc/eqn/eqn.1.man:
    * src/preproc/grn/grn.1.man:
    * src/preproc/pic/pic.1.man:
    * src/preproc/soelim/soelim.1.man:
    * src/preproc/tbl/tbl.1.man:
    * src/roff/troff/troff.1.man: Document --help and --version.  Move -v
      out of "main" synopsis and group with --version synopsis.
    
    * src/preproc/grn/grn.1.man: Also document the anomalous '-?', a synonym
      for '--help' that never really took off because people who can
      remember to escape shell glob characters in command-line options don't
      need manuals anyway. ;-)  I assume it's supported here for
      compatibility with an earlier grn(1) implementation, but I couldn't
      find a man page for such on the Web with a cursory search.
---
 src/devices/grops/grops.1.man   | 15 ++++++++++++++-
 src/preproc/eqn/eqn.1.man       | 15 ++++++++++++++-
 src/preproc/grn/grn.1.man       | 18 +++++++++++++++++-
 src/preproc/pic/pic.1.man       | 17 +++++++++++++++--
 src/preproc/soelim/soelim.1.man | 15 ++++++++++++++-
 src/preproc/tbl/tbl.1.man       | 15 ++++++++++++++-
 src/roff/troff/troff.1.man      | 15 ++++++++++++++-
 7 files changed, 102 insertions(+), 8 deletions(-)

diff --git a/src/devices/grops/grops.1.man b/src/devices/grops/grops.1.man
index 6468afa..ba2a9a9 100644
--- a/src/devices/grops/grops.1.man
+++ b/src/devices/grops/grops.1.man
@@ -44,7 +44,7 @@ grops \- PostScript driver for groff
 .\" ====================================================================
 .
 .SY grops
-.OP \-glmv
+.OP \-glm
 .OP \-b n
 .OP \-c n
 .OP \-F dir
@@ -57,6 +57,19 @@ grops \- PostScript driver for groff
 .YS
 .
 .
+.SY grops
+.B \-\-help
+.YS
+.
+.
+.SY grops
+.B \-v
+.
+.SY grops
+.B \-\-version
+.YS
+.
+.
 .\" ====================================================================
 .SH Description
 .\" ====================================================================
diff --git a/src/preproc/eqn/eqn.1.man b/src/preproc/eqn/eqn.1.man
index 1f9bc5f..77ce788 100644
--- a/src/preproc/eqn/eqn.1.man
+++ b/src/preproc/eqn/eqn.1.man
@@ -42,7 +42,7 @@
 .\" ====================================================================
 .
 .SY @g@eqn
-.OP \-rvCNR
+.OP \-rCNR
 .OP \-d xy
 .OP \-T name
 .OP \-M dir
@@ -55,6 +55,19 @@
 .YS
 .
 .
+.SY @g@eqn
+.B \-\-help
+.YS
+.
+.
+.SY @g@eqn
+.B \-v
+.
+.SY @g@eqn
+.B \-\-version
+.YS
+.
+.
 .\" ====================================================================
 .SH Description
 .\" ====================================================================
diff --git a/src/preproc/grn/grn.1.man b/src/preproc/grn/grn.1.man
index a61b20f..8370094 100644
--- a/src/preproc/grn/grn.1.man
+++ b/src/preproc/grn/grn.1.man
@@ -36,7 +36,7 @@
 .\" ====================================================================
 .
 .SY @g@grn
-.OP \-Cv
+.OP \-C
 .OP \-T dev
 .OP \-M dir
 .OP \-F dir
@@ -45,6 +45,22 @@
 .YS
 .
 .
+.SY @g@grn
+.B \-?
+.
+.SY @g@grn
+.B \-\-help
+.YS
+.
+.
+.SY @g@grn
+.B \-v
+.
+.SY @g@grn
+.B \-\-version
+.YS
+.
+.
 .\" ====================================================================
 .SH Description
 .\" ====================================================================
diff --git a/src/preproc/pic/pic.1.man b/src/preproc/pic/pic.1.man
index 12104f7..438ec80 100644
--- a/src/preproc/pic/pic.1.man
+++ b/src/preproc/pic/pic.1.man
@@ -56,7 +56,7 @@
 .\" ====================================================================
 .
 .SY @g@pic
-.OP \-nvCSU
+.OP \-nCSU
 .RI [ file
 \&.\|.\|.\&]
 .YS
@@ -64,12 +64,25 @@
 .
 .SY @g@pic
 .B \-t
-.OP \-cvzCSU
+.OP \-czCSU
 .RI [ file
 \&.\|.\|.\&]
 .YS
 .
 .
+.SY @g@pic
+.B \-\-help
+.YS
+.
+.
+.SY @g@pic
+.B \-v
+.
+.SY @g@pic
+.B \-\-version
+.YS
+.
+.
 .\" ====================================================================
 .SH Description
 .\" ====================================================================
diff --git a/src/preproc/soelim/soelim.1.man b/src/preproc/soelim/soelim.1.man
index ca16153..43f9c99 100644
--- a/src/preproc/soelim/soelim.1.man
+++ b/src/preproc/soelim/soelim.1.man
@@ -37,13 +37,26 @@
 .\" ====================================================================
 .
 .SY @g@soelim
-.OP \-Crtv
+.OP \-Crt
 .OP \-I dir
 .RI [ file
 \&.\|.\|.\&]
 .YS
 .
 .
+.SY @g@soelim
+.B \-\-help
+.YS
+.
+.
+.SY @g@soelim
+.B \-v
+.
+.SY @g@soelim
+.B \-\-version
+.YS
+.
+.
 .\" ====================================================================
 .SH Description
 .\" ====================================================================
diff --git a/src/preproc/tbl/tbl.1.man b/src/preproc/tbl/tbl.1.man
index f157ddb..d9241fc 100644
--- a/src/preproc/tbl/tbl.1.man
+++ b/src/preproc/tbl/tbl.1.man
@@ -37,12 +37,25 @@
 .\" ====================================================================
 .
 .SY @g@tbl
-.OP \-Cv
+.OP \-C
 .RI [ file
 \&.\|.\|.\&]
 .YS
 .
 .
+.SY @g@tbl
+.B \-\-help
+.YS
+.
+.
+.SY @g@tbl
+.B \-v
+.
+.SY @g@tbl
+.B \-\-version
+.YS
+.
+.
 .\" ====================================================================
 .SH Description
 .\" ====================================================================
diff --git a/src/roff/troff/troff.1.man b/src/roff/troff/troff.1.man
index c49c64a..3fd30a4 100644
--- a/src/roff/troff/troff.1.man
+++ b/src/roff/troff/troff.1.man
@@ -32,7 +32,7 @@
 .\" ====================================================================
 .
 .SY @g@troff
-.OP \-abcivzCERU
+.OP \-abcizCERU
 .OP \-d cs
 .OP \-f fam
 .OP \-F dir
@@ -50,6 +50,19 @@
 .YS
 .
 .
+.SY @g@troff
+.B \-\-help
+.YS
+.
+.
+.SY @g@troff
+.B \-v
+.
+.SY @g@troff
+.B \-\-version
+.YS
+.
+.
 .\" ====================================================================
 .SH Description
 .\" ====================================================================