diff --git a/en_US.ISO8859-1/books/porters-handbook/plist/chapter.xml b/en_US.ISO8859-1/books/porters-handbook/plist/chapter.xml
index 7d9c27a84d..13e53c349b 100644
--- a/en_US.ISO8859-1/books/porters-handbook/plist/chapter.xml
+++ b/en_US.ISO8859-1/books/porters-handbook/plist/chapter.xml
@@ -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
diff --git a/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml b/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
index a9c55bef28..817f4e2243 100644
--- a/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
+++ b/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
@@ -3178,7 +3178,7 @@ USE_QT4=	moc_build qmake_build rcc_build uic_build</programlisting>
 	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