actually fix rustdoc

Author: abr-egn

src/binary/vector.rs

@@ -30,10 +30,10 @@ const PACKED_BIT: u8 = 0x10;
 /// }
 ///
 /// let data = Data { vector: Vector::Int8(vec![0, 1, 2]) };
-/// let document = bson::to_document(&data).unwrap();
+/// let document = bson::serialize_to_document(&data).unwrap();
 /// assert_eq!(document.get("vector").unwrap().element_type(), ElementType::Binary);
 ///
-/// let data: Data = bson::from_document(document).unwrap();
+/// let data: Data = bson::deserialize_from_document(document).unwrap();
 /// assert_eq!(data.vector, Vector::Int8(vec![0, 1, 2]));
 /// ```
 ///

src/datetime.rs

@@ -73,7 +73,7 @@ use serde::{Deserialize, Deserializer, Serialize};
 ///
 /// # fn main() -> bson::ser::Result<()> {
 /// let f = Foo { date_time: bson::DateTime::now(), chrono_datetime: chrono::Utc::now() };
-/// println!("{:?}", bson::to_document(&f)?);
+/// println!("{:?}", bson::serialize_to_document(&f)?);
 /// # Ok(())
 /// # }
 /// ```
@@ -170,7 +170,7 @@ use serde::{Deserialize, Deserializer, Serialize};
 ///   "as_bson": bson::DateTime::from_chrono(dt),
 /// };
 ///
-/// assert_eq!(bson::to_document(&foo)?, expected);
+/// assert_eq!(bson::serialize_to_document(&foo)?, expected);
 /// # }
 /// # Ok::<(), Box<dyn std::error::Error>>(())
 /// ```

src/document.rs

@@ -690,7 +690,7 @@ impl Document {
     ///
     /// let mut v: Vec<u8> = Vec::new();
     /// let doc = doc! { "x" : 1 };
-    /// doc.to_writer(&mut v)?;
+    /// doc.encode_to_writer(&mut v)?;
     /// # Ok(())
     /// # }
     /// ```
@@ -714,14 +714,14 @@ impl Document {
     ///
     /// let mut v: Vec<u8> = Vec::new();
     /// let doc = doc! { "x" : 1 };
-    /// doc.to_writer(&mut v)?;
+    /// doc.encode_to_writer(&mut v)?;
     ///
     /// // read from mutable reference
     /// let mut reader = Cursor::new(v.clone());
-    /// let doc1 = Document::from_reader(&mut reader)?;
+    /// let doc1 = Document::decode_from_reader(&mut reader)?;
     ///
     /// // read from owned value
-    /// let doc2 = Document::from_reader(Cursor::new(v))?;
+    /// let doc2 = Document::decode_from_reader(Cursor::new(v))?;
     ///
     /// assert_eq!(doc, doc1);
     /// assert_eq!(doc, doc2);

src/lib.rs

@@ -132,7 +132,7 @@
 //! use std::io::Read;
 //!
 //! let mut bytes = hex::decode("0C0000001069000100000000").unwrap();
-//! let doc = Document::from_reader(&mut bytes.as_slice()).unwrap(); // { "i": 1 }
+//! let doc = Document::decode_from_reader(&mut bytes.as_slice()).unwrap(); // { "i": 1 }
 //!
 //! let doc = doc! {
 //!    "hello": "world",
@@ -200,14 +200,14 @@
 //! // Deserialize the Person struct from the BSON data, automatically
 //! // verifying that the necessary keys are present and that they are of
 //! // the correct types.
-//! let mut person: Person = bson::from_bson(bson_data).unwrap();
+//! let mut person: Person = bson::deserialize_from_bson(bson_data).unwrap();
 //!
 //! // Do things just like with any other Rust data structure.
 //! println!("Redacting {}'s record.", person.name);
 //! person.name = "REDACTED".to_string();
 //!
 //! // Get a serialized version of the input data as a [`Bson`].
-//! let redacted_bson = bson::to_bson(&person).unwrap();
+//! let redacted_bson = bson::serialize_to_bson(&person).unwrap();
 //! ```
 //!
 //! Any types that implement [`Serialize`](serde::Serialize) and [`Deserialize`](serde::Deserialize)

src/oid.rs

@@ -92,7 +92,7 @@ impl error::Error for Error {}
 ///
 /// # fn main() -> std::result::Result<(), Box<dyn std::error::Error>> {
 /// let f = Foo { oid: ObjectId::new() };
-/// println!("bson: {}", bson::to_document(&f)?);
+/// println!("bson: {}", bson::serialize_to_document(&f)?);
 /// println!("json: {}", serde_json::to_string(&f)?);
 /// # Ok(())
 /// # }
@@ -127,7 +127,7 @@ impl error::Error for Error {}
 /// }
 /// # fn main() -> std::result::Result<(), Box<dyn std::error::Error>> {
 /// let f = Foo { oid: ObjectId::new(), oid_as_hex: ObjectId::new() };
-/// println!("bson: {}", bson::to_document(&f)?);
+/// println!("bson: {}", bson::serialize_to_document(&f)?);
 /// println!("json: {}", serde_json::to_string(&f)?);
 /// # Ok(())
 /// # }

src/raw.rs

@@ -23,7 +23,7 @@
 //! };
 //!
 //! // See http://bsonspec.org/spec.html for details on the binary encoding of BSON.
-//! let doc = RawDocumentBuf::from_bytes(b"\x13\x00\x00\x00\x02hi\x00\x06\x00\x00\x00y'all\x00\x00".to_vec())?;
+//! let doc = RawDocumentBuf::decode_from_bytes(b"\x13\x00\x00\x00\x02hi\x00\x06\x00\x00\x00y'all\x00\x00".to_vec())?;
 //! let elem = doc.get("hi")?.unwrap();
 //!
 //! assert_eq!(
@@ -76,7 +76,7 @@
 //! use bson::raw::RawDocument;
 //!
 //! let bytes = b"\x13\x00\x00\x00\x02hi\x00\x06\x00\x00\x00y'all\x00\x00";
-//! assert_eq!(RawDocument::from_bytes(bytes)?.get_str("hi")?, "y'all");
+//! assert_eq!(RawDocument::decode_from_bytes(bytes)?.get_str("hi")?, "y'all");
 //! # Ok::<(), Box<dyn std::error::Error>>(())
 //! ```
 //!

src/raw/array.rs

@@ -37,9 +37,9 @@ use crate::{
 /// let doc = doc! {
 ///     "x": [1, true, "two", 5.5]
 /// };
-/// let bytes = bson::to_vec(&doc)?;
+/// let bytes = bson::serialize_to_vec(&doc)?;
 ///
-/// let rawdoc = RawDocument::from_bytes(bytes.as_slice())?;
+/// let rawdoc = RawDocument::decode_from_bytes(bytes.as_slice())?;
 /// let rawarray = rawdoc.get_array("x")?;
 ///
 /// for v in rawarray {
@@ -59,9 +59,9 @@ use crate::{
 /// let doc = doc! {
 ///     "x": [1, true, "two", 5.5]
 /// };
-/// let bytes = bson::to_vec(&doc)?;
+/// let bytes = doc.encode_to_vec()?;
 ///
-/// let rawdoc = RawDocument::from_bytes(bytes.as_slice())?;
+/// let rawdoc = RawDocument::decode_from_bytes(bytes.as_slice())?;
 /// let rawarray = rawdoc.get_array("x")?;
 ///
 /// assert_eq!(rawarray.get_bool(1)?, true);

src/raw/document.rs

@@ -46,7 +46,7 @@ use crate::{oid::ObjectId, spec::ElementType, Document};
 /// # use bson::error::Error;
 /// use bson::raw::RawDocument;
 ///
-/// let doc = RawDocument::from_bytes(b"\x13\x00\x00\x00\x02hi\x00\x06\x00\x00\x00y'all\x00\x00")?;
+/// let doc = RawDocument::decode_from_bytes(b"\x13\x00\x00\x00\x02hi\x00\x06\x00\x00\x00y'all\x00\x00")?;
 /// let mut iter = doc.into_iter();
 /// let (key, value) = iter.next().unwrap()?;
 /// assert_eq!(key, "hi");
@@ -63,7 +63,7 @@ use crate::{oid::ObjectId, spec::ElementType, Document};
 /// ```
 /// use bson::raw::RawDocument;
 ///
-/// let doc = RawDocument::from_bytes(b"\x13\x00\x00\x00\x02hi\x00\x06\x00\x00\x00y'all\x00\x00")?;
+/// let doc = RawDocument::decode_from_bytes(b"\x13\x00\x00\x00\x02hi\x00\x06\x00\x00\x00y'all\x00\x00")?;
 /// assert_eq!(doc.get_str("hi")?, "y'all");
 /// # Ok::<(), Box<dyn std::error::Error>>(())
 /// ```
@@ -89,7 +89,7 @@ impl RawDocument {
     /// ```
     /// use bson::raw::RawDocument;
     ///
-    /// let doc = RawDocument::from_bytes(b"\x05\0\0\0\0")?;
+    /// let doc = RawDocument::decode_from_bytes(b"\x05\0\0\0\0")?;
     /// # Ok::<(), bson::error::Error>(())
     /// ```
     pub fn decode_from_bytes<D: AsRef<[u8]> + ?Sized>(data: &D) -> RawResult<&RawDocument> {
@@ -132,7 +132,7 @@ impl RawDocument {
     /// use bson::raw::{RawDocument, RawDocumentBuf};
     ///
     /// let data = b"\x05\0\0\0\0";
-    /// let doc_ref = RawDocument::from_bytes(data)?;
+    /// let doc_ref = RawDocument::decode_from_bytes(data)?;
     /// let doc: RawDocumentBuf = doc_ref.to_raw_document_buf();
     /// # Ok::<(), bson::error::Error>(())
     pub fn to_raw_document_buf(&self) -> RawDocumentBuf {

src/raw/document_buf.rs

@@ -24,7 +24,7 @@ mod raw_writer;
 /// # use bson::error::Error;
 /// use bson::raw::RawDocumentBuf;
 ///
-/// let doc = RawDocumentBuf::from_bytes(b"\x13\x00\x00\x00\x02hi\x00\x06\x00\x00\x00y'all\x00\x00".to_vec())?;
+/// let doc = RawDocumentBuf::decode_from_bytes(b"\x13\x00\x00\x00\x02hi\x00\x06\x00\x00\x00y'all\x00\x00".to_vec())?;
 /// let mut iter = doc.iter();
 /// let (key, value) = iter.next().unwrap()?;
 /// assert_eq!(key, "hi");
@@ -42,7 +42,7 @@ mod raw_writer;
 /// ```
 /// use bson::raw::RawDocumentBuf;
 ///
-/// let doc = RawDocumentBuf::from_bytes(b"\x13\x00\x00\x00\x02hi\x00\x06\x00\x00\x00y'all\x00\x00".to_vec())?;
+/// let doc = RawDocumentBuf::decode_from_bytes(b"\x13\x00\x00\x00\x02hi\x00\x06\x00\x00\x00y'all\x00\x00".to_vec())?;
 /// assert_eq!(doc.get_str("hi")?, "y'all");
 /// # Ok::<(), Box<dyn std::error::Error>>(())
 /// ```
@@ -74,7 +74,7 @@ impl RawDocumentBuf {
     ///
     /// ```
     /// # use bson::raw::RawDocumentBuf;
-    /// let doc = RawDocumentBuf::from_bytes(b"\x05\0\0\0\0".to_vec())?;
+    /// let doc = RawDocumentBuf::decode_from_bytes(b"\x05\0\0\0\0".to_vec())?;
     /// # Ok::<(), bson::error::Error>(())
     /// ```
     pub fn decode_from_bytes(data: Vec<u8>) -> Result<Self> {

src/ser.rs

@@ -172,7 +172,7 @@ where
 /// }
 ///
 /// let cat = Cat { name: "Garfield".to_string(), age: 43 };
-/// let doc = bson::to_raw_document_buf(&cat)?;
+/// let doc = bson::serialize_to_raw_document_buf(&cat)?;
 /// assert_eq!(doc, rawdoc! { "name": "Garfield", "age": 43 });
 /// # Ok::<(), Box<dyn std::error::Error>>(())
 /// ```