annotation fixup and links to wiki in JavaDoc #1250

Author: ehennum

marklogic-client-api/src/main/java/com/marklogic/client/datamovement/RowBatcher.java

@@ -96,6 +96,7 @@
  * <p>Specify a failure listener to handle any errors during retrieval.</p>
  *
  * @param <T> the Java class that stores a batch of retrieved roles
+ * @see <a href="https://github.com/marklogic/java-client-api/wiki/Row-Batcher">Exporting a TDE View</a>
  */
 public interface RowBatcher<T> extends Batcher {
     /**

marklogic-client-api/src/main/java/com/marklogic/client/dataservices/ExecCaller.java

@@ -22,6 +22,8 @@
 /**
  * Provides an interface for calling an endpoint that doesn't take
  * input data structures or return output data structures.
+ *
+ * @see <a href="https://github.com/marklogic/java-client-api/wiki/Data-Services-for-IO#exec-endpoints">Exec endpoints</a>
  */
 public interface ExecCaller extends IOEndpoint {
     /**
@@ -80,6 +82,8 @@ static ExecCaller on(DatabaseClient client, JSONWriteHandle apiDecl) {
      * data structure or return output data structures.
      *
      * Call awaitCompletion() to start making calls.
+     *
+     * @see <a href="https://github.com/marklogic/java-client-api/wiki/Bulk-Data-Services">Bulk Data Services</a>
      */
     interface BulkExecCaller extends BulkIOEndpointCaller {
         void setErrorListener(ErrorListener errorListener);

marklogic-client-api/src/main/java/com/marklogic/client/dataservices/InputCaller.java

@@ -23,6 +23,9 @@
 
 /**
  * Provides an interface for calling an endpoint that takes input data structures.
+ *
+ * @param <I>  The representation for document input
+ * @see <a href="https://github.com/marklogic/java-client-api/wiki/Data-Services-for-IO#input-endpoints">Input endpoints</a>
  */
 public interface InputCaller<I> extends IOEndpoint {
 	/**
@@ -79,9 +82,12 @@ static <I> InputCaller<I> on(DatabaseClient client, JSONWriteHandle apiDecl, Buf
 	BulkInputCaller<I> bulkCaller(CallContext[] callContexts, int threadCount);
 
 	/**
-     * Provides an interface for completing a unit of work
-     * by repeated calls to the input endpoint.
-     */
+	 * Provides an interface for completing a unit of work
+	 * by repeated calls to the input endpoint.
+	 *
+	 * @param <I>  The representation for document input
+	 * @see <a href="https://github.com/marklogic/java-client-api/wiki/Bulk-Data-Services">Bulk Data Services</a>
+	 */
 	interface BulkInputCaller<I> extends BulkIOEndpointCaller {
 		/**
 		 * Accepts an input item for the endpoint.  Items are queued

marklogic-client-api/src/main/java/com/marklogic/client/dataservices/InputEndpoint.java

@@ -78,6 +78,7 @@ private BulkLocal(EndpointLocal<O> endpoint) {
      * Provides an interface for completing a unit of work
      * by repeated calls to the input endpoint.
      */
+	@Deprecated
 	interface BulkInputCaller extends InputCaller.BulkInputCaller<InputStream> {
 	}
 }

marklogic-client-api/src/main/java/com/marklogic/client/dataservices/InputOutputCaller.java

@@ -26,6 +26,10 @@
 /**
  * Provides an interface for calling an endpoint that takes input data structures and
  * returns output data structures.
+ *
+ * @param <I>  The representation for document input
+ * @param <O> The representation for document output
+ * @see <a href="https://github.com/marklogic/java-client-api/wiki/Data-Services-for-IO#input-output-endpoints">Input-output endpoints</a>
  */
 public interface InputOutputCaller<I,O> extends IOEndpoint {
     /**
@@ -92,6 +96,10 @@ static <I,O> InputOutputCaller<I,O> on(
     /**
      * Provides an interface for completing a unit of work
      * by repeated calls to the input-output endpoint.
+     *
+     * @param <I>  The representation for document input
+     * @param <O> The representation for document output
+     * @see <a href="https://github.com/marklogic/java-client-api/wiki/Bulk-Data-Services">Bulk Data Services</a>
      */
     interface BulkInputOutputCaller<I,O> extends BulkIOEndpointCaller {
         /**

marklogic-client-api/src/main/java/com/marklogic/client/dataservices/OutputCaller.java

@@ -24,6 +24,9 @@
 
 /**
  * Provides an interface for calling an endpoint that returns output data structures.
+ *
+ * @param <O> The representation for document output
+ * @see <a href="https://github.com/marklogic/java-client-api/wiki/Data-Services-for-IO#output-endpoints">Output endpoints</a>
  */
 public interface OutputCaller<O> extends IOEndpoint {
     /**
@@ -84,6 +87,9 @@ static <O> OutputCaller<O> on(
     /**
      * Provides an interface for completing a unit of work
      * by repeated calls to the output endpoint.
+     *
+     * @param <O> The representation for document output
+     * @see <a href="https://github.com/marklogic/java-client-api/wiki/Bulk-Data-Services">Bulk Data Services</a>
      */
     interface BulkOutputCaller<O> extends BulkIOEndpointCaller {
         /**