Fix javadoc doclint HTML warnings (#1653)

gson/src/main/java/com/google/gson/ExclusionStrategy.java

@@ -46,11 +46,11 @@ package com.google.gson;
  *
  * <p><strong>Excludes fields and objects based on a particular annotation:</strong>
  * <pre class="code">
- * public &#64interface FooAnnotation {
+ * public &#64;interface FooAnnotation {
  *   // some implementation here
  * }
  *
- * // Excludes any field (or class) that is tagged with an "&#64FooAnnotation"
+ * // Excludes any field (or class) that is tagged with an "&#64;FooAnnotation"
  * private static class FooAnnotationExclusionStrategy implements ExclusionStrategy {
  *   public boolean shouldSkipClass(Class&lt;?&gt; clazz) {
  *     return clazz.getAnnotation(FooAnnotation.class) != null;

gson/src/main/java/com/google/gson/FieldNamingPolicy.java

@@ -44,10 +44,10 @@ public enum FieldNamingPolicy implements FieldNamingStrategy {
    * Using this naming policy with Gson will ensure that the first "letter" of the Java
    * field name is capitalized when serialized to its JSON form.
    *
-   * <p>Here's a few examples of the form "Java Field Name" ---> "JSON Field Name":</p>
+   * <p>Here's a few examples of the form "Java Field Name" ---&gt; "JSON Field Name":</p>
    * <ul>
-   *   <li>someFieldName ---> SomeFieldName</li>
+   *   <li>someFieldName ---&gt; SomeFieldName</li>
-   *   <li>_someFieldName ---> _SomeFieldName</li>
+   *   <li>_someFieldName ---&gt; _SomeFieldName</li>
    * </ul>
    */
   UPPER_CAMEL_CASE() {
@@ -61,10 +61,10 @@ public enum FieldNamingPolicy implements FieldNamingStrategy {
    * field name is capitalized when serialized to its JSON form and the words will be
    * separated by a space.
    *
-   * <p>Here's a few examples of the form "Java Field Name" ---> "JSON Field Name":</p>
+   * <p>Here's a few examples of the form "Java Field Name" ---&gt; "JSON Field Name":</p>
    * <ul>
-   *   <li>someFieldName ---> Some Field Name</li>
+   *   <li>someFieldName ---&gt; Some Field Name</li>
-   *   <li>_someFieldName ---> _Some Field Name</li>
+   *   <li>_someFieldName ---&gt; _Some Field Name</li>
    * </ul>
    *
    * @since 1.4
@@ -79,12 +79,12 @@ public enum FieldNamingPolicy implements FieldNamingStrategy {
    * Using this naming policy with Gson will modify the Java Field name from its camel cased
    * form to a lower case field name where each word is separated by an underscore (_).
    *
-   * <p>Here's a few examples of the form "Java Field Name" ---> "JSON Field Name":</p>
+   * <p>Here's a few examples of the form "Java Field Name" ---&gt; "JSON Field Name":</p>
    * <ul>
-   *   <li>someFieldName ---> some_field_name</li>
+   *   <li>someFieldName ---&gt; some_field_name</li>
-   *   <li>_someFieldName ---> _some_field_name</li>
+   *   <li>_someFieldName ---&gt; _some_field_name</li>
-   *   <li>aStringField ---> a_string_field</li>
+   *   <li>aStringField ---&gt; a_string_field</li>
-   *   <li>aURL ---> a_u_r_l</li>
+   *   <li>aURL ---&gt; a_u_r_l</li>
    * </ul>
    */
   LOWER_CASE_WITH_UNDERSCORES() {
@@ -97,12 +97,12 @@ public enum FieldNamingPolicy implements FieldNamingStrategy {
    * Using this naming policy with Gson will modify the Java Field name from its camel cased
    * form to a lower case field name where each word is separated by a dash (-).
    *
-   * <p>Here's a few examples of the form "Java Field Name" ---> "JSON Field Name":</p>
+   * <p>Here's a few examples of the form "Java Field Name" ---&gt; "JSON Field Name":</p>
    * <ul>
-   *   <li>someFieldName ---> some-field-name</li>
+   *   <li>someFieldName ---&gt; some-field-name</li>
-   *   <li>_someFieldName ---> _some-field-name</li>
+   *   <li>_someFieldName ---&gt; _some-field-name</li>
-   *   <li>aStringField ---> a-string-field</li>
+   *   <li>aStringField ---&gt; a-string-field</li>
-   *   <li>aURL ---> a-u-r-l</li>
+   *   <li>aURL ---&gt; a-u-r-l</li>
    * </ul>
    * Using dashes in JavaScript is not recommended since dash is also used for a minus sign in
    * expressions. This requires that a field named with dashes is always accessed as a quoted
@@ -120,12 +120,12 @@ public enum FieldNamingPolicy implements FieldNamingStrategy {
    * Using this naming policy with Gson will modify the Java Field name from its camel cased
    * form to a lower case field name where each word is separated by a dot (.).
    *
-   * <p>Here's a few examples of the form "Java Field Name" ---> "JSON Field Name":</p>
+   * <p>Here's a few examples of the form "Java Field Name" ---&gt; "JSON Field Name":</p>
    * <ul>
-   *   <li>someFieldName ---> some.field.name</li>
+   *   <li>someFieldName ---&gt; some.field.name</li>
-   *   <li>_someFieldName ---> _some.field.name</li>
+   *   <li>_someFieldName ---&gt; _some.field.name</li>
-   *   <li>aStringField ---> a.string.field</li>
+   *   <li>aStringField ---&gt; a.string.field</li>
-   *   <li>aURL ---> a.u.r.l</li>
+   *   <li>aURL ---&gt; a.u.r.l</li>
    * </ul>
    * Using dots in JavaScript is not recommended since dot is also used for a member sign in
    * expressions. This requires that a field named with dots is always accessed as a quoted

gson/src/main/java/com/google/gson/annotations/Expose.java

@@ -34,9 +34,9 @@ import java.lang.annotation.Target;
  * <p>Here is an example of how this annotation is meant to be used:
  * <p><pre>
  * public class User {
- *   &#64Expose private String firstName;
+ *   &#64;Expose private String firstName;
- *   &#64Expose(serialize = false) private String lastName;
+ *   &#64;Expose(serialize = false) private String lastName;
- *   &#64Expose (serialize = false, deserialize = false) private String emailAddress;
+ *   &#64;Expose (serialize = false, deserialize = false) private String emailAddress;
  *   private String password;
  * }
  * </pre></p>

gson/src/main/java/com/google/gson/annotations/JsonAdapter.java

@@ -31,7 +31,7 @@ import java.lang.annotation.Target;
  *
  * <p>Here is an example of how this annotation is used:</p>
  * <pre>
- * &#64JsonAdapter(UserJsonAdapter.class)
+ * &#64;JsonAdapter(UserJsonAdapter.class)
  * public class User {
  *   public final String firstName, lastName;
  *   private User(String firstName, String lastName) {
@@ -40,7 +40,7 @@ import java.lang.annotation.Target;
  *   }
  * }
  * public class UserJsonAdapter extends TypeAdapter&lt;User&gt; {
- *   &#64Override public void write(JsonWriter out, User user) throws IOException {
+ *   &#64;Override public void write(JsonWriter out, User user) throws IOException {
  *     // implement write: combine firstName and lastName into name
  *     out.beginObject();
  *     out.name("name");
@@ -48,7 +48,7 @@ import java.lang.annotation.Target;
  *     out.endObject();
  *     // implement the write method
  *   }
- *   &#64Override public User read(JsonReader in) throws IOException {
+ *   &#64;Override public User read(JsonReader in) throws IOException {
  *     // implement read: split name into firstName and lastName
  *     in.beginObject();
  *     in.nextName();
@@ -59,13 +59,13 @@ import java.lang.annotation.Target;
  * }
  * </pre>
  *
- * Since User class specified UserJsonAdapter.class in &#64JsonAdapter annotation, it
+ * Since User class specified UserJsonAdapter.class in &#64;JsonAdapter annotation, it
  * will automatically be invoked to serialize/deserialize User instances. <br>
  *
  * <p> Here is an example of how to apply this annotation to a field.
  * <pre>
  * private static final class Gadget {
- *   &#64JsonAdapter(UserJsonAdapter2.class)
+ *   &#64;JsonAdapter(UserJsonAdapter2.class)
  *   final User user;
  *   Gadget(User user) {
  *     this.user = user;

gson/src/main/java/com/google/gson/annotations/SerializedName.java

@@ -35,8 +35,8 @@ import java.lang.annotation.Target;
  * <p>Here is an example of how this annotation is meant to be used:</p>
  * <pre>
  * public class MyClass {
- *   &#64SerializedName("name") String a;
+ *   &#64;SerializedName("name") String a;
- *   &#64SerializedName(value="name1", alternate={"name2", "name3"}) String b;
+ *   &#64;SerializedName(value="name1", alternate={"name2", "name3"}) String b;
  *   String c;
  *
  *   public MyClass(String a, String b, String c) {

gson/src/main/java/com/google/gson/annotations/Since.java

@@ -36,9 +36,9 @@ import java.lang.annotation.Target;
  * public class User {
  *   private String firstName;
  *   private String lastName;
- *   &#64Since(1.0) private String emailAddress;
+ *   @Since(1.0) private String emailAddress;
- *   &#64Since(1.0) private String password;
+ *   @Since(1.0) private String password;
- *   &#64Since(1.1) private Address address;
+ *   @Since(1.1) private Address address;
  * }
  * </pre>
  *

gson/src/main/java/com/google/gson/annotations/Until.java

@@ -38,8 +38,8 @@ import java.lang.annotation.Target;
  * public class User {
  *   private String firstName;
  *   private String lastName;
- *   &#64Until(1.1) private String emailAddress;
+ *   @Until(1.1) private String emailAddress;
- *   &#64Until(1.1) private String password;
+ *   @Until(1.1) private String password;
  * }
  * </pre>
  *

gson/src/main/java/com/google/gson/stream/JsonReader.java

@@ -170,7 +170,7 @@ import java.util.Arrays;
  * precision loss, extremely large values should be written and read as strings
  * in JSON.
  *
- * <a name="nonexecuteprefix"/><h3>Non-Execute Prefix</h3>
+ * <a id="nonexecuteprefix"/><h3>Non-Execute Prefix</h3>
  * Web servers that serve private data using JSON may be vulnerable to <a
  * href="http://en.wikipedia.org/wiki/JSON#Cross-site_request_forgery">Cross-site
  * request forgery</a> attacks. In such an attack, a malicious site gains access