svn commit: r48372 - in head/en_US.ISO8859-1/books/porters-handbook: makefiles plist special

[Mathieu Arnold]

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</programlisting>
   <sect1 xml:id="install">
     <title>Installing Files</title>
 
+    <important>
+      <para>The <buildtarget>install</buildtarget> 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 <filename>Makefile</filename> in all the
+	<buildtarget>*-install</buildtarget> targets should be
+	echo'ed.  <emphasis>Do not</emphasis> silence them with
+	<literal>@</literal> or <literal>.SILENT</literal>.</para>
+    </important>
+
     <sect2 xml:id="install-macros">
       <title><varname>INSTALL_<replaceable>*</replaceable></varname>
 	Macros</title>
@@ -5303,6 +5313,12 @@ PORTVERSION=	1.0</programlisting>
 	${MKDIR} ${STAGEDIR}${DOCSDIR}
 	${INSTALL_MAN} ${WRKSRC}/docs/xvdocs.ps ${STAGEDIR}${DOCSDIR}</programlisting>
 
+      <para>On the other hand, if there is a DOCS option in the port,
+	install the documentation in a
+	<buildtarget>post-install-DOCS-on</buildtarget> target.  These
+	targets are described in <xref
+	  linkend="options-targets"/>.</para>
+
       <para>Here are some handy variables and how they are expanded by
 	default when used in the <filename>Makefile</filename>:</para>
 

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 <filename>Makefile</filename>:</para>
 
       <programlisting>post-stage:
-	@${MKDIR} ${STAGEDIR}${PREFIX}/some/directory</programlisting>
+	${MKDIR} ${STAGEDIR}${PREFIX}/some/directory</programlisting>
 
       <para>Add the directory to <filename>pkg-plist</filename>
 	like any other.  For example:</para>

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}</programlisting>
+	cd ${WRKDIR}/${PORTDIRNAME} && ${COPYTREE_SHARE} \* ${WEBAPPDIR}/${PORTDIRNAME}</programlisting>
 
       <para>Regardless of the type of port (library or
 	application), the additional documentation is installed in the