---

yaml
---
r: 7773
b: refs/heads/snap-stage3
c: 6d80584
h: refs/heads/master
i:
  7771: 34a8f4b
v: v3

Author: brson

[refs]

@@ -1,6 +1,6 @@
 ---
 refs/heads/master: 2898dcc5d97da9427ac367542382b6239d9c0bbf
 refs/heads/snap-stage1: e33de59e47c5076a89eadeb38f4934f58a3618a6
-refs/heads/snap-stage3: fc64aefe0aebe547322e86b3e5daa4564d038e63
+refs/heads/snap-stage3: 6d8058451b71f3e5a8178ca21856b529655df032
 refs/heads/try: 2898dcc5d97da9427ac367542382b6239d9c0bbf
 refs/tags/release-0.1: 1f5c5126e96c79d22cb7862f75304136e204f105

branches/snap-stage3/src/rustdoc/attr_parser.rs

@@ -25,7 +25,8 @@ type fn_attrs = {
     brief: option<str>,
     desc: option<str>,
     args: [arg_attrs],
-    return: option<str>
+    return: option<str>,
+    failure: option<str>
 };
 
 type arg_attrs = {
@@ -193,7 +194,8 @@ fn parse_fn(
                 brief: none,
                 desc: desc,
                 args: [],
-                return: none
+                return: none,
+                failure: none
             }
         },
         parse_fn_long_doc
@@ -206,7 +208,7 @@ fn parse_fn_long_doc(
     desc: option<str>
 ) -> fn_attrs {
     let return = attr::meta_item_value_from_list(items, "return");
-
+    let failure = attr::meta_item_value_from_list(items, "failure");
     let args = alt attr::meta_item_list_from_list(items, "args") {
       some(items) {
         vec::filter_map(items) {|item|
@@ -225,7 +227,8 @@ fn parse_fn_long_doc(
         brief: brief,
         desc: desc,
         args: args,
-        return: return
+        return: return,
+        failure: failure
     }
 }
 
@@ -281,6 +284,14 @@ fn parse_fn_should_parse_the_argument_descriptions() {
     assert attrs.args[1] == {name: "b", desc: "arg b"};
 }
 
+#[test]
+fn parse_fn_should_parse_failure_conditions() {
+    let source = "#[doc(failure = \"it's the fail\")]";
+    let attrs = test::parse_attributes(source);
+    let attrs = parse_fn(attrs);
+    assert attrs.failure == some("it's the fail");
+}
+
 fn parse_const(attrs: [ast::attribute]) -> const_attrs {
     parse_short_doc_or(
         attrs,