From owner-svn-doc-all@freebsd.org Fri Mar 11 13:58:42 2016 Return-Path: Delivered-To: svn-doc-all@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 B96E6ACC491; Fri, 11 Mar 2016 13:58:42 +0000 (UTC) (envelope-from mat@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 940E3614; Fri, 11 Mar 2016 13:58:42 +0000 (UTC) (envelope-from mat@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id u2BDwfN0030332; Fri, 11 Mar 2016 13:58:41 GMT (envelope-from mat@FreeBSD.org) Received: (from mat@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id u2BDwf5N030329; Fri, 11 Mar 2016 13:58:41 GMT (envelope-from mat@FreeBSD.org) Message-Id: <201603111358.u2BDwf5N030329@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: mat set sender to mat@FreeBSD.org using -f From: Mathieu Arnold Date: Fri, 11 Mar 2016 13:58:41 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r48372 - in head/en_US.ISO8859-1/books/porters-handbook: makefiles plist special X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 11 Mar 2016 13:58:42 -0000 Author: mat Date: Fri Mar 11 13:58:41 2016 New Revision: 48372 URL: https://svnweb.freebsd.org/changeset/doc/48372 Log: Always echo commands during the install phase. Sponsored by: Absolight Differential Revision: https://reviews.freebsd.org/D5581 Modified: head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml head/en_US.ISO8859-1/books/porters-handbook/plist/chapter.xml head/en_US.ISO8859-1/books/porters-handbook/special/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 Fri Mar 11 09:50:30 2016 (r48371) +++ head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml Fri Mar 11 13:58:41 2016 (r48372) @@ -5111,6 +5111,16 @@ PORTVERSION= 1.0 Installing Files + + The install phase is the most + important from the end-user's point of view as it is the one + adding files to his system. All the additional commands run + in the port's Makefile in all the + *-install targets should be + echo'ed. Do not silence them with + @ or .SILENT. + + <varname>INSTALL_<replaceable>*</replaceable></varname> Macros @@ -5303,6 +5313,12 @@ PORTVERSION= 1.0 ${MKDIR} ${STAGEDIR}${DOCSDIR} ${INSTALL_MAN} ${WRKSRC}/docs/xvdocs.ps ${STAGEDIR}${DOCSDIR} + On the other hand, if there is a DOCS option in the port, + install the documentation in a + post-install-DOCS-on target. These + targets are described in . + Here are some handy variables and how they are expanded by default when used in the Makefile: Modified: head/en_US.ISO8859-1/books/porters-handbook/plist/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/plist/chapter.xml Fri Mar 11 09:50:30 2016 (r48371) +++ head/en_US.ISO8859-1/books/porters-handbook/plist/chapter.xml Fri Mar 11 13:58:41 2016 (r48372) @@ -162,7 +162,7 @@ PLIST_SUB+= X11I386="@comment " them in the Makefile: post-stage: - @${MKDIR} ${STAGEDIR}${PREFIX}/some/directory + ${MKDIR} ${STAGEDIR}${PREFIX}/some/directory Add the directory to pkg-plist like any other. For example: Modified: head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml Fri Mar 11 09:50:30 2016 (r48371) +++ head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml Fri Mar 11 13:58:41 2016 (r48372) @@ -3216,7 +3216,7 @@ post-extract: do-install: cd ${WRKDIR} && \ ${INSTALL} -d -o ${WWWOWN} -g ${WWWGRP} ${TOMCATDIR}/webapps/${PORTDIRNAME} - @cd ${WRKDIR}/${PORTDIRNAME} && ${COPYTREE_SHARE} \* ${WEBAPPDIR}/${PORTDIRNAME} + cd ${WRKDIR}/${PORTDIRNAME} && ${COPYTREE_SHARE} \* ${WEBAPPDIR}/${PORTDIRNAME} Regardless of the type of port (library or application), the additional documentation is installed in the