From 1d7882b9e6d1db26e8e875df8c207629b2cfb21b Mon Sep 17 00:00:00 2001
From: Chris Eppstein <chris@eppsteins.net>
Date: Sat, 20 Nov 2010 09:10:41 -0800
Subject: [PATCH] Deprecate the CSS3 Gradient module.

---
 .../reference/compass/css3/gradient.haml      |  1 +
 .../stylesheets/compass/css3/_gradient.scss   | 13 +---
 .../stylesheets/compass/css3/_images.scss     | 61 ++++++++++++-------
 .../stylesheets/compass/css3/_version-2.scss  |  1 -
 4 files changed, 42 insertions(+), 34 deletions(-)

diff --git a/doc-src/content/reference/compass/css3/gradient.haml b/doc-src/content/reference/compass/css3/gradient.haml
index 917c3f5c..423b1122 100644
--- a/doc-src/content/reference/compass/css3/gradient.haml
+++ b/doc-src/content/reference/compass/css3/gradient.haml
@@ -3,6 +3,7 @@ title: Compass Gradient
 crumb: Gradient
 framework: compass
 stylesheet: compass/css3/_gradient.scss
+deprecated: true
 meta_description: Specify linear gradients and radial gradients for all browsers.
 layout: core
 classnames:
diff --git a/frameworks/compass/stylesheets/compass/css3/_gradient.scss b/frameworks/compass/stylesheets/compass/css3/_gradient.scss
index 7a33154f..11533e2f 100644
--- a/frameworks/compass/stylesheets/compass/css3/_gradient.scss
+++ b/frameworks/compass/stylesheets/compass/css3/_gradient.scss
@@ -1,6 +1,8 @@
 @import "compass/utilities/general/hacks";
 @import "images";
 
+@warn "The css3 gradient module is deprecated. For more information see: http://beta.compass-style.org/docs/tutorials/upgrading/css3-v2/#gradients";
+
 // The linear gradient mixin works best across browsers if you use percentage-based color stops.
 //
 // Examples:
@@ -51,17 +53,6 @@
   @include background-image($image, linear-gradient($start, $color-stops));
 }
 
-// Emit a IE-Specific filters that renders a simple linear gradient.
-// For use in IE 6 - 8. Best practice would have you apply this via a
-// conditional IE stylesheet, but if you must, you should place this before
-// any background-image properties that you have specified.
-@mixin filter-gradient($start-color, $end-color, $orientation: vertical) {
-  @include has-layout;
-  $gradient-type: if($orientation == vertical, 0, 1);
-  filter: progid:DXImageTransform.Microsoft.gradient(gradientType=#{$gradient-type}, startColorstr='#{ie-hex-str($start-color)}', endColorstr='#{ie-hex-str($end-color)}');
-  -ms-filter: "progid:DXImageTransform.Microsoft.gradient(gradientType=#{$gradient-type}, startColorstr='#{ie-hex-str($start-color)}', endColorstr='#{ie-hex-str($end-color)}')";
-}
-
 // Because of webkit's limitations, the radial gradient mixin works best if you use
 // pixel-based color stops.
 //
diff --git a/frameworks/compass/stylesheets/compass/css3/_images.scss b/frameworks/compass/stylesheets/compass/css3/_images.scss
index 3bf00d6b..8cce6dff 100644
--- a/frameworks/compass/stylesheets/compass/css3/_images.scss
+++ b/frameworks/compass/stylesheets/compass/css3/_images.scss
@@ -1,27 +1,6 @@
 @import "shared";
 
-
-@mixin background-image(
-  $image-1,
-  $image-2: false,
-  $image-3: false,
-  $image-4: false,
-  $image-5: false,
-  $image-6: false,
-  $image-7: false,
-  $image-8: false,
-  $image-9: false,
-  $image-10: false
-) {
-  $images: compact($image-1, $image-2, $image-3, $image-4, $image-5, $image-6, $image-7, $image-8, $image-9, $image-10);
-
-  @if $experimental-support-for-svg     and prefixed(-svg,    $images) { background-image:    -svg($images); }
-  @if $experimental-support-for-webkit  and prefixed(-webkit, $images) { background-image: -webkit($images); }
-  @if $experimental-support-for-mozilla and prefixed(-moz,    $images) { background-image:    -moz($images); }
-  @if $experimental-support-for-pie     and (prefixed(-pie,    $images) or -compass-list-size($images) > 1) { @warn "PIE does not support background-image. Use @include background(#{$images}) instead." }
-                                                                         background-image:         $images ;
-}
-
+// Background property support for vendor prefixing within values.
 @mixin background(
   $background-1,
   $background-2: false,
@@ -44,6 +23,41 @@
                                                                                     background:         $backgrounds;
 }
 
+// Background image property support for vendor prefixing within values.
+@mixin background-image(
+  $image-1,
+  $image-2: false,
+  $image-3: false,
+  $image-4: false,
+  $image-5: false,
+  $image-6: false,
+  $image-7: false,
+  $image-8: false,
+  $image-9: false,
+  $image-10: false
+) {
+  $images: compact($image-1, $image-2, $image-3, $image-4, $image-5, $image-6, $image-7, $image-8, $image-9, $image-10);
+
+  @if $experimental-support-for-svg     and prefixed(-svg,    $images) { background-image:    -svg($images); }
+  @if $experimental-support-for-webkit  and prefixed(-webkit, $images) { background-image: -webkit($images); }
+  @if $experimental-support-for-mozilla and prefixed(-moz,    $images) { background-image:    -moz($images); }
+  @if $experimental-support-for-pie     and (prefixed(-pie,    $images) or -compass-list-size($images) > 1) { @warn "PIE does not support background-image. Use @include background(#{$images}) instead." }
+                                                                         background-image:         $images ;
+}
+
+// Emit a IE-Specific filters that renders a simple linear gradient.
+// For use in IE 6 - 8. Best practice would have you apply this via a
+// conditional IE stylesheet, but if you must, you should place this before
+// any background-image properties that you have specified.
+@mixin filter-gradient($start-color, $end-color, $orientation: vertical) {
+  @include has-layout;
+  $gradient-type: if($orientation == vertical, 0, 1);
+  filter: progid:DXImageTransform.Microsoft.gradient(gradientType=#{$gradient-type}, startColorstr='#{ie-hex-str($start-color)}', endColorstr='#{ie-hex-str($end-color)}');
+  -ms-filter: "progid:DXImageTransform.Microsoft.gradient(gradientType=#{$gradient-type}, startColorstr='#{ie-hex-str($start-color)}', endColorstr='#{ie-hex-str($end-color)}')";
+}
+
+
+// Border image property support for vendor prefixing properties and values.
 @mixin border-image($value) {
   @if $experimental-support-for-mozilla {    -moz-border-image:    -moz(-compass-list($value)); }
   @if $experimental-support-for-webkit  { -webkit-border-image: -webkit(-compass-list($value)); }
@@ -51,6 +65,7 @@
                                                   border-image:                       $value;
 }
 
+// List style image property support for vendor prefixing within values.
 @mixin list-style-image($image) {
   @if $experimental-support-for-mozilla and prefixed(-moz,    $image) { list-style-image:    -moz($image); }
   @if $experimental-support-for-webkit  and prefixed(-webkit, $image) { list-style-image: -webkit($image); }
@@ -58,6 +73,7 @@
                                                                         list-style-image:         $image ;
 }
 
+// List style property support for vendor prefixing within values.
 @mixin list-style($value) {
   $value: -compass-list($value);
   @if $experimental-support-for-mozilla and prefixed(-moz,    $value) { list-style-image:    -moz($value); }
@@ -66,6 +82,7 @@
                                                                         list-style-image:         $value ;
 }
 
+// content property support for vendor prefixing within values.
 @mixin content($value) {
   $value: -compass-list($value);
   @if $experimental-support-for-mozilla and prefixed(-moz,    $value) { content:    -moz($value); }
diff --git a/frameworks/compass/stylesheets/compass/css3/_version-2.scss b/frameworks/compass/stylesheets/compass/css3/_version-2.scss
index ffe69b09..ae111133 100644
--- a/frameworks/compass/stylesheets/compass/css3/_version-2.scss
+++ b/frameworks/compass/stylesheets/compass/css3/_version-2.scss
@@ -7,7 +7,6 @@
 @import "box-sizing";
 @import "box";
 @import "images";
-@import "gradient";
 @import "background-clip";
 @import "background-origin";
 @import "background-size";