[src/trunk]: src/share/man/man8 rc(8): more foo.sh clarification

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

details:   https://anonhg.NetBSD.org/src/rev/1042a96ddc42
branches:  trunk
changeset: 827110:1042a96ddc42
user:      lukem <lukem%NetBSD.org@localhost>
date:      Sat Oct 14 21:21:51 2017 +0000

description:
rc(8): more foo.sh clarification

- Use "inline.sh" instead of "foo.sh".
- Clarify that "inline.sh" scripts will terminate the boot if
  the script causes trhe current shell process to terminate.
- Use "service" instead of "bar.
- Use "sub-shell" instead of "subshell".

Inspired by feedback from kre@

diffstat:

 share/man/man8/rc.8 |  18 +++++++++---------
 1 files changed, 9 insertions(+), 9 deletions(-)

diffs (62 lines):

diff -r ff9d25392369 -r 1042a96ddc42 share/man/man8/rc.8
--- a/share/man/man8/rc.8       Sat Oct 14 19:16:26 2017 +0000
+++ b/share/man/man8/rc.8       Sat Oct 14 21:21:51 2017 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: rc.8,v 1.38 2017/10/11 23:42:33 lukem Exp $
+.\"    $NetBSD: rc.8,v 1.39 2017/10/14 21:21:51 lukem Exp $
 .\"
 .\" Copyright (c) 2000-2017 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -27,7 +27,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd October 12, 2017
+.Dd October 15, 2017
 .Dt RC 8
 .Os
 .Sh NAME
@@ -120,7 +120,7 @@
 .Dv $1
 to
 .Sq start ,
-and sources the script in a subshell.
+and sources the script in a sub-shell.
 If the script has a
 .Sq .sh
 suffix then it is sourced directly into the current shell.
@@ -175,7 +175,7 @@
 .Dv $1
 to
 .Sq stop ,
-and sources the script in a subshell.
+and sources the script in a sub-shell.
 If the script has a
 .Sq .sh
 suffix then it is sourced directly into the current shell.
@@ -231,20 +231,20 @@
 and
 .Pa sendmail ) .
 .El
-.It Pa foo.sh
-Scripts that are to be sourced into the current shell rather than a subshell
+.It Pa inline.sh
+Scripts that are sourced into the current shell rather than a sub-shell
 have a
 .Sq Pa .sh
 suffix.
 Extreme care must be taken in using this, as the startup sequence will
-terminate if the script terminates.
+terminate if the script causes the current shell process to terminate.
 .Pa /etc/rc.d/bootconf.sh
 uses this behaviour to allow the user to select a different
 configuration (including
 .Pa /etc/rc.conf )
 early in the boot.
-.It Pa bar
-Scripts that are sourced in a subshell.
+.It Pa service
+Scripts that are sourced in a sub-shell.
 The boot does not stop if such a script terminates with a non-zero status,
 but a script can stop the boot if necessary by invoking the
 .Fn stop_boot