gbranden pushed a commit to branch master
in repository groff.
commit 5e81d477bfd5556850154dcdeadc50cbea335b70
Author: G. Branden Robinson <[email protected]>
AuthorDate: Thu Nov 6 05:08:39 2025 -0600
src/devices/gropdf/gropdf.pl: Tweak usage message.
* src/devices/gropdf/gropdf.pl (usage): Tweak synopsis syntax. Rename
option argument from "advanced-opts" to "option-bits" to align with
man page change below.
* src/devices/gropdf/gropdf.1.man (Synopsis, Options): Respell "optbits"
as "option-bits".
* src/devices/gropdf/gropdf.pl (usage):
* src/devices/gropdf/gropdf.1.man (Synopsis): Put braces around
multi-character expressions used in alternation (that is, with `|`
notation), for clarity; few people seem to keep in their heads a
rigorous grammar for synopsis notation that includes operator
precedence.
---
ChangeLog | 16 ++++++++++++++++
src/devices/gropdf/gropdf.1.man | 8 ++++----
src/devices/gropdf/gropdf.pl | 2 +-
3 files changed, 21 insertions(+), 5 deletions(-)
diff --git a/ChangeLog b/ChangeLog
index c8bd0e14d..3433c8859 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,19 @@
+2025-11-06 G. Branden Robinson <[email protected]>
+
+ * src/devices/gropdf/gropdf.pl (usage): Tweak synopsis syntax.
+ Rename option argument from "advanced-opts" to "option-bits" to
+ align with man page change below.
+
+ * src/devices/gropdf/gropdf.1.man (Synopsis, Options): Respell
+ "optbits" as "option-bits".
+
+ * src/devices/gropdf/gropdf.pl (usage):
+ * src/devices/gropdf/gropdf.1.man (Synopsis): Put braces around
+ multi-character expressions used in alternation (that is, with
+ `|` notation), for clarity; few people seem to keep in their
+ heads a rigorous grammar for synopsis notation that includes
+ operator precedence.
+
2025-11-04 Deri James <[email protected]>
[gropdf]: Problem including pdfs produced by ghostscript 10
diff --git a/src/devices/gropdf/gropdf.1.man b/src/devices/gropdf/gropdf.1.man
index f7bff6035..ea185de9a 100644
--- a/src/devices/gropdf/gropdf.1.man
+++ b/src/devices/gropdf/gropdf.1.man
@@ -70,11 +70,11 @@ output driver for Portable Document Format
.RB [ \-I\~\c
.IR inclusion-directory ]
.RB [ \-\-opt\~\c
-.IR optbits ]
+.IR option-bits ]
.RB [ \-p\~\c
.IR paper-format ]
.RB [ \-\-pdfver\~\c
-.IR 1.4 \~|\~ 1.7 ]
+.RI { 1.4 \~|\~ 1.7 }]
\#.RB [ \-w\~\c
\#.IR n ]
.RB [ \-u
@@ -212,9 +212,9 @@ it is otherwise searched last.
Orient the document in landscape format.
.
.TP
-.BI \-\-opt\~ optbits
+.BI \-\-opt\~ option-bits
Specify advanced options for gropdf.
-.I optbits
+.I option-bits
controls which features are active:-
.RS
.LP
diff --git a/src/devices/gropdf/gropdf.pl b/src/devices/gropdf/gropdf.pl
index 048a607fb..d0da52c42 100644
--- a/src/devices/gropdf/gropdf.pl
+++ b/src/devices/gropdf/gropdf.pl
@@ -452,7 +452,7 @@ sub usage
$stream = *STDERR if $had_error;
print $stream
"usage: $prog [-delsW] [-F font-directory] [-I inclusion-directory]" .
-" [--opt advanced-opts] [-p paper-format] [--pdfver 1.4|1.7] [-u [cmap-file]]
[-y foundry] [file ...]\n" .
+" [--opt option-bits] [-p paper-format] [--pdfver {1.4|1.7}] [-u [cmap-file]]
[-y foundry] [file ...]\n" .
"usage: $prog {-v | --version}\n" .
"usage: $prog --help\n";
if (!$had_error)
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
