From de5ec40a3f807c5bc9c1a3326b2043194964e2f5 Mon Sep 17 00:00:00 2001
From: Chris Eppstein <chris@eppsteins.net>
Date: Tue, 16 Mar 2010 18:43:13 -0500
Subject: [PATCH] The Sass Parser will drop starting whitespace on single line
 comments so the | char can be used to work around that in the docs.

---
 doc-src/lib/stylesheets/sass_extensions.rb    |  2 +-
 .../blueprint/stylesheets/blueprint/_ie.sass  | 35 ++++++++++++-------
 2 files changed, 23 insertions(+), 14 deletions(-)

diff --git a/doc-src/lib/stylesheets/sass_extensions.rb b/doc-src/lib/stylesheets/sass_extensions.rb
index 3be479fa..db998da0 100644
--- a/doc-src/lib/stylesheets/sass_extensions.rb
+++ b/doc-src/lib/stylesheets/sass_extensions.rb
@@ -154,7 +154,7 @@ module Sass
         docstring.gsub(/@doc off(.*?)@doc on/m, '')
       end
       def docstring
-        ([value] + lines).join("\n")
+        ([value] + lines).join("\n").gsub(/(^\| )|(^\|$)/, '')
       end
       def doc
         if value == "@doc off"
diff --git a/frameworks/blueprint/stylesheets/blueprint/_ie.sass b/frameworks/blueprint/stylesheets/blueprint/_ie.sass
index 44d9f5e7..ea093f23 100644
--- a/frameworks/blueprint/stylesheets/blueprint/_ie.sass
+++ b/frameworks/blueprint/stylesheets/blueprint/_ie.sass
@@ -1,21 +1,30 @@
+// @doc off
 // The blueprint IE mixins should be mixed into a stylesheet that gets conditionally included
 // into IE like so:
 // <!--[if lt IE 8]><link rel="stylesheet" href="ie.css"
 //                   type="text/css" media="screen, projection"><![endif]-->
+// @doc on
 
-
-// Usage examples:
-// As a top-level mixin, apply to any page that includes the stylesheet:
-//   +blueprint-ie
-// Scoped by a presentational class:
-//   body.blueprint
-//    +blueprint-ie(true)
-// Scoped by semantic selectors:
-//   body#page-1, body#page-2, body.a-special-page-type
-//     +blueprint-ie(true)
-// Deprecated:
-//   You can pass the body selector as the first argument when used as a top-level mixin
-//   +blueprint-ie("body#page-1, body#page-2, body.a-special-page-type")
+//| Usage Examples
+//| --------------
+//|
+//| As a top-level mixin, apply to any page that includes the stylesheet:
+//|
+//|     +blueprint-ie
+//|
+//| Scoped by a presentational class:
+//|
+//|     body.blueprint
+//|      +blueprint-ie(true)
+//|
+//| Scoped by semantic selectors:
+//|
+//|     body#page-1, body#page-2, body.a-special-page-type
+//|       +blueprint-ie(true)
+//|
+//| **Deprecated:** You can pass the body selector as the first argument when used as a top-level mixin
+//|
+//|     +blueprint-ie("body#page-1, body#page-2, body.a-special-page-type")
 =blueprint-ie(!body_selector = "body")
   @if !body_selector == true
     +blueprint-ie-body