JAVA-2250: Remove references to the getlasterror command in Javadoc, replacing with generic reference to write commands

Author: jyemin

driver-core/src/main/com/mongodb/ConnectionString.java

@@ -106,9 +106,9 @@
  * <ul>
  * <li>{@code safe=true|false}
  * <ul>
- * <li>{@code true}: the driver sends a getLastError command after every update to ensure that the update succeeded
+ * <li>{@code true}: the driver ensures that all writes are acknowledged by the MongoDB server, or else throws an exception.
  * (see also {@code w} and {@code wtimeoutMS}).</li>
- * <li>{@code false}: the driver does not send a getLastError command after every update.</li>
+ * <li>{@code false}: the driver does not ensure that all writes are acknowledged by the MongoDB server.</li>
  * </ul>
  * </li>
  * <li>{@code journal=true|false}
@@ -119,14 +119,14 @@
  * </li>
  * <li>{@code w=wValue}
  * <ul>
- * <li>The driver adds { w : wValue } to the getLastError command. Implies {@code safe=true}.</li>
+ * <li>The driver adds { w : wValue } to all write commands. Implies {@code safe=true}.</li>
  * <li>wValue is typically a number, but can be any string in order to allow for specifications like
  * {@code "majority"}</li>
  * </ul>
  * </li>
  * <li>{@code wtimeoutMS=ms}
  * <ul>
- * <li>The driver adds { wtimeout : ms } to the getlasterror command. Implies {@code safe=true}.</li>
+ * <li>The driver adds { wtimeout : ms } to all write commands. Implies {@code safe=true}.</li>
  * <li>Used in combination with {@code w}</li>
  * </ul>
  * </li>

driver-core/src/main/com/mongodb/WriteConcern.java

@@ -426,7 +426,7 @@ public boolean fsync() {
     }
 
     /**
-     * Returns whether "getlasterror" should be called (w > 0)
+     * Returns true if this write concern indicates that write operations must be acknowledged.
      *
      * @return whether this write concern will result in an an acknowledged write
      * @deprecated Prefer {@link #isAcknowledged()}

driver-core/src/main/com/mongodb/WriteConcernException.java

@@ -50,7 +50,7 @@ public WriteConcernException(final BsonDocument response, final ServerAddress ad
     }
 
     /**
-     * For internal use only: extract the error code from the response to a getlasterror command.
+     * For internal use only: extract the error code from the response to a write command.
      * @param response the response
      * @return the code, or -1 if there is none
      */
@@ -63,7 +63,7 @@ public static int extractErrorCode(final BsonDocument response) {
             }
         }
 
-        // mongos may return a list of documents representing getlasterror responses from each shard.  Return the one with a matching
+        // mongos may return a list of documents representing write command responses from each shard.  Return the one with a matching
         // "err" field, so that it can be used to get the error code
         if (!response.containsKey("code") && response.containsKey("errObjects")) {
             for (BsonValue curErrorDocument : response.getArray("errObjects")) {
@@ -76,7 +76,7 @@ public static int extractErrorCode(final BsonDocument response) {
     }
 
     /**
-     * For internal use only: extract the error message from the response to a getlasterror command.
+     * For internal use only: extract the error message from the response to a write command.
      *
      * @param response the response
      * @return the error message

driver/src/main/com/mongodb/MongoClientURI.java

@@ -84,9 +84,9 @@
  * <ul>
  *  <li>{@code safe=true|false}
  *      <ul>
- *          <li>{@code true}: the driver sends a getLastError command after every update to ensure that the update succeeded
+ *          <li>{@code true}: the driver ensures that all writes are acknowledged by the MongoDB server, or else throws an exception.
  * (see also {@code w} and {@code wtimeoutMS}).</li>
- *          <li>{@code false}: the driver does not send a getLastError command after every update.</li>
+ *          <li>{@code false}: the driver does not ensure that all writes are acknowledged by the MongoDB server.</li>
  *      </ul>
  *  </li>
  * <li>{@code journal=true|false}
@@ -97,14 +97,14 @@
  * </li>
  *  <li>{@code w=wValue}
  *      <ul>
- *          <li>The driver adds { w : wValue } to the getLastError command. Implies {@code safe=true}.</li>
+ *          <li>The driver adds { w : wValue } to all write commands. Implies {@code safe=true}.</li>
  *          <li>wValue is typically a number, but can be any string in order to allow for specifications like
  * {@code "majority"}</li>
  *      </ul>
  *  </li>
  *  <li>{@code wtimeoutMS=ms}
  *      <ul>
- *          <li>The driver adds { wtimeout : ms } to the getlasterror command. Implies {@code safe=true}.</li>
+ *          <li>The driver adds { wtimeout : ms } to all write commands. Implies {@code safe=true}.</li>
  *          <li>Used in combination with {@code w}</li>
  *      </ul>
  *  </li>