Minor clean-ups:

- document some more things (MANPS, make oddities)
- put all PHONY targets in bsd.own.mk, since it's included by everything
that uses it.
- remove them from bsd.lib.mk, since it includes bsd.own.mk.
- ... except for load/unload, which are only in bsd.lkm.mk.
- fix spell target, so that it actually depends on the generated file.

okay niklas@

1 files changed, 32 insertions, 1 deletions

diff --git a/share/mk/bsd.README b/share/mk/bsd.README
index 4a83f69ac41..13d2986f862 100644
--- a/share/mk/bsd.README
+++ b/share/mk/bsd.README
@@ -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 @@ variable assignment is the overriding one, i.e. if the Makefile has:
 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 @@ BINMODE		Binary mode. [555]
 
 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 @@ make configuration file to modify the behaviour of the system build
 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 @@ KERBEROS5	Compile in support for Kerberos 5 authentication.
 
 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 @@ PIPE		If set to "-pipe" gcc will be given the -pipe option
 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.