* doc/groff.texinfo (Drawing Requests): Improve documentation of

\D'P ...'.

1 files changed, 18 insertions, 0 deletions

diff --git a/doc/groff.texinfo b/doc/groff.texinfo
index d99f3612..aae17d01 100644
--- a/doc/groff.texinfo
+++ b/doc/groff.texinfo
@@ -11762,6 +11762,24 @@ text completely.
 ..
 @endExample
 
+If you want a filled polygon which has exactly the same size as an
+unfilled one, you must draw both an unfilled and a filled polygon.
+A filled polygon is always smaller than an unfilled one because the
+latter uses straight lines with a given line thickness to connect
+the polygon's corners, while the former simply fills the area
+defined by the coordinates.
+
+@Example
+\h'1i'\v'1i'\
+\# increase line thickness
+\Z'\D't 5p''\
+\# draw unfilled polygon
+\Z'\D'p 3 3 -6 0''\
+\# draw filled polygon
+\Z'\D'P 3 3 -6 0''
+@endExample
+
+
 @item \D't @var{n}'
 @cindex line thickness (@w{@code{\D't @dots{}'}})
 @cindex thickness of lines (@w{@code{\D't @dots{}'}})