[pkgsrc/trunk]: pkgsrc/regress/tools-platform regress/tools-platform: documen...

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

details:   https://anonhg.NetBSD.org/pkgsrc/rev/31419af03d8c
branches:  trunk
changeset: 430665:31419af03d8c
user:      rillig <rillig%pkgsrc.org@localhost>
date:      Sun May 03 07:38:50 2020 +0000

description:
regress/tools-platform: document which shell pkgsrc uses

diffstat:

 regress/tools-platform/sh.test |  17 ++++++++++++-----
 1 files changed, 12 insertions(+), 5 deletions(-)

diffs (28 lines):

diff -r 0ab5534869ff -r 31419af03d8c regress/tools-platform/sh.test
--- a/regress/tools-platform/sh.test    Sun May 03 07:07:03 2020 +0000
+++ b/regress/tools-platform/sh.test    Sun May 03 07:38:50 2020 +0000
@@ -1,12 +1,19 @@
 #! /bin/sh
-# $NetBSD: sh.test,v 1.2 2020/05/02 07:24:32 rillig Exp $
+# $NetBSD: sh.test,v 1.3 2020/05/03 07:38:50 rillig Exp $
 #
 # Tests for the shell that is available as ${SH} in Makefiles.
 #
-# Having a feature tested in this file does not mean it is available in
-# Makefiles since devel/bmake may use a completely different shell for
-# running its commands.  For example on SunOS, devel/bmake typically
-# uses /usr/xpg4/bin/sh while TOOLS_PLATFORM.sh is /bin/ksh.
+# On platforms where /bin/sh is not good enough, pkgsrc may use
+# different shells, depending on the exact situation.
+#
+# TOOLS_PLATFORM.sh (which ends up in SH as well) is used for running
+# shell programs from mk/ and other programs that typically start with
+# a #! line.
+#
+# The shell commands that are written in the targets of Makefiles (such
+# as do-build, pre-configure) are run with a possibly different shell,
+# see devel/bmake/Makefile.  This shell is tested by regress/make-shell,
+# which also uses this code.
 
 set -eu