From 8fec36bbf54b7bd0b917ce0f676001dd207935dc Mon Sep 17 00:00:00 2001 From: Chris Eppstein Date: Mon, 10 May 2010 03:03:36 -0700 Subject: [PATCH] [Docs] Unify the v0.10.0 change log. --- .../content/CHANGELOG-v0-10-0-beta.markdown | 394 ++++++++++++++++++ doc-src/content/CHANGELOG.markdown | 369 ++++------------ 2 files changed, 469 insertions(+), 294 deletions(-) create mode 100644 doc-src/content/CHANGELOG-v0-10-0-beta.markdown diff --git a/doc-src/content/CHANGELOG-v0-10-0-beta.markdown b/doc-src/content/CHANGELOG-v0-10-0-beta.markdown new file mode 100644 index 00000000..f8915256 --- /dev/null +++ b/doc-src/content/CHANGELOG-v0-10-0-beta.markdown @@ -0,0 +1,394 @@ +--- +title: Compass v0.10.0 Beta History +crumb: CHANGELOG +body_id: changelog +layout: article +--- + +0.10.0.rc6 (May 8, 2010) +------------------------ +* [Compass Core] The configuration constant `$firefox2-ellipsis` has been + renamed to `$use-mozilla-ellipsis-binding` to reflect the fact that + it must be used for any version of mozilla less than 3.6. +* [CLI] The the new Sub-command based CLI will now recognize abbreviated + commands as long as the abbreviation is unambiguous. + For instance, `compass w` is a shortcut for `compass watch` and + `compass com` for `compass compile` but `compas co` will not work + for compile because it also matches `compass config`. +* [Rails] When configuring Sass during initialization, + Compass now passes the template locations as an array of tuples + instead of as a hash. This preserves ordering in all versions + of ruby and ensures that the deprecated imports do not take precedence. + +0.10.0.rc5 (May 2, 2010) +------------------------ + +* [Rails] The default location for compass extensions has moved from + `vendor/plugins/compass/extensions` to `vendor/plugins/compass_extensions`. +* [Rails] The rails template has been updated to use the latest haml and compass versions. +* [Compass Core] Global reset no longer automatically resets the *:focus. + This allows browsers to use their default :focus styles which is considered + a best practice. If you wish to reset :focus styles simply include this in + your stylesheets: + `*:focus { @include reset-focus; }` +* [Compass Core] A new mixin `replace-text-with-dimensions` has been added. + This is the same as the `replace-text` mixin except that it will read the + dimensions from the image and set them for you on the element. +* [Compass Core] If you want Firefox 2 Support (via -moz-binding) for the + `ellipsis` mixin, you must now set `$firefox2-ellipsis` to `true` before + importing the module. +* [Compass Core] The `compass/text/ellipsis` module is now imported + automatically by the `compass/text` module. +* [Compass Core] The gradient mixins now accept a background image that will + be placed over the gradient. Credit: [Will Leinweber](http://bitfission.com/) +* [Compass Core] You can now opt out of support for specific browsers in + the css3 module. See [the docs](/docs/reference/compass/css3/shared/) + for more details. + + +0.10.0.rc4 (April 27, 2010) +--------------------------- +* Lot of new docs can be found at: [http://compass-style.org/docs/](http://compass-style.org/docs/). +* The `unobtrusive-logo` mixin is deprecated and will be removed. + If you use this, please move the source to your project. +* The CSS3 modules were refactored to share a common implementation that + abstracts the browser prefixes that are supported and gives + greater control to the user over which prefixes are generated. + Depending on what mixins you were using you might see some changes to + what prefixes get generated by default and the order that they are + emitted. The goal of this change is to provide a more future-proof + implementation. +* The unnecessary import of the `float` module from the `hacks` module + was removed. If you were relying on this, you'll need to + import the float module explicitly now. +* The `pretty-bullets` mixin will now infer the image dimensions by + reading the image file if the image dimensions are not provided. +* The old CLI is now deprecated and a warning message will be printed + out if you use it. The new CLI is better and can be learned + by typing `compass help`. Credit: [Alexander Kahn](http://akahn.net) +* The `background-clip` mixin now accepts the value of `text`. Credit: [Thomas Reynolds]() +* The display: box model and associated properties are now part of the + css3 module. Credit: [Lorin Tackett](http://blog.lorintackett.com/) +* The compass gem is now built with a simple `gem build compass.gemspec`. + This should make it play nicer with tools like + [bundler](http://gembundler.org/). + +0.10.0.rc3 (April 13, 2010) +--------------------------- +* This release addresses several bugs in rc2. + +0.10.0.rc2 (April 12, 2010) +--------------------------- +**IMPORTANT:** + +* Compass now depends on Sass 3 -- Please be prepared to upgrade. + Things won't break but you'll have a lot of deprecation warnings. + Upgrading is pretty easy thanks to the `sass-convert` tool. See the + [Sass Changelog](http://beta.sass-lang.com/docs/yardoc/file.SASS_CHANGELOG.html) + for more information. +* All compass stylesheets are now written in the SCSS syntax, + if you import compass framework stylesheets with an explicit + `.sass` extension, then you'll receive deprecation warnings + directing you to update your stylesheets. +* A new command line switch `--syntax` (or `-x`) has been added + to commands that install stylesheets into your project that + allows you to select the syntax to use (scss or sass) +* A new configuration option `preferred_syntax` now exists + and defaults to `:scss`. Please update your project's configuration + file with `preferred_syntax = :sass` if you prefer to use the + indentation-based syntax. +* You may silence deprecation warnings by adding + `sass_options = {:quiet => true}` to your configuration. + +0.10.0.pre9 (March 6, 2010) +--------------------------- + +* Fix a ruby 1.9 bug in the image_size helper functions for jpeg images. +* Silence a deprecation warning. + + +0.10.0.pre7 & 0.10.0.pre8 (February 23, 2010) +--------------------------------------------- + +* Rails 3 compatibility fixes +* Fix for rgba colors with the new gradient mixins +* A better error message if a color stop list is not passed in to the gradient mixins. + +0.10.0.pre6 (February 22, 2010) +------------------------------- + +**IMPORTANT:** + +* Rails users need to update their compass initializer. +* The CSS 3 Gradient mixins were re-written and their usage has changed. + +Read on for the details: + +### CLI +* Fixed some issues with colorized output. +* Don't force the user to specify the configuration path when calling compass config + +### Compass Core +* Fix to the bang_hack mixin (Credit: Mark Rajcok) +* Support :first-child and :last-child pseudo selectors for +horizontal-list. (Credit: Cody Robbins) +* Clear the sticky footer so that it works correctly with grid layouts. +* The css3 gradient module has been re-written and has a new, much simpler mixins. If you have been using the css3 gradient mixins, you'll need to update your sass stylesheets. The new mixins can be seen in action [here](http://compass-style.org/examples/css3/gradients.html). +* Added new helper functions: `image_width("path/to/image.png")` & `image_height("path/to/image.png")` that return the size in pixels. (Credit: Deepak Jois & Richard Aday) + +### Blueprint +* Take margins into account in liquid grid. (Credit: Christoffer Eliesen) + +### Rails +* Several Rails 3 bug fixes (Credit: Jacques Crocker) +* Don't set unset options on the Sass::Plugin +* Fixed a setup bug and handle compass configuration changes at rails boot. + +**IMPORTANT:** Existing rails projects _must_ change their compass initializer file to: + + require 'compass' + rails_root = (defined?(Rails) ? Rails.root : RAILS_ROOT).to_s + Compass.add_project_configuration(File.join(rails_root, "config", "compass.rb")) + Compass.configure_sass_plugin! + Compass.handle_configuration_change! + +### Internals +* New APIs for dealing with configuration changes and accessing a compiler instance. +* Provide a convenience function for discovering extensions: `Compass.discover_extensions!` that can be called during project configuration w/ other ruby frameworks. + +### Extensions + +* Don't force an extension to register itself just because it has ruby code. + This makes it easier for extensions to provide Sass functions from ruby. + +Special thanks to Daniel Hofstetter for fixing my typos. + +0.10.0.pre5 (January 18, 2010) +------------------------------ +* Fixed a bug in the grid builder in ruby 1.8.6 (Credit: [Richard Wöber][der-rich]) +* Better sudo handling for the rails installer via environment variables or prompt. (Credit: Ryan Shaw, Evan Sharp) +* Removed support for the rip package manager. +* Support for scss files in the compass watcher. +* Cache buster timestamps were not working in some cases. +* Make ANSI color output work on windows. +* Command line switch (--boring) to turn off colorized output. +* Strip trailing slash from directory and path configuration variables. +* Added a --poll option to the compass watch subcommand to force polling. +* Fixed a test failure in ruby 1.9 due to faulty test code. +* Move the frameworks directory back to the top level. There's not actually a good reason for it to be buried in the ruby source. +* Upgrade FSSM. (Hopfully) Fixes a watcher issue that caused the watcher to not trigger for some users. +* Silence a deprecation warning in Rails 3. + +0.10.0.pre4 (January 04, 2010) +------------------------------ +* Fixed an FSSM loading issue that broke the compass watcher. +* Fixed some compatibility issues with edge versions of Sass. + +0.10.0.pre3 (January 02, 2010) +------------------------------ + +Bug fixes: + +* [Blueprint] Bug Fix: variable referenced in a non-script context within the + dquo mixin in the fancy_type module. +* [Rails] fixed win32 sudo incompatibility issue in the rails installer template. + (Credit: [Jonathan Silverman][jsilver]) +* [Rails] Update the gem dependencies for the rails installer template. +* If the configuration file changes, wipe out the sass cache and force compilation +* Upgrade the vendored version of FSSM to version 0.1.2. + Fixes some bugs with jruby and adds inotify support for linux. + (Credit: [Travis Tilley][ttilley]) +* Patched hide-text to account for items that are not left aligned. + (Credit: [Josh Pyles][pixelmatrix]) + +Minor Enhancements: + +* Support for SCSS files if haml edge is installed. +* Color any stderr or stdout output from the `Sass::Engine` red during compilation. +* [Configuration] The sass cache location can now be set in the compass config + file using the `cache_dir` property and the cache can be disabled by setting + `cache = false`. +* [Compass Core] `+min-height`, `+min-width`, and `+bang-hack` mixins in the + compass/utilities/general/min.sass module. + (Credit: [Adam Stacoviak][adamstac]) +* [Command Line] If you only want to compile certain files, you can now + specify them when invoking compass compile. E.g. `compass compile src/foo.sass` +* [Compass Core] Split out `+hide-text` as its own mixin. + (Credit: [Andrew Vit][avit]) +* Some code cleanup for the compass project compiler. +* Removed the dependency on RMagic for grid image generation. + (Credit: [Richard Wöber][der-rich]) + +0.10.0.pre2 (November 30, 2009) +-------------------------------- +Bug fixes: + +* The line-height in the compass reset should have been 1 and not 1em. +* Fixed the reference in the rails initializer to the compass configuration file. +* Use the correct error formatting function based on what sass version is installed. +* Boolean properties like line_comments can now be set to false in configuration files + +0.10.0.pre1 (November 29, 2009) +-------------------------------- + +Deprecated in this release: + +* The usless blueprint "modules" folder will be removed. Please update your + blueprint imports by removing the modules folder. Deprecation warnings will be + emitted if you use the old imports. +* Blueprint mixins that used to accept a "body selector" argument, are now + deprecated, instead you should pass `true` to them and mix them into + the selector of your choice. +* If you are using the `+opacity` or `+inline-block` mixins, you may need to update your imports. +* In your configuration file, setting `http_images_path` to `:relative` is + deprecated in favor of setting `relative_assets` to `true` +* The YUI framework has been extracted to a plugin. + If you use it, please follow the [installation instructions](http://github.com/chriseppstein/yui-compass-plugin) + +Command-Line: + +* The compass command-line tool has been re-written to allow be easier to + use and be more flexible. The old command line is still supported at + this time. "compass help" will get you started on using the new + command line syntax. +* Allow specification of a height for the grid image +* For the truly hardcore compass users, you may now create a + compass project using "compass create my_project --bare" + and you'll have a completely bare project created for you with no + sass files provided for you. +* Get stats on your compass project with "compass stats". You'll + need to install the "css_parser" ruby gem to get stats on your + css files. + +Configuration: + +* The entire configuration infrastructure has been re-written to make it + easier to support the various sources of configuration data (project type, + config file, command line, and hard coded defaults) +* Whether to generate relative links to assets is now controlled by a + separate boolean configuration flag called `relative_assets` in the + configuration file and `--relative-assets` on the command line. + Setting `http_images_path` to `:relative` is deprecated. +* You may now configure the http locations for your project by simply setting + `http_path` for the top level path of the project. You + may also set `http_images_dir`, `http_stylesheets_dir`, and + `http_javascripts_dir` relative to the `http_path` instead of + setting the absolute `http_XXX_path` counterparts. +* You may now configure the fonts directory for your project (fonts_dir). + By default, for standalone projects, it is the "fonts" subdirectory of + your css directory. Rails projects will default to "public/fonts". + +Compass Core: + +* A new helper function `stylesheet_url(path)` can now be used to refer + to assets that are relative to the css directory. +* Compass sprite mixins are now more flexible and feature rich. +* Fixed the append_selector function to allow comma-delimited selectors + for both arguments instead of just the first +* There is no longer any outline on unstyled links in the :active and :focused states. +* IE6 bug fixes for sticky-footer +* New CSS3 Compatibility Mixins. You can import them all with `@import compass/css3.sass` + * `+opacity(amount)` where amount should be between 0 and 1, where 0 is transparent and 1 is opaque. + * `+opaque` and `+transparent` mixins for convenience. Built on top of the opacity mixin. + * `+border-radius(amount)` as well as the following convenience mixins: + * `+border-top-left-radius(amount)` + * `+border-top-right-radius(amount)` + * `+border-top-right-radius(amount)`, + * `+border-bottom-left-radius(amount)` + * `+border-bottom-right-radius(amount)` + * `+border-top-radius(amount)` + * `+border-right-radius(amount)` + * `+border-left-radius(amount)` + * `+border-bottom-radius(amount)` + * `+box-shadow(!horiz_offset, !vert_offset, !blur, !color)` + * `+box-sizing(!sizing_mode)` + * Column support via the following mixins: + * `+column-count` + * `+column-gap` + * `+column-width` + * `+column-rule-width` + * `+column-rule-style` + * `+column-rule-color` + * `+column-rule` + * `+background-clip(clip)` where clip can be `padding-box` or `border-box` + * `+background-origin(origin)` where origin can be `padding-box`, `border-box`, or `content-box` + * `+background-size(size)` where size is a width and height. E.g. "50% 75%" + * `+font-face` should be mixed into the top level of your document. + Usage Example: `+font-face("this name", font-files("this.woff", "woff", "this.otf", "opentype"), "fonts/this.eot", "thisname")` + * Simple Background Gradient Support: + * `+gradient` - Generic background gradient mixin + * `+radial-gradient` - Radial gradient mixin + * `+linear-gradient` - Linear gradient mixin + * `+h-gradient` - Horizontal linear gradient mixin + * `+v-gradient` - Vertical linear gradient mixin + * `+text-shadow` - Create a text shadow effect. + * Transforms Support: + * `+transform` + * `+scale` + * `+rotate` + * `+translate` + * `+skew` + * Transition Support: + * `+transition-property` + * `+transition-duration` + * `+transition-timing-function` + * `+transition-delay` + * `+transition` + * The import for `+inline-block` has moved from compass/utilities/general/inline_block + to compass/css3/inline_block + * The import for `+opacity` has moved from compass/utilities/general/opacity + to compass/css3/opacity + * Note: If you are using the `+opacity` or `+inline-block` mixins, + you may need to update your imports. + +Blueprint: + +* Make the primary blueprint mixins easier to use by allowing them to be nested when passing true as the first argument. + The old approach of passing a selector as the first argument is now deprecated in favor of a simple flag to indicate nesting or not. + +YUI: + +* YUI was upgraded to 2.7.0 +* Yahoo has deprecated the YUI CSS framework, as such YUI has been extracted to a plugin. + If you use it, please install it with: `sudo gem install compass-yui` + +Extensions: + +* Extensions can now be installed locally by unpacking them into a project's + "extensions" directory. Rails projects use "vendor/plugins/compass/extenstions". +* Extensions can deliver html to projects if they like. The html can be in + haml and will be transformed to html and can contain inline, compass-enabled + sass. +* All files can be processed using ERB before being copied into the user's + project. +* Compass extensions can now add support for other application frameworks. + These extensions can help compass understand the project structure of that + framework as well as provide runtime integration for ruby-based apps. + Contact me if you plan to do this -- the first couple times may be a little + rough. +* Compass extensions can now add new command line commands. Contact me if you + plan to do this -- the first couple times may be a little rough. +* Extensions can now provide help documentation just after a project is + created and on demand when the user uses the command line help system. + This can be done via the manifest file or by adding a USAGE.markdown file + at the top level of the framework template. + +Miscellaneous: + +* The compass configuration object is no longer a singleton, this makes it + possible for other ruby software to manage multiple compass projects at a + time. +* Compass no longer requires rubygems in order to work, this is a ruby + best-practice. +* All sass provided by compass now uses css-style property syntax. +* The command line tool is now tested using the cucumber testing framework. + +Many thanks to the following Contributors: + + * Brandon Mathis - CSS3 (+opacity, +border-radius) and sprites + * Eric Meyer - CSS3 (+box-shadow, +columns, +box-sizing) + * Jacques Crocker - Merb Compatibility fixes + * Gabriel Mansour - Fixes to +unstyled-link + * John Debs - IE6 Fixes for +sticky-footer + * Brian Johnson - Upgraded to YUI 2.7.0 + * Beau Smith - fixing my dyslexia. + diff --git a/doc-src/content/CHANGELOG.markdown b/doc-src/content/CHANGELOG.markdown index 04f9a373..3e4cebe8 100644 --- a/doc-src/content/CHANGELOG.markdown +++ b/doc-src/content/CHANGELOG.markdown @@ -7,86 +7,17 @@ layout: article COMPASS CHANGELOG ================= -0.10.0.rc6 (May 8, 2010) ------------------------- -* [Compass Core] The configuration constant `$firefox2-ellipsis` has been - renamed to `$use-mozilla-ellipsis-binding` to reflect the fact that - it must be used for any version of mozilla less than 3.6. -* [CLI] The the new Sub-command based CLI will now recognize abbreviated - commands as long as the abbreviation is unambiguous. - For instance, `compass w` is a shortcut for `compass watch` and - `compass com` for `compass compile` but `compas co` will not work - for compile because it also matches `compass config`. -* [Rails] When configuring Sass during initialization, - Compass now passes the template locations as an array of tuples - instead of as a hash. This preserves ordering in all versions - of ruby and ensures that the deprecated imports do not take precedence. +0.10.0 (May 10, 2010) +--------------------- -0.10.0.rc5 (May 2, 2010) ------------------------- +This changelog entry is condensed from a very long beta release. You can read [the 0.10.0 beta release notes here](/docs/CHANGELOG-v0-10-0-beta/). -* [Rails] The default location for compass extensions has moved from - `vendor/plugins/compass/extensions` to `vendor/plugins/compass_extensions`. -* [Rails] The rails template has been updated to use the latest haml and compass versions. -* [Compass Core] Global reset no longer automatically resets the *:focus. - This allows browsers to use their default :focus styles which is considered - a best practice. If you wish to reset :focus styles simply include this in - your stylesheets: - `*:focus { @include reset-focus; }` -* [Compass Core] A new mixin `replace-text-with-dimensions` has been added. - This is the same as the `replace-text` mixin except that it will read the - dimensions from the image and set them for you on the element. -* [Compass Core] If you want Firefox 2 Support (via -moz-binding) for the - `ellipsis` mixin, you must now set `$firefox2-ellipsis` to `true` before - importing the module. -* [Compass Core] The `compass/text/ellipsis` module is now imported - automatically by the `compass/text` module. -* [Compass Core] The gradient mixins now accept a background image that will - be placed over the gradient. Credit: [Will Leinweber](http://bitfission.com/) -* [Compass Core] You can now opt out of support for specific browsers in - the css3 module. See [the docs](/docs/reference/compass/css3/shared/) - for more details. - - -0.10.0.rc4 (April 27, 2010) ---------------------------- -* Lot of new docs can be found at: [http://compass-style.org/docs/](http://compass-style.org/docs/). -* The `unobtrusive-logo` mixin is deprecated and will be removed. - If you use this, please move the source to your project. -* The CSS3 modules were refactored to share a common implementation that - abstracts the browser prefixes that are supported and gives - greater control to the user over which prefixes are generated. - Depending on what mixins you were using you might see some changes to - what prefixes get generated by default and the order that they are - emitted. The goal of this change is to provide a more future-proof - implementation. -* The unnecessary import of the `float` module from the `hacks` module - was removed. If you were relying on this, you'll need to - import the float module explicitly now. -* The `pretty-bullets` mixin will now infer the image dimensions by - reading the image file if the image dimensions are not provided. -* The old CLI is now deprecated and a warning message will be printed - out if you use it. The new CLI is better and can be learned - by typing `compass help`. Credit: [Alexander Kahn](http://akahn.net) -* The `background-clip` mixin now accepts the value of `text`. Credit: [Thomas Reynolds]() -* The display: box model and associated properties are now part of the - css3 module. Credit: [Lorin Tackett](http://blog.lorintackett.com/) -* The compass gem is now built with a simple `gem build compass.gemspec`. - This should make it play nicer with tools like - [bundler](http://gembundler.org/). - -0.10.0.rc3 (April 13, 2010) ---------------------------- -* This release addresses several bugs in rc2. - -0.10.0.rc2 (April 12, 2010) ---------------------------- -**IMPORTANT:** +### Sass 3: * Compass now depends on Sass 3 -- Please be prepared to upgrade. Things won't break but you'll have a lot of deprecation warnings. Upgrading is pretty easy thanks to the `sass-convert` tool. See the - [Sass Changelog](http://beta.sass-lang.com/docs/yardoc/file.SASS_CHANGELOG.html) + [Sass Changelog](http://sass-lang.com/docs/yardoc/file.SASS_CHANGELOG.html) for more information. * All compass stylesheets are now written in the SCSS syntax, if you import compass framework stylesheets with an explicit @@ -102,151 +33,7 @@ COMPASS CHANGELOG * You may silence deprecation warnings by adding `sass_options = {:quiet => true}` to your configuration. -0.10.0.pre9 (March 6, 2010) ---------------------------- - -* Fix a ruby 1.9 bug in the image_size helper functions for jpeg images. -* Silence a deprecation warning. - - -0.10.0.pre7 & 0.10.0.pre8 (February 23, 2010) ---------------------------------------------- - -* Rails 3 compatibility fixes -* Fix for rgba colors with the new gradient mixins -* A better error message if a color stop list is not passed in to the gradient mixins. - -0.10.0.pre6 (February 22, 2010) -------------------------------- - -**IMPORTANT:** - -* Rails users need to update their compass initializer. -* The CSS 3 Gradient mixins were re-written and their usage has changed. - -Read on for the details: - -### CLI -* Fixed some issues with colorized output. -* Don't force the user to specify the configuration path when calling compass config - -### Compass Core -* Fix to the bang_hack mixin (Credit: Mark Rajcok) -* Support :first-child and :last-child pseudo selectors for +horizontal-list. (Credit: Cody Robbins) -* Clear the sticky footer so that it works correctly with grid layouts. -* The css3 gradient module has been re-written and has a new, much simpler mixins. If you have been using the css3 gradient mixins, you'll need to update your sass stylesheets. The new mixins can be seen in action [here](http://compass-style.org/examples/css3/gradients.html). -* Added new helper functions: `image_width("path/to/image.png")` & `image_height("path/to/image.png")` that return the size in pixels. (Credit: Deepak Jois & Richard Aday) - -### Blueprint -* Take margins into account in liquid grid. (Credit: Christoffer Eliesen) - -### Rails -* Several Rails 3 bug fixes (Credit: Jacques Crocker) -* Don't set unset options on the Sass::Plugin -* Fixed a setup bug and handle compass configuration changes at rails boot. - -**IMPORTANT:** Existing rails projects _must_ change their compass initializer file to: - - require 'compass' - rails_root = (defined?(Rails) ? Rails.root : RAILS_ROOT).to_s - Compass.add_project_configuration(File.join(rails_root, "config", "compass.rb")) - Compass.configure_sass_plugin! - Compass.handle_configuration_change! - -### Internals -* New APIs for dealing with configuration changes and accessing a compiler instance. -* Provide a convenience function for discovering extensions: `Compass.discover_extensions!` that can be called during project configuration w/ other ruby frameworks. - -### Extensions - -* Don't force an extension to register itself just because it has ruby code. - This makes it easier for extensions to provide Sass functions from ruby. - -Special thanks to Daniel Hofstetter for fixing my typos. - -0.10.0.pre5 (January 18, 2010) ------------------------------- -* Fixed a bug in the grid builder in ruby 1.8.6 (Credit: [Richard Wöber][der-rich]) -* Better sudo handling for the rails installer via environment variables or prompt. (Credit: Ryan Shaw, Evan Sharp) -* Removed support for the rip package manager. -* Support for scss files in the compass watcher. -* Cache buster timestamps were not working in some cases. -* Make ANSI color output work on windows. -* Command line switch (--boring) to turn off colorized output. -* Strip trailing slash from directory and path configuration variables. -* Added a --poll option to the compass watch subcommand to force polling. -* Fixed a test failure in ruby 1.9 due to faulty test code. -* Move the frameworks directory back to the top level. There's not actually a good reason for it to be buried in the ruby source. -* Upgrade FSSM. (Hopfully) Fixes a watcher issue that caused the watcher to not trigger for some users. -* Silence a deprecation warning in Rails 3. - -0.10.0.pre4 (January 04, 2010) ------------------------------- -* Fixed an FSSM loading issue that broke the compass watcher. -* Fixed some compatibility issues with edge versions of Sass. - -0.10.0.pre3 (January 02, 2010) ------------------------------- - -Bug fixes: - -* [Blueprint] Bug Fix: variable referenced in a non-script context within the - dquo mixin in the fancy_type module. -* [Rails] fixed win32 sudo incompatibility issue in the rails installer template. - (Credit: [Jonathan Silverman][jsilver]) -* [Rails] Update the gem dependencies for the rails installer template. -* If the configuration file changes, wipe out the sass cache and force compilation -* Upgrade the vendored version of FSSM to version 0.1.2. - Fixes some bugs with jruby and adds inotify support for linux. - (Credit: [Travis Tilley][ttilley]) -* Patched hide-text to account for items that are not left aligned. - (Credit: [Josh Pyles][pixelmatrix]) - -Minor Enhancements: - -* Support for SCSS files if haml edge is installed. -* Color any stderr or stdout output from the `Sass::Engine` red during compilation. -* [Configuration] The sass cache location can now be set in the compass config - file using the `cache_dir` property and the cache can be disabled by setting - `cache = false`. -* [Compass Core] `+min-height`, `+min-width`, and `+bang-hack` mixins in the - compass/utilities/general/min.sass module. - (Credit: [Adam Stacoviak][adamstac]) -* [Command Line] If you only want to compile certain files, you can now - specify them when invoking compass compile. E.g. `compass compile src/foo.sass` -* [Compass Core] Split out `+hide-text` as its own mixin. - (Credit: [Andrew Vit][avit]) -* Some code cleanup for the compass project compiler. -* Removed the dependency on RMagic for grid image generation. - (Credit: [Richard Wöber][der-rich]) - -0.10.0.pre2 (November 30, 2009) --------------------------------- -Bug fixes: - -* The line-height in the compass reset should have been 1 and not 1em. -* Fixed the reference in the rails initializer to the compass configuration file. -* Use the correct error formatting function based on what sass version is installed. -* Boolean properties like line_comments can now be set to false in configuration files - -0.10.0.pre1 (November 29, 2009) --------------------------------- - -Deprecated in this release: - -* The usless blueprint "modules" folder will be removed. Please update your - blueprint imports by removing the modules folder. Deprecation warnings will be - emitted if you use the old imports. -* Blueprint mixins that used to accept a "body selector" argument, are now - deprecated, instead you should pass `true` to them and mix them into - the selector of your choice. -* If you are using the `+opacity` or `+inline-block` mixins, you may need to update your imports. -* In your configuration file, setting `http_images_path` to `:relative` is - deprecated in favor of setting `relative_assets` to `true` -* The YUI framework has been extracted to a plugin. - If you use it, please follow the [installation instructions](http://github.com/chriseppstein/yui-compass-plugin) - -Command-Line: +### Command-Line: * The compass command-line tool has been re-written to allow be easier to use and be more flexible. The old command line is still supported at @@ -260,8 +47,12 @@ Command-Line: * Get stats on your compass project with "compass stats". You'll need to install the "css_parser" ruby gem to get stats on your css files. +* Command line switch (--boring) to turn off colorized output. +* Color any output from the `Sass::Engine` red during compilation. +* If you only want to compile certain files, you can now + specify them when invoking compass compile. E.g. `compass compile src/foo.sass` -Configuration: +### Configuration: * The entire configuration infrastructure has been re-written to make it easier to support the various sources of configuration data (project type, @@ -278,82 +69,77 @@ Configuration: * You may now configure the fonts directory for your project (fonts_dir). By default, for standalone projects, it is the "fonts" subdirectory of your css directory. Rails projects will default to "public/fonts". +* The sass cache location can now be set in the compass config + file using the `cache_dir` property and the cache can be disabled by setting + `cache = false`. +* In your configuration file, setting `http_images_path` to `:relative` is + deprecated in favor of setting `relative_assets` to `true` -Compass Core: +### Rails: -* A new helper function `stylesheet_url(path)` can now be used to refer +**IMPORTANT:** Existing rails projects _must_ change their compass initializer file to: + + require 'compass' + rails_root = (defined?(Rails) ? Rails.root : RAILS_ROOT).to_s + Compass.add_project_configuration(File.join(rails_root, "config", "compass.rb")) + Compass.configure_sass_plugin! + Compass.handle_configuration_change! + +* The rails template has been updated to use the latest haml and compass versions. +* Compass now supports Rails 3, but asset_host and cache_buster integration is disabled. +* When configuring Sass during initialization, + Compass now passes the template locations as an array of tuples + instead of as a hash. This preserves ordering in all versions + of ruby and ensures that the deprecated imports do not take precedence. + +### Compass Core: + +* A new helper function `stylesheet-url(path)` can now be used to refer to assets that are relative to the css directory. * Compass sprite mixins are now more flexible and feature rich. -* Fixed the append_selector function to allow comma-delimited selectors +* Fixed the `append-selector` function to allow comma-delimited selectors for both arguments instead of just the first * There is no longer any outline on unstyled links in the :active and :focused states. -* IE6 bug fixes for sticky-footer * New CSS3 Compatibility Mixins. You can import them all with `@import compass/css3.sass` - * `+opacity(amount)` where amount should be between 0 and 1, where 0 is transparent and 1 is opaque. - * `+opaque` and `+transparent` mixins for convenience. Built on top of the opacity mixin. - * `+border-radius(amount)` as well as the following convenience mixins: - * `+border-top-left-radius(amount)` - * `+border-top-right-radius(amount)` - * `+border-top-right-radius(amount)`, - * `+border-bottom-left-radius(amount)` - * `+border-bottom-right-radius(amount)` - * `+border-top-radius(amount)` - * `+border-right-radius(amount)` - * `+border-left-radius(amount)` - * `+border-bottom-radius(amount)` - * `+box-shadow(!horiz_offset, !vert_offset, !blur, !color)` - * `+box-sizing(!sizing_mode)` - * Column support via the following mixins: - * `+column-count` - * `+column-gap` - * `+column-width` - * `+column-rule-width` - * `+column-rule-style` - * `+column-rule-color` - * `+column-rule` - * `+background-clip(clip)` where clip can be `padding-box` or `border-box` - * `+background-origin(origin)` where origin can be `padding-box`, `border-box`, or `content-box` - * `+background-size(size)` where size is a width and height. E.g. "50% 75%" - * `+font-face` should be mixed into the top level of your document. - Usage Example: `+font-face("this name", font-files("this.woff", "woff", "this.otf", "opentype"), "fonts/this.eot", "thisname")` - * Simple Background Gradient Support: - * `+gradient` - Generic background gradient mixin - * `+radial-gradient` - Radial gradient mixin - * `+linear-gradient` - Linear gradient mixin - * `+h-gradient` - Horizontal linear gradient mixin - * `+v-gradient` - Vertical linear gradient mixin - * `+text-shadow` - Create a text shadow effect. - * Transforms Support: - * `+transform` - * `+scale` - * `+rotate` - * `+translate` - * `+skew` - * Transition Support: - * `+transition-property` - * `+transition-duration` - * `+transition-timing-function` - * `+transition-delay` - * `+transition` - * The import for `+inline-block` has moved from compass/utilities/general/inline_block - to compass/css3/inline_block - * The import for `+opacity` has moved from compass/utilities/general/opacity - to compass/css3/opacity - * Note: If you are using the `+opacity` or `+inline-block` mixins, - you may need to update your imports. + Read the [documentation][http://compass-style.org/docs/reference/compass/css3/]. +* The import for `+inline-block` has moved from "compass/utilities/general/inline_block" + to "compass/css3/inline-block". +* The import for `+opacity` has moved from "compass/utilities/general/opacity" + to "compass/css3/opacity" +* Note: If you are using the `+opacity` or `+inline-block` mixins, + you may need to update your imports. +* `+min-height`, `+min-width`, and `+bang-hack` mixins in the + compass/utilities/general/min.sass module. (Credit: [Adam Stacoviak][adamstac]) +* Split out `+hide-text` as its own mixin. (Credit: [Andrew Vit][avit]) +* Support :first-child and :last-child pseudo selectors for +horizontal-list. (Credit: Cody Robbins) +* Added new helper functions: `image_width("path/to/image.png")` & `image_height("path/to/image.png")` that return the size in pixels. (Credit: Deepak Jois & Richard Aday) +* The `pretty-bullets` mixin will now infer the image dimensions by + reading the image file if the image dimensions are not provided. +* In addition to installing the `binding.xml`, the configuration constant + `$use-mozilla-ellipsis-binding` must now be set to `true` + to support any version of mozilla less than 3.6 in the `+ellipsis` mixin. -Blueprint: +### Blueprint: -* Make the primary blueprint mixins easier to use by allowing them to be nested when passing true as the first argument. - The old approach of passing a selector as the first argument is now deprecated in favor of a simple flag to indicate nesting or not. +* The useless blueprint "modules" folder will be removed. Please update your + blueprint imports by removing the modules folder. Deprecation warnings will be + emitted if you use the old imports. +* Blueprint mixins that used to accept a "body selector" argument, are now + deprecated, instead you should pass `true` to them and mix them into + the selector of your choice. +* Make the primary blueprint mixins easier to use by allowing them to be + nested when passing true as the first argument. + The old approach of passing a selector as the first argument is now deprecated + in favor of a simple flag to indicate nesting or not. +* Take margins into account in liquid grid. (Credit: Christoffer Eliesen) -YUI: +### YUI: * YUI was upgraded to 2.7.0 * Yahoo has deprecated the YUI CSS framework, as such YUI has been extracted to a plugin. - If you use it, please install it with: `sudo gem install compass-yui` + If you use it, please [install it](http://github.com/chriseppstein/yui-compass-plugin). -Extensions: +### Extensions: * Extensions can now be installed locally by unpacking them into a project's "extensions" directory. Rails projects use "vendor/plugins/compass/extenstions". @@ -374,25 +160,20 @@ Extensions: This can be done via the manifest file or by adding a USAGE.markdown file at the top level of the framework template. -Miscellaneous: +### Miscellaneous: +* Lot of new docs can be found at: [http://compass-style.org/docs/](http://compass-style.org/docs/). * The compass configuration object is no longer a singleton, this makes it possible for other ruby software to manage multiple compass projects at a time. * Compass no longer requires rubygems in order to work, this is a ruby best-practice. -* All sass provided by compass now uses css-style property syntax. * The command line tool is now tested using the cucumber testing framework. - -Many thanks to the following Contributors: - - * Brandon Mathis - CSS3 (+opacity, +border-radius) and sprites - * Eric Meyer - CSS3 (+box-shadow, +columns, +box-sizing) - * Jacques Crocker - Merb Compatibility fixes - * Gabriel Mansour - Fixes to +unstyled-link - * John Debs - IE6 Fixes for +sticky-footer - * Brian Johnson - Upgraded to YUI 2.7.0 - * Beau Smith - fixing my dyslexia. +* Removed support for the rip package manager. +* Removed the dependency on RMagic for grid image generation. + (Credit: [Richard Wöber][der-rich]) +* The `unobtrusive-logo` mixin is deprecated and will be removed. + If you use this, please move the source to your project. 0.8.17 (September 24, 2009) ---------------------------