javadoc: Un-declare javadoc params/throws without docs

And adjust javadoc lint to not complain about missing javadocs
And adjust javadoc lint to not complain about missing javadocs

Author: dsmiley

pom.xml

@@ -379,14 +379,15 @@
       <plugin>
         <groupId>org.apache.maven.plugins</groupId>
         <artifactId>maven-javadoc-plugin</artifactId>
-        <version>2.10.3</version>
+        <version>3.2.0</version>
         <configuration>
           <header>Spatial4j, ${project.version}</header>
           <footer>Spatial4j, ${project.version}</footer>
           <doctitle>Spatial4j, ${project.version}</doctitle>
           <links>
             <link>http://locationtech.github.io/jts/javadoc/</link>
           </links>
+          <doclint>all,-missing</doclint>
         </configuration>
         <!-- we exclude tests: -->
         <reportSets>

src/main/java/org/locationtech/spatial4j/context/SpatialContext.java

@@ -263,9 +263,7 @@ public Shape readShapeFromWkt(String wkt) throws ParseException, InvalidShapeExc
   /**
    * Try to read a shape from any supported formats
    * 
-   * @param value
    * @return shape or null if unable to parse any shape
-   * @throws InvalidShapeException
    */
   @Deprecated
   public Shape readShape(String value) throws InvalidShapeException {

src/main/java/org/locationtech/spatial4j/distance/DistanceUtils.java

@@ -163,7 +163,6 @@ public static double[] vectorBoxCorner(double[] center, double[] result, double
    * @param startLon The starting point longitude, in radians
    * @param distanceRAD The distance to travel along the bearing in radians.
    * @param bearingRAD The bearing, in radians.  North is a 0, moving clockwise till radians(360).
-   * @param ctx
    * @param reuse A preallocated object to hold the results.
    * @return The destination point, IN RADIANS.
    */

src/main/java/org/locationtech/spatial4j/io/ShapeReader.java

@@ -40,9 +40,6 @@ public interface ShapeReader extends ShapeIO {
    * 
    * @param reader -- the input. Note, it will not be closed by this function
    * @return a valid Shape (never null)
-   * @throws IOException
-   * @throws ParseException
-   * @throws InvalidShapeException
    */
   public Shape read(Reader reader) throws IOException, ParseException, InvalidShapeException;
 }

src/main/java/org/locationtech/spatial4j/io/WKTReader.java

@@ -145,7 +145,6 @@ protected State newState(String wktString) {
    * dimension and EMPTY token via
    * {@link org.locationtech.spatial4j.io.WKTReader.State#nextIfEmptyAndSkipZM()}.
    *
-   * @param state
    * @param shapeType Non-Null string; could have mixed case. The first character is a letter.
    * @return The shape or null if not supported / unknown.
    */

src/main/java/org/locationtech/spatial4j/io/jts/JtsWKTReaderShapeParser.java

@@ -53,7 +53,7 @@ private JtsShapeFactory getShapeFactory() {
 
   /**
    * Reads WKT from the {@code str} via JTS's {@link org.locationtech.jts.io.WKTReader}.
-   * @param str
+   *
    * @param reader <pre>new WKTReader(ctx.getGeometryFactory()))</pre>
    * @return Non-Null
    */

src/main/java/org/locationtech/spatial4j/shape/Shape.java

@@ -75,8 +75,6 @@ public interface Shape {
    * rounded-corner buffer, although some shapes might buffer differently. This
    * is an optional operation.
    *
-   *
-   * @param distance
    * @return Not null, and the returned shape should contain the current shape.
    */
   Shape getBuffered(double distance, SpatialContext ctx);

src/main/java/org/locationtech/spatial4j/shape/ShapeCollection.java

@@ -44,7 +44,6 @@ public class ShapeCollection<S extends Shape> extends AbstractList<S> implements
   /**
    * WARNING: {@code shapes} is copied by reference.
    * @param shapes Copied by reference! (make a defensive copy if caller modifies)
-   * @param ctx
    */
   public ShapeCollection(List<S> shapes, SpatialContext ctx) {
     if (!(shapes instanceof RandomAccess))

src/main/java/org/locationtech/spatial4j/shape/impl/BufferedLine.java

@@ -49,7 +49,6 @@ public class BufferedLine extends BaseShape<SpatialContext> {
    * @param pA  start point
    * @param pB  end point
    * @param buf the buffer distance in degrees
-   * @param ctx
    */
   public BufferedLine(Point pA, Point pB, double buf, SpatialContext ctx) {
     super(ctx);

src/main/java/org/locationtech/spatial4j/shape/impl/BufferedLineString.java

@@ -50,7 +50,6 @@ public BufferedLineString(List<Point> points, double buf, SpatialContext ctx) {
    * org.locationtech.spatial4j.shape.Point, double)}.
    *                                  If true then the buffer for each segment
    *                                  is computed.
-   * @param ctx
    */
   public BufferedLineString(List<Point> points, double buf, boolean expandBufForLongitudeSkew,
                             SpatialContext ctx) {