Replace remaning doc attrs with comments

src/servo/css/lexer.rs

@@ -1,4 +1,4 @@
-#[doc = "Code to lex and tokenize css files."]
+//! Code to lex and tokenize css files
 
 use option::is_none;
 use str::from_bytes;

src/servo/css/parser_util.rs

@@ -1,4 +1,4 @@
-#[doc = "Helper functions to parse values of specific attributes."]
+//! Helper functions to parse values of specific attributes
 
 use css::values::*;
 use str::{pop_char, from_chars};

src/servo/css/values.rs

@@ -1,13 +1,13 @@
+/*!
+Defines how css rules, both selectors and style specifications, are
+stored.  CSS selector-matching rules, as presented by 
+http://www.w3.org/TR/CSS2/selector.html are represented by nested types.
+*/
+
 use SharedColor = util::color::Color;
 use cmp::Eq;
 use std::net::url::Url;
 
-#[doc = "
-  Defines how css rules, both selectors and style specifications, are
-  stored.  CSS selector-matching rules, as presented by 
-  http://www.w3.org/TR/CSS2/selector.html are represented by nested types.
-"]
-
 // CSS Units
 
 enum ParseResult<T> {

src/servo/gfx/compositor.rs

@@ -1,10 +1,10 @@
 use dom::event::Event;
 use azure::azure_hl::DrawTarget;
 
-#[doc = "
+/**
 The interface used to by the renderer to aquire draw targets for
 each rendered frame and submit them to be drawn to the display
-"]
+*/
 trait Compositor {
     fn begin_drawing(+next_dt: pipes::Chan<DrawTarget>);
     fn draw(+next_dt: pipes::Chan<DrawTarget>, +draw_me: DrawTarget);

src/servo/gfx/png_compositor.rs

@@ -1,9 +1,9 @@
-#[doc = "
+/*!
 A graphics compositor that renders to PNG format buffers
 
 Each time the renderer renders a frame the compositor will output a
 `~[u8]` containing the frame in PNG format.
-"];
+*/
 
 use libc::{c_int, c_uint, c_void, c_uchar};
 use azure_bg = azure::bindgen;

src/servo/html/lexer_util.rs

@@ -1,4 +1,6 @@
-#[doc = "A collection of functions that are useful for both css and html parsing."]
+/*!
+A collection of functions that are useful for both css and html parsing
+*/
 
 use option::is_none;
 use str::from_bytes;

src/servo/platform/osmain.rs

@@ -161,10 +161,10 @@ fn mainloop(+mode: Mode, po: comm::Port<Msg>) {
     }
 }
 
-#[doc = "
+/**
 Implementation to allow the osmain channel to be used as a graphics
 compositor for the renderer
-"]
+*/
 impl OSMain : Compositor {
     fn begin_drawing(+next_dt: pipes::Chan<DrawTarget>) {
         self.send(BeginDrawing(next_dt))
@@ -226,7 +226,7 @@ fn Surface() -> Surface {
     Surface { cairo_surface: cairo_surface, draw_target: draw_target, have: true }
 }
 
-#[doc = "A function for spawning into the platform's main thread"]
+/// A function for spawning into the platform's main thread
 fn on_osmain<T: Send>(+f: fn~(+po: comm::Port<T>)) -> comm::Chan<T> {
     task::task().sched_mode(task::PlatformThread).spawn_listener(f)
 }