gbranden pushed a commit to branch master
in repository groff.
commit 76d2007e6bd764e3165e7fe1bfc2ff1d9076b578
Author: G. Branden Robinson <g.branden.robin...@gmail.com>
AuthorDate: Mon Jun 2 02:05:51 2025 -0500
doc/*,man/*: Improve `so` request description.
Support for an "include search path" is a GNU troff extension; document
it as such.
Document warning behavior in man pages.
Parallelize wording between our Texinfo manual and man pages.
---
doc/groff.texi.in | 12 +++++++-----
man/groff.7.man | 17 +++++++++++++++++
man/groff_diff.7.man | 17 +++++++++++++++++
3 files changed, 41 insertions(+), 5 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 06ce29fb0..bee66c930 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -16906,16 +16906,18 @@ GNU
@command{troff} @c GNU
searches for
@var{file}
-in the directories specified by the @option{-I} command-line option.
+in any directories specified by
+@option{-I}
+command-line options,
+followed by the current working directory.
If
@var{file}
does not exist,
-GNU
+the formatter ignores the request.@footnote{GNU
@command{troff} @c GNU
emits a warning in category
-@samp{file}
-and the request has no further effect.
-@xref{Warnings}.
+@samp{file}.
+@xref{Warnings}.}
@code{so} can be useful for large documents,
allowing each chapter of a book,
diff --git a/man/groff.7.man b/man/groff.7.man
index d12d8fc11..a569e1205 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -4590,6 +4590,23 @@ Replace the request's control line
with the contents of
.IR file ,
\[lq]sourcing\[rq] it.
+GNU
+.I troff \" GNU
+searches for
+.I file
+in any directories specified by
+.B \-I
+command-line options,
+followed by the current working directory.
+.
+If
+.I file
+does not exist,
+the formatter ignores the request.
+(GNU
+.I troff \" GNU
+emits a warning in category
+.RB \[lq] file \[rq].)
.
.TPx
.REQ .soquiet file
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index 6a7eeef66..d7e019f66 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -4440,6 +4440,23 @@ from
permitting initial embedded spaces in it,
and reads it to the end of the input line in copy mode.
.
+GNU
+.I troff \" GNU
+searches for
+.I file
+in any directories specified by
+.B \-I
+command-line options,
+followed by the current working directory.
+.
+If
+.I file
+does not exist,
+GNU
+.I troff \" GNU
+emits a warning in category
+.RB \[lq] file \[rq].
+.
.
.TP
.BI .ss\~ word-space-size\~\c
_______________________________________________
groff-commit mailing list
groff-commit@gnu.org
https://lists.gnu.org/mailman/listinfo/groff-commit
