The branch main has been updated by brooks:
URL:
https://cgit.FreeBSD.org/src/commit/?id=fbfc85d9e81f751c52f3ded445d4ae03b8307667
commit fbfc85d9e81f751c52f3ded445d4ae03b8307667
Author: Brooks Davis <bro...@freebsd.org>
AuthorDate: 2025-05-23 23:34:26 +0000
Commit: Brooks Davis <bro...@freebsd.org>
CommitDate: 2025-05-23 23:37:50 +0000
share/mk: make *ADD and *FLAGS descriptions common
Move ACFLAGS, AFLAGS, CFLAGS, CXXFLAGS, DPADD, LDADD, LDFLAGS, and
LIBADD descriptions into the common section since they aren't limited
to bsd.progs.mk. Mostly just relocated, but updated the DPADD text to
reflect its relocation.
Reviewed by: jhb
Sponsored by: DARPA, AFRL
Differential Revision: https://reviews.freebsd.org/D50479
---
share/mk/bsd.README | 114 +++++++++++++++++++++++++---------------------------
1 file changed, 54 insertions(+), 60 deletions(-)
diff --git a/share/mk/bsd.README b/share/mk/bsd.README
index 6bab0effbcf4..03cb996f0f67 100644
--- a/share/mk/bsd.README
+++ b/share/mk/bsd.README
@@ -120,14 +120,20 @@ stack smashing protection and without sanitizer
instrumentation.
The following variables are common:
-AFLAGS.${SRC}
- Flags dependent on source file name.
-AFLAGS.${.TARGET:T}
- Flags dependent on output file name.
+ACFLAGS Flags to the compiler when preprocessing and
+ assembling .S files.
ACFLAGS.${SRC}
Flags dependent on source file name.
ACFLAGS.${.TARGET:T}
Flags dependent on output file name.
+
+AFLAGS Flags to the assembler when assembling .s files.
+AFLAGS.${SRC}
+ Flags dependent on source file name.
+AFLAGS.${.TARGET:T}
+ Flags dependent on output file name.
+
+CFLAGS Flags to the compiler when creating C objects.
CFLAGS.${SRC}
Flags dependent on source file name.
CFLAGS.${.TARGET:T}
@@ -139,6 +145,7 @@ CFLAGS.${MACHINE_ARCH}
CFLAGS_NO_SIMD Add this to CFLAGS for programs that don't want any SIMD
instructions generated. It is setup in bsd.cpu.mk to an
appropriate value for the compiler and target.
+
CXXFLAGS.${COMPILER_TYPE}
Flags dependent on compiler added to CXXFLAGS.
CXXFLAGS.${MACHINE_ARCH}
@@ -147,6 +154,49 @@ CXXFLAGS.${SRC}
Flags dependent on source file name.
CXXFLAGS.${.TARGET:T}
Flags dependent on output file name.
+
+DPADD Additional dependencies. Usually used for libraries.
+ For example, to depend on the compatibility and utility
+ libraries use:
+
+ DPADD=${LIBCOMPAT} ${LIBUTIL}
+
+ There is a predefined identifier for each (non-shared)
+ library and object. Library file names are
+ transformed to identifiers by removing the extension and
+ converting to upper case.
+
+ There are no special identifiers for shared libraries
+ or objects. The identifiers for the standard
+ libraries are used in DPADD. This works correctly iff
+ all the libraries are built at the same time.
+ Unfortunately, it causes unnecessary relinks to shared
+ libraries when only the static libraries have changed.
+ Dependencies on shared libraries should be only on the
+ library version numbers.
+
+LDADD Additional loader objects. Usually used to add libraries.
+ For example, to load with the compatibility and utility
+ libraries, use:
+
+ LDADD=-lutil -lcompat
+
+LDADD.${.TARGET:T}
+ Loader objects dependent on output file name.
+
+LDFLAGS Additional loader flags. Passed to the loader via CC,
+ since that's used to link programs as well, so loader
+ specific flags need to be prefixed with -Wl, to work.
+LDFLAGS.${.TARGET:T}
+ Flags dependent on output file name.
+
+LIBADD Additional libraries. This is for base system libraries
+ and is only valid inside of the FreeBSD tree.
+ Use LIBADD=name instead of LDADD=-lname.
+
+LIBADD.${.TARGET:T}
+ Libraries dependent on output file name.
+
COMPILER_FEATURES
A list of features that the compiler supports. Zero or
more of:
@@ -281,19 +331,12 @@ It has seven targets:
It sets/uses the following variables:
-ACFLAGS Flags to the compiler when preprocessing and
- assembling .S files.
-
-AFLAGS Flags to the assembler when assembling .s files.
-
BINGRP Binary group.
BINMODE Binary mode.
BINOWN Binary owner.
-CFLAGS Flags to the compiler when creating C objects.
-
CLEANDIRS Additional files (CLEANFILES) and directories (CLEANDIRS) to
CLEANFILES remove during clean and cleandir targets. "rm -rf" and
"rm -f" are used, respectively.
@@ -310,54 +353,11 @@ DIRS A list of variables referring to
directories. For example:
will be created before the files are installed and the
dependencies will be set correctly.
-DPADD Additional dependencies for the program. Usually used for
- libraries. For example, to depend on the compatibility and
- utility libraries use:
-
- DPADD=${LIBCOMPAT} ${LIBUTIL}
-
- There is a predefined identifier for each (non-shared
- library and object. Library file names are
- transformed to identifiers by removing the extension and
- converting to upper case.
-
- There are no special identifiers for shared libraries
- or objects. The identifiers for the standard
- libraries are used in DPADD. This works correctly iff
- all the libraries are built at the same time.
- Unfortunately, it causes unnecessary relinks to shared
- libraries when only the static libraries have changed.
- Dependencies on shared libraries should be only on the
- library version numbers.
-
FILES A list of non-executable files.
The installation is controlled by the FILESNAME, FILESOWN,
FILESGRP, FILESMODE, FILESDIR variables that can be
further specialized by FILES<VAR>_<file>.
-LDADD Additional loader objects. Usually used for libraries.
- For example, to load with the compatibility and utility
- libraries, use:
-
- LDADD=-lutil -lcompat
-
-LDADD.${.TARGET:T}
- Loader objects dependent on output file name.
-
-LDFLAGS Additional loader flags. Passed to the loader via CC,
- since that's used to link programs as well, so loader
- specific flags need to be prefixed with -Wl, to work.
-
-LDFLAGS.${.TARGET:T}
- Flags dependent on output file name.
-
-LIBADD Additional libraries. This is for base system libraries
- and is only valid inside of the /usr/src tree.
- Use LIBADD=name instead of LDADD=-lname.
-
-LIBADD.${.TARGET:T}
- Libraries dependent on output file name.
-
LINKS The list of binary links; should be full pathnames, the
linked-to file coming first, followed by the linked
file. The files are hard-linked. For example, to link
@@ -568,16 +568,10 @@ the BSD tree.
It sets/uses the following variables:
-LDADD Additional loader objects.
-
LIB The name of the library to build. Both a shared and static
library will be built. NO_PIC can be set to only build a
static library.
-LIBADD Additional libraries. This is for base system libraries
- and is only valid inside of the /usr/src tree.
- Use LIBADD=name instead of LDADD=-lname.
-
LIBDIR Target directory for libraries.
LIBGRP Library group.
