From 831839dcd9b7b543d6b76d4349fadb3b799d6ee4 Mon Sep 17 00:00:00 2001 From: espie Date: Sun, 2 Jul 2017 17:03:45 +0000 Subject: [PATCH] document new depends somewhat. I asked jmc, told me to go ahead and he'd review it when he can. --- share/mk/bsd.README | 21 +++++++++++++++------ 1 file changed, 15 insertions(+), 6 deletions(-) diff --git a/share/mk/bsd.README b/share/mk/bsd.README index 434fa34ad3a..b01d71217c5 100644 --- 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 and ) + 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 + LIB The name of the library to build. LIBDIR Target directory for libraries. -- 2.20.1