[groff] 08/12: groff(7): Clarify summaries of stream requests.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 02fec248b753bd712f53cc7a841621ca20769c0a
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Fri Nov 10 12:42:57 2023 -0600

    groff(7): Clarify summaries of stream requests.
---
 man/groff.7.man | 30 ++++++++++++++++++------------
 1 file changed, 18 insertions(+), 12 deletions(-)

diff --git a/man/groff.7.man b/man/groff.7.man
index 9828bd2a4..b7b4fe476 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -2777,9 +2777,12 @@ comprising the characters or range expressions
 and so on.
 .
 .TPx
-.REQ .close "stream"
-Close the
-.IR stream .
+.REQ .close stream
+Close
+.IR stream ,
+making it unavailable for
+.request .write
+requests.
 .
 .
 .TPx
@@ -3799,18 +3802,21 @@ Stop formatting current file and begin reading
 .I file.
 .
 .TPx
-.REQ .open "stream file"
+.REQ .open "ident file"
 Open
 .I file
-for writing and associate the stream named
-.I stream
-with it.
+for writing and associate a stream named
+.I ident
+with it,
+making it available for
+.request .write
+requests.
 .
 Unsafe request;
 disabled by default.
 .
 .TPx
-.REQ .opena "stream file"
+.REQ .opena "ident file"
 As
 .request .open ,
 but append to
@@ -4584,7 +4590,7 @@ evaluates false.
 .REQ .write "stream anything"
 Write
 .I anything
-to the stream named
+to
 .IR stream .
 .
 .TPx
@@ -4594,10 +4600,10 @@ Similar to
 without emitting a final newline.
 .
 .TPx
-.REQ .writem "stream xx"
+.REQ .writem "stream name"
 Write contents of macro or string
-.I xx
-to the stream named
+.I name
+to
 .IR stream .
 .
 .LE