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

[Mathieu Arnold]

Author: mat
Date: Sun Dec 20 16:43:48 2015
New Revision: 47897
URL: https://svnweb.freebsd.org/changeset/doc/47897

Log:
  Change the wording to push people to use variables directly and not the
  %%FOO%% constructs in PLIST_FILES.
  
  Sponsored by:	Absolight

Modified:
  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/plist/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/plist/chapter.xml	Sun Dec 20 15:45:07 2015	(r47896)
+++ head/en_US.ISO8859-1/books/porters-handbook/plist/chapter.xml	Sun Dec 20 16:43:48 2015	(r47897)
@@ -97,11 +97,13 @@ OPTIONS_SUB=	yes</programlisting>
       <varname>PLIST_DIRS</varname>.  The value of each variable is
       regarded as a list of pathnames to write to
       <filename>TMPPLIST</filename> along with
-      <filename>PLIST</filename> contents.  Names listed in
+      <filename>PLIST</filename> contents.  While names listed in
       <varname>PLIST_FILES</varname> and
       <varname>PLIST_DIRS</varname> are subject to
       <literal>%%<replaceable>VAR</replaceable>%%</literal>
-      substitution as described above.  Except for that, names from
+      substitution as described above, it is better to use the
+      <literal>${<replaceable>VAR</replaceable>}</literal> directly.
+      Except for that, names from
       <varname>PLIST_FILES</varname> will appear in the final packing
       list unchanged, while <literal>@dir</literal>
       will be prepended to names from

Modified: head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml	Sun Dec 20 15:45:07 2015	(r47896)
+++ head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml	Sun Dec 20 16:43:48 2015	(r47897)
@@ -3178,7 +3178,7 @@ USE_QT4=	moc_build qmake_build rcc_build
 	the name of the JAR file installed as part of the
 	port):</para>
 
-      <programlisting>PLIST_FILES+=	%%JAVAJARDIR%%/<replaceable>myport</replaceable>.jar</programlisting>
+      <programlisting>PLIST_FILES+=	${JAVAJARDIR}/<replaceable>myport</replaceable>.jar</programlisting>
 
       <para>When porting a Java application, the port usually
 	installs everything under a single directory (including its