Index: en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml
===================================================================
--- en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml
+++ en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml
@@ -5111,6 +5111,16 @@
   <sect1 xml:id="install">
     <title>Installing Files</title>
 
+    <important>
+      <para>As the <buildtarget>install</buildtarget> phase is the
+	most important from the end-user's point of view, all the
+	additional commands run in the port's
+	<filename>Makefile</filename> in all the
+	<buildtarget>*-install</buildtarget> targets should be
+	echo'ed.  Do not 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 @@
 	${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>
 
Index: en_US.ISO8859-1/books/porters-handbook/plist/chapter.xml
===================================================================
--- en_US.ISO8859-1/books/porters-handbook/plist/chapter.xml
+++ en_US.ISO8859-1/books/porters-handbook/plist/chapter.xml
@@ -162,7 +162,7 @@
 	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>
Index: en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
===================================================================
--- en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
+++ en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
@@ -3216,7 +3216,7 @@
 do-install:
 	cd ${WRKDIR} &amp;&amp; \
 	${INSTALL} -d -o ${WWWOWN} -g ${WWWGRP} ${TOMCATDIR}/webapps/${PORTDIRNAME}
-	@cd ${WRKDIR}/${PORTDIRNAME} &amp;&amp; ${COPYTREE_SHARE} \* ${WEBAPPDIR}/${PORTDIRNAME}</programlisting>
+	cd ${WRKDIR}/${PORTDIRNAME} &amp;&amp; ${COPYTREE_SHARE} \* ${WEBAPPDIR}/${PORTDIRNAME}</programlisting>
 
       <para>Regardless of the type of port (library or
 	application), the additional documentation is installed in the