===================================================================
RCS file: /cvsrepo/anoncvs/cvs/src/share/mk/bsd.README,v
retrieving revision 1.65
retrieving revision 1.66
diff -u -r1.65 -r1.66
--- src/share/mk/bsd.README	2016/07/04 18:01:44	1.65
+++ src/share/mk/bsd.README	2017/07/02 17:03:45	1.66
@@ -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 @@
 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 @@
 		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 @@
 
 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.
@@ -411,6 +417,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.