document new depends somewhat.

I asked jmc, told me to go ahead and he'd review it when he can.

diff --git a/share/mk/bsd.README b/share/mk/bsd.README
index 434fa34..b01d712 100644 (file)
--- a/share/mk/bsd.README
+++ b/share/mk/bsd.README
@@ -1,4 +1,4 @@
-#      $OpenBSD: bsd.README,v 1.65 2016/07/04 18:01:44 guenther Exp $
+#      $OpenBSD: bsd.README,v 1.66 2017/07/02 17:03:45 espie Exp $
 #      $NetBSD: bsd.README,v 1.17 1996/04/13 02:08:08 thorpej Exp $
 #      @(#)bsd.README  5.1 (Berkeley) 5/11/90
 
@@ -80,9 +80,8 @@ of make.  So, don't get mad at us, figure out a better way to handle multiple
 architectures so we can quit using the symbolic link stuff.  (Imake doesn't
 count.)
 
-The file .depend in the source directory is expected to contain dependencies
-for the source files.  This file is read automatically by make after reading
-the Makefile.
+Dependencies are handled using the compiler's -M* options, resulting in
+lots of .d files. These are manually included through bsd.dep.mk.
 
 The variable DESTDIR works as before.  It's not set anywhere but will change
 the tree where the file gets installed.
@@ -264,8 +263,9 @@ It has seven targets:
                remove all of the files removed by the target clean, as
                well as .depend, tags, and any manual pages.
        depend:
-               make the dependencies for the source files, and store
-               them in the file .depend.
+               Misnomer as dependencies are built on-the-fly during make all.
+               Still used by a few directories needing some configuration
+               before make all.
        includes:
                install any header files.
        install:
@@ -285,6 +285,12 @@ BINOWN             Binary owner.
 
 BINMODE                Binary mode.
 
+BUILDFIRST     Stuff that needs to be built before anything else, in
+               terms of dependencies.
+
+BUILDLATER     Stuff that comes later (usually don't touch, defined correctly
+               by <bsd.prog.mk> and <bsd.lib.mk>)
+
 CLEANFILES     Additional files to remove for the clean and cleandir targets.
 
 COPTS          Additional flags to the compiler when creating C objects.
@@ -412,6 +418,9 @@ consistent with the current needs of the BSD tree.
 
 It sets/uses the following variables:
 
+BUILDFIRST/BUILDLATER
+               See <bsd.prog.mk>
+
 LIB            The name of the library to build.
 
 LIBDIR         Target directory for libraries.