summaryrefslogtreecommitdiff
path: root/share
diff options
context:
space:
mode:
authorMarc Espie <espie@cvs.openbsd.org>2017-07-02 17:03:46 +0000
committerMarc Espie <espie@cvs.openbsd.org>2017-07-02 17:03:46 +0000
commita53d208b9c176236dc89f28d353238aee86369b4 (patch)
treebd397fdf1d409ba47634590a9f974b20dff540b0 /share
parent23737f2b4a46cae385a54a45f7aeeb05141d9d73 (diff)
document new depends somewhat.
I asked jmc, told me to go ahead and he'd review it when he can.
Diffstat (limited to 'share')
-rw-r--r--share/mk/bsd.README21
1 files 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 <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.