From 56ae019a0948d748989d5b65b8a9a3b2d6a7b78d Mon Sep 17 00:00:00 2001
From: David Tolnay <dtolnay@gmail.com>
Date: Sun, 10 May 2020 13:33:00 -0700
Subject: [PATCH] Make mapping module public

---
 src/lib.rs     | 6 ++++--
 src/mapping.rs | 5 +++++
 2 files changed, 9 insertions(+), 2 deletions(-)

diff --git a/src/lib.rs b/src/lib.rs
index 6a76049b..84c4296b 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -88,10 +88,12 @@
 
 pub use crate::de::{from_reader, from_slice, from_str};
 pub use crate::error::{Error, Location, Result};
-pub use crate::mapping::Mapping;
 pub use crate::ser::{to_string, to_vec, to_writer};
 pub use crate::value::{from_value, to_value, Index, Number, Sequence, Value};
 
+#[doc(inline)]
+pub use crate::mapping::Mapping;
+
 /// Entry points for deserializing with pre-existing state.
 ///
 /// These functions are only exposed this way because we don't yet expose a
@@ -103,7 +105,7 @@ pub mod seed {
 
 mod de;
 mod error;
-mod mapping;
+pub mod mapping;
 mod number;
 mod path;
 mod ser;
diff --git a/src/mapping.rs b/src/mapping.rs
index 04388e7f..0786516e 100644
--- a/src/mapping.rs
+++ b/src/mapping.rs
@@ -1,3 +1,5 @@
+//! A YAML mapping and its iterator types.
+
 use crate::Value;
 use linked_hash_map::LinkedHashMap;
 use serde::{Deserialize, Deserializer, Serialize};
@@ -175,6 +177,7 @@ macro_rules! delegate_iterator {
     }
 }
 
+/// Iterator over `&serde_yaml::Mapping`.
 pub struct Iter<'a> {
     iter: linked_hash_map::Iter<'a, Value, Value>,
 }
@@ -192,6 +195,7 @@ impl<'a> IntoIterator for &'a Mapping {
     }
 }
 
+/// Iterator over `&mut serde_yaml::Mapping`.
 pub struct IterMut<'a> {
     iter: linked_hash_map::IterMut<'a, Value, Value>,
 }
@@ -209,6 +213,7 @@ impl<'a> IntoIterator for &'a mut Mapping {
     }
 }
 
+/// Iterator over `serde_yaml::Mapping` by value.
 pub struct IntoIter {
     iter: linked_hash_map::IntoIter<Value, Value>,
 }