svn commit: r51690 - head/en_US.ISO8859-1/books/porters-handbook/quick-porting

[Mathieu Arnold]

Author: mat
Date: Mon May 21 15:03:28 2018
New Revision: 51690
URL: https://svnweb.freebsd.org/changeset/doc/51690

Log:
  Stop telling people they cannot do things that work just fine.
  
  Sponsored by:	Absolight

Modified:
  head/en_US.ISO8859-1/books/porters-handbook/quick-porting/chapter.xml

Modified: head/en_US.ISO8859-1/books/porters-handbook/quick-porting/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/quick-porting/chapter.xml	Mon May 21 13:31:58 2018	(r51689)
+++ head/en_US.ISO8859-1/books/porters-handbook/quick-porting/chapter.xml	Mon May 21 15:03:28 2018	(r51690)
@@ -209,15 +209,14 @@ lib/X11/oneko/mouse.xpm</programlisting>
 	  for more information.</para>
       </tip>
 
-      <para>The price for this way of listing a port's files and
-	directories is that the keywords described in
-	&man.pkg-create.8; and <xref linkend="plist-keywords"/> cannot
-	be used.  Therefore, it is suitable
-	only for simple ports and makes them even simpler.  At the
-	same time, it has the advantage of reducing the number of
-	files in the ports collection.  Please consider using this
-	technique before resorting to
-	<filename>pkg-plist</filename>.</para>
+      <tip>
+	<para>As <varname>PLIST_FILES</varname> is a make variable,
+	  any entry with spaces must be quoted.  For example, if using
+	  keywords described in &man.pkg-create.8; and <xref
+	    linkend="plist-keywords"/>, the entry must be quoted.</para>
+
+	<programlisting>PLIST_FILES=	"@sample ${ETCDIR}/oneko.conf.sample"</programlisting>
+      </tip>
 
       <para>Later we will see how <filename>pkg-plist</filename>
 	and <varname>PLIST_FILES</varname> can be used to fulfill