corrected several JavaDoc issues

Author: scarytom

src/main/java/com/timgroup/statsd/NonBlockingStatsDClient.java

@@ -203,7 +203,7 @@ public void recordGaugeValue(String aspect, int value) {
     }
 
     /**
-     * Convenience method equivalent to {@link #recordGaugeValue(String)}. 
+     * Convenience method equivalent to {@link #recordGaugeValue(String, int)}. 
      */
     @Override
     public void gauge(String aspect, int value) {
@@ -226,7 +226,7 @@ public void recordExecutionTime(String aspect, int timeInMs) {
     }
 
     /**
-     * Convenience method equivalent to {@link #recordExecutionTime(String)}. 
+     * Convenience method equivalent to {@link #recordExecutionTime(String, int)}. 
      */
     @Override
     public void time(String aspect, int value) {

src/main/java/com/timgroup/statsd/StatsDClient.java

@@ -4,6 +4,14 @@
  * Describes a client connection to a StatsD server, which may be used to post metrics
  * in the form of counters, timers, and gauges.
  * 
+ * <p>Three key methods are provided for the submission of data-points for the application under
+ * scrutiny:
+ * <ul>
+ *   <li>{@link #incrementCounter} - adds one to the value of the specified named counter</li>
+ *   <li>{@link #recordGaugeValue} - records the latest fixed value for the specified named gauge</li>
+ *   <li>{@link #recordExecutionTime} - records an execution time in milliseconds for the specified named operation</li>
+ * </ul>
+ * 
  * @author Tom Denley
  *
  */
@@ -70,7 +78,7 @@ public interface StatsDClient {
     void recordGaugeValue(String aspect, int value);
 
     /**
-     * Convenience method equivalent to {@link #recordGaugeValue(String)}. 
+     * Convenience method equivalent to {@link #recordGaugeValue(String, int)}. 
      */
     void gauge(String aspect, int value);
 
@@ -87,7 +95,7 @@ public interface StatsDClient {
     void recordExecutionTime(String aspect, int timeInMs);
 
     /**
-     * Convenience method equivalent to {@link #recordExecutionTime(String)}. 
+     * Convenience method equivalent to {@link #recordExecutionTime(String, int)}. 
      */
     void time(String aspect, int value);
 

src/main/java/com/timgroup/statsd/StatsDClientErrorHandler.java

@@ -14,6 +14,6 @@ public interface StatsDClientErrorHandler {
      * @param exception
      *     the {@link Exception} that occurred
      */
-    void handle(Exception e);
+    void handle(Exception exception);
 
 }