caveats for database parameter in JavaDoc #1065

Author: ehennum

marklogic-client-api/src/main/java/com/marklogic/client/DatabaseClientFactory.java

@@ -1127,6 +1127,10 @@ static public DatabaseClient newClient(String host, int port) {
    * without any authentication. Such clients can be convenient for
    * experimentation but should not be used in production.
    *
+   * The CallManager interface can only call an endpoint for the configured content database
+   * of the appserver. You cannot specify the database when constructing a client for working
+   * with a CallManager.
+   *
    * @param host	the host with the REST server
    * @param port	the port for the REST server
    * @param database	the database to access (default: configured database for the REST server)
@@ -1171,6 +1175,10 @@ static public DatabaseClient newClient(String host, int port, SecurityContext se
   /**
    * Creates a client to access the database by means of a REST server.
    *
+   * The CallManager interface can only call an endpoint for the configured content database
+   * of the appserver. You cannot specify the database when constructing a client for working
+   * with a CallManager.
+   *
    * @param host the host with the REST server
    * @param port the port for the REST server
    * @param database the database to access (default: configured database for
@@ -1187,6 +1195,10 @@ static public DatabaseClient newClient(String host, int port, String database, S
   /**
    * Creates a client to access the database by means of a REST server.
    *
+   * The CallManager interface can only call an endpoint for the configured content database
+   * of the appserver. You cannot specify the database when constructing a client for working
+   * with a CallManager.
+   *
    * @param host the host with the REST server
    * @param port the port for the REST server
    * @param database the database to access (default: configured database for
@@ -1260,6 +1272,10 @@ static public DatabaseClient newClient(String host, int port, String user, Strin
   /**
    * Creates a client to access the database by means of a REST server.
    *
+   * The CallManager interface can only call an endpoint for the configured content database
+   * of the appserver. You cannot specify the database when constructing a client for working
+   * with a CallManager.
+   *
    * @param host	the host with the REST server
    * @param port	the port for the REST server
    * @param database	the database to access (default: configured database for the REST server)
@@ -1292,6 +1308,10 @@ static public DatabaseClient newClient(String host, int port, String user, Strin
   /**
    * Creates a client to access the database by means of a REST server.
    *
+   * The CallManager interface can only call an endpoint for the configured content database
+   * of the appserver. You cannot specify the database when constructing a client for working
+   * with a CallManager.
+   *
    * @param host	the host with the REST server
    * @param port	the port for the REST server
    * @param database	the database to access (default: configured database for the REST server)
@@ -1326,6 +1346,10 @@ static public DatabaseClient newClient(String host, int port, String user, Strin
   /**
    * Creates a client to access the database by means of a REST server.
    *
+   * The CallManager interface can only call an endpoint for the configured content database
+   * of the appserver. You cannot specify the database when constructing a client for working
+   * with a CallManager.
+   *
    * @param host	the host with the REST server
    * @param port	the port for the REST server
    * @param database	the database to access (default: configured database for the REST server)
@@ -1564,6 +1588,11 @@ public String getDatabase() {
     /**
      * Specifies the database for clients created with a
      * DatabaseClientFactory.Bean object.
+     *
+     * The CallManager interface can only call an endpoint for the configured content database
+     * of the appserver. You cannot specify the database when constructing a client for working
+     * with a CallManager.
+     *
      * @param database	a database to pass along to new DocumentManager and QueryManager instances
      */
     public void setDatabase(String database) {