xmerge: fix javadoc errors for JDK 8

Change-Id: Ic8352b7460c36155215d25339650ede40735e65d
Reviewed-on: https://gerrit.libreoffice.org/11189
Reviewed-by: Noel Grandin <noelgrandin@gmail.com>
Tested-by: Noel Grandin <noelgrandin@gmail.com>

xmerge/source/xmerge/java/org/openoffice/xmerge/converter/palm/PalmDB.java

@@ -44,12 +44,12 @@ import java.io.UnsupportedEncodingException;
  *  <code>bName</code>, and a corresponding String object <code>sName</code>
  *  that contains characters without the '\0' characters.</p>
  *
- *  <p>The {@link #write write} method is called within the
+ *  <p>The <code>write</code> method is called within the
  *  {@link org.openoffice.xmerge.converter.palm.PalmDocument#write
  *  PalmDocument.write} method for writing out its data to the <code>OutputStream</code>
  *  object.</p>
  *
- *  <p>The {@link #read read} method is called within the
+ *  <p>The <code>read</code> method is called within the
  *  {@link org.openoffice.xmerge.converter.palm.PalmDocument#read
  *  PalmDocument.read} method for reading in its data from the <code>InputStream</code>
  *  object.</p>

xmerge/source/xmerge/java/org/openoffice/xmerge/converter/palm/PdbDecoder.java

@@ -36,15 +36,15 @@ import java.io.DataInputStream;
  *
  *  <p>This decoder has the following assumptions on the PDB file:</p>
  *
- *  <p><ol>
+ *  <ol>
- *  <li>There is only one RecordList section in the PDB.</li>
+ *    <li>There is only one RecordList section in the PDB.</li>
- *  <li>The <code>Record</code> indices in the RecordList are sorted in
+ *    <li>The <code>Record</code> indices in the RecordList are sorted in
- *      order, i.e. the first <code>Record</code> index refers to
+ *        order, i.e. the first <code>Record</code> index refers to
- *      <code>Record</code> 0, and so forth.</li>
+ *        <code>Record</code> 0, and so forth.</li>
- *  <li>The raw <code>Record</code> in the <code>Record</code> section
+ *    <li>The raw <code>Record</code> in the <code>Record</code> section
- *      are sorted as well in order, i.e. first <code>Record</code>
+ *        are sorted as well in order, i.e. first <code>Record</code>
- *      comes ahead of second <code>Record</code>, etc.</li>
+ *        comes ahead of second <code>Record</code>, etc.</li>
- *  </ol></p>
+ *  </ol>
  *
  *  <p>Other decoders assume these as well.</p>
  *

xmerge/source/xmerge/java/org/openoffice/xmerge/converter/palm/PdbEncoder.java

@@ -86,7 +86,7 @@ public final class PdbEncoder {
 
 
     /**
-     *  <p>Write out a PDB into the given <code>OutputStream</code>.</p>
+     *  Write out a PDB into the given <code>OutputStream</code>.
      *
      *  <p>First, write out the header data by using the
      *  <code>PdbHeader</code> <code>write</code> method. Next,
@@ -98,12 +98,12 @@ public final class PdbEncoder {
      *  <code>Record</code> index info, where each <code>Record</code>
      *  index info contains:</p>
      *
-     *  <p><ul>
+     *  <ul>
-     *  <li>4 bytes local offset of the <code>Record</code> from the
+     *    <li>4 bytes local offset of the <code>Record</code> from the
-     *      top of the PDB.</li>
+     *        top of the PDB.</li>
-     *  <li>1 byte of <code>Record</code> attribute.</li>
+     *    <li>1 byte of <code>Record</code> attribute.</li>
-     *  <li>3 bytes unique <code>Record</code> ID.</li>
+     *    <li>3 bytes unique <code>Record</code> ID.</li>
-     *  </ul></p>
+     *  </ul>
      *
      *  <p>There should be a total of <code>header.numRecords</code>
      *  of <code>Record</code> index info</p>.

xmerge/source/xmerge/java/org/openoffice/xmerge/converter/xml/ParaStyle.java

@@ -117,28 +117,25 @@ class alignment extends conversionAlgorithm {
 
 
 /**
- *  <p>This class represents a paragraph <code>Style</code>.</p>
+ *  This class represents a paragraph <code>Style</code>.
  *
- *  <p><table border="1" cellpadding="1"><tr><td>
+ *  <table summary="Paragraph style attributes and their values" border="1" cellpadding="1">
- *  Attribute        </td><td>Value
+ *    <caption>Table with all paragraph style attributes and their values</caption>
- *  </td></tr><tr><td>
+ *    <tr><td>Attribute</td><td>Value</td></tr>
- *  MARGIN_LEFT      </td><td>mm * 100
+ *    <tr><td>MARGIN_LEFT</td><td>mm * 100</td></tr>
- *  </td></tr><tr><td>
+ *    <tr><td>MARGIN_RIGHT</td><td>mm * 100</td></tr>
- *  MARGIN_RIGHT     </td><td>mm * 100
+ *    <tr><td>MARGIN_TOP</td><td>mm * 100 (space on top of paragraph)</td></tr>
- *  </td></tr><tr><td>
+ *    <tr><td>MARGIN_BOTTOM</td><td>mm * 100</td></tr>
- *  MARGIN_TOP       </td><td>mm * 100 (space on top of paragraph)
+ *    <tr><td>TEXT_INDENT</td><td>mm * 100 (first line indent)</td></tr>
- *  </td></tr><tr><td>
+ *    <tr>
- *  MARGIN_BOTTOM    </td><td>mm * 100
+ *      <td>LINE_HEIGHT</td>
- *  </td></tr><tr><td>
+ *      <td>mm * 100, unless or'ed with LH_PCT, in which
- *  TEXT_INDENT      </td><td>mm * 100 (first line indent)
+ *          case it is a percentage (e.g. 200% for double spacing)
- *  </td></tr><tr><td>
+ *          Can also be or'ed with LH_ATLEAST.  Value is stored
- *  LINE_HEIGHT      </td><td>mm * 100, unless or'ed with LH_PCT, in which
+ *          in bits indicated by LH_VALUEMASK.</td>
- *                   case it is a percentage (e.g. 200% for double spacing)
+ *    </tr>
- *                   Can also be or'ed with LH_ATLEAST.  Value is stored
+ *    <tr><td>TEXT_ALIGN</td><td>ALIGN_RIGHT, ALIGN_CENTER, ALIGN_JUST, ALIGN_LEFT</td></tr>
- *                   in bits indicated by LH_VALUEMASK.
+ *  </table>
- *  </td></tr><tr><td>
- *  TEXT_ALIGN       </td><td>ALIGN_RIGHT, ALIGN_CENTER, ALIGN_JUST, ALIGN_LEFT
- *  </td></tr></table></p>
  */
 public class ParaStyle extends Style implements Cloneable {
 

xmerge/source/xmerge/java/org/openoffice/xmerge/converter/xml/sxc/DocumentMergerImpl.java

@@ -44,7 +44,9 @@ import org.openoffice.xmerge.util.Debug;
  *  Generic small device implementation of <code>DocumentMerger</code> for
  *  the {@link
  *  org.openoffice.xmerge.converter.xml.sxc.SxcPluginFactory
- *  SxcPluginFactory}.  Used with SXC <code>Document</code> objects.</p>
+ *  SxcPluginFactory}.
+ *
+ *  <p>Used with SXC <code>Document</code> objects.</p>
  */
 public class DocumentMergerImpl implements DocumentMerger {
 

xmerge/source/xmerge/java/org/openoffice/xmerge/converter/xml/xslt/DocumentMergerImpl.java

@@ -38,7 +38,7 @@ import org.openoffice.xmerge.util.Debug;
  *  Xslt implementation of <code>DocumentMerger</code>
  *  for the {@link
  *  org.openoffice.xmerge.converter.xml.xslt.PluginFactoryImpl
- *  PluginFactoryImpl}.</p>
+ *  PluginFactoryImpl}.
  */
 public class DocumentMergerImpl implements DocumentMerger {
 

xmerge/source/xmerge/java/org/openoffice/xmerge/merger/diff/IteratorRowCompare.java

@@ -28,28 +28,32 @@ import org.openoffice.xmerge.merger.Iterator;
 import org.openoffice.xmerge.converter.xml.OfficeConstants;
 
 /**
- *  <p>A very simple and direct difference algorithm for row
+ *  A very simple and direct difference algorithm for row
- *  <code>Node</code> objects in a spreadsheet.  Basically, it will
+ *  <code>Node</code> objects in a spreadsheet.
- *  compare objects in sequence and does not look ahead (unlike LCS).</p>
  *
- *  <p><ol><li>
+ *  <p>Basically, it will compare objects in sequence and does not look ahead
- *    If two objects are the same, skip to next one.
+ *  (unlike LCS).</p>
- *  </li><li>
+ *
- *    Otherwise check whether the row repeated attribute is the same.
+ *  <ol>
- *  </li><li>
+ *    <li>
- *    If the row repeated attribute is the same, then compare two rows
+ *      If two objects are the same, skip to next one.
- *    and mark it as <i>change</i> if those rows are different.
+ *    </li><li>
- *  </li><li>
+ *      Otherwise check whether the row repeated attribute is the same.
- *    If the row repeated attribute is different, then split the rows and
+ *    </li><li>
- *    continue to compare.
+ *      If the row repeated attribute is the same, then compare two rows
- *  </li><li>
+ *      and mark it as <i>change</i> if those rows are different.
- *    If there are more objects in the modseq than the original sequence,
+ *    </li><li>
- *    then all of the extra ones in the modified sequence are marked as add.
+ *      If the row repeated attribute is different, then split the rows and
- *  </li><li>
+ *      continue to compare.
- *    If there are more objects in the original sequence than the modified
+ *    </li><li>
- *    sequence, then all the extra one in the modified sequence are marked
+ *      If there are more objects in the modseq than the original sequence,
- *    as delete.
+ *      then all of the extra ones in the modified sequence are marked as add.
- *  </li></ol></p>
+ *    </li><li>
+ *      If there are more objects in the original sequence than the modified
+ *      sequence, then all the extra one in the modified sequence are marked
+ *      as delete.
+ *    </li>
+ *  </ol>
  *
  *  <p>NOTE: The algorithm will have potential side effect to split rows.</p>
  */

xmerge/source/xmerge/java/org/openoffice/xmerge/merger/merge/SheetUtil.java

@@ -33,14 +33,17 @@ import org.openoffice.xmerge.converter.xml.OfficeConstants;
 public class SheetUtil {
 
     /**
-     *  <p>Empty the content of a cell value.   This includes the following:
+     *  Empty the content of a cell value.
-     *  </p>
      *
-     *  <p><ul><li>
+     *  <p>This includes the following:</p>
-     *    Remove all of the supported attributes.
+     *
-     *  </li><li>
+     *  <ul>
-     *    Remove the first <i>text:p</i> <code>Node</code> for most of the cells.
+     *    <li>
-     *  </li></ul></p>
+     *      Remove all of the supported attributes.
+     *    </li><li>
+     *      Remove the first <i>text:p</i> <code>Node</code> for most of the cells.
+     *    </li>
+     *  </ul>
      *
      *  @param  cc    The <code>ConverterCapabilities</code>.
      *  @param  node  The <code>Node</code>.

xmerge/source/xmerge/java/org/openoffice/xmerge/util/Debug.java

@@ -31,7 +31,7 @@ import java.util.Properties;
 /**
  *  This class is used for logging debug messages.
  *  Currently, there are three types of logging:  {@link #INFO},
- *  {@link #TRACE} & {@link #ERROR}.  Use the Debug.properties
+ *  {@link #TRACE} & {@link #ERROR}.  Use the Debug.properties
  *  file to set or unset each type.  Also use Debug.properties
  *  to set the writer to either <code>System.out</code>,
  *  <code>System.err</code>, or to a file.