Document reply for update_one and update_many

Author: jmikola

src/libmongoc/doc/mongoc_collection_update_many.rst

@@ -36,6 +36,8 @@ This function updates all documents in ``collection`` that match ``selector``.
 
 To update at most one document see :symbol:`mongoc_collection_update_one`.
 
+If you pass a non-NULL ``reply``, it is filled out with fields  ``matchedCount``, ``modifiedCount``, and optionally ``upsertedId`` if applicable. If there is a server error then ``reply`` contains either a "writeErrors" array with one subdocument or a "writeConcernErrors" array. The reply must be freed with :symbol:`bson:bson_destroy`.
+
 See Also
 --------
 
@@ -54,5 +56,3 @@ Returns
 Returns ``true`` if successful. Returns ``false`` and sets ``error`` if there are invalid arguments or a server or network error.
 
 A write concern timeout or write concern error is considered a failure.
-
-If provided, ``reply`` will be initialized and populated with the fields ``matchedCount``, ``modifiedCount``, and optionally ``upsertedId`` if applicable. The reply must be freed with :symbol:`bson:bson_destroy`.

src/libmongoc/doc/mongoc_collection_update_one.rst

@@ -36,6 +36,8 @@ This function updates at most one document in ``collection`` that matches ``sele
 
 To update multiple documents see :symbol:`mongoc_collection_update_many`.
 
+If you pass a non-NULL ``reply``, it is filled out with fields  ``matchedCount``, ``modifiedCount``, and optionally ``upsertedId`` if applicable. If there is a server error then ``reply`` contains either a "writeErrors" array with one subdocument or a "writeConcernErrors" array. The reply must be freed with :symbol:`bson:bson_destroy`.
+
 See Also
 --------
 
@@ -57,8 +59,6 @@ Returns ``true`` if successful. Returns ``false`` and sets ``error`` if there ar
 
 A write concern timeout or write concern error is considered a failure.
 
-If provided, ``reply`` will be initialized and populated with the fields ``matchedCount``, ``modifiedCount``, and optionally ``upsertedId`` if applicable. The reply must be freed with :symbol:`bson:bson_destroy`.
-
 Example
 -------
 .. literalinclude:: ../examples/example-update.c