Improves Javadoc formatting.

Author: sebright2

core/java/com/google/census/Census.java

@@ -42,9 +42,10 @@ public static CensusContext getCurrent() {
   }
 
   /**
-   * Creates a {@link CensusContext} from the given on-the-wire encoded representation. Should be
-   * the inverse of {@link CensusContext#serialize()}. The serialized representation should be
-   * based on the {@link CensusContext} protobuf representation.
+   * Creates a {@link CensusContext} from the given on-the-wire encoded representation.
+   *
+   * <p>Should be the inverse of {@link CensusContext#serialize()}. The serialized representation
+   * should be based on the {@link CensusContext} protobuf representation.
    */
   @Nullable
   public static CensusContext deserialize(ByteBuffer buffer) {

core/java/com/google/census/CensusContext.java

@@ -48,7 +48,8 @@ public final CensusContext with(
 
   /**
    * Serializes the {@link CensusContext} into the on-the-wire representation.
-   * The inverse of {@link CensusContextFactory#deserialize()} and should be based on the
+   *
+   * <p>The inverse of {@link CensusContextFactory#deserialize()} and should be based on the
    * {@link CensusContext} protobuf representation.
    *
    * @return serialized bytes.

core/java/com/google/census/CensusContextFactory.java

@@ -21,9 +21,10 @@
  */
 public abstract class CensusContextFactory {
   /**
-   * Creates a {@link CensusContext} from the given on-the-wire encoded representation. Should be
-   * the inverse of {@link CensusContext#serialize()}. The serialized representation should be
-   * based on the {@link CensusContext} protobuf representation.
+   * Creates a {@link CensusContext} from the given on-the-wire encoded representation.
+   *
+   * <p>Should be the inverse of {@link CensusContext#serialize()}. The serialized representation
+   * should be based on the {@link CensusContext} protobuf representation.
    *
    * @param buffer on-the-wire representation of a {@link CensusContext}
    * @return a {@link CensusContext} deserialized from {@code buffer}

core_native/java/com/google/census/CensusContextFactoryImpl.java

@@ -22,8 +22,9 @@ final class CensusContextFactoryImpl extends CensusContextFactory {
   static final CensusContextImpl DEFAULT = new CensusContextImpl(new HashMap<String, String>(0));
 
   /**
-   * Deserializes a {@link CensusContextImpl} from a serialized {@link CensusContextProto}. The
-   * encoded tags are of the form: (<tag prefix> + 'key' + <tag delim> + 'value')*
+   * Deserializes a {@link CensusContextImpl} from a serialized {@link CensusContextProto}.
+   *
+   * <p>The encoded tags are of the form: {@code <tag prefix> + 'key' + <tag delim> + 'value'}*
    */
   @Override
   @Nullable

core_native/java/com/google/census/CensusContextImpl.java

@@ -35,8 +35,9 @@ public CensusContextImpl record(MetricMap stats) {
   }
 
   /**
-   * Serializes a {@link CensusContextImpl} into {@link CensusContextProto} serialized format. The
-   * encoded tags are of the form: (<tag prefix> + 'key' + <tag delim> + 'value')*
+   * Serializes a {@link CensusContextImpl} into {@link CensusContextProto} serialized format.
+   *
+   * <p>The encoded tags are of the form: {@code <tag prefix> + 'key' + <tag delim> + 'value'}*
    */
   @Override
   public ByteBuffer serialize() {