Date: Tue, 7 Mar 2017 17:38:52 +0000 (UTC) From: Ngie Cooper <ngie@FreeBSD.org> To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Subject: svn commit: r314869 - head/share/mk Message-ID: <201703071738.v27Hcq3Y070554@repo.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: ngie Date: Tue Mar 7 17:38:52 2017 New Revision: 314869 URL: https://svnweb.freebsd.org/changeset/base/314869 Log: Alphabetically sort variables The only content change is minor rewording around CLEANDIRS/CLEANFILES to accomodate sorting order. MFC after: 1 week Sponsored by: Dell EMC Isilon Modified: head/share/mk/bsd.README Modified: head/share/mk/bsd.README ============================================================================== --- head/share/mk/bsd.README Tue Mar 7 17:12:22 2017 (r314868) +++ head/share/mk/bsd.README Tue Mar 7 17:38:52 2017 (r314869) @@ -180,19 +180,19 @@ It has three targets: It sets/uses the following variables: +MAN The manual pages to be installed (use a .1 - .9 suffix). + MANDIR Base path for manual installation. MANGRP Manual group. -MANOWN Manual owner. - MANMODE Manual mode. +MANOWN Manual owner. + MANSUBDIR Subdirectory under the manual page section, i.e. "/vax" or "/tahoe" for machine specific manual pages. -MAN The manual pages to be installed (use a .1 - .9 suffix). - MLINKS List of manual page links (using a .1 - .9 suffix). The linked-to file must come first, the linked file second, and there may be multiple pairs. The files are hard-linked. @@ -211,18 +211,18 @@ It sets/uses the following variables: BINGRP Binary group. -BINOWN Binary owner. - BINMODE Binary mode. +BINOWN Binary owner. + MANDIR Base path for manual installation. MANGRP Manual group. -MANOWN Manual owner. - MANMODE Manual mode. +MANOWN Manual owner. + This file is generally useful when building your own Makefiles so that they use the same default owners etc. as the rest of the tree. @@ -257,23 +257,43 @@ It has seven targets: It sets/uses the following variables: -AFLAGS Flags to the assembler when assembling .s files. - ACFLAGS Flags to the compiler when preprocessing and assembling .S files. -BINGRP Binary group. +AFLAGS Flags to the assembler when assembling .s files. -BINOWN Binary owner. +BINGRP Binary group. BINMODE Binary mode. -CLEANFILES Additional files to remove and -CLEANDIRS additional directories to remove during clean and cleandir - targets. "rm -f" and "rm -rf" used respectively. +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. + +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-profiled, + 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 profiled or 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 @@ -285,14 +305,14 @@ LDADD Additional loader objects. Usual LDADD=-lutil -lcompat -LIBADD Additional libraries. This is for base system libraries - and is only valid inside of the /usr/src tree. - Rather than use LDADD=-lname use LIBADD=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. +LIBADD Additional libraries. This is for base system libraries + and is only valid inside of the /usr/src tree. + Rather than use LDADD=-lname use LIBADD=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 @@ -306,6 +326,9 @@ MAN Manual pages (should end in .1 - .9 PROG The name of the program to build. If not supplied, nothing is built. +PROGNAME The name that the above program will be installed as, if + different from ${PROG}. + PROG_CXX If defined, the name of the program to build. Also causes <bsd.prog.mk> to link the program with the standard C++ library. PROG_CXX overrides the value @@ -344,33 +367,15 @@ PROGS_CXX PROG and PROGS_CXX in one Make - STRIP - WARNS -PROGNAME The name that the above program will be installed as, if - different from ${PROG}. +SCRIPTS A list of interpreter scripts [file.{sh,csh,pl,awk,...}]. + The installation is controlled by the SCRIPTSNAME, SCRIPTSOWN, + SCRIPTSGRP, SCRIPTSMODE, SCRIPTSDIR variables that can be + further specialized by SCRIPTS<VAR>_<script>. SRCS List of source files to build the program. If SRCS is not defined, it's assumed to be ${PROG}.c or, if PROG_CXX is defined, ${PROG_CXX}.cc. -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-profiled, - 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 profiled or 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. - STRIP The flag passed to the install program to cause the binary to be stripped. This is to be used when building your own install script so that the entire system can be made @@ -380,11 +385,6 @@ SUBDIR A list of subdirectories that sh Each of the targets will execute the same target in the subdirectories. -SCRIPTS A list of interpreter scripts [file.{sh,csh,pl,awk,...}]. - The installation is controlled by the SCRIPTSNAME, SCRIPTSOWN, - SCRIPTSGRP, SCRIPTSMODE, SCRIPTSDIR variables that can be - further specialized by SCRIPTS<VAR>_<script>. - The include file <bsd.prog.mk> includes the file named "../Makefile.inc" if it exists, as well as the include file <bsd.man.mk>. @@ -503,40 +503,37 @@ with the current needs of 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. -LIB_CXX The name of the library to build. It also causes - <bsd.lib.mk> to link the library with the - standard C++ library. LIB_CXX overrides the value - of LIB if LIB is also set. 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. + Rather than use LDADD=-lname use LIBADD=name. LIBDIR Target directory for libraries. -LINTLIBDIR Target directory for lint libraries. - LIBGRP Library group. +LIBMODE Library mode. + LIBOWN Library owner. -LIBMODE Library mode. +LIBRARIES_ONLY Do not build or install files other than the library. -LDADD Additional loader objects. +LIB_CXX The name of the library to build. It also causes + <bsd.lib.mk> to link the library with the + standard C++ library. LIB_CXX overrides the value + of LIB if LIB is also set. 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. - Rather than use LDADD=-lname use LIBADD=name. +LINTLIBDIR Target directory for lint libraries. MAN The manual pages to be installed (use a .1 - .9 suffix). -SRCS List of source files to build the library. Suffix types - .s, .c, and .f are supported. Note, .s files are preferred - to .c files of the same name. (This is not the default for - versions of make.) - SHLIB Like LIB but only builds a shared library. SHLIB_CXX Like LIB_CXX but only builds a shared library. @@ -545,7 +542,10 @@ SHLIB_LDSCRIPT Template file to generate Unless used, a simple symlink is created to the real shared object. -LIBRARIES_ONLY Do not build or install files other than the library. +SRCS List of source files to build the library. Suffix types + .s, .c, and .f are supported. Note, .s files are preferred + to .c files of the same name. (This is not the default for + versions of make.) The include file <bsd.lib.mk> includes the file named "../Makefile.inc" if it exists, as well as the include file <bsd.man.mk>. @@ -596,15 +596,11 @@ It has seven targets: It sets/uses the following variables, among many others: -TESTSBASE Installation prefix for tests. Defaults to /usr/tests +ATF_TESTS_C The names of the ATF C test programs to build. -TESTSDIR Path to the installed tests. Must be a subdirectory of - TESTSBASE and the subpath should match the relative - location of the tests within the src tree. +ATF_TESTS_CXX The names of the ATF C++ test programs to build. - The value of TESTSDIR defaults to - ${TESTSBASE}/${RELDIR:H} , e.g. /usr/tests/bin/ls when - included from bin/ls/tests . +ATF_TESTS_SH The names of the ATF sh test programs to build. CHECKDIR The directory that 'make check' executes tests from. @@ -621,11 +617,12 @@ LOCALBASE The --prefix for the kyua pack The value of LOCALBASE defaults to /usr/local . -ATF_TESTS_C The names of the ATF C test programs to build. - -ATF_TESTS_CXX The names of the ATF C++ test programs to build. - -ATF_TESTS_SH The names of the ATF sh test programs to build. +NOT_FOR_TEST_SUITE + If defined, none of the built test programs get + installed under /usr/tests/ and no Kyuafile is + automatically generated. Should not be used within the + FreeBSD source tree but is provided for the benefit of + third-parties. PLAIN_TESTS_C The names of the plain (legacy) programs to build. @@ -652,18 +649,21 @@ TAP_TESTS_PERL The names of the TAP-comp TAP_TESTS_SH The names of the TAP-compliant sh test programs to build. +TESTSBASE Installation prefix for tests. Defaults to /usr/tests + +TESTSDIR Path to the installed tests. Must be a subdirectory of + TESTSBASE and the subpath should match the relative + location of the tests within the src tree. + + The value of TESTSDIR defaults to + ${TESTSBASE}/${RELDIR:H} , e.g. /usr/tests/bin/ls when + included from bin/ls/tests . + TESTS_SUBDIRS List of subdirectories containing tests into which to recurse. Differs from SUBDIR in that these directories get registered into the automatically-generated Kyuafile (if any). -NOT_FOR_TEST_SUITE - If defined, none of the built test programs get - installed under /usr/tests/ and no Kyuafile is - automatically generated. Should not be used within the - FreeBSD source tree but is provided for the benefit of - third-parties. - The actual building of the test programs is performed by <bsd.prog.mk>. Please see the documentation above for this other file for additional details on the behavior of <bsd.test.mk>.
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201703071738.v27Hcq3Y070554>