From owner-svn-doc-head@FreeBSD.ORG Thu Apr 9 15:06:14 2015 Return-Path: Delivered-To: svn-doc-head@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 0FA58113; Thu, 9 Apr 2015 15:06:14 +0000 (UTC) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::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 EDFC46C5; Thu, 9 Apr 2015 15:06:13 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.9/8.14.9) with ESMTP id t39F6Ddk055236; Thu, 9 Apr 2015 15:06:13 GMT (envelope-from mat@FreeBSD.org) Received: (from mat@localhost) by svn.freebsd.org (8.14.9/8.14.9/Submit) id t39F6DpA055235; Thu, 9 Apr 2015 15:06:13 GMT (envelope-from mat@FreeBSD.org) Message-Id: <201504091506.t39F6DpA055235@svn.freebsd.org> X-Authentication-Warning: svn.freebsd.org: mat set sender to mat@FreeBSD.org using -f From: Mathieu Arnold Date: Thu, 9 Apr 2015 15:06:13 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r46509 - head/en_US.ISO8859-1/books/porters-handbook/makefiles X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.18-1 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 09 Apr 2015 15:06:14 -0000 Author: mat Date: Thu Apr 9 15:06:13 2015 New Revision: 46509 URL: https://svnweb.freebsd.org/changeset/doc/46509 Log: Some minor fixes to the makefiles chapter. Differential Revision: https://reviews.freebsd.org/D2257 Approved by: wblock (mentor) Sponsored by: Absolight Modified: head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml Modified: head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml Thu Apr 9 12:07:27 2015 (r46508) +++ head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml Thu Apr 9 15:06:13 2015 (r46509) @@ -3539,7 +3539,7 @@ MASTERDIR= ${.CURDIR}/../xdvi300 If the port anchors its man tree somewhere other than PREFIX, use MANDIRS to specify those directories. Note - that the files corresponding to manual pages must be be placed in + that the files corresponding to manual pages must be placed in pkg-plist along with the rest of the files. The purpose of MANDIRS is to enable automatic compression of manual pages, therefore the file names are @@ -4382,6 +4382,14 @@ LIB_DEPENDS+= liba.so:${PORTSDIR}/devel/ + + Some variables are not in this list, in particular + PKGNAMEPREFIX and + PKGNAMESUFFIX. This is intentional. A + port must not change its name when + its option set changes. + + Some of these variables, at least ALL_TARGET and @@ -4481,7 +4489,7 @@ PORTVERSION= 1.0 directory, foo-1.0, and the rest of the files are located under that directory. - A number of variables can overriden if that is + A number of variables can be overridden if that is not the case. @@ -4591,12 +4599,14 @@ PORTVERSION= 1.0 targets. Set ownership directly in pkg-plist with the corresponding entries, such as - @owner owner and + @(owner,group,), + @owner owner, and @group group. - These operators work until being overridden, or until the end + These operators work until overridden, or until the end of pkg-plist, so do not forget to reset them after they are no longer needed. The default ownership - is root:wheel. + is root:wheel. See for more information. @@ -4634,31 +4644,31 @@ PORTVERSION= 1.0 - These are the install - command with all the appropriate flags. + These variables are set to the &man.install.1; command + with the appropriate flags for each situation. - + Do not use INSTALL_LIB to install - static libraries, because stripping them render them + static libraries, because stripping them renders them useless. Use INSTALL_DATA instead. - + Stripping Binaries and Shared Libraries Installed binaries should be stripped. Do not strip - binaries manually unless forced to. The - INSTALL_PROGRAM macro will install and - strip a binary at the same time (see the next section). The + binaries manually unless absolutely required. The + INSTALL_PROGRAM macro installs and + strips a binary at the same time. The INSTALL_LIB macro does the same thing to shared libraries. When a file must be stripped, but neither INSTALL_PROGRAM nor INSTALL_LIB macros are desirable, - ${STRIP_CMD} will strip the program or + ${STRIP_CMD} strips the program or shared library. This is typically done within the post-install target. For example: