gbranden pushed a commit to branch master
in repository groff.
commit 2fa3a2c3a48a6997dd7fecb507a29df48fa6f3d7
Author: G. Branden Robinson <[email protected]>
AuthorDate: Sun Feb 8 02:39:41 2026 -0600
[grodf]: Fix Savannah #68022.
* src/devices/gropdf/gropdf.pl: Rename new `--opt` command-line option
to `--format-options`, with short `-f` synonym.
* src/devices/gropdf/gropdf.1.man (Options): Update.
Fixes <https://savannah.gnu.org/bugs/?68022>.
---
ChangeLog | 8 ++++
src/devices/gropdf/gropdf.1.man | 101 +++++++++++++++++++++++-----------------
src/devices/gropdf/gropdf.pl | 9 ++--
3 files changed, 72 insertions(+), 46 deletions(-)
diff --git a/ChangeLog b/ChangeLog
index 4ebaaf44d..a63771063 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,11 @@
+2026-02-08 G. Branden Robinson <[email protected]>
+
+ * src/devices/gropdf/gropdf.pl: Rename new `--opt` command-line
+ option to `--format-options`, with short `-f` synonym.
+ * src/devices/gropdf/gropdf.1.man (Options): Update.
+
+ Fixes <https://savannah.gnu.org/bugs/?68022>.
+
2026-02-08 G. Branden Robinson <[email protected]>
Simplify handling of ".version" file.
diff --git a/src/devices/gropdf/gropdf.1.man b/src/devices/gropdf/gropdf.1.man
index b0374c50b..c354c06c2 100644
--- a/src/devices/gropdf/gropdf.1.man
+++ b/src/devices/gropdf/gropdf.1.man
@@ -180,50 +180,28 @@ fonts (even the 14 base PDF fonts).
.
.
.TP
-.BI \-F " dir"
-Prepend directory
-.IR dir /dev name
-to the search path for font, and device description files;
-.I name
-is the name of the device, usually
-.BR pdf .
-.
-.TP
-.BI \-I\~ dir
-Search the directory
-.I dir
-for files named in
-.B \[rs]X\[aq]pdf: pdfpic\[aq]
-device extension commands.
-.
-.B \-I
-may be specified more than once;
-each
-.I dir
-is searched in the given order.
-.
-To search the current working directory before others,
-add
-.RB \[lq] "\-I .\&" \[rq]
-at the desired place;
-it is otherwise searched last.
-.
-.
-.TP
-.B \-l
-Orient the document in landscape format.
-.
-.TP
-.BI \-\-opt\~ option-bits
+.BI \-\-format\-options\~ bit-vector
+.TQ
+.BI \-f\~ bit-vector
Specify advanced options for
.I gropdf.
-.I option-bits
-is a bit vector that selects active features.
+.
+Familiarity with the
+.UR https://\:www\:.pdfa\-inc\:.org/\:product/\
+\:iso\-32000\-2\-pdf\-2\-0\-bundle\-sponsored\-access/
+ISO\~32000 PDF standard
+.UE
+is helpful.
+.
+The
+.I bit-vector
+argument is an integer
+that configures characteristics of the generated PDF.
.
Add the following values to combine them.
.
.
-.LP
+.IP
.RS \" One inset to align with the indentation of `TP`...
.RS \" ...and one more to get "inboard" of it.
.TS
@@ -236,13 +214,12 @@ _
Use more compact format for text by including space as a character.
Fonts that do not include space as a glyph
may conflict with this feature.
+.\" GBR: How? Will there be an error message?
T}
4 T{
-Compress all streams.
+Compress all data streams.
T}
8 T{
-.\" Why don't we flip the sense of this bit and the default can be
-.\" 15--all bits on? See Savannah #66342. --GBR
Don't embed font files.
.
(A font required by the document is not embedded;
@@ -250,7 +227,10 @@ usually not useful.)
T}
.TE
.RE
-.LP
+.RE
+.
+.
+.IP
The default feature combination is 7.
.
To mimic what
@@ -259,7 +239,42 @@ from
.I groff
1.23 produced,
specify \[lq]6\[rq] to turn off subsetting.
-.RE
+.
+.
+.TP
+.BI \-F " dir"
+Prepend directory
+.IR dir /dev name
+to the search path for font, and device description files;
+.I name
+is the name of the device, usually
+.BR pdf .
+.
+.
+.TP
+.BI \-I\~ dir
+Search the directory
+.I dir
+for files named in
+.B \[rs]X\[aq]pdf: pdfpic\[aq]
+device extension commands.
+.
+.B \-I
+may be specified more than once;
+each
+.I dir
+is searched in the given order.
+.
+To search the current working directory before others,
+add
+.RB \[lq] "\-I .\&" \[rq]
+at the desired place;
+it is otherwise searched last.
+.
+.
+.TP
+.B \-l
+Orient the document in landscape format.
.
.
.TP
diff --git a/src/devices/gropdf/gropdf.pl b/src/devices/gropdf/gropdf.pl
index 4b3241a5f..f4768d5d3 100644
--- a/src/devices/gropdf/gropdf.pl
+++ b/src/devices/gropdf/gropdf.pl
@@ -456,8 +456,10 @@ sub usage
my $had_error = shift;
$stream = *STDERR if $had_error;
print $stream
-"usage: $prog [-delsW] [-F font-directory] [-I inclusion-directory]" .
-" [--opt option-bits] [-p paper-format] [--pdfver {1.4|1.7}] [-u [cmap-file]]
[-y foundry] [file ...]\n" .
+"usage: $prog [-delsW] [-f bit-vector] [-F font-directory]" .
+" [--format-options bit-vector] [-I inclusion-directory]" .
+" [-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)
@@ -499,7 +501,8 @@ my $parclntyp=qr/(?:[\d\w]|\([+-]?[\S]{2}|$parcln)/;
if (!GetOptions('F=s' => \@fdlist, 'I=s' => \@idirs, 'l' => \$frot,
'p=s' => \$fpsz, 'd!' => \$debug, 'help' => \$want_help, 'pdfver=f' =>
\$PDFver,
- 'v' => \$version, 'version' => \$version, 'opt=s' => \$options,
+ 'v' => \$version, 'version' => \$version,
+ 'f=s' => \$options, 'format-options=s' => \$options,
'e' => \$embedall, 'y=s' => \$Foundry, 's' => \$stats, 'W' => \$warnexit,
'u:s' => \$unicodemap))
{
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
