CDRIVER-1930 docs for client and client_session bulk setters

Author: jmikola

doc/mongoc_bulk_operation_set_client.rst

@@ -0,0 +1,29 @@
+:man_page: mongoc_bulk_operation_set_client
+
+mongoc_bulk_operation_set_client()
+==================================
+
+Synopsis
+--------
+
+.. code-block:: c
+
+  void
+  mongoc_bulk_operation_set_client (mongoc_bulk_operation_t *bulk, void *client);
+
+Parameters
+----------
+
+* ``bulk``: A :symbol:`mongoc_bulk_operation_t`.
+* ``client``: A :symbol:`mongoc_client_t`.
+
+Description
+-----------
+
+Specifies a client to use for the operation. This function has an effect only if called before :symbol:`mongoc_bulk_operation_execute`.
+
+If a :symbol:`mongoc_client_session_t` has already been assigned with :symbol:`mongoc_bulk_operation_set_client_session`, the ``client`` parameter must be the same as the :symbol:`mongoc_client_t` associated with that :symbol:`mongoc_client_session_t`.
+
+Use ``mongoc_bulk_operation_set_client`` only for building a language driver that wraps the C Driver. When writing applications in C, a client is implicitly set by :symbol:`mongoc_collection_create_bulk_operation_with_opts`.
+
+The ``client`` parameter's type is a void pointer by mistake, but it must be preserved for ABI. You must only pass a :symbol:`mongoc_client_t` pointer for ``client``.

doc/mongoc_bulk_operation_set_client_session.rst

@@ -0,0 +1,28 @@
+:man_page: mongoc_bulk_operation_set_client_session
+
+mongoc_bulk_operation_set_client_session()
+==========================================
+
+Synopsis
+--------
+
+.. code-block:: c
+
+  void
+  mongoc_bulk_operation_set_client_session (
+     mongoc_bulk_operation_t *bulk, mongoc_client_session_t *client_session);
+
+Parameters
+----------
+
+* ``bulk``: A :symbol:`mongoc_bulk_operation_t`.
+* ``client_session``: A :symbol:`mongoc_client_session_t`.
+
+Description
+-----------
+
+Specifies a client session to use for the operation. This function has an effect only if called before :symbol:`mongoc_bulk_operation_execute`.
+
+If a :symbol:`mongoc_client_t` has already been assigned with :symbol:`mongoc_bulk_operation_set_client`, the ``client_session`` parameter must be associated with the same :symbol:`mongoc_client_t`.
+
+Use ``mongoc_bulk_operation_set_client_session`` only for building a language driver that wraps the C Driver. When writing applications in C, a client session should be specified via :symbol:`mongoc_collection_create_bulk_operation_with_opts`.

doc/mongoc_bulk_operation_t.rst

@@ -49,6 +49,8 @@ See Also
     mongoc_bulk_operation_replace_one
     mongoc_bulk_operation_replace_one_with_opts
     mongoc_bulk_operation_set_bypass_document_validation
+    mongoc_bulk_operation_set_client
+    mongoc_bulk_operation_set_client_session
     mongoc_bulk_operation_set_hint
     mongoc_bulk_operation_update
     mongoc_bulk_operation_update_many_with_opts