From 170f87ef0fe757b10d233c0bc3762b0c466c1056 Mon Sep 17 00:00:00 2001
From: Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
Date: Tue, 31 Jul 2018 23:47:55 +0200
Subject: [PATCH] roster: Finish to document this module.

---
 src/roster.rs | 35 +++++++++++++++++++++++++++--------
 1 file changed, 27 insertions(+), 8 deletions(-)

diff --git a/src/roster.rs b/src/roster.rs
index bbd0c399..66a61882 100644
--- a/src/roster.rs
+++ b/src/roster.rs
@@ -4,18 +4,37 @@
 // License, v. 2.0. If a copy of the MPL was not distributed with this
 // file, You can obtain one at http://mozilla.org/MPL/2.0/.
 
+#![deny(missing_docs)]
+
 use jid::Jid;
 use iq::{IqGetPayload, IqSetPayload, IqResultPayload};
 
-generate_elem_id!(Group, "group", ROSTER);
+generate_elem_id!(
+    /// Represents a group a contact is part of.
+    Group, "group", ROSTER
+);
 
-generate_attribute!(Subscription, "subscription", {
-    None => "none",
-    From => "from",
-    To => "to",
-    Both => "both",
-    Remove => "remove",
-}, Default = None);
+generate_attribute!(
+    /// The state of your mutual subscription with a contact.
+    Subscription, "subscription", {
+        /// The user doesn’t have any subscription to this contact’s presence,
+        /// and neither does this contact.
+        None => "none",
+
+        /// Only this contact has a subscription with you, not the opposite.
+        From => "from",
+
+        /// Only you have a subscription with this contact, not the opposite.
+        To => "to",
+
+        /// Both you and your contact are subscribed to each other’s presence.
+        Both => "both",
+
+        /// In a roster set, this asks the server to remove this contact item
+        /// from your roster.
+        Remove => "remove",
+    }, Default = None
+);
 
 generate_element!(
     /// Contact from the user’s contact list.