[src/trunk]: src/usr.sbin/postinstall postinstall: improve -s usage

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

details:   https://anonhg.NetBSD.org/src/rev/9d9c801ed011
branches:  trunk
changeset: 359534:9d9c801ed011
user:      lukem <lukem%NetBSD.org@localhost>
date:      Sat Jan 08 23:30:41 2022 +0000

description:
postinstall: improve -s usage

Reword -s SRC_ARG to be a bit clearer as to the variations, and sync
more with postinstall(8).

diffstat:

 usr.sbin/postinstall/postinstall.in |  20 +++++++++++---------
 1 files changed, 11 insertions(+), 9 deletions(-)

diffs (44 lines):

diff -r f692ae9d7136 -r 9d9c801ed011 usr.sbin/postinstall/postinstall.in
--- a/usr.sbin/postinstall/postinstall.in       Sat Jan 08 23:07:17 2022 +0000
+++ b/usr.sbin/postinstall/postinstall.in       Sat Jan 08 23:30:41 2022 +0000
@@ -1,6 +1,6 @@
 #!/bin/sh
 #
-# $NetBSD: postinstall.in,v 1.49 2022/01/08 23:07:17 lukem Exp $
+# $NetBSD: postinstall.in,v 1.50 2022/01/08 23:30:41 lukem Exp $
 #
 # Copyright (c) 2002-2022 The NetBSD Foundation, Inc.
 # All rights reserved.
@@ -2541,7 +2541,7 @@
 help()
 {
        cat << _USAGE_
-Usage: ${PROGNAME} [-a ARCH] [-d DEST_DIR] [-m MACHINE] [-s SRC_DIR] [-x XSRC_DIR] OPERATION ...
+Usage: ${PROGNAME} [-a ARCH] [-d DEST_DIR] [-m MACHINE] [-s SRC_ARG] [-x XSRC_DIR] OPERATION ...
        ${PROGNAME} -?
 
        Perform post-installation checks and/or fixes on a system's
@@ -2553,14 +2553,16 @@
        -a ARCH         Set \$MACHINE_ARCH to ARCH.     [${MACHINE_ARCH}]
        -d DEST_DIR     Destination directory to check. [${DEST_DIR:-/}]
        -m MACHINE      Set \$MACHINE to MACHINE.       [${MACHINE}]
-       -s SRC_DIR      Location of the source files.  This may be any of
+       -s SRC_ARG      Location of the source files.  This may be any of
                        the following:
-                       * A directory that contains a NetBSD source tree;
-                       * A distribution set file such as "etc.tgz" or
-                         "xetc.tgz".  Pass multiple -s options to specify
-                         multiple such files;
-                       * A temporary directory in which one or both of
-                         "etc.tgz" and "xetc.tgz" have been extracted.
+                       -s SRC_DIR      A directory that contains a NetBSD
+                                       source tree.
+                       -s TGZ_DIR      A directory in which one or both of
+                                       "etc.tgz" and "xetc.tgz" have been
+                                       extracted.
+                       -s TGZ_FILE     A distribution set file such as
+                                       "etc.tgz" or "xetc.tgz".
+                                       May be specified multipled times.
                                                        [${SRC_DIR:-/usr/src}]
        -x XSRC_DIR     Location of the X11 source files.  This must be
                        a directory that contains a NetBSD xsrc tree.