From 5f11b126e62239c1726b32db6e699ab7ef77830a Mon Sep 17 00:00:00 2001
From: Chris Eppstein <chris@eppsteins.net>
Date: Mon, 15 Nov 2010 17:41:03 -0800
Subject: [PATCH] Touch up docs

---
 .../tutorials/upgrading/im-scared.markdown    | 14 ++++++-------
 .../compass/css3/_transform-v2.scss           | 20 ++++++++++++-------
 2 files changed, 20 insertions(+), 14 deletions(-)

diff --git a/doc-src/content/tutorials/upgrading/im-scared.markdown b/doc-src/content/tutorials/upgrading/im-scared.markdown
index 0233b9aa..4a3e066c 100644
--- a/doc-src/content/tutorials/upgrading/im-scared.markdown
+++ b/doc-src/content/tutorials/upgrading/im-scared.markdown
@@ -35,23 +35,23 @@ what changed to your stylesheets:
 10. Scroll or use your arrow keys to review the differences between the files.
 11. If you're satisfied: $ git commit -a -m "Upgraded compass"
 12. If you're scared again:
-    A. Don't panic.
-    B. Read the [CHANGELOG](http://compass-style.org/docs/CHANGELOG/) and
+    1. Don't panic.
+    2. Read the [CHANGELOG](http://compass-style.org/docs/CHANGELOG/) and
        see if the changes are explained there.
-    B. Send an email to the [mailing list](http://groups.google.com/group/compass-users)
+    3. Send an email to the [mailing list](http://groups.google.com/group/compass-users)
        explaining the problem and providing enough context like snippets from your diff
        and the relevant snippets of your sass/scss files. In rare cases we might request
        that you construct a simple compass project that exhibits the issue and make an
        archive of it and send us an email with it attached.
-    C. If it's pretty obviously a bug. Please file an issue
+    4. If it's pretty obviously a bug. Please file an issue
        on [github](http://github.com/chriseppstein/compass/issues). If you're experiencing
        a crash, please run the command with the --trace option and record the output for
        diagnostic purposes.
-    D. $ sudo gem uninstall compass
+    5. $ sudo gem uninstall compass
        Select the newest version of compass. You have now downgraded to the old
        version of compass.
-    E. $ compass compile --force
-    F. Diff the folders as in steps 7 through 9.
+    6. $ compass compile --force
+    7. Diff the folders as in steps 7 through 9.
 13. Breathe a sigh of relief.
        
        
diff --git a/frameworks/compass/stylesheets/compass/css3/_transform-v2.scss b/frameworks/compass/stylesheets/compass/css3/_transform-v2.scss
index 2a3d48ad..1e4c34d4 100644
--- a/frameworks/compass/stylesheets/compass/css3/_transform-v2.scss
+++ b/frameworks/compass/stylesheets/compass/css3/_transform-v2.scss
@@ -152,8 +152,9 @@ $default-skew-y      : 5deg                  !default;
   @include transform($trans, true);
 }
 
-
+// @doc off
 // 3D Parameters -------------------------------------------------------------
+// @doc on
 
 // Set the perspective of 3D transforms on the children of an element:
 //
@@ -193,7 +194,7 @@ $default-skew-y      : 5deg                  !default;
 
 // Determine the visibility of an element when it's back is turned
 //
-// @include backface-visibility( [ visibility ] )
+//     @include backface-visibility( [ visibility ] )
 //
 // where `visibility` can be either `visible` or `hidden`
 // browsers default to visible, mixin defaults to hidden
@@ -440,11 +441,14 @@ $default-skew-y      : 5deg                  !default;
   @include transform3d($trans);
 }
 
-
+// @doc off
 // Skew ----------------------------------------------------------------------
+// @doc on
 
-// Skew an element
-// @include skew( [ skew-x, skew-y, 3D-only ] )
+// Skew an element:
+//
+//     @include skew( [ skew-x, skew-y, 3D-only ] )
+//
 // where the 'skew-' arguments accept css angles in degrees (deg) or radian (rad) units
 //
 // **Note** This mixin cannot be combined with other transform mixins.
@@ -458,7 +462,8 @@ $default-skew-y      : 5deg                  !default;
 }
 
 // Skew an element along the x axiz
-// @include skew( [ skew-x, 3D-only ] )
+//
+//     @include skew( [ skew-x, 3D-only ] )
 //
 // **Note** This mixin cannot be combined with other transform mixins.
 @mixin skewX(
@@ -470,7 +475,8 @@ $default-skew-y      : 5deg                  !default;
 }
 
 // Skew an element along the y axis
-// @include skew( [ skew-y, 3D-only ] )
+//
+//     @include skew( [ skew-y, 3D-only ] )
 //
 // **Note** This mixin cannot be combined with other transform mixins.
 @mixin skewY(