gbranden pushed a commit to branch master
in repository groff.
commit aa471e9b5d1a2dcabc5da95aeba01ab44664767c
Author: G. Branden Robinson <[email protected]>
AuthorDate: Fri Apr 3 20:05:24 2026 -0500
[doc,man]: Clarify detail of `\D'p'`.
---
doc/groff.texi.in | 21 +++++++++++----------
man/groff.7.man | 18 +++++++++---------
man/groff_diff.7.man | 17 +++++++----------
3 files changed, 27 insertions(+), 29 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index f7aebded7..d8148ed8a 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -17929,16 +17929,17 @@ box margin.
Draw polygon with vertices at the drawing position
and each point in sequence.
GNU
-@code{troff} closes the polygon by drawing a line from
-(@var{hn}, @var{vn})
-back to the initial drawing position.
-@c XXX: This would be the "STUPID_DRAWING_POSITIONING" complained of in
-@c src/libs/libdriver/input.cpp. It is neither the rightmost point
-@c of the figure nor the initial drawing position that GNU troff
-@c automatically returned to close the figure.
-Afterward,
-the drawing position is left at
-(@var{hn}, @var{vn}).
+@command{troff} @c GNU
+closes the polygon by drawing a line from
+(@var{hn},
+@var{vn})
+back to the initial drawing position
+and leaves the drawing position there.@footnote{DWB
+and Heirloom Doctools
+@command{troff}s
+do neither.}
+@c XXX: That would be the "STUPID_DRAWING_POSITIONING" complained of in
+@c src/libs/libdriver/input.cpp.
@item \D'P @var{dx1} @var{dy1} @var{dx2} @var{dy2} @dots{}'
@cindex polygon, filled, drawing (@samp{\D'P @dots{}'})
diff --git a/man/groff.7.man b/man/groff.7.man
index 356bfa214..9ef8927a5 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -6769,15 +6769,15 @@ GNU
.I troff \" GNU
closes the polygon by drawing a line from
.RI ( hn ,\~ vn )
-back to the initial drawing position.
-.
-.\" XXX: This would be the "STUPID_DRAWING_POSITIONING" complained of in
-.\" src/libs/libdriver/input.cpp. It is neither the rightmost point
-.\" of the figure nor the initial drawing position that GNU troff
-.\" automatically returned to close the figure.
-Afterward,
-the drawing position is left at
-.RI ( hn ,\~ vn ).
+back to the initial drawing position
+and leaves the drawing position there.
+.\" XXX: That would be the "STUPID_DRAWING_POSITIONING" complained of in
+.\" src/libs/libdriver/input.cpp.
+.
+(DWB
+and Heirloom Doctools
+.IR troff s \" DWB, Heirloom
+do neither.)
.
.TP
.BI \[rs]D\[aq]P\~ "h1 v1"\~\c
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index b8ed37317..8f018c76b 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -973,17 +973,14 @@ GNU
closes the polygon by drawing a line from
.RI ( hn ,\~ vn )
back to the initial drawing position;
-DWB and Heirloom
+and leaves the drawing position there.
+.\" XXX: That would be the "STUPID_DRAWING_POSITIONING" complained of in
+.\" src/libs/libdriver/input.cpp.
+.
+(DWB
+and Heirloom Doctools
.IR troff s \" DWB, Heirloom
-do not.
-.
-.\" XXX: This would be the "STUPID_DRAWING_POSITIONING" complained of in
-.\" src/libs/libdriver/input.cpp. It is neither the rightmost point
-.\" of the figure nor the initial drawing position that GNU troff
-.\" automatically returned to close the figure.
-Afterward,
-the drawing position is left at
-.RI ( hn ,\~ vn ).
+do neither.)
.
.
.TP
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
