core: More doc cleanup

src/libcore/core.rc

@@ -10,12 +10,14 @@ used features.
 `core` includes modules corresponding to each of the integer types, each of
 the floating point types, the `bool` type, tuples, characters, strings,
 vectors (`vec`), shared boxes (`box`), and unsafe and borrowed pointers
-(`ptr`).  Additionally, `core` provides very commonly used built-in types
-and operations, concurrency primitives, platform abstractions, I/O, and
-complete bindings to the C standard library.
+(`ptr`).  Additionally, `core` provides task management and creation (`task`),
+communication primitives (`comm` and `pipes`), an efficient vector builder
+(`dvec`), platform abstractions (`os` and `path`), basic I/O abstractions
+(`io`), common traits (`cmp`, `num`, `to_str`), and complete bindings
+to the C standard library (`libc`).
 
-`core` is linked to all crates and its contents imported.  Implicitly, all
-crates behave as if they included the following prologue:
+`core` is linked to all crates by default and its contents imported.
+Implicitly, all crates behave as if they included the following prologue:
 
     extern mod core;
     use core::*;

src/libcore/task.rs

@@ -82,8 +82,6 @@ macro_rules! move_it (
     { $x:expr } => { unsafe { let y <- *ptr::addr_of($x); move y } }
 )
 
-/* Data types */
-
 /// A handle to a task
 enum Task {
     TaskHandle(task_id)
@@ -800,7 +798,7 @@ unsafe fn atomically<U>(f: fn() -> U) -> U {
     f()
 }
 
-/****************************************************************************
+/* **************************************************************************
  * Spawning & linked failure
  *
  * Several data structures are involved in task management to allow properly
@@ -1431,7 +1429,7 @@ fn spawn_raw(+opts: TaskOpts, +f: fn~()) {
     }
 }
 
-/****************************************************************************
+/* **************************************************************************
  * Task local data management
  *
  * Allows storing boxes with arbitrary types inside, to be accessed anywhere