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

Reply via email to