Address requested changes

Author: Richard Dodd

markup5ever/serialize.rs

@@ -18,12 +18,16 @@ use std::io;
 
 //§ serializing-html-fragments
 /// Used as a parameter to `serialize`, telling it if we want to skip the parent.
-/// TODO check: Currently the parameter to `ChildrenOnly` is unused.
 #[derive(Clone, PartialEq)]
 pub enum TraversalScope {
     /// Include the parent node when serializing.
     IncludeNode,
-    /// Only serialize the children of the node.
+    /// Only serialize the children of the node, treating any provided qualified name as the
+    /// parent while serializing.
+    ///
+    /// This is used in the implementation of [`html5ever::serialize::serialize`]
+    ///
+    /// [`html5ever::serialize::serialize`]: ../../html5ever/serialize/fn.serialize.html
     ChildrenOnly(Option<QualName>)
 }
 

markup5ever/util/buffer_queue.rs

@@ -170,12 +170,6 @@ impl BufferQueue {
         result
     }
 
-    // Check if the next characters are an ASCII case-insensitive match for
-    // `pat`, which must be non-empty.
-    //
-    // If so, consume them and return Some(true).
-    // If they do not match, return Some(false).
-    // If not enough characters are available to know, return None.
     /// Consume bytes matching the pattern, using a custom comparison function `eq`.
     ///
     /// Returns `Some(true)` if there is a match, `Some(false)` if there is no match, or `None` if