From owner-svn-src-stable@freebsd.org Thu Mar 16 01:36:10 2017 Return-Path: Delivered-To: svn-src-stable@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 6F363D0DE7D; Thu, 16 Mar 2017 01:36:10 +0000 (UTC) (envelope-from ngie@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 49BFC1752; Thu, 16 Mar 2017 01:36:10 +0000 (UTC) (envelope-from ngie@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id v2G1a9Ww058247; Thu, 16 Mar 2017 01:36:09 GMT (envelope-from ngie@FreeBSD.org) Received: (from ngie@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id v2G1a9JV058246; Thu, 16 Mar 2017 01:36:09 GMT (envelope-from ngie@FreeBSD.org) Message-Id: <201703160136.v2G1a9JV058246@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: ngie set sender to ngie@FreeBSD.org using -f From: Ngie Cooper Date: Thu, 16 Mar 2017 01:36:09 +0000 (UTC) To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-stable@freebsd.org, svn-src-stable-11@freebsd.org Subject: svn commit: r315342 - stable/11/share/mk X-SVN-Group: stable-11 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-src-stable@freebsd.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: SVN commit messages for all the -stable branches of the src tree List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 16 Mar 2017 01:36:10 -0000 Author: ngie Date: Thu Mar 16 01:36:09 2017 New Revision: 315342 URL: https://svnweb.freebsd.org/changeset/base/315342 Log: MFC r314869,r314871,r314872: r314869: Alphabetically sort variables The only content change is minor rewording around CLEANDIRS/CLEANFILES to accomodate sorting order. r314871: Fix LINKS example in bsd.prog.mk LINKS appends DESTDIR -- don't suggest double-append in example. r314872: Add bsd.man.mk references for MAN under bsd.lib.mk and bsd.prog.mk The latter set of manpages directly consume bsd.man.mk, so the bsd.man.mk behavior should be the source of truth for underlying behavior, whereas the other manpage fragment descriptions should document how they tweak the variable behavior, if at all (bsd.prog.mk does tweak the default value, as noted in its description) Modified: stable/11/share/mk/bsd.README Directory Properties: stable/11/ (props changed) Modified: stable/11/share/mk/bsd.README ============================================================================== --- stable/11/share/mk/bsd.README Thu Mar 16 01:32:56 2017 (r315341) +++ stable/11/share/mk/bsd.README Thu Mar 16 01:36:09 2017 (r315342) @@ -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,27 +305,30 @@ 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 /bin/test and /bin/[, use: - LINKS= ${DESTDIR}/bin/test ${DESTDIR}/bin/[ + LINKS= /bin/test /bin/[ -MAN Manual pages (should end in .1 - .9). If no MAN variable - is defined, "MAN=${PROG}.1" is assumed. +MAN Manual pages. If no MAN variable is defined, + "MAN=${PROG}.1" is assumed. See bsd.man.mk for more details. 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 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_