===================================================================
RCS file: /cvsrepo/anoncvs/cvs/src/share/mk/bsd.README,v
retrieving revision 1.22
retrieving revision 1.23
diff -u -r1.22 -r1.23
--- src/share/mk/bsd.README	2000/05/15 06:10:21	1.22
+++ src/share/mk/bsd.README	2001/04/03 23:00:08	1.23
@@ -1,4 +1,4 @@
-#	$OpenBSD: bsd.README,v 1.22 2000/05/15 06:10:21 niklas Exp $
+#	$OpenBSD: bsd.README,v 1.23 2001/04/03 23:00:08 espie Exp $
 #	$NetBSD: bsd.README,v 1.17 1996/04/13 02:08:08 thorpej Exp $
 #	@(#)bsd.README	5.1 (Berkeley) 5/11/90
 
@@ -54,6 +54,25 @@
 the command "make b" will echo "bar".  This is for compatibility with the
 way the V7 make behaved.
 
+To make things even more confusing, make uses lazy evaluation. All
+variables are expanded only when needed. Which means that, in
+
+	a=	foo
+
+	b: $(a)
+		echo $(.ALLSRC)
+		echo $(a)
+
+	foo:
+		touch foo
+
+   	a=	bar
+
+the command "make b" will echo "foo"; echo "bar".  The first $(a) means 
+"foo", because it's needed to generate the dependency rule when it's read, 
+but the second $(a) is only expanded when needed, at which point a contains
+bar.
+
 It's fairly difficult to make the BSD .mk files work when you're building
 multiple programs in a single directory.  It's a lot easier to split up the
 programs than to deal with the problem.  Most of the agony comes from making
@@ -140,6 +159,8 @@
 
 NONBINMODE	Mode for non-executable files. [444]
 
+DIRMODE		Mode for new directories. [755]
+
 MANDIR		Base path for manual installation. [/usr/share/man/cat]
 
 MANGRP		Manual group. [bin]
@@ -195,6 +216,8 @@
 process (default values are in brackets along with comments, if set by
 bsd.own.mk):
 
+AFS		Compile support for AFS.
+
 SKEY		Compile in support for S/key authentication. [yes, set
 		unconditionally]
 
@@ -204,6 +227,8 @@
 
 MANZ		Compress manual pages at installation time.
 
+MANPS		Define to have PostScript manual pages generated.
+
 SYS_INCLUDE	Copy or symlink kernel include files into /usr/include.
 		Possible values are "symlinks" or "copies" (which is
 		the same as the variable being unset).
@@ -235,6 +260,12 @@
 GLOBAL_AUTOCONF_CACHE
 		Set to the name of a file that all cached GNU autoconf
 		test results will be saved in.	Reduces redundant tests.
+		Be careful!  Redundant tests may not be redundant if you
+		are installing substantially updated gnu programs.
+
+UVM
+		Set to yes on machines that switched to the new unified
+		vm. Temporary, until everything supports uvm.
 
 bsd.own.mk is generally useful when building your own Makefiles so that
 they use the same default owners etc. as the rest of the tree.