[src/trunk]: src/usr.bin/make/unit-tests tests/make: document a few tests

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

details:   https://anonhg.NetBSD.org/src/rev/7f75396cc1f1
branches:  trunk
changeset: 376503:7f75396cc1f1
user:      rillig <rillig%NetBSD.org@localhost>
date:      Wed Jun 21 07:30:50 2023 +0000

description:
tests/make: document a few tests

diffstat:

 usr.bin/make/unit-tests/var-op-append.mk          |  19 ++++++++++++++++---
 usr.bin/make/unit-tests/varname-dot-parsedir.exp  |   6 +++---
 usr.bin/make/unit-tests/varname-dot-parsedir.mk   |  10 +++++++++-
 usr.bin/make/unit-tests/varname-dot-parsefile.exp |   6 +++---
 usr.bin/make/unit-tests/varname-dot-parsefile.mk  |  10 +++++++++-
 5 files changed, 40 insertions(+), 11 deletions(-)

diffs (91 lines):

diff -r d2715eedc7ee -r 7f75396cc1f1 usr.bin/make/unit-tests/var-op-append.mk
--- a/usr.bin/make/unit-tests/var-op-append.mk  Wed Jun 21 04:20:20 2023 +0000
+++ b/usr.bin/make/unit-tests/var-op-append.mk  Wed Jun 21 07:30:50 2023 +0000
@@ -1,7 +1,20 @@
-# $NetBSD: var-op-append.mk,v 1.9 2021/04/04 10:13:09 rillig Exp $
+# $NetBSD: var-op-append.mk,v 1.10 2023/06/21 07:30:50 rillig Exp $
+#
+# Tests for the '+=' variable assignment operator, which appends to a
+# variable, creating it if necessary.
+#
+# See also
+#      var-op.mk
 #
-# Tests for the += variable assignment operator, which appends to a variable,
-# creating it if necessary.
+# Standards
+#      The '+=' variable assignment operator is planned to be added in
+#      POSIX.1-202x.
+#
+#      This implementation does not support the immediate-expansion macros
+#      specified in POSIX.1-202x.  All variables are delayed-expansion.
+#
+# History
+#      The '+=' variable assignment operator was added before 1993-03-21.
 
 # Appending to an undefined variable is possible.
 # The variable is created, and no extra space is added before the value.
diff -r d2715eedc7ee -r 7f75396cc1f1 usr.bin/make/unit-tests/varname-dot-parsedir.exp
--- a/usr.bin/make/unit-tests/varname-dot-parsedir.exp  Wed Jun 21 04:20:20 2023 +0000
+++ b/usr.bin/make/unit-tests/varname-dot-parsedir.exp  Wed Jun 21 07:30:50 2023 +0000
@@ -1,5 +1,5 @@
-make: "varname-dot-parsedir.mk" line 29: At this point, .PARSEDIR is undefined.
-make: "<normalized>" line 35: The location can be faked in some cases.
-make: "varname-dot-parsedir.mk" line 40: The location is no longer fake.
+make: "varname-dot-parsedir.mk" line 37: At this point, .PARSEDIR is undefined.
+make: "<normalized>" line 43: The location can be faked in some cases.
+make: "varname-dot-parsedir.mk" line 48: The location is no longer fake.
 At run time, .PARSEDIR is undefined.
 exit status 0
diff -r d2715eedc7ee -r 7f75396cc1f1 usr.bin/make/unit-tests/varname-dot-parsedir.mk
--- a/usr.bin/make/unit-tests/varname-dot-parsedir.mk   Wed Jun 21 04:20:20 2023 +0000
+++ b/usr.bin/make/unit-tests/varname-dot-parsedir.mk   Wed Jun 21 07:30:50 2023 +0000
@@ -1,7 +1,15 @@
-# $NetBSD: varname-dot-parsedir.mk,v 1.7 2023/06/01 20:56:35 rillig Exp $
+# $NetBSD: varname-dot-parsedir.mk,v 1.8 2023/06/21 07:30:50 rillig Exp $
 #
 # Tests for the special .PARSEDIR variable, which contains the directory part
 # of the file that is currently parsed.
+#
+# See also
+#      varname-dot-includedfromdir.mk
+#      varname-dot-includedfromfile.mk
+#      varname-dot-parsefile.mk
+#
+# History
+#      .PARSEDIR and .PARSEFILE were added on 1999-08-09.
 
 # The .PARSEDIR may be absolute or relative, therefore there is not much that
 # can be tested here.
diff -r d2715eedc7ee -r 7f75396cc1f1 usr.bin/make/unit-tests/varname-dot-parsefile.exp
--- a/usr.bin/make/unit-tests/varname-dot-parsefile.exp Wed Jun 21 04:20:20 2023 +0000
+++ b/usr.bin/make/unit-tests/varname-dot-parsefile.exp Wed Jun 21 07:30:50 2023 +0000
@@ -1,5 +1,5 @@
-make: "varname-dot-parsefile.mk" line 24: At this point, .PARSEFILE is undefined.
-make: "<normalized>" line 30: The location can be faked in some cases.
-make: "varname-dot-parsefile.mk" line 35: The location is no longer fake.
+make: "varname-dot-parsefile.mk" line 32: At this point, .PARSEFILE is undefined.
+make: "<normalized>" line 38: The location can be faked in some cases.
+make: "varname-dot-parsefile.mk" line 43: The location is no longer fake.
 At run time, .PARSEFILE is undefined.
 exit status 0
diff -r d2715eedc7ee -r 7f75396cc1f1 usr.bin/make/unit-tests/varname-dot-parsefile.mk
--- a/usr.bin/make/unit-tests/varname-dot-parsefile.mk  Wed Jun 21 04:20:20 2023 +0000
+++ b/usr.bin/make/unit-tests/varname-dot-parsefile.mk  Wed Jun 21 07:30:50 2023 +0000
@@ -1,7 +1,15 @@
-# $NetBSD: varname-dot-parsefile.mk,v 1.6 2023/06/01 20:56:35 rillig Exp $
+# $NetBSD: varname-dot-parsefile.mk,v 1.7 2023/06/21 07:30:50 rillig Exp $
 #
 # Tests for the special .PARSEFILE variable, which contains the basename part
 # of the file that is currently parsed.
+#
+# See also
+#      varname-dot-includedfromdir.mk
+#      varname-dot-includedfromfile.mk
+#      varname-dot-parsedir.mk
+#
+# History
+#      .PARSEDIR and .PARSEFILE were added on 1999-08-09.
 
 .if ${.PARSEFILE} != "varname-dot-parsefile.mk"
 .  error