[groff] 11/12: doc/groff.texi (Debugging): Discuss `fl` more.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit d975d283a4d8382ea437a31aeb92b0f6c70cb22a
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Fri Feb 2 19:39:49 2024 -0600

    doc/groff.texi (Debugging): Discuss `fl` more.
---
 doc/groff.texi | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/doc/groff.texi b/doc/groff.texi
index 5ff964977..fef257741 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -17129,6 +17129,19 @@ Break the line and flush any pending output line 
immediately.  The
 effect is the same as the @code{br} request unless the no-break control
 character is used; @samp{'br} does nothing, whereas @samp{'fl} writes
 the pending output line without further updating the drawing position.
+However, the @emph{reported} horizontal drawing position is still
+reckoned from the start of the input line.
+
+@Example
+foo bar \n(hp
+foo bar \c
+'fl
+\n(hp
+    @result{} foo bar 192 foo bar 0
+@endExample
+
+The timing of a flush is most easily perceived in GNU @command{troff}'s
+device-independent output.
 
 Historically, @code{fl} was used with @code{rd} to produce interactive
 @command{nroff} documents.  GNU @command{troff} does not easily support