Add comments to span debugger

diff --git a/src/librustc/driver/session.rs b/src/librustc/driver/session.rs
index 4e386fa343d08af14f92feee98cb45a5b10bcb84..6fb7e749475044ff098d3724ea9329b6cce0a19a 100644 (file)
--- a/src/librustc/driver/session.rs
+++ b/src/librustc/driver/session.rs
@@ -96,7 +96,7 @@ pub fn debugging_opts_map() -> ~[(&'static str, &'static str, u64)] {
      ("no-landing-pads", "omit landing pads for unwinding",
       NO_LANDING_PADS),
      ("debug-llvm", "enable debug output from LLVM", DEBUG_LLVM),
-     ("show-span", "show spans", SHOW_SPAN),
+     ("show-span", "show spans for compiler debugging", SHOW_SPAN),
      ("count-type-sizes", "count the sizes of aggregate types",
       COUNT_TYPE_SIZES),
      ("meta-stats", "gather metadata statistics", META_STATS),

diff --git a/src/librustc/front/show_span.rs b/src/librustc/front/show_span.rs
index a5bc8e0243bdc34175084cd87c425f00ea6b084e..2c076aac095abcf1ddbc14f541b74e433d7472c5 100644 (file)
--- a/src/librustc/front/show_span.rs
+++ b/src/librustc/front/show_span.rs
@@ -8,6 +8,11 @@
 // option. This file may not be copied, modified, or distributed
 // except according to those terms.
 
+//! Span debugger
+//!
+//! This module shows spans for all expressions in the crate
+//! to help with compiler debugging.
+
 use syntax::ast;
 use syntax::visit;
 use syntax::visit::Visitor;