CDRIVER-2838 Document ObjectID unsafe functions (#1428)

Document BSON ObjectID unsafe functions

Author: adriandole

src/libbson/doc/bson_oid_compare_unsafe.rst

@@ -0,0 +1,17 @@
+:man_page: bson_oid_compare_unsafe
+
+bson_oid_compare_unsafe()
+=========================
+
+Synopsis
+--------
+
+.. code-block:: c
+
+  static inline int
+  bson_oid_compare_unsafe (const bson_oid_t *oid1, const bson_oid_t *oid2);
+
+Description
+-----------
+
+Identical to :symbol:`bson_oid_compare()`, but performs no integrity checking.

src/libbson/doc/bson_oid_copy_unsafe.rst

@@ -0,0 +1,17 @@
+:man_page: bson_oid_copy_unsafe
+
+bson_oid_copy_unsafe()
+======================
+
+Synopsis
+--------
+
+.. code-block:: c
+
+  static inline void
+  bson_oid_copy_unsafe (const bson_oid_t *src, bson_oid_t *dst);
+
+Description
+-----------
+
+Identical to :symbol:`bson_oid_copy()`, but performs no integrity checking.

src/libbson/doc/bson_oid_equal_unsafe.rst

@@ -0,0 +1,17 @@
+:man_page: bson_oid_equal_unsafe
+
+bson_oid_equal_unsafe()
+=======================
+
+Synopsis
+--------
+
+.. code-block:: c
+
+  static inline bool
+  bson_oid_equal_unsafe (const bson_oid_t *oid1, const bson_oid_t *oid2);
+
+Description
+-----------
+
+Identical to :symbol:`bson_oid_equal()`, but performs no integrity checking.

src/libbson/doc/bson_oid_get_time_t_unsafe.rst

@@ -0,0 +1,17 @@
+:man_page: bson_oid_get_time_t_unsafe
+
+bson_oid_get_time_t_unsafe()
+============================
+
+Synopsis
+--------
+
+.. code-block:: c
+
+  static inline time_t
+  bson_oid_get_time_t_unsafe (const bson_oid_t *oid);
+
+Description
+-----------
+
+Identical to :symbol:`bson_oid_get_time_t()`, but performs no integrity checking.

src/libbson/doc/bson_oid_hash_unsafe.rst

@@ -0,0 +1,17 @@
+:man_page: bson_oid_hash_unsafe
+
+bson_oid_hash_unsafe()
+======================
+
+Synopsis
+--------
+
+.. code-block:: c
+
+  static inline uint32_t
+  bson_oid_hash_unsafe (const bson_oid_t *oid);
+
+Description
+-----------
+
+Identical to :symbol:`bson_oid_hash()`, but performs no integrity checking.

src/libbson/doc/bson_oid_init_from_string_unsafe.rst

@@ -0,0 +1,17 @@
+:man_page: bson_oid_init_from_string_unsafe
+
+bson_oid_init_from_string_unsafe()
+==================================
+
+Synopsis
+--------
+
+.. code-block:: c
+
+  static inline void
+  bson_oid_init_from_string_unsafe (bson_oid_t *oid, const char *str);
+
+Description
+-----------
+
+Identical to :symbol:`bson_oid_init_from_string()`, but performs no integrity checking.

src/libbson/doc/bson_oid_t.rst

@@ -57,13 +57,19 @@ You can validate that a string containing a hex-encoded ObjectID is valid using
     :maxdepth: 1
 
     bson_oid_compare
+    bson_oid_compare_unsafe
     bson_oid_copy
+    bson_oid_copy_unsafe
     bson_oid_equal
+    bson_oid_equal_unsafe
     bson_oid_get_time_t
+    bson_oid_get_time_t_unsafe
     bson_oid_hash
+    bson_oid_hash_unsafe
     bson_oid_init
     bson_oid_init_from_data
     bson_oid_init_from_string
+    bson_oid_init_from_string_unsafe
     bson_oid_init_sequence
     bson_oid_is_valid
     bson_oid_to_string