---

yaml
---
r: 32734
b: refs/heads/dist-snap
c: 89bbbd6
h: refs/heads/master
v: v3

Author: brson

[refs]

@@ -7,6 +7,6 @@ refs/tags/release-0.1: 1f5c5126e96c79d22cb7862f75304136e204f105
 refs/heads/ndm: f3868061cd7988080c30d6d5bf352a5a5fe2460b
 refs/heads/try2: d0c6ce338884ee21843f4b40bf6bf18d222ce5df
 refs/heads/incoming: d9317a174e434d4c99fc1a37fd7dc0d2f5328d37
-refs/heads/dist-snap: d3f0ede1980a483178df9625c342899f8aa742b5
+refs/heads/dist-snap: 89bbbd612a1b7380b402acf335f287c8d57fca3d
 refs/tags/release-0.2: c870d2dffb391e14efb05aa27898f1f6333a9596
 refs/tags/release-0.3: b5f0d0f648d9a6153664837026ba1be43d3e2503

branches/dist-snap/src/rustdoc/astsrv.rs

@@ -1,11 +1,11 @@
-#[doc(
-    brief = "Provides all access to AST-related, non-sendable info",
-    desc =
-    "Rustdoc is intended to be parallel, and the rustc AST is filled \
-     with shared boxes. The AST service attempts to provide a single \
-     place to query AST-related information, shielding the rest of \
-     Rustdoc from its non-sendableness."
-)];
+/*!
+Provides all access to AST-related, non-sendable info
+
+Rustdoc is intended to be parallel, and the rustc AST is filled with
+shared boxes. The AST service attempts to provide a single place to
+query AST-related information, shielding the rest of Rustdoc from its
+non-sendableness.
+*/
 
 use std::map::HashMap;
 use rustc::driver::session;

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

@@ -1,9 +1,9 @@
-#[doc(
-    brief = "Attribute parsing",
-    desc =
-    "The attribute parser provides methods for pulling documentation out of \
-     an AST's attributes."
-)];
+/*!
+Attribute parsing
+
+The attribute parser provides methods for pulling documentation out of
+an AST's attributes.
+*/
 
 use syntax::ast;
 use syntax::attr;

branches/dist-snap/src/rustdoc/attr_pass.rs

@@ -1,10 +1,10 @@
-#[doc(
-    brief = "The attribute parsing pass",
-    desc =
-    "Traverses the document tree, pulling relevant documention out of the \
-     corresponding AST nodes. The information gathered here is the basis \
-     of the natural-language documentation for a crate."
-)];
+/*!
+The attribute parsing pass
+
+Traverses the document tree, pulling relevant documention out of the
+corresponding AST nodes. The information gathered here is the basis
+of the natural-language documentation for a crate.
+*/
 
 use doc::ItemUtils;
 use extract::to_str;

branches/dist-snap/src/rustdoc/desc_to_brief_pass.rs

@@ -1,9 +1,9 @@
 /*!
- * Pulls a brief description out of a long description.
- *
- * If the first paragraph of a long description is short enough then it
- * is interpreted as the brief description.
- */
+Pulls a brief description out of a long description.
+
+If the first paragraph of a long description is short enough then it
+is interpreted as the brief description.
+*/
 
 use doc::ItemUtils;
 

branches/dist-snap/src/rustdoc/page_pass.rs

@@ -1,9 +1,9 @@
 /*!
- * Divides the document tree into pages.
- *
- * Each page corresponds is a logical section. There may be pages for
- * individual modules, pages for the crate, indexes, etc.
- */
+Divides the document tree into pages.
+
+Each page corresponds is a logical section. There may be pages for
+individual modules, pages for the crate, indexes, etc.
+*/
 
 use doc::{ItemUtils, PageUtils};
 use syntax::ast;

branches/dist-snap/src/rustdoc/rustdoc.rs

@@ -1,4 +1,5 @@
-// Some utility interfaces
+//! Some utility interfaces
+
 use doc::ItemUtils;
 use doc::Item;
 use doc::util;

branches/dist-snap/src/rustdoc/trim_pass.rs

@@ -1,9 +1,9 @@
 /*!
- * Pulls a brief description out of a long description.
- *
- * If the first paragraph of a long description is short enough then it
- * is interpreted as the brief description.
- */
+Pulls a brief description out of a long description.
+
+If the first paragraph of a long description is short enough then it
+is interpreted as the brief description.
+*/
 
 use doc::ItemUtils;
 

branches/dist-snap/src/rustdoc/unindent_pass.rs

@@ -1,13 +1,13 @@
 /*!
- * Removes the common level of indention from description strings. For
- * instance, if an entire doc comment is indented 8 spaces we want to
- * remove those 8 spaces from every line.
- *
- * The first line of a string is allowed to be intend less than
- * subsequent lines in the same paragraph in order to account for
- * instances where the string containing the doc comment is opened in the
- * middle of a line, and each of the following lines is indented.
- */
+Removes the common level of indention from description strings. For
+instance, if an entire doc comment is indented 8 spaces we want to
+remove those 8 spaces from every line.
+
+The first line of a string is allowed to be intend less than
+subsequent lines in the same paragraph in order to account for
+instances where the string containing the doc comment is opened in the
+middle of a line, and each of the following lines is indented.
+*/
 
 export mk_pass;