gbranden pushed a commit to branch master
in repository groff.
commit eef589cae4409bbb9e6d476f3e11bc169ca7b6f0
Author: G. Branden Robinson <g.branden.robin...@gmail.com>
AuthorDate: Wed Mar 5 09:04:44 2025 -0600
[doc,man]: Revise description of `pline` output.
...now that it's wired up to the new node dumper features.
* doc/groff.texi.in (Debugging) <pline>:
* man/groff.7.man (Request short reference) <pline>:
* man/groff_diff.7.man (New requests) <pline>: Do it.
---
doc/groff.texi.in | 10 +++++++---
man/groff.7.man | 7 +++++--
man/groff_diff.7.man | 7 +++++--
3 files changed, 17 insertions(+), 7 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index a53882e98..b03f371dd 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -17743,9 +17743,13 @@ asterisk (@code{*}).
@cindex node list, of pending output line, dumping (@code{pline})
@cindex output line, node list of pending, dumping (@code{pline})
@cindex pending node list of output line, dumping (@code{pline})
-Report, to the standard error stream, the list of output nodes
-corresponding to the pending output line. The list is empty if there
-are none.
+Report,
+in JSON syntax to the standard error stream,
+the list of output nodes corresponding to the pending output line.
+In JSON,
+a pair of empty brackets
+@samp{[ ]}
+represents an empty list.
@endDefreq
@Defreq {pm, }
diff --git a/man/groff.7.man b/man/groff.7.man
index 0b10f1c58..0421225ab 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -4195,10 +4195,13 @@ Change page length to
.TPx
.REQ .pline
Report,
-to the standard error stream,
+in JSON syntax to the standard error stream,
the list of output nodes corresponding to the pending output line.
.
-The list is empty if there are none.
+In JSON,
+a pair of empty brackets
+.RB \[lq] "[ ]" \[rq]
+represents an empty list.
.
.TPx
.REQ .pm
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index 94387cf53..516ad4b11 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -3415,10 +3415,13 @@ are suffixed with a tab and asterisk
.TP
.B .pline
Report,
-to the standard error stream,
+in JSON syntax to the standard error stream,
the list of output nodes corresponding to the pending output line.
.
-The list is empty if there are none.
+In JSON,
+a pair of empty brackets
+.RB \[lq] "[ ]" \[rq]
+represents an empty list.
.
.
.TP
_______________________________________________
groff-commit mailing list
groff-commit@gnu.org
https://lists.gnu.org/mailman/listinfo/groff-commit
