3.4.22 (28 March 2016)
* Sass now runs without warnings when running ruby with code style
warnings enabled.
* Sass no longer watches the current working directory unless it is on
the load path or the files being compiled are in the current working
directory. This was causing performance issues for users with large
numbers of files in their project directory. Issue #1562, Issue #1966,
Issue #2006.
* sass-convert now accepts a -q and --quiet option to disable ouput
while it is running.
* Fixed a bug in sass-convert when recursively processing CSS files into
Sass files which caused the process to crash without processing any
files. Issue #1827,
Deprecation – Must Read!
* Support for Ruby 1.8.7 and 1.9.3 is deprecated. See this blog post for
details.
* The current handling of CSS variables is deprecated. In order to
support the CSS spec as fully as possible, no Sass-specific constructs
other than #{} will be supported in CSS variable values. For
forwards-compatibility, any SassScript being used in CSS variables
must be moved into #{}.
3.4.21 (11 January 2016)
This is a bug fix release.
* Consistent output formatting for numbers close to an integer.
Issue #1931
* Correctly round negative numbers that were almost but not quite a whole
number (slightly greater than the negative number).
Issue #1938
* Don't strip escaped semicolons from compressed output.
Issue #1932
* Only compress around dashes within nth selectors.
Issue #1933
* Selector compression of whitespace around commas was affecting attribute
values.
Issue #1947
* Make subtraction work when a unit is followed directly by a hyphen and then
a period. For example, 1em-.75em now returns 0.25em rather than
1em-0.75em. This is consistent with the behavior when the subtrahend begins
with a 0.
Issue #1954
3.4.20 (09 December 2015)
* Fix a bug with the rounding changes from 3.4.14 and 3.4.15 where some
negative numbers would incorrectly be rounded up instead of down.
* Better compression for :nth pseudoselectors with subtraction. Issue #1650
* Add support for the new supports() clause for CSS @import directives.
* Rounding numbers now respects Sass’s precision setting for numbers very
close to half an integer.
* Add support for the q unit, representing one quarter of a millimeter.
* Mitigate a race condition when multiple threads are using the same
Sass::Plugin object at once.
* In compressed mode, numbers between -1 and 1 now have the leading 0 omitted.
* Source maps now include source ranges for comments.
Deprecation – Must Read!
Certain ways of using #{} without quotes in property and variable values have
been deprecated in order to simplify the feature.
Currently, #{} behaves unpredictably. If it’s used near operators, it will
cause those operators to become part of an unquoted string instead of having
their normal meaning. This isn’t an especially useful feature, and it makes
it hard to reason about some code that includes #{}, so we’re getting rid of
it.
In the new world, #{} just returns an unquoted string that acts like any other
unquoted string. For example, foo + #{$var} will now do the same thing as foo
+ $var, instead of doing the same thing as unquote("foo + #{$var}").
In order to ease the transition, Sass will now emit deprecation warnings for
all uses of #{} that will change behavior in 4.0. We don’t anticipate many
warnings to appear in practice, and you can fix most of them automatically by
running sass-convert --in-place on the affected files.
For more details, see the blog post on the deprecation and the GitHub issue in
which it was planned.
3.4.17 (21 August 2015)
* Allow passing calc values to rgb/hsl color constructors.
* The source map end character for lists now correctly uses the end of the
list instead of the end of the first element in the list.
* Fix up some edge cases where extra semicolons could be added to unknown
directives in compressed mode.
* If you try to do a stupid color operation with a stupid value, the error
message will now be less stupid than it was.
* Make is-superselector("a > c d", "a > b c d") return false. This also fixes
some related @extend behavior.
* A / in a parenthesized list is consistently treated as a plain / unless it
meets the criteria for being treated as division.
* In sass-convert, ensure that literal /es are preserved.
3.4.16 (10 July 2015)
* When converting from Sass to SCSS or vice versa, double-space around nested
rules the same as around top-level rules.
* Compatibility with listen 3.
* Parse a minus operator with no surrounding whitespace (e.g. 20px-10px) the
same regardless of whether it’s being used in a static property.
3.4.15 (22 June 2015)
* Further improve rounding for various numeric operations.
* Be more explicit in the function documentation about functions being
immutable.
* Improve rounding in operator-based color operations.
Deprecations – Must Read!
* When using --stdin with the sass or scss executables, importing relative to
the working directory is deprecated. Having the working directory on the
load path was deprecated in 3.3 and removed in 3.4, but due to an oversight
the deprecation process never happened for files read over standard input in
particular. This is the first step of that process.
3.4.14 (22 May 2015)
* Further avoid race conditions when caching.
* Only emit one warning for each line that uses the deprecated form of
unquote().
* Stop parsing and emitting invalid @supports directives.
* Add a deprecation warning for using != to compare a number with units to a
number without. Such a warning already existed for ==.
* Improve rounding of the results of color operations.
3.2.15 (7 March 2014)
* Support &.foo when the parent selector has a newline followed by a comma.
3.2.14 (24 January 2014)
* Don't crash when parsing a directive with no name in the indented syntax.
* Clean up file paths when importing to avoid errors for overlong path names.
* Parse calls to functions named true, false, and null as function calls.
* Don't move CSS @imports to the top of the file unless it's necessary.
3.2.13 (19 December 2013)
* Numbers returned by user-defined functions now trigger division, just like
numbers stored in variables.
* Support importing files in paths with open brackets.
* Fix sass-convert's handling of rules with empty bodies when converting from
CSS.
* Fix CSS imports using url() with a quoted string and media queries.
3.2.12 (4 October 2013)
* Add a couple missing requires, fixing some load errors, especially when
using the command-line interface.
* Tune up some heuristics for eliminating redundant generated selectors. This
will prevent some selector elimination in cases where multi-layered @extend
is being used and where it seems intuitively like selectors shouldn't be
eliminated.
3.2.11 (27 September 2013)
* Fix @extend's semantics with respect to pseudo-elements. They are no longer
treated identically to pseudo-classes.
* A more understandable error is now provided when the -E option is passed to
the Sass command line in ruby 1.8
* Fixed a bug in the output of lists containing unary plus or minus operations
during sass <=> scss conversion.
* Avoid the IE7 content: counter bug with content: counters as well.
* Fix some thread-safety issues.
3.2.10
* Use the Sass logger infrastructure for @debug directives.
* When printing a Sass error into a CSS comment, escape */ so the comment
doesn¡Çt end prematurely.
* Preserve the ! in /*! ... */-style comments.
* Fix a bug where selectors were being incorrectly trimmed when using @extend.
* Fix a bug where sass --unix-newlines and sass-convert --in-place are not
working on Windows (thanks SATO Kentaro).
3.2.9
* Fix a bug where @extends would occasionally cause a selector to be generated
with the incorrect specificity.
* Avoid loading listen v1.0, even if it¡Çs installed as a Gem (see issue 719).
* Update the bundled version of listen to 0.7.3.
* Automatically avoid the IE7 content: counter bug.
3.2.8
* Fix some edge cases where redundant selectors were emitted when using @extend.
* Fix a bug where comma-separated lists with interpolation could lose elements.
* Fix a bug in sass-convert where lists being passed as arguments to functions
or mixins would lose their surrounding parentheses.
* Fix a bug in sass-convert where null wasn¡Çt being converted correctly.
* Fix a bug where multiple spaces in a string literal would sometimes be
folded together.
* sass and sass-convert won¡Çt create an empty file before writing to it. This
fixes a flash of unstyled content when using LiveReload and similar tools.
* Fix a case where a corrupted cache could produce fatal errors on some
versions of Ruby.
* Fix a case where a mixin loop error would be incorrectly reported when using
@content.
COMMENT should not be longer than 70 characters.
COMMENT should not begin with 'A'.
COMMENT should not begin with 'An'.
COMMENT should not begin with 'a'.
COMMENT should not end with a period.
COMMENT should start with a capital letter.
pkglint warnings. Some files also got minor formatting, spelling, and style
corrections.
3.2.7
* The index and zip functions now work like all other list functions and treat
individual values as single-element lists.
* Avoid stack overflow errors caused by very long function or mixin argument
lists.
* Emit relative paths when using the --line-comments flag of the sass
executable.
* Fix a case where very long numbers would cause the SCSS parser to take
exponential time.
3.2.6
* Support for Rubinius 2.0.0.rc1. All tests pass in 1.8 mode. 1.9 mode has
some tests blocked on Rubinius issue 2139.
* Support for JRuby 1.7.2.
* Support for symlinked executables. Thanks to Yin-So Chen.
* Support for bubbling @supports queries in the indented syntax.
* Fix an incorrect warning when using @extend from within nested @media
queries.
* Update the bundled version of listen to 0.7.2.
3.2.5
* Fix a bug where bogus @extend warnings were being generated.
* Fix an @import bug on Windows. Thanks to Darryl Miles.
* Ruby 2.0.0-preview compatibility. Thanks to Eric Saxby.
* Fix incorrect line numbering when using DOS line endings with the indented
syntax.
3.2.4
* Fix imports from .jar files in JRuby. Thanks to Alex Hvostov.
* Allow comments within @import statements in SCSS.
* Fix a parsing performance bug where long decimals would occasionally take
many minutes to parse.
3.2.3
* sass --watch no longer crashs when a file in a watched directory is deleted.
* Allow @extend within bubbling nodes such as @media.
* Fix various JRuby incompatibilities and test failures.
* Work around a performance bug that arises from using @extend with
deeply-nested selectors.
3.2.2
* Add a --poll option to force sass --watch to use the polling backend to
Listen.
* Fix some error reporting bugs related to @import.
* Treat protocol-relative URLs in @imports as static URLs, just like http and
https URLs.
* Improve the error message for misplaced simple selectors.
* Fix an option-handling bug that was causing errors with the Compass URL
helpers.
* Fix a performance issue with @import that only appears when ActiveSupport is
loaded.
* Fix flushing of actions to stdout. Thanks to Russell Davis
(http://github.com/russelldavis).
* Fix the documentation for the max() function.
* Fix a @media parsing bug.
Deprecations -- Must Read!
* Sass will now print a warning when it encounters a single @import statement
that tries to import more than one file. For example, if you have @import
"screen" and both screen.scss and _screen.scss exist, a warning will be
printed. This will become an error in future versions of Sass.
3.1.16
* Fix some bugs in sass-convert selector parsing when converting from CSS.
* Substantially improve compilation performance on Ruby 1.8.
* Support the @-moz-document directive¡Çs non-standard url-prefix and domain
function syntax.
* Support the @supports directive.
* Fix a performance issue when using /*! */ comments with the Rails asset
pipeline.
* Support -moz-element.
* Properly handle empty lists in sass-convert.
* Move from FSSM to Listen for file-system monitoring.
3.1.12
* Compatibility with the mathn library (thanks to Thomas Walpole).
* Fix some infinite loops with mixins that were previously uncaught.
* Catch infinite @import loops.
* Fix a deprecation warning in sass --update and --watch (thanks to Marcel
Köppen).
* Don’t make $important a special pre-initialized variable.
* Fix exponential parsing time of certain complex property values and
selectors.
* Properly merge @media directives with comma-separated queries.
E.g.
@media foo, bar { @media baz { ... } } now becomes
@media foo and baz, bar and baz { ... }.
3.1.11
* Allow control directives (such as @if) to be nested beneath properties.
* Allow property names to begin with a hyphen followed by interpolation
(e.g. -#{...}).
* Fix a parsing error with interpolation in comma-separated lists.
* Make --cache-store with with --update.
* Properly report ArgumentErrors that occur within user-defined functions.
* Don’t crash on JRuby if the underlying Java doesn’t support every Unicode
encoding.
* Add new updated_stylesheet callback, which is run after each stylesheet has
been successfully compiled. Thanks to Christian Peters.
* Allow absolute paths to be used in an importer with a different root.
* Don’t destructively modify the options when running
Sass::Plugin.force_update.
Deprecations – Must Read!
* The updating_stylesheet is deprecated and will be removed in a future
release. Use the new updated_stylesheet callback instead.
3.1.10
* Fix another aspect of the 3.1.8 regression relating to +.
3.1.9
* Fix a regression in 3.1.8 that broke the + combinator in selectors.
* Deprecate the loud-comment flag when used with silent comments
(e.g. //!). Using it with multi-line comments (e.g. /*!) still works.
3.1.8
* Deprecate parent selectors followed immediately by identifiers
(e.g. &foo). This should never have worked, since it violates the rule of &
only being usable where an element selector would.
* Add a --force option to the sass executable which makes --update always
compile all stylesheets, even if the CSS is newer.
* Disallow semicolons at the end of @import directives in the indented syntax.
* Don’t error out when being used as a library without requiring fileutil.
* Don’t crash when Compass-style sprite imports are used with
StalenessChecker (thanks to Matthias Bauer).
* The numeric precision of numbers in Sass can now be set using the
--precision option to the command line. Additionally, the default number of
digits of precision in Sass output can now be changed by setting
Sass::Script::Number.precision to an integer (defaults to 3). Since this
value can now be changed, the PRECISION constant in Sass::Script::Number has
been deprecated. In the unlikely event that you were using it in your code,
you should now use Sass::Script::Number.precision_factor instead.
* Don’t crash when running sass-convert with selectors with two commas in a
row.
* Explicitly require Ruby >= 1.8.7 (thanks Eric Mason).
* Properly validate the nesting of elements in imported stylesheets.
* Properly compile files in parent directories with --watch and --update.
* Properly null out options in mixin definitions before caching them. This
fixes a caching bug that has been plaguing some Rails 3.1 users.
3.1.6
* The option :trace_selectors can now be used to emit a full trace before each
selector. This can be helpful for in-browser debugging of stylesheet imports
and mixin includes. This option supersedes the :line_comments option and is
superseded by the :debug_info option.
* Fix a bug where long @if/@else chains would cause exponential slowdown under
some circumstances.
3.1.5
* Updated the vendored FSSM version, which will avoid segfaults on OS X Lion
when using --watch.
3.1.4
* Sass no longer unnecessarily caches the sass options hash. This allows
objects that cannot be marshaled to be placed into the options hash.
3.1.3
* Sass now logs message thru a logger object which can be changed to provide
integration with other frameworks¡Ç logging infrastructure.
ruby-compass pacakge.
# Sass
**Sass makes CSS fun again**. Sass is an extension of CSS3,
adding nested rules, variables, mixins, selector inheritance, and more.
It's translated to well-formatted, standard CSS
using the command line tool or a web-framework plugin.
Sass has two syntaxes. The new main syntax (as of Sass 3)
is known as "SCSS" (for "Sassy CSS"),
and is a superset of CSS3's syntax.
This means that every valid CSS3 stylesheet is valid SCSS as well.
SCSS files use the extension `.scss`.
The second, older syntax is known as the indented syntax (or just "Sass").
Inspired by Haml's terseness, it's intended for people
who prefer conciseness over similarity to CSS.
Instead of brackets and semicolons,
it uses the indentation of lines to specify blocks.
Although no longer the primary syntax,
the indented syntax will continue to be supported.
Files in the indented syntax use the extension `.sass`.
