gbranden pushed a commit to branch master
in repository groff.
commit 9c810ca9264e88d742b4ee5a3f53eab0186ad5fd
Author: G. Branden Robinson <[email protected]>
AuthorDate: Sat Nov 7 06:39:42 2026 -0600
[doc,man]: Fix content, style, and markup nits.
* Speak of a "vertex" determined by a drawing command, not a "point".
* Favor active voice over passive.
* Sync input line breaks between Texinfo and *roff documents.
---
doc/groff.texi.in | 70 +++++++++++++++++++++++++++++++++++++-----------------
man/groff.7.man.in | 13 +++++-----
2 files changed, 54 insertions(+), 29 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 599d472c3..c3114c9a4 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -19502,28 +19502,54 @@ When writing text, the drawing position is at the
text baseline; recall
@c BEGIN Keep (roughly) parallel with subsection "Drawing commands" of
@c groff(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.
-Terminals in particular implement almost none. @xref{Graphics
-Commands}.
-
-Rendering starts at the drawing position; when finished, the drawing
-position is left at the rightmost point of the object, even for closed
-figures, except where noted. GNU @code{troff} draws stroked (outlined)
-objects with the stroke color, and shades filled ones with the fill
-color. @xref{Colors}. Coordinates @var{h} and @var{v} are horizontal
-and vertical motions relative to the drawing position or previous point
-in the command. The default scaling unit for horizontal measurements
-(and diameters of circles) is @samp{m}; for vertical ones, @samp{v}.
-
-Circles, ellipses, and polygons can be drawn filled or stroked. These
-are independent properties; if you want a filled, stroked figure, you
-must draw the same figure twice using each drawing command. A filled
-figure is always smaller than an outlined one because the former is
-drawn only within its defined area, whereas strokes have a line
-thickness (set with @samp{\D't'}).
+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.
+Terminals in particular implement almost none.@footnote{@xref{Graphics
+Commands}.}
+
+Rendering starts at the drawing position;
+when finished,
+the formatter leaves
+the drawing position at the rightmost point of the object,
+even for closed figures,
+except where noted.
+GNU
+@command{troff}
+draws stroked (outlined) objects with the stroke color,
+and shades filled ones with the fill color.@footnote{@xref{Colors}.}
+Coordinates
+@var{h}
+and
+@var{v}
+are horizontal and vertical motions
+relative to the drawing position or previous vertex in the command.
+The default scaling unit for horizontal measurements
+(and diameters of circles)
+is
+@samp{m};
+for vertical ones,
+@samp{v}.
+
+Circles,
+ellipses,
+and polygons can be drawn filled or stroked.
+These are independent properties;
+if you want a filled,
+stroked figure,
+you must draw the same figure twice using each drawing command.
+A filled figure is always smaller than an outlined one
+because the formatter draws the former only within its defined area,
+whereas strokes have a line
+thickness
+(set with
+@samp{\D't'}).
@Example
\h'1i'\v'1i'\
diff --git a/man/groff.7.man.in b/man/groff.7.man.in
index 8e5de7794..ceaa17488 100644
--- a/man/groff.7.man.in
+++ b/man/groff.7.man.in
@@ -7031,7 +7031,8 @@ Terminals in particular implement almost none.
.P
Rendering starts at the drawing position;
when finished,
-the drawing position is left at the rightmost point of the object,
+the formatter leaves
+the drawing position at the rightmost point of the object,
even for closed figures,
except where noted.
.
@@ -7040,14 +7041,12 @@ GNU
draws stroked (outlined) objects with the stroke color,
and shades filled ones with the fill color.
.
-See section \[lq]Colors\[rq] above.
-.
Coordinates
.I h
and
.I v
-are horizontal and vertical motions relative to the drawing position
-or previous point in the command.
+are horizontal and vertical motions
+relative to the drawing position or previous vertex in the command.
.
The default scaling unit for horizontal measurements
(and diameters of circles)
@@ -7066,8 +7065,8 @@ if you want a filled,
stroked figure,
you must draw the same figure twice using each drawing command.
.
-A filled figure is always smaller than an outlined one because the
-former is drawn only within its defined area,
+A filled figure is always smaller than an outlined one
+because the formatter draws the former only within its defined area,
whereas strokes have a line thickness
(set with
.BR \[rs]D\[aq]t\[aq] ).
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit