DOCSP-29036: API files (#5)

* DOCSP-29036: API files

* more files

* more files

* client_t files

* mongoc_collection files

* mongoc_cursor files

* mongoc_database

* small changes to all

* more edits

* more api files

* delete files

* more edits

Author: norareidy

.DS_Store

@@ -0,0 +1,28 @@
+.. _mongoc_error_has_label:
+
+========================
+mongoc_error_has_label()
+========================
+
+Synopsis
+--------
+
+.. code-block:: c
+
+   bool
+   mongoc_error_has_label (const bson_t *reply, const char *label);
+
+Test whether a reply from a failed operation includes a specific error label. See
+:ref:`Error Labels <error_labels>` for details, and see :ref:`mongoc_client_session_start_transaction`
+for example code that demonstrates their use.
+
+Parameters
+----------
+
+- ``reply``: A ``bson_t-storage-ptr`` to contain the results.
+- ``label``: The label to test for, such as "TransientTransactionError" or "UnknownTransactionCommitResult".
+
+Returns
+-------
+
+Returns true if ``reply`` contains the error label.

source/.DS_Store

@@ -0,0 +1,13 @@
+.. _gridfs:
+
+======
+GridFS
+======
+
+The C driver includes two APIs for GridFS.
+
+The older API consists of :ref:`mongoc_gridfs_t` and its derivatives. It contains deprecated API, does not support read preferences, and is not recommended in new applications. It does not conform to the `MongoDB GridFS specification <https://github.com/mongodb/specifications/blob/master/source/gridfs/gridfs-spec.rst>`_.
+
+The newer API consists of :ref:`mongoc_gridfs_bucket_t` and allows uploading/downloading through derived :ref:`mongoc_stream_t` objects. It conforms to the `MongoDB GridFS specification <https://github.com/mongodb/specifications/blob/master/source/gridfs/gridfs-spec.rst>`_.
+
+There is not always a straightforward upgrade path from an application built with :ref:`mongoc_gridfs_t` to :ref:`mongoc_gridfs_bucket_t` (e.g. a :ref:`mongoc_gridfs_file_t` provides functions to seek but :ref:`mongoc_stream_t` does not). But users are encouraged to upgrade when possible.