diff --git a/frameworks/compass/stylesheets/compass/css3/_box_shadow.sass b/frameworks/compass/stylesheets/compass/css3/_box_shadow.sass
index 0331f07d..6735d5aa 100644
--- a/frameworks/compass/stylesheets/compass/css3/_box_shadow.sass
+++ b/frameworks/compass/stylesheets/compass/css3/_box_shadow.sass
@@ -1,18 +1,20 @@
-//
-  Provides cross-browser CSS box shadows for Webkit, Gecko, and CSS3.
+// @doc off
+// These defaults make the arguments optional for this mixin
+// If you like, set different defaults before importing.
+// @doc on
 
-  Standard arguments are color, horizontal offset, vertical offset, and blur.
-
-//
-  These defaults make the arguments optional for this mixin
-
-  If you like, set different defaults in your project.
-  
+// The default color for box shadows
 !default_box_shadow_color     ||= #333
+// The default horizontal offset. Positive is to the right.
 !default_box_shadow_h_offset  ||= 1px
+// The default vertical offset. Positive is down.
 !default_box_shadow_v_offset  ||= 1px
+// The default blur length.
 !default_box_shadow_blur      ||= 5px
 
+//
+  Provides cross-browser CSS box shadows for Webkit, Gecko, and CSS3.
+  Arguments are color, horizontal offset, vertical offset, and blur length.
 =box-shadow(!color = !default_box_shadow_color, !hoff = !default_box_shadow_h_offset, !voff = !default_box_shadow_v_offset, !blur = !default_box_shadow_blur)
   /* Webkit (Safari, Chrome) */
   -webkit-box-shadow= !color !hoff !voff !blur