[Java]: Fix javadoc warnings on Java 8.

Author: mjpt777

main/csharp/Otf/OtfHeaderDecoder.cs

@@ -4,9 +4,9 @@ namespace Adaptive.SimpleBinaryEncoding.Otf
 {
  /// <summary>
  /// Used to decode a message header while doing on-the-fly decoding of a message stream.
- /// <p/>
+ ///
  /// Meta data is cached to improve the performance of decoding headers.
- /// <p/>
+ ///
  /// This class is thread safe.
  /// </summary>
  public class OtfHeaderDecoder

main/csharp/PrimitiveType.cs

@@ -3,7 +3,7 @@
  /// <summary>
  /// Primitive types from which all other types are composed.
  /// 
- /// <p/>
+ ///
  /// <table>
  /// <thead>
  /// <tr>

main/csharp/ir/IntermediateRepresentation.cs

@@ -136,7 +136,7 @@ public int Id
 
  /// <summary>
  /// Get the namespaceName to be used for generated code.
- /// <p/>
+ ///
  /// If <seealso cref="NamespaceName"/> is null then <seealso cref="PackageName"/> is used.
  /// </summary>
  /// <returns> the namespaceName to be used for generated code. </returns>

main/csharp/ir/Token.cs

@@ -22,15 +22,15 @@ namespace Adaptive.SimpleBinaryEncoding.ir
  /// <summary>
  /// Class to encapsulate a token of information for the message schema stream. This Intermediate Representation (IR)
  /// is intended to be language, schema, platform independent.
- /// <p/>
+ ///
  /// Processing and optimization could be run over a list of Tokens to perform various functions
  /// <ul>
  /// <li>re-ordering of fields based on size</li>
  /// <li>padding of fields in order to provide expansion room</li>
  /// <li>computing offsets of individual fields</li>
  /// <li>etc.</li>
  /// </ul>
- /// <p/>
+ ///
  /// IR could be used to generate code or other specifications. It should be possible to do the
  /// following:
  /// <ul>
@@ -39,18 +39,18 @@ namespace Adaptive.SimpleBinaryEncoding.ir
  /// <li>generate a GPB spec from IR</li>
  /// <li>etc.</li>
  /// </ul>
- /// <p/>
+ ///
  /// IR could be serialized to storage or network via code generated by SBE. Then read back in to
  /// a List of <seealso cref="Token"/>s.
- /// <p/>
+ ///
  /// The entire IR of an entity is a <see cref="List{Token}"/>. The order of this list is
  /// very important. Encoding of fields is done by nodes pointing to specific encoding <seealso cref="PrimitiveType"/>
  /// objects. Each encoding node contains size, offset, byte order, and <seealso cref="Encoding"/>. Entities relevant
  /// to the encoding such as fields, messages, repeating groups, etc. are encapsulated in the list as nodes
  /// themselves. Although, they will in most cases never be serialized. The boundaries of these entities
  /// are delimited by BEGIN and END <seealso cref="Adaptive.SimpleBinaryEncoding.ir.Signal"/> values in the node <seealso cref="Encoding"/>.
  /// A list structure like this allows for each concatenation of encodings as well as easy traversal.
- /// <p/>
+ ///
  /// An example encoding of a message headerStructure might be like this.
  /// <ul>
  /// <li>Token 0 - Signal = BEGIN_MESSAGE, schemaId = 100</li>
@@ -59,7 +59,7 @@ namespace Adaptive.SimpleBinaryEncoding.ir
  /// <li>Token 3 - Signal = END_FIELD</li>
  /// <li>Token 4 - Signal = END_MESSAGE</li>
  /// </ul>
- /// <p/>
+ ///
  /// </summary>
  public class Token
  {

main/java/uk/co/real_logic/sbe/PrimitiveType.java

@@ -18,74 +18,6 @@
 
 /**
  * Primitive types from which all other types are composed.
- *
- * <p/>
- * <table>
- * <thead>
- * <tr>
- * <th>PrimitiveType Type</th>
- * <th>Description</th>
- * <th>Length (octets)</th>
- * </tr>
- * </thead>
- * <tbody>
- * <tr>
- * <td>char</td>
- * <td>Character</td>
- * <td>1</td>
- * </tr>
- * <tr>
- * <td>int8</td>
- * <td>Signed byte</td>
- * <td>1</td>
- * </tr>
- * <tr>
- * <td>uint8</td>
- * <td>Unsigned Byte / single byte character</td>
- * <td>1</td>
- * </tr>
- * <tr>
- * <td>int16</td>
- * <td>Signed integer</td>
- * <td>2</td>
- * </tr>
- * <tr>
- * <td>uint16</td>
- * <td>Unsigned integer</td>
- * <td>2</td>
- * </tr>
- * <tr>
- * <td>int32</td>
- * <td>Signed integer</td>
- * <td>4</td>
- * </tr>
- * <tr>
- * <td>uint32</td>
- * <td>Unsigned integer</td>
- * <td>4</td>
- * </tr>
- * <tr>
- * <td>int64</td>
- * <td>Signed integer</td>
- * <td>8</td>
- * </tr>
- * <tr>
- * <td>uint64</td>
- * <td>Unsigned integer</td>
- * <td>8</td>
- * </tr>
- * <tr>
- * <td>float</td>
- * <td>Single precision floating point</td>
- * <td>4</td>
- * </tr>
- * <tr>
- * <td>double</td>
- * <td>Double precision floating point</td>
- * <td>8</td>
- * </tr>
- * </tbody>
- * </table>
  */
 public enum PrimitiveType
 {

main/java/uk/co/real_logic/sbe/PrimitiveValue.java

@@ -25,74 +25,6 @@
 
 /**
  * Class used to encapsulate values for primitives. Used for nullValue, minValue, maxValue, and constants
- * <p/>
- *
- * <table>
- * <thead>
- * <tr>
- * <th>PrimitiveType</th>
- * <th>Null</th>
- * <th>Min</th>
- * <th>Max</th>
- * </tr>
- * </thead>
- * <tbody>
- * <tr>
- * <td>char</td>
- * <td>0</td>
- * <td>0x20</td>
- * <td>0x7E</td>
- * </tr>
- * <tr>
- * <td>int8</td>
- * <td>-128</td>
- * <td>-127</td>
- * <td>127</td>
- * </tr>
- * <tr>
- * <td>uint8</td>
- * <td>255</td>
- * <td>0</td>
- * <td>254</td>
- * </tr>
- * <tr>
- * <td>int16</td>
- * <td>-32768</td>
- * <td>-32767</td>
- * <td>32767</td>
- * </tr>
- * <tr>
- * <td>uint16</td>
- * <td>65535</td>
- * <td>0</td>
- * <td>65534</td>
- * </tr>
- * <tr>
- * <td>int32</td>
- * <td>2^31</td>
- * <td>-2^31 + 1</td>
- * <td>2^31 - 1</td>
- * </tr>
- * <tr>
- * <td>uint32</td>
- * <td>2^32 - 1</td>
- * <td>0</td>
- * <td>2^32 - 2</td>
- * </tr>
- * <tr>
- * <td>int64</td>
- * <td>2^63</td>
- * <td>-2^63 + 1</td>
- * <td>2^63 - 1</td>
- * </tr>
- * <tr>
- * <td>uint64</td>
- * <td>2^64 - 1</td>
- * <td>0</td>
- * <td>2^64 - 2</td>
- * </tr>
- * </tbody>
- * </table>
  */
 public class PrimitiveValue
 {
@@ -161,6 +93,7 @@ public enum Representation
  * Construct and fill in value as a long.
  *
  * @param value in long format
+ * @param size of the type in bytes
  */
  public PrimitiveValue(final long value, final int size)
  {
@@ -174,7 +107,9 @@ public PrimitiveValue(final long value, final int size)
 
  /**
  * Construct and fill in value as a double.
+ *
  * @param value in double format
+ * @param size of the type in bytes
  */
  public PrimitiveValue(final double value, final int size)
  {
@@ -190,6 +125,8 @@ public PrimitiveValue(final double value, final int size)
  * Construct and fill in value as a byte array.
  *
  * @param value as a byte array
+ * @param characterEncoding of the characters
+ * @param size of string in characters
  */
  public PrimitiveValue(final byte[] value, final String characterEncoding, final int size)
  {

main/java/uk/co/real_logic/sbe/SbeTool.java

@@ -31,16 +31,14 @@
 
 /**
  * A tool for running the SBE parser, validator, and code generator.
- * <p/>
+ *
  * Usage:
- * <code>
- * <pre>
+ * <pre>
  * $ java -jar sbe.jar &lt;filename.xml&gt;
  * $ java -Doption=value -jar sbe.jar &lt;filename.xml&gt;
  * $ java -Doption=value -jar sbe.jar &lt;filename.sbeir&gt;
- * </pre>
- * </code>
- * <p/>
+ * </pre>
+ *
  * Properties
  * <ul>
  * <li><code>sbe.validation.xsd</code>: Use XSD to validate or not.</li>

main/java/uk/co/real_logic/sbe/codec/java/DirectBuffer.java

@@ -509,6 +509,7 @@ public int putBytes(final int index, final byte[] src, final int offset, final i
  *
  * @param index in the underlying buffer to start from.
  * @param srcBuffer to copy the bytes from.
+ * @param length of the source buffer in bytes to copy
  * @return count of bytes copied.
  */
  public int putBytes(final int index, final ByteBuffer srcBuffer, final int length)

main/java/uk/co/real_logic/sbe/generation/OutputManager.java

@@ -29,6 +29,7 @@ public interface OutputManager
  *
  * @param name of the given output.
  * @return A {@link Writer} to which the code generation should be output.
+ * @throws IOException if an error occurs during output.
  */
  Writer createOutput(final String name) throws IOException;
 }

main/java/uk/co/real_logic/sbe/generation/cpp98/NamespaceOutputManager.java

@@ -33,6 +33,7 @@ public class NamespaceOutputManager implements OutputManager
  *
  * @param baseDirectoryName for the generated source code.
  * @param namespaceName for the generated source code relative to the baseDirectoryName.
+ * @throws IOException if an error occurs during output
  */
  public NamespaceOutputManager(final String baseDirectoryName, final String namespaceName)
  throws IOException
@@ -56,7 +57,7 @@ public NamespaceOutputManager(final String baseDirectoryName, final String names
 
  /**
  * Create a new output which will be a C++98 source file in the given package.
- * <p/>
+ *
  * The {@link java.io.Writer} should be closed once the caller has finished with it. The Writer is
  * buffer for efficient IO operations.
  *