gbranden pushed a commit to branch master
in repository groff.
commit 5c3499f3b95755d0c6698fa348f50951d0a078a3
Author: G. Branden Robinson <[email protected]>
AuthorDate: Thu Nov 6 05:09:06 2025 -0600
gropdf(1): Fix style nits.
* Set "gropdf" in italics, not roman.
* Retitle column in `--opt` table; the values in the column are already
exponentiated. (That is, where 2^x = y, the table entries are y, not
x.)
* Consistently use complete sentences and grammatical mood (imperative)
in descriptions of option-bits values.
* Respell table format description to align with other groff man pages.
* Recast.
* Break input lines at sentence endings.
* Annotate a man(7) macro usage trick.
* Annotate a question I have for Deri.
---
src/devices/gropdf/gropdf.1.man | 46 +++++++++++++++++++++++++++--------------
1 file changed, 31 insertions(+), 15 deletions(-)
diff --git a/src/devices/gropdf/gropdf.1.man b/src/devices/gropdf/gropdf.1.man
index ea185de9a..09b5d191a 100644
--- a/src/devices/gropdf/gropdf.1.man
+++ b/src/devices/gropdf/gropdf.1.man
@@ -213,37 +213,53 @@ Orient the document in landscape format.
.
.TP
.BI \-\-opt\~ option-bits
-Specify advanced options for gropdf.
+Specify advanced options for
+.I gropdf.
.I option-bits
-controls which features are active:-
-.RS
+is a bit vector that selects active features.
+.
+Add the following values to combine them.
+.
+.
.LP
-.RS
+.RS \" One inset to align with the indentation of `TP`...
+.RS \" ...and one more to get "inboard" of it.
.TS
-l l, lB lx.
-Bit Meaning
+L L
+Lb Lx.
+Value Meaning
_
-1 included type 1 fonts are subsetted
+1 Subset included Type 1 fonts.
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).
+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.
T}
4 T{
-compress all streams, if this bit is unset streams are uncompressed.
+Compress all streams.
T}
8 T{
-don't include font file. (The font is specified in the pdf but no font
-data is embedded - usually not useful).
+.\" Why don't we flip the sense of this bit and the default can be
+.\" 15--all bits on? --GBR
+Don't embed font files.
+.
+(A font required by the document is not 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
+The default feature combination is 7.
+.
+To mimic what
.I gropdf
-1.23 produced use value 6 (turn off subsetting).
+from
+.I groff
+1.23 produced,
+specify \[lq]6\[rq] to turn off subsetting.
.RE
.
+.
.TP
.BI \-p " paper-format"
Set the physical dimensions of the output medium.
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
