gbranden pushed a commit to branch master
in repository groff.
commit 309079129baa19c450e0f777964c81e197194055
Author: G. Branden Robinson <g.branden.robin...@gmail.com>
AuthorDate: Fri Feb 28 17:31:33 2025 -0600
[doc,man]: Clarify postprocessor access features.
---
doc/groff.texi.in | 27 ++++++++++++++++++++-------
man/groff.7.man | 13 +++++++++----
2 files changed, 29 insertions(+), 11 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 16c44be7f..b927de377 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -16924,13 +16924,26 @@ as returned by @cite{getenv@r{(3)}}.
@cindex postprocessor access
@cindex access to postprocessor
-Two escape sequences and two requests enable documents to pass
-information directly to a postprocessor. These are useful for
-exercising device-specific capabilities that the @code{groff} language
-does not abstract or generalize; examples include the embedding of
-hyperlinks and image files. Device-specific functions are documented in
-each output driver's man page, such as @cite{gropdf@r{(1)}},
-@cite{grops@r{(1)}}, or @cite{grotty@r{(1)}}.
+Beyond the
+@code{cf}
+and
+@code{trf}
+requests
+(recall
+@ref{I/O}),
+two escape sequences and two requests enable documents
+to pass information directly to a postprocessor.
+These are useful for exercising device-specific capabilities that the
+@code{groff}
+language does not abstract or generalize;
+examples include the embedding of hyperlinks and image files.
+Device-specific functions are documented
+in each output driver's man page,
+such as
+@cite{gropdf@r{(1)}},
+@cite{grops@r{(1)}},
+or
+@cite{grotty@r{(1)}}.
@DefreqList {device, [@code{"}]@Var{contents}}
@DefescListEndx {\\X, @code{'}, contents @r{@dots{}}, @code{'}}
diff --git a/man/groff.7.man b/man/groff.7.man
index ff67bb3df..e024d385e 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -8404,16 +8404,21 @@ copies a named environment's parameters to the current
one.
.
.\" BEGIN Keep (roughly) parallel with groff.texi node "Postprocessor
.\" Access".
-Two escape sequences and two requests enable documents to pass
-information directly to an output driver or other postprocessor.
+Beyond the
+.B cf
+and
+.B trf
+requests,
+two escape sequences and two requests enable documents
+to pass information directly to a postprocessor.
.
These are useful for exercising device-specific capabilities that the
.I groff
language does not abstract or generalize;
examples include the embedding of hyperlinks and image files.
.
-Device-specific functions are documented in each output driver's man
-page,
+Device-specific functions are documented
+in each output driver's man page,
such as
.MR gropdf @MAN1EXT@ ,
.MR grops @MAN1EXT@ ,
_______________________________________________
groff-commit mailing list
groff-commit@gnu.org
https://lists.gnu.org/mailman/listinfo/groff-commit
