From 5d8f532b277361c9c70a39711345b6c0eeacc61a Mon Sep 17 00:00:00 2001
From: Chris Eppstein <chris@eppsteins.net>
Date: Wed, 3 Nov 2010 23:09:19 -0700
Subject: [PATCH] Document the new box shadow api

---
 .../reference/compass/css3/box_shadow.haml        |  6 ++++--
 .../reference/compass/css3/box_shadow_v2.haml     | 15 +++++++++++++++
 doc-src/content/stylesheets/_sidebar.sass         |  4 +++-
 doc-src/layouts/partials/sidebar/item.haml        |  6 ++++--
 4 files changed, 26 insertions(+), 5 deletions(-)
 create mode 100644 doc-src/content/reference/compass/css3/box_shadow_v2.haml

diff --git a/doc-src/content/reference/compass/css3/box_shadow.haml b/doc-src/content/reference/compass/css3/box_shadow.haml
index 2d54abd0..e63de6ec 100644
--- a/doc-src/content/reference/compass/css3/box_shadow.haml
+++ b/doc-src/content/reference/compass/css3/box_shadow.haml
@@ -1,10 +1,11 @@
 --- 
 title: Compass Box Shadow
-crumb: Box Shadow
+crumb: Box Shadow (Deprecated)
 framework: compass
 stylesheet: compass/css3/_box-shadow.scss
 meta_description: Specify the box shadow for all browsers.
 layout: core
+deprecated: true
 classnames:
   - reference
   - core
@@ -12,4 +13,5 @@ classnames:
 ---
 - render 'reference' do
   %p
-    The box-shadow mixin is used to give a block element a drop shadow.
\ No newline at end of file
+    This import is deprecated. Please import
+    <a href="/docs/reference/compass/css3/box_shadow_v2/">box_shadow_v2</a> instead.
\ No newline at end of file
diff --git a/doc-src/content/reference/compass/css3/box_shadow_v2.haml b/doc-src/content/reference/compass/css3/box_shadow_v2.haml
new file mode 100644
index 00000000..e2e1bdbf
--- /dev/null
+++ b/doc-src/content/reference/compass/css3/box_shadow_v2.haml
@@ -0,0 +1,15 @@
+--- 
+title: Compass Box Shadow (v2)
+crumb: Box Shadow (v2)
+framework: compass
+stylesheet: compass/css3/_box-shadow-v2.scss
+meta_description: Specify the box shadow for all browsers.
+layout: core
+classnames:
+  - reference
+  - core
+  - css3
+---
+- render 'reference' do
+  %p
+    The box-shadow mixins are used to apply an inset or drop shadow to a block element.
\ No newline at end of file
diff --git a/doc-src/content/stylesheets/_sidebar.sass b/doc-src/content/stylesheets/_sidebar.sass
index 59c308dc..949dee59 100644
--- a/doc-src/content/stylesheets/_sidebar.sass
+++ b/doc-src/content/stylesheets/_sidebar.sass
@@ -55,6 +55,8 @@ aside[role="sidebar"]
         background: #f5f5f5
         &.selected
           font-weight: bold
+        &.deprecated span
+          text-decoration: line-through
         &:hover, &:focus, &.selected
           +border-radius
           +text-shadow(lighten($c, 15), 0, 1px)
@@ -74,4 +76,4 @@ aside[role="sidebar"]
           font-style: normal
           float: right
           color: #ddd
-          font-weight: normal
\ No newline at end of file
+          font-weight: normal
diff --git a/doc-src/layouts/partials/sidebar/item.haml b/doc-src/layouts/partials/sidebar/item.haml
index 3fcd05f6..4a829ea0 100644
--- a/doc-src/layouts/partials/sidebar/item.haml
+++ b/doc-src/layouts/partials/sidebar/item.haml
@@ -1,2 +1,4 @@
-%li{:class => ("selected" if @selected)}
-  %a{:href => default_path(@current_item), :class => ("selected" if @selected)}= @crumb
+- classes = [("selected" if @selected), ("deprecated" if @current_item[:deprecated])].compact.join(" ")
+%li{:class => classes}
+  %a{:href => default_path(@current_item), :class => classes}
+    %span= @crumb