rustdoc: Add parsing of const attribute docs

Author: brson

src/rustdoc/attr_parser.rs

@@ -9,8 +9,8 @@ import rustc::syntax::ast;
 import rustc::front::attr;
 import core::tuple;
 
-export crate_attrs, mod_attrs, fn_attrs, arg_attrs;
-export parse_crate, parse_mod, parse_fn;
+export crate_attrs, mod_attrs, fn_attrs, arg_attrs, const_attrs;
+export parse_crate, parse_mod, parse_fn, parse_const;
 
 type crate_attrs = {
     name: option<str>
@@ -33,6 +33,11 @@ type arg_attrs = {
     desc: str
 };
 
+type const_attrs = {
+    brief: option<str>,
+    desc: option<str>
+};
+
 fn doc_meta(
     attrs: [ast::attribute]
 ) -> option<@ast::meta_item> {
@@ -276,6 +281,47 @@ fn parse_fn_should_parse_the_argument_descriptions() {
     assert attrs.args[1] == {name: "b", desc: "arg b"};
 }
 
+fn parse_const(attrs: [ast::attribute]) -> const_attrs {
+    parse_short_doc_or(
+        attrs,
+        {|desc|
+            {
+                brief: none,
+                desc: desc
+            }
+        },
+        parse_const_long_doc
+    )
+}
+
+fn parse_const_long_doc(
+    _items: [@ast::meta_item],
+    brief: option<str>,
+    desc: option<str>
+) -> const_attrs {
+    {
+        brief: brief,
+        desc: desc
+    }
+}
+
+#[test]
+fn should_parse_const_short_doc() {
+    let source = "#[doc = \"description\"]";
+    let attrs = test::parse_attributes(source);
+    let attrs = parse_fn(attrs);
+    assert attrs.desc == some("description");
+}
+
+#[test]
+fn should_parse_const_long_doc() {
+    let source = "#[doc(brief = \"a\", desc = \"b\")]";
+    let attrs = test::parse_attributes(source);
+    let attrs = parse_fn(attrs);
+    assert attrs.brief == some("a");
+    assert attrs.desc == some("b");
+}
+
 #[cfg(test)]
 mod test {