summaryrefslogtreecommitdiff
path: root/share
diff options
context:
space:
mode:
authorIngo Schwarze <schwarze@cvs.openbsd.org>2017-07-11 23:38:54 +0000
committerIngo Schwarze <schwarze@cvs.openbsd.org>2017-07-11 23:38:54 +0000
commit305d935e0fdc51d584ed770407b8848dc9dd459c (patch)
tree0fbb78e12265e248f7e8f0c72fbd186e8d6add54 /share
parent4f0325874809f86543c7e9e01e8a29aa41731914 (diff)
explain the limitations of PROGS; joint work with espie@
Diffstat (limited to 'share')
-rw-r--r--share/mk/bsd.README12
1 files changed, 8 insertions, 4 deletions
diff --git a/share/mk/bsd.README b/share/mk/bsd.README
index f51370948e3..0d2e070ec93 100644
--- a/share/mk/bsd.README
+++ b/share/mk/bsd.README
@@ -1,4 +1,4 @@
-# $OpenBSD: bsd.README,v 1.72 2017/07/11 22:17:28 schwarze Exp $
+# $OpenBSD: bsd.README,v 1.73 2017/07/11 23:38:53 schwarze Exp $
# $NetBSD: bsd.README,v 1.17 1996/04/13 02:08:08 thorpej Exp $
# @(#)bsd.README 5.1 (Berkeley) 5/11/90
@@ -412,9 +412,13 @@ grammar.c grammar.h: grammar.y
${YACC.Y} -o grammar.c grammar.y
-<bsd.prog.mk> may be used to build several programs in a single directory.
-Just define the list of programs as PROGS instead of using PROG.
-For instance PROGS = foo bar
+<bsd.prog.mk> provides a limited capability to build several
+programs in a single directory by defining the list of programs
+as PROGS instead of using PROG, for instance: PROGS = foo bar
+
+This only works if all programs in the directory use the same
+compiler and linker flags. Also, the programs cannot use source
+files with the same file name but different content.
Each program of the list, for instance foo, will use SRCS_foo instead
of SRCS to find its sources. SRCS_foo still defaults to foo.c, and