gbranden pushed a commit to branch master
in repository groff.
commit c2c08d82ac7440ee8ce561cab4ae300b980b6664
Author: G. Branden Robinson <[email protected]>
AuthorDate: Thu Aug 17 05:59:16 2023 -0500
[docs]: Fix style and markup nits.
* Migrate terminology to "terminals" and "typesetters".
* Tighten wording.
* Annotate Texinfo/man synchronization.
---
doc/groff.texi | 6 +++++-
man/groff.7.man | 8 +++++---
2 files changed, 10 insertions(+), 4 deletions(-)
diff --git a/doc/groff.texi b/doc/groff.texi
index 045dbf8de..6714d306c 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -13376,6 +13376,8 @@ one level higher. This is used to define a wrapper
macro for
@subsection Parameters
@cindex parameters
+@c BEGIN Keep (roughly) parallel with subsection "Parameters" of
+@c groff(7).
Macro calls and string interpolations optionally accept a list of
arguments; recall @ref{Calling Macros}. At the time such an
interpolation takes place, these @dfn{parameters} can be examined using
@@ -13411,6 +13413,8 @@ to@tie{}@var{n} are no longer available. Shifting by a
non-positive
amount performs no operation. The register @code{.$} is adjusted
accordingly.
@endDefreq
+@c END Keep (roughly) parallel with subsection "Parameters" of
+@c groff(7).
@cindex copy mode, and macro parameters
@cindex mode, copy, and macro parameters
@@ -14143,7 +14147,7 @@ The @code{\D} escape sequence provides @dfn{drawing
commands} that
direct the output device to render geometrical objects rather than
glyphs. Specific devices may support only a subset, or may feature
additional ones; consult the man page for the output driver in use.
-Terminal devices in particular implement almost none. @xref{Graphics
+Terminals in particular implement almost none. @xref{Graphics
Commands}.
Rendering starts at the drawing position; when finished, the drawing
diff --git a/man/groff.7.man b/man/groff.7.man
index 8f01dee51..f54898ee9 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -5400,7 +5400,7 @@ Specific devices may support only a subset,
or may feature additional ones;
consult the man page for the output driver in use.
.
-Terminal devices in particular implement almost none.
+Terminals in particular implement almost none.
.
.
.P
@@ -7055,6 +7055,7 @@ returning to the enclosing context.
.SS Parameters
.\" ====================================================================
.
+.\" BEGIN Keep (roughly) parallel with groff.texi node "Parameters".
Macro call and string interpolation parameters can be accessed using
escape sequences starting with
.RB \[lq] \|\[rs]$ \[rq].
@@ -7063,7 +7064,7 @@ The
.B \[rs]n[.$]
read-only register stores the count of parameters available to a macro
or string;
-its value can be changed by the
+change its value with the
.B .shift
request,
which dequeues parameters from the current list.
@@ -7073,6 +7074,7 @@ The
escape sequence interpolates the name by which a macro was called.
.
Applying string interpolation to a macro does not change this name.
+.\" END Keep (roughly) parallel with groff.texi node "Parameters".
.
.
.\" ====================================================================
@@ -7725,7 +7727,7 @@ There exists a
request
.B .ul
(see above)
-that underlines subsequent source lines on terminal devices,
+that underlines subsequent source lines on terminals,
but on typesetters,
it selects an italic font style instead.
.
_______________________________________________
Groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
