svn commit: r43054 - head/en_US.ISO8859-1/books/porters-handbook

[Eitan Adler]

Author: eadler
Date: Mon Oct 28 19:13:05 2013
New Revision: 43054
URL: http://svnweb.freebsd.org/changeset/doc/43054

Log:
  Modify the documentation example for staging.

Modified:
  head/en_US.ISO8859-1/books/porters-handbook/book.xml

Modified: head/en_US.ISO8859-1/books/porters-handbook/book.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/book.xml	Mon Oct 28 19:05:18 2013	(r43053)
+++ head/en_US.ISO8859-1/books/porters-handbook/book.xml	Mon Oct 28 19:13:05 2013	(r43054)
@@ -5117,15 +5117,13 @@ PORTVERSION=	1.0</programlisting>
 	  the same time, you can use the whole
 	  <makevar>PKGNAME</makevar>.</para>
 
-	<para>Make the installation dependent on the variable
-	  <literal>DOCS</literal> option so that users can disable it
-	  in <filename>/etc/make.conf</filename>, like this:</para>
+	<para>Since only the files listed in <filename>pkg-plist</filename>
+	  are installed it is safe to always install
+	  documentation to <makevar>STAGEDIR</makevar>.</para>
 
 	<programlisting>post-install:
-.if ${PORT_OPTIONS:MDOCS}
-	${MKDIR} ${DOCSDIR}
-	${INSTALL_MAN} ${WRKSRC}/docs/xvdocs.ps ${DOCSDIR}
-.endif</programlisting>
+	  ${MKDIR} ${STAGEDIR}${DOCSDIR}
+	  ${INSTALL_MAN} ${WRKSRC}/docs/xvdocs.ps ${STAGEDIR}${DOCSDIR}</programlisting>
 
 	<para>Here are some handy variables and how they are expanded
 	  by default when used in the