diff --git a/pdf/xdocs/index.xml b/pdf/xdocs/index.xml
index 8399b68e..2c70acd1 100644
--- a/pdf/xdocs/index.xml
+++ b/pdf/xdocs/index.xml
@@ -50,10 +50,12 @@
           <p>Due to several problems, it is actually impossible to reference the same file in different items in navigation.xml. You must define another navigation file (using the property <a href="properties.html">"maven.pdf.navigationFile"</a>) which you'll use only with the PDF plug-in. This navigation cannot define several items with the same href.</p>
         </li>
         <li>
-          <p>
-            <a href="http://jira.codehaus.org/secure/IssueNavigator.jspa?reset=true&amp;pid=10356&amp;statusIds=1" target="_blank">Other issues are available in Jira.</a>
+          <p>Identical <code>name</code> or <code>id</code> attributes within one document will lead to a build failure. Note in particular that in the current version of the pdf plugin, id's are constructed from sub/section names (in analogy to the xdoc plugin), so identical titles for sections or subsections will make the pdf generation fail. See <a href="http://jira.codehaus.org/browse/MPPDF-40">MPPDF-40</a>.
           </p>
         </li>
+        <li>
+          <p>Other issues are available in <a href="http://jira.codehaus.org/secure/IssueNavigator.jspa?reset=true&amp;pid=10356&amp;statusIds=1" target="_blank">Jira</a>.</p>
+        </li>
       </ul>
     </section>
   </body>
diff --git a/pdf/xdocs/properties.xml b/pdf/xdocs/properties.xml
index b843bca0..d3e73c4c 100644
--- a/pdf/xdocs/properties.xml
+++ b/pdf/xdocs/properties.xml
@@ -70,8 +70,7 @@
             <td width="25%">maven.pdf.copyrightYear</td>
             <td>The year for the copyright.</td>
             <td width="10%">Yes</td>
-            <td>
-              <code>${pom.inceptionYear}</code>
+            <td>By default, gets constructed like: "<code>${pom.inceptionYear}-build_year</code>", or just "<code>build_year</code>" if the two are equal (or if <code>${pom.inceptionYear}</code> is undefined).
             </td>
           </tr>
           <tr>
@@ -221,7 +220,8 @@
           </tr>
           <tr>
             <td width="25%">maven.jar.jimi</td>
-            <td>Jimi OR Jai libraries must be declared if you want to use PNG images in your pdf document. Jimi and Jai cannot be distributed via ibiblio, so you must add the path to one of these libraries in your project properties. For example : <code>maven.jar.jimi=${maven.repo.local}/jimi/jars/jimi-X.Y.Z.jar</code></td>
+            <td>Jimi OR Jai libraries must be declared if you want to use PNG images in your pdf document. Jimi and Jai cannot be distributed via ibiblio, so you must add the path to one of these libraries in your project properties. For example : <code>maven.jar.jimi=${maven.repo.local}/jimi/jars/jimi-X.Y.Z.jar</code>
+            </td>
             <td width="10%">Yes</td>
             <td>
               <code>Empty.</code>
@@ -229,7 +229,9 @@
           </tr>
           <tr>
             <td width="25%">maven.jar.jaicore<br/>maven.jar.jaicodec</td>
-            <td>Jimi OR Jai libraries must be declared if you want to use PNG images in your pdf document. Jimi and Jai cannot be distributed via ibiblio, so you must add the path to one of these libraries in your project properties. For example : <br/><code>maven.jar.jaicore=${maven.repo.local}/jai/jars/jai_core-X.Y.Z.jar<br/>maven.jar.jaicodec=${maven.repo.local}/jai/jars/jai_codec-X.Y.Z.jar</code></td>
+            <td>Jimi OR Jai libraries must be declared if you want to use PNG images in your pdf document. Jimi and Jai cannot be distributed via ibiblio, so you must add the path to one of these libraries in your project properties. For example : <br/>
+              <code>maven.jar.jaicore=${maven.repo.local}/jai/jars/jai_core-X.Y.Z.jar<br/>maven.jar.jaicodec=${maven.repo.local}/jai/jars/jai_codec-X.Y.Z.jar</code>
+            </td>
             <td width="10%">Yes</td>
             <td>
               <code>Empty.</code>