summaryrefslogtreecommitdiff
path: root/mk/buildlink2/NOTES
diff options
context:
space:
mode:
Diffstat (limited to 'mk/buildlink2/NOTES')
-rw-r--r--mk/buildlink2/NOTES36
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