Auto merge of #401 - federicomenaquintero:expanded-name-docs, r=jdm

Expanded name docs

Author: bors-servo

markup5ever/build.rs

@@ -71,7 +71,9 @@ fn main() {
     writeln!(
         generated,
         r#"
-        /// Maps the input of `namespace_prefix!` to the output of `namespace_url!`.
+        /// Maps the input of [`namespace_prefix!`](macro.namespace_prefix.html) to 
+        /// the output of [`namespace_url!`](macro.namespace_url.html).
+        ///
         #[macro_export] macro_rules! ns {{
         "#
     )

markup5ever/interface/mod.rs

@@ -43,6 +43,14 @@ impl<'a> fmt::Debug for ExpandedName<'a> {
 
 /// Helper to quickly create an expanded name.
 ///
+/// Can be used with no namespace as `expanded_name!("", "some_name")`
+/// or with a namespace as `expanded_name!(ns "some_name")`.  In the
+/// latter case, `ns` is one of the symbols which the [`ns!`][ns]
+/// macro accepts; note the lack of a comma between the `ns` and
+/// `"some_name"`.
+///
+/// [ns]: macro.ns.html
+///
 /// # Examples
 ///
 /// ```
@@ -57,7 +65,15 @@ impl<'a> fmt::Debug for ExpandedName<'a> {
 ///         ns: &ns!(),
 ///         local: &local_name!("div")
 ///     }
-/// )
+/// );
+///
+/// assert_eq!(
+///     expanded_name!(html "div"),
+///     ExpandedName {
+///         ns: &ns!(html),
+///         local: &local_name!("div")
+///     }
+/// );
 /// # }
 #[macro_export]
 macro_rules! expanded_name {