Reformatted 4

Author: rijnb

src/main/java/com/mapcode/Common.java

@@ -20,7 +20,7 @@
  * ----------------------------------------------------------------------------------------------
  * Package private implementation class. For internal use within the Mapcode implementation only.
  * ----------------------------------------------------------------------------------------------
- * <p/>
+ *
  * This class contains common data structures and methods used by the Mapcode implementation.
  */
 class Common {

src/main/java/com/mapcode/Data.java

@@ -23,7 +23,7 @@
  * ----------------------------------------------------------------------------------------------
  * Package private implementation class. For internal use within the Mapcode implementation only.
  * ----------------------------------------------------------------------------------------------
- * <p/>
+ *
  * This class the data class for Mapcode codex items.
  */
 class Data {

src/main/java/com/mapcode/DataAccess.java

@@ -24,7 +24,7 @@
  * ----------------------------------------------------------------------------------------------
  * Package private implementation class. For internal use within the Mapcode implementation only.
  * ----------------------------------------------------------------------------------------------
- * <p/>
+ *
  * This class contains the module that reads the Mapcode areas into memory and processes them.
  */
 class DataAccess {

src/main/java/com/mapcode/Mapcode.java

@@ -24,7 +24,7 @@
 /**
  * This class defines a single mapcode encoding result, including the mapcode itself and the
  * territory definition.
- * <p/>
+ *
  * Note that the constructor will throw an {@link IllegalArgumentException} if the syntax of the mapcode
  * is not correct. It does not throw an {@link UnknownMapcodeException}, because the mapcode
  * is not checked for validity, other than its syntax.
@@ -63,7 +63,7 @@ public Mapcode(
     /**
      * Get the Mapcode string (without territory information) with standard precision.
      * The returned mapcode does not include the '-' separator and additional digits.
-     * <p/>
+     *
      * The returned precision is approximately 5 meters. The precision is defined as the maximum distance to the
      * (latitude, longitude) pair that encoded to this mapcode, which means the mapcode defines an area of
      * approximately 10 x 10 meters (100 m2).
@@ -109,7 +109,7 @@ public String getMapcodePrecision0() {
      * Get the medium-precision mapcode string (without territory information).
      * The returned mapcode includes the '-' separator and 1 additional digit, if available.
      * If a medium precision code is not available, the regular mapcode is returned.
-     * <p/>
+     *
      * The returned precision is approximately 1 meter. The precision is defined as the maximum distance to the
      * (latitude, longitude) pair that encoded to this mapcode, which means the mapcode defines an area of
      * approximately 2 x 2 meters (4 m2).
@@ -134,7 +134,7 @@ public String getMapcodeMediumPrecision() {
      * Get the high-precision mapcode string (without territory information).
      * The returned mapcode includes the '-' separator and 2 additional digit2, if available.
      * If a high precision code is not available, the regular mapcode is returned.
-     * <p/>
+     *
      * The returned precision is approximately 16 centimeters. The precision is defined as the maximum distance to the
      * (latitude, longitude) pair that encoded to this mapcode, which means the mapcode defines an area of
      * approximately 32 x 32 centimeters (0.1 m2).
@@ -203,7 +203,7 @@ public enum MapcodeFormatType {
      * This method return the mapcode type, given a mapcode string. If the mapcode string has an invalid
      * format, {@link MapcodeFormatType#MAPCODE_TYPE_INVALID} is returned. If another value is returned,
      * the precision of the mapcode is given.
-     * <p/>
+     *
      * Note that this method only checks the syntactic validity of the mapcode, the string format. It does not
      * check if the mapcode is really a valid mapcode representing a position on Earth.
      *
@@ -258,7 +258,7 @@ public static String convertToAscii(@Nonnull final String mapcode) {
 
     /**
      * Return the local mapcode string, potentially ambiguous.
-     * <p/>
+     *
      * Example:
      * 49.4V
      *
@@ -273,7 +273,7 @@ public String asLocal() {
      * Return the full international mapcode, including the full name of the territory and the Mapcode itself.
      * The format of the code is:
      * full-territory-name mapcode
-     * <p/>
+     *
      * Example:
      * Netherlands 49.4V           (regular code)
      * Netherlands 49.4V-K2        (high precision code)
@@ -290,7 +290,7 @@ public String asInternationalFullName() {
      * International codes use a territory code "AAA".
      * The format of the code is:
      * short-territory-name mapcode
-     * <p/>
+     *
      * Example:
      * NLD 49.4V                   (regular code)
      * NLD 49.4V-K2                (high-precision code)

src/main/java/com/mapcode/MapcodeCodec.java

@@ -26,7 +26,7 @@
  * ----------------------------------------------------------------------------------------------
  * Mapcode public interface.
  * ----------------------------------------------------------------------------------------------
- * <p/>
+ *
  * This class is the external Java interface for encoding and decoding mapcodes.
  */
 public final class MapcodeCodec {
@@ -44,13 +44,13 @@ private MapcodeCodec() {
     /**
      * Encode a lat/lon pair to a mapcode with territory information. This produces a non-empty list of mapcode,
      * with at the very least 1 mapcodes for the lat/lon, which is the "International" mapcode.
-     * <p/>
+     *
      * The returned result list will always contain at least 1 mapcode, because every lat/lon pair can be encoded.
-     * <p/>
+     *
      * The list is ordered in such a way that the first result contains the shortest mapcode (which is usually a
      * local mapcode). The last result contains the "International" or world-wide mapcode, which is always
      * unambiguous, even when used without a territory specification.
-     * <p/>
+     *
      * The international code can be obtained from the list by using: "results.get(results.size() - 1)".
      *
      * @param latDeg Latitude, accepted range: -90..90.
@@ -75,9 +75,9 @@ public static List<Mapcode> encode(
     /**
      * Encode a lat/lon pair to a mapcode with territory information, for a specific territory. This produces a
      * potentially empty list of mapcodes (empty if the lat/lon does not fall within the territory for mapcodes).
-     * <p/>
+     *
      * The returned result list will always contain at least 1 mapcode, because every lat/lon pair can be encoded.
-     * <p/>
+     *
      * The list is ordered in such a way that the first result contains the shortest mapcode (which is usually a
      * local mapcode).
      *
@@ -191,7 +191,7 @@ public static Mapcode encodeToInternational(
     /**
      * Decode a mapcode to a Point. The decoding process may fail for local mapcodes,
      * because no territory context is supplied (world-wide).
-     * <p/>
+     *
      * The accepted format is:
      * {mapcode}
      * {territory-code} {mapcode}
@@ -231,7 +231,7 @@ public static Point decode(
 
     /**
      * Decode a mapcode to a Point. A reference territory is supplied for disambiguation (only used if applicable).
-     * <p/>
+     *
      * The accepted format is:
      * {mapcode}        (note that a territory code is not allowed here)
      *

src/main/java/com/mapcode/ParentTerritory.java

@@ -22,7 +22,7 @@
  * ----------------------------------------------------------------------------------------------
  * Mapcode public interface.
  * ----------------------------------------------------------------------------------------------
- * <p/>
+ *
  * This class defines "parent territories" for territories that have multiple territory codes.
  */
 public enum ParentTerritory {

src/main/java/com/mapcode/Point.java

@@ -25,7 +25,7 @@
  * ----------------------------------------------------------------------------------------------
  * Package private implementation class. For internal use within the mapcode implementation only.
  * ----------------------------------------------------------------------------------------------
- * <p/>
+ *
  * This class defines a class for lat/lon points.
  */
 public class Point {

src/main/java/com/mapcode/Range.java

@@ -24,7 +24,7 @@
  * ----------------------------------------------------------------------------------------------
  * Package private implementation class. For internal use within the Mapcode implementation only.
  * ----------------------------------------------------------------------------------------------
- * <p/>
+ *
  * This class contains a class for dealing with ranges of comparable items.
  */
 class Range<T extends Comparable<T>> {

src/main/java/com/mapcode/SubArea.java

@@ -32,7 +32,7 @@
  * ----------------------------------------------------------------------------------------------
  * Package private implementation class. For internal use within the mapcode implementation only.
  * ----------------------------------------------------------------------------------------------
- * <p/>
+ *
  * This class contains a class that defines an area for local mapcodes.
  */
 class SubArea {

src/main/java/com/mapcode/Territory.java

@@ -30,7 +30,7 @@
  * ----------------------------------------------------------------------------------------------
  * Mapcode public interface.
  * ----------------------------------------------------------------------------------------------
- * <p/>
+ *
  * This class defines the available territory codes as used by mapcode.
  */
 public enum Territory {
@@ -657,13 +657,13 @@ public static Territory fromTerritoryCode(final int territoryCode) {
      * Get a territory from a mapcode territory abbreviation. Note that the provided abbreviation is NOT an
      * ISO code: it's a mapcode prefix. As local mapcodes for states have been optimized to prefer to use 2-character
      * state codes in local codes, states are preferred over countries in this case.
-     * <p/>
+     *
      * For example, fromString("AS") returns {@link Territory#IN_AS} rather than {@link Territory#ASM} and
      * fromString("BR") returns {@link Territory#IN_BR} rather than {@link Territory#BRA}.
-     * <p/>
+     *
      * This behavior is intentional as local mapcodes are designed to be as short as possible. A mapcode within
      * the Indian state Bihar should therefore be able to specified as "BR 49.46M3" rather "IN-BR 49.46M3".
-     * <p/>
+     *
      * Brazilian mapcodes, on the other hand, would be specified as "BRA BDHP.JK39-1D", using the ISO 3 letter code.
      *
      * @param name Territory name.