deri pushed a commit to branch master
in repository groff.
commit 068d73d2300c0bd60dfe3ec320dc78881cfe06da
Author: Deri James <[email protected]>
AuthorDate: Tue Nov 4 17:37:43 2025 +0000
[gropdf]: Document --opt and --pdfver
* src/devices/gropdf/gropdf.1.man: Add option entries.
Fixes https://savannah.gnu.org/bugs/?67616
Thanks to Dave for the report.
---
ChangeLog | 10 ++++++++++
src/devices/gropdf/gropdf.1.man | 44 +++++++++++++++++++++++++++++++++++++++++
2 files changed, 54 insertions(+)
diff --git a/ChangeLog b/ChangeLog
index 3f2075e2c..593ba2714 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,13 @@
+2025-11-04 Deri James <[email protected]>
+
+ [gropdf]: Document --opt and --pdfver
+
+ * src/devices/gropdf/gropdf.1.man: Add option entries.
+
+ Fixes https://savannah.gnu.org/bugs/?67616
+
+ Thanks to Dave for the report.
+
2025-11-04 Deri James <[email protected]>
[gropdf]: Reinstate -W to set exit code 2 on warning, and
diff --git a/src/devices/gropdf/gropdf.1.man b/src/devices/gropdf/gropdf.1.man
index a5087e20a..9e618c938 100644
--- a/src/devices/gropdf/gropdf.1.man
+++ b/src/devices/gropdf/gropdf.1.man
@@ -69,8 +69,12 @@ output driver for Portable Document Format
.IR font-directory ]
.RB [ \-I\~\c
.IR inclusion-directory ]
+.RB [ \-\-opt\~\c
+.IR optbits ]
.RB [ \-p\~\c
.IR paper-format ]
+.RB [ \-\-pdfver\~\c
+.IR 1.4 \~|\~ 1.7 ]
\#.RB [ \-w\~\c
\#.IR n ]
.RB [ \-u
@@ -208,6 +212,37 @@ it is otherwise searched last.
Orient the document in landscape format.
.
.TP
+.BI \-\-opt\~ optbits
+Specify advanced options for gropdf.
+.I optbits
+controls which features are active:-
+.RS
+.LP
+.RS
+.TS
+l l, lB lx.
+Bit Meaning
+_
+1 included type 1 fonts are subsetted
+2 T{
+use more compact format for text by including space as a character
+(fonts which do not include space as a glyph may require this unset).
+T}
+4 compress all streams, if this bit is unset streams are uncompressed.
+8 T{
+don't include font file. (The font is specified in the pdf but no font
+data is embedded - usually not useful).
+T}
+.TE
+.RE
+.LP
+Each number can be added together to form a bit-mask. The default value
+is 7. To mimic what
+.I gropdf
+1.23 produced use value 6 (turn off subsetting).
+.RE
+.
+.TP
.BI \-p " paper-format"
Set the physical dimensions of the output medium.
.
@@ -229,6 +264,15 @@ for details.
.
.
.TP
+.BI \-\-pdfver\~ 1.4 \~|\~ 1.7
+PDF version 1.7 introduced a more compact object format, this is
+now the default.
+If you require the original format (as produced by
+.I gropdf
+1.23) set the version to 1.4.
+.
+.
+.TP
.B \-s
Append a comment line to end of PDF showing statistics,
i.e.\& number of pages in document.
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
