The buildlink2 problems on non-NetBSD platform seem to be related to

correct manipulation of variables containing values with escaped
metacharacters by the shell.  The new code only does partial caching, which
doesn't cache "special" arguments that contain escaped metacharacters or
other oddly quoted values.  On certain platforms listed in _BLNK_CACHE_ALL
in bsd.buildlink2.mk, we do full caching, which has enormous speed benefits
since it avoids an extra sed invocation per "special" argument.

Known working platforms:

	MacOS X 10.1.5 (schmonz)
	MacOS X 10.2 (grant)
	NetBSD 1.6 [full caching] (jlam)
	OpenBSD (cjep)
	Solaris 8 (grant)
	Solaris 9 (salo)

1 files changed, 36 insertions, 0 deletions

diff --git a/mk/buildlink2/NOTES b/mk/buildlink2/NOTES
new file mode 100644
index 00000000000..06112108b44
--- /dev/null
+++ b/mk/buildlink2/NOTES
@@ -0,0 +1,36 @@
+$NetBSD: NOTES,v 1.1 2002/12/22 19:02:43 jlam Exp $
+
+ Caching
+ =======
+
+The caching problems seem to be related to correct manipulation of
+variables containing values with escaped metacharacters by the shell.  The
+current code only does partial caching, which doesn't cache "special"
+arguments that contain escaped metacharacters or other oddly quoted values.
+On certain platforms listed in _BLNK_CACHE_ALL in bsd.buildlink2.mk, we do
+full caching, which has enormous speed benefits since it avoids an extra
+sed invocation per "special" argument.
+
+The test process for buildlink2 consists of building and installing:
+
+	shells/tcsh	tests handling of specially-quoted arguments
+	devel/gettext	same as above, but uses libtool
+
+Full caching can be tested be adding ${OPSYS} to _BLNK_CACHE_ALL and
+performing the tests above.
+
+Known working platforms:
+
+	MacOS X 10.1.5 (schmonz)
+	MacOS X 10.2 (grant)
+	NetBSD 1.6 [full caching] (jlam)
+	OpenBSD (cjep)
+	Solaris 8 (grant)
+	Solaris 9 (salo)
+
+Unknown status:
+
+	IRIX
+	NetBSD 1.5.x
+	Solaris 7
+	Linux