rustdoc: Add more rustdocs

diff --git a/src/rustdoc/rustdoc.rs b/src/rustdoc/rustdoc.rs
index b58850b7e3ec32c2fd1d88eb1be856c40270e452..6406c2f1df026f86899ed54bca47863a9ef31b07 100755 (executable)
--- a/src/rustdoc/rustdoc.rs
+++ b/src/rustdoc/rustdoc.rs
@@ -11,7 +11,21 @@ fn run_passes(
     passes: [pass]
 ) -> doc::cratedoc {
 
-    #[doc = "Run a series of passes over the document"];
+    #[doc(
+        brief =
+        "Run a series of passes over the document",
+        args(
+            srv =
+            "The AST service to provide to the passes",
+            doc =
+            "The document to transform",
+            passes =
+            "The list of passes used to transform the document"
+        ),
+        return =
+        "The transformed document that results from folding the \
+         original through each pass"
+    )];
 
     vec::foldl(doc, passes) {|doc, pass|
         pass(srv, doc)