gbranden pushed a commit to branch master
in repository groff.
commit 3bb47634eac2368858afb5a4f4a8903e28e1586a
Author: G. Branden Robinson <[email protected]>
AuthorDate: Thu Jan 22 10:42:30 2026 -0600
gropdf(1): Relocate material.
gropdf's `markstart` and `markend` device extension commands don't have
convenience macros, as Deri pointed out in commit 3a8f90f926, so move
their descriptions out from under the sentence that claims "the
following have counterpart convenience macros".
Its `xrev` device extension command is in the same boat; move it, too.
---
src/devices/gropdf/gropdf.1.man | 73 +++++++++++++++++++----------------------
1 file changed, 34 insertions(+), 39 deletions(-)
diff --git a/src/devices/gropdf/gropdf.1.man b/src/devices/gropdf/gropdf.1.man
index 94aa0695e..4dd6448f1 100644
--- a/src/devices/gropdf/gropdf.1.man
+++ b/src/devices/gropdf/gropdf.1.man
@@ -1042,6 +1042,40 @@ and
option.
.
.
+.TP
+.BI "\[rs]X\[aq]pdf: markstart " /ANN-definition \[aq]
+.TQ
+.B \[rs]X\[aq]pdf: markend\[aq]
+Macros that support PDF features use these calls internally to
+start and stop (respectively) the placement of the
+.I hotspot
+text; the user will have used a PDF macro which supports clickable
+text. The
+.I /ANN-definition
+is supplied internally, so user documents should use the appropriate
+.B \%.pdfhref
+call and never
+.B \[rs]X\[aq]pdf: markstart\[aq].
+The only time to mark the end of a hotspot is if you have called
+.B \%.pdfhref
+with the -S flag, then use it to signal the end of the hotspot text
+using
+.B \[rs]X\[aq]pdf: markend\[aq]\[rs]m[\[rs]*[pdf:curcol]]
+.
+.
+.TP
+.B \[rs]X\[aq]pdf: xrev\[aq]
+Toggle the reversal of glyph direction.
+.
+This feature works by reversing all following text.
+Each separate letter is also mirrored.
+.
+One application is the reversal of glyphs in the Zapf Dingbats font.
+.
+To restore the normal glyph orientation,
+repeat the command.
+.
+.
.LP
.I gropdf
supports several more device extensions using the
@@ -1183,29 +1217,6 @@ see
.RE
.
.
-.br
-.ne 3v
-.TP
-.BI "\[rs]X\[aq]pdf: markstart " /ANN-definition \[aq]
-.TQ
-.B \[rs]X\[aq]pdf: markend\[aq]
-Macros that support PDF features use these calls internally to
-start and stop (respectively) the placement of the
-.I hotspot
-text; the user will have used a PDF macro which supports clickable
-text. The
-.I /ANN-definition
-is supplied internally, so user documents should use the appropriate
-.B \%.pdfhref
-call and never
-.B \[rs]X\[aq]pdf: markstart\[aq].
-The only time to mark the end of a hotspot is if you have called
-.B \%.pdfhref
-with the -S flag, then use it to signal the end of the hotspot text
-using
-.B \[rs]X\[aq]pdf: markend\[aq]\[rs]m[\[rs]*[pdf:curcol]]
-.
-.
.TP
.B .pdfmarksuspend
.TQ
@@ -1620,32 +1631,16 @@ transition style only) If
.BR true ,
the area that shall be flown
in is rectangular and opaque.
-.LP
.IP
Any of the parameters may be
replaced with a "." which signifies the parameter retains its
previous value, also any trailing missing parameters are ignored.
-.LP
.IP
.B Note:
not all PDF Readers support any or all these transitions.
.LP
.
.
-.TP
-.\" XXX: No convenience macro for this one? --GBR
-.B \[rs]X\[aq]pdf: xrev\[aq]
-Toggle the reversal of glyph direction.
-.
-This feature works by reversing all following text.
-Each separate letter is also mirrored.
-.
-One application is the reversal of glyphs in the Zapf Dingbats font.
-.
-To restore the normal glyph orientation,
-repeat the command.
-.
-.
.\" ====================================================================
.SS Macros
.\" ====================================================================
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
