[src/trunk]: src/usr.bin/make make(1): document the -S option

[rillig <rillig%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/c031fb80df66
branches:  trunk
changeset: 957041:c031fb80df66
user:      rillig <rillig%NetBSD.org@localhost>
date:      Sat Nov 14 22:19:13 2020 +0000

description:
make(1): document the -S option

This option has been available at least since 1993-03-21, and for the
same time it has been undocumented.

diffstat:

 usr.bin/make/main.c             |   6 +++---
 usr.bin/make/make.1             |  10 +++++++---
 usr.bin/make/unit-tests/opt.exp |   4 ++--
 3 files changed, 12 insertions(+), 8 deletions(-)

diffs (84 lines):

diff -r fc498d2f996a -r c031fb80df66 usr.bin/make/main.c
--- a/usr.bin/make/main.c       Sat Nov 14 22:17:29 2020 +0000
+++ b/usr.bin/make/main.c       Sat Nov 14 22:19:13 2020 +0000
@@ -1,4 +1,4 @@
-/*     $NetBSD: main.c,v 1.467 2020/11/14 22:16:17 rillig Exp $        */
+/*     $NetBSD: main.c,v 1.468 2020/11/14 22:19:13 rillig Exp $        */
 
 /*
  * Copyright (c) 1988, 1989, 1990, 1993
@@ -109,7 +109,7 @@
 #include "trace.h"
 
 /*     "@(#)main.c     8.3 (Berkeley) 3/19/94" */
-MAKE_RCSID("$NetBSD: main.c,v 1.467 2020/11/14 22:16:17 rillig Exp $");
+MAKE_RCSID("$NetBSD: main.c,v 1.468 2020/11/14 22:19:13 rillig Exp $");
 #if defined(MAKE_NATIVE) && !defined(lint)
 __COPYRIGHT("@(#) Copyright (c) 1988, 1989, 1990, 1993 "
            "The Regents of the University of California.  "
@@ -190,7 +190,7 @@
        size_t prognameLen = strcspn(progname, "[");
 
        (void)fprintf(stderr,
-"usage: %.*s [-BeikNnqrstWwX]\n"
+"usage: %.*s [-BeikNnqrSstWwX]\n"
 "            [-C directory] [-D variable] [-d flags] [-f makefile]\n"
 "            [-I directory] [-J private] [-j max_jobs] [-m directory] [-T file]\n"
 "            [-V variable] [-v variable] [variable=value] [target ...]\n",
diff -r fc498d2f996a -r c031fb80df66 usr.bin/make/make.1
--- a/usr.bin/make/make.1       Sat Nov 14 22:17:29 2020 +0000
+++ b/usr.bin/make/make.1       Sat Nov 14 22:19:13 2020 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: make.1,v 1.291 2020/11/12 23:35:21 sjg Exp $
+.\"    $NetBSD: make.1,v 1.292 2020/11/14 22:19:13 rillig Exp $
 .\"
 .\" Copyright (c) 1990, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\"    from: @(#)make.1        8.4 (Berkeley) 3/19/94
 .\"
-.Dd November 12, 2020
+.Dd November 14, 2020
 .Dt MAKE 1
 .Os
 .Sh NAME
@@ -37,7 +37,7 @@
 .Nd maintain program dependencies
 .Sh SYNOPSIS
 .Nm
-.Op Fl BeikNnqrstWwX
+.Op Fl BeikNnqrSstWwX
 .Op Fl C Ar directory
 .Op Fl D Ar variable
 .Op Fl d Ar flags
@@ -329,6 +329,10 @@
 up-to-date and 1, otherwise.
 .It Fl r
 Do not use the built-in rules specified in the system makefile.
+.It Fl S
+Stop processing if an error is encountered.
+This is the default behavior and the opposite of
+.Fl k .
 .It Fl s
 Do not echo any commands as they are executed.
 Equivalent to specifying
diff -r fc498d2f996a -r c031fb80df66 usr.bin/make/unit-tests/opt.exp
--- a/usr.bin/make/unit-tests/opt.exp   Sat Nov 14 22:17:29 2020 +0000
+++ b/usr.bin/make/unit-tests/opt.exp   Sat Nov 14 22:19:13 2020 +0000
@@ -1,5 +1,5 @@
 make -:
-usage: make [-BeikNnqrstWwX]
+usage: make [-BeikNnqrSstWwX]
             [-C directory] [-D variable] [-d flags] [-f makefile]
             [-I directory] [-J private] [-j max_jobs] [-m directory] [-T file]
             [-V variable] [-v variable] [variable=value] [target ...]
@@ -10,7 +10,7 @@
 `/dev/null' is up to date.
 
 make -?
-usage: make [-BeikNnqrstWwX]
+usage: make [-BeikNnqrSstWwX]
             [-C directory] [-D variable] [-d flags] [-f makefile]
             [-I directory] [-J private] [-j max_jobs] [-m directory] [-T file]
             [-V variable] [-v variable] [variable=value] [target ...]