Follow-up Comment #6, bug #66537 (group groff): At 2024-12-09T04:42:13-0500, Bjarni Ingi Gislason wrote: > Follow-up Comment #5, bug #66537 (group groff): > > "info groff", search for '.pso': says (through ".so") that the > "command" must end with a newline.
I think that's a misleading characterization. When discussing `so`, and
even more so `pso`, we must carefully distinguish the argument given to
the request from the contents of the stream that the request produces
and reads. Your comment implies the former. Further, it is not
mandatory that the contents of the stream end with a newline, but one
must understand the consequences if it does not.
Perhaps your copy of the groff Texinfo manual is old; I have recently
revised and clarified this material.
-- Request: .so ['"']file
-- Request: .soquiet ['"']file
Replace the 'so' request's control line with the contents of the
file named by the argument, "sourcing" it. FILE is sought in the
directories specified by '-I' command-line option. If FILE does
not exist, a warning in category 'file' is produced and the request
has no further effect. *Note Warnings::, for information about the
enablement and suppression of warnings.
...
*Caution:* Since the formatter replaces the entire control line
with the contents of a file, FILE must end with a newline, or the
formatter will continue reading the next input line of the 'roff'
file as if were part of the last line of the sourced file.
Consider a file 'xxx' containing only the word 'foo' without a
trailing newline.
$ printf 'foo' > xxx
$ groff <<EOF
The situation is
.so xxx
bar.
EOF
=> The situation is foobar.
...
-- Request: .pso ['"']command
Read the standard output from the specified COMMAND when passed to
'popen(3)' and include it in place of the 'pso' request.
...
The cautionary note regarding a final newline in the stream read by
the 'so' request applies to 'pso' as well.
_______________________________________________________
Reply to this item at:
<https://savannah.gnu.org/bugs/?66537>
_______________________________________________
Message sent via Savannah
https://savannah.gnu.org/
signature.asc
Description: PGP signature
