gbranden pushed a commit to branch master
in repository groff.

commit b7054334117b582333c49f980145287049fd2b1c
Author: G. Branden Robinson <[email protected]>
AuthorDate: Sun Nov 1 22:07:17 2026 -0600

    [soelim]: Document `-x` option.
    
    ...introduced in groff 1.25.
    
    * src/preproc/soelim/soelim.cpp (usage):
    * src/preproc/soelim/soelim.1.man (Synopsis, Options): Do it.
    
    Fixes <https://savannah.gnu.org/bugs/?68761>.
    
    NEWS: Add item.
---
 ChangeLog                       | 9 +++++++++
 NEWS                            | 6 ++++++
 src/preproc/soelim/soelim.1.man | 9 ++++++++-
 src/preproc/soelim/soelim.cpp   | 5 +++--
 4 files changed, 26 insertions(+), 3 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 2a5fd7a87..624067e0d 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,12 @@
+2026-11-01  G. Branden Robinson <[email protected]>
+
+       [soelim]: Document `-x` option introduced in groff 1.25.
+
+       * src/preproc/soelim/soelim.cpp (usage):
+       * src/preproc/soelim/soelim.1.man (Synopsis, Options): Do it.
+
+       Fixes <https://savannah.gnu.org/bugs/?68761>.
+
 2026-11-15  G. Branden Robinson <[email protected]>
 
        [pic]: Fix memory leak.
diff --git a/NEWS b/NEWS
index 8e5f730fd..7a9e37e6f 100644
--- a/NEWS
+++ b/NEWS
@@ -46,6 +46,12 @@ troff
    interpolation (such as `\n+[myreg]` or `\n-[count]`) is (uselessly)
    applied to a non-auto-crementing register.
 
+soelim
+------
+
+*  soelim now recognizes an option `-x` that promotes failure to open
+   any included file to a fatal error.
+
 
 VERSION 1.25.0
 ==============
diff --git a/src/preproc/soelim/soelim.1.man b/src/preproc/soelim/soelim.1.man
index 986abde84..ebc392863 100644
--- a/src/preproc/soelim/soelim.1.man
+++ b/src/preproc/soelim/soelim.1.man
@@ -64,7 +64,7 @@ or other text files
 .\" ====================================================================
 .
 .SY @g@soelim
-.RB [ \-Crt ]
+.RB [ \-Crtx ]
 .RB [ \-I
 .IR dir ]
 .RI [ input-file\~ .\|.\|.]
@@ -461,6 +461,13 @@ are given,
 the last one specified controls.
 .
 .
+.TP
+.B \-x
+Exit with an error status if an
+.I included-file
+cannot be opened.
+.
+.
 .\" ====================================================================
 .SH "Exit status"
 .\" ====================================================================
diff --git a/src/preproc/soelim/soelim.cpp b/src/preproc/soelim/soelim.cpp
index 94a90cf66..dfa6b5b03 100644
--- a/src/preproc/soelim/soelim.cpp
+++ b/src/preproc/soelim/soelim.cpp
@@ -54,7 +54,7 @@ static bool do_file(const char *);
 
 static void usage(FILE *stream)
 {
-  fprintf(stream, "usage: %s [-Crt] [-I dir] [input-file ...]\n"
+  fprintf(stream, "usage: %s [-Crtx] [-I dir] [input-file ...]\n"
          "usage: %s {-v | --version}\n"
          "usage: %s --help\n",
          program_name, program_name, program_name);
@@ -67,7 +67,8 @@ static void usage(FILE *stream)
 "requests as well to record the name and line number of each\n"
 "input-file and included-file.  Use the -t option to produce TeX\n"
 "comments instead of roff requests.  Use the -r option to write\n"
-"neither.  See the soelim(1) manual page.\n",
+"neither.  Specify the -x option to make failure to open an\n"
+"included-file a fatal error.  See the soelim(1) manual page.\n",
          stream);
 }
 

_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit

Reply via email to