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
@@ -84,7 +84,12 @@
       point to a wrong location, like when a remote file system has
       been mounted with <acronym>NFS</acronym> under a non-root mount
       point.  Relative paths are less fragile, and often much
-      shorter.</para>
+      shorter.  An example for generating a relative path:</para>
+
+    <programlisting>${RLN} ${STAGEDIR}${DATADIR}/<replaceable>foobar.war</replaceable> ${STAGEDIR}${PREFIX}/apache-tomcat-8.0/webapps</programlisting>
+
+    <para>When ${RLN} is used to generate a relative path symlink,
+      absolute paths are needed for the source and target.</para>
 
     <para>Ports that install kernel modules must prepend
       <varname>STAGEDIR</varname> to their destination, by default