1
0
Fork 0
mirror of https://github.com/haml/haml.git synced 2022-11-09 12:33:31 -05:00

[Sass] Document some of the new sass-convert stuff in the CHANGELOG.

This commit is contained in:
Nathan Weizenbaum 2010-03-29 20:51:40 -07:00
parent 4aeab9649d
commit 9bc0c06157

View file

@ -25,6 +25,11 @@
Use `$` as a prefix instead. Use `$` as a prefix instead.
See also [this changelog entry](#3-0-0-dollar-prefix). See also [this changelog entry](#3-0-0-dollar-prefix).
* The `css2sass` command-line tool has been deprecated,
and will be removed in Sass 3.2.
Use the new `sass-convert` tool instead.
See also [this changelog entry](#3-0-0-sass-convert).
### Syntax Changes ### Syntax Changes
#### SassScript Context #### SassScript Context
@ -297,6 +302,32 @@ In fact, `--update` work exactly the same as `--watch`,
except that it doesn't continue watching the files except that it doesn't continue watching the files
after the first check. after the first check.
### `sass-convert` (née `css2sass`) {#3-0-0-sass-convert}
The `sass-convert` tool, which used to be known as `css2sass`,
has been greatly improved in various ways.
It now uses a full-fledged CSS3 parser,
so it should be able to handle any valid CSS3,
as well as most hacks and proprietary syntax.
It's also now possible to convert a file in-place --
that is, overwrite the old file with the new file.
This is useful for converting files in the [Sass 2 syntax](#3-0-0-deprecations)
to the new Sass 3 syntax,
e.g. by doing `sass-convert --in-place --from sass2 style.sass`.
#### Error Handling
Several bug fixes and minor improvements have been made, including:
* Fixing line-number reporting for errors on the last line of templates
that didn't have trailing newlines.
* Only displaying the text for the current line when reporting CSS parsing errors.
* Displaying the expected strings as strings rather than regular expressions
whenever possible.
### Error Backtraces ### Error Backtraces
Numerous bugs were fixed with the backtraces given for Sass errors, Numerous bugs were fixed with the backtraces given for Sass errors,
@ -373,18 +404,6 @@ colors will be output as the minimal possible representation.
This means whichever is smallest of the HTML4 color name This means whichever is smallest of the HTML4 color name
and the hex representation (shortened to the three-letter version if possible). and the hex representation (shortened to the three-letter version if possible).
### `css2sass` Error Handling
Several bug fixes and minor improvements have been made, including:
* Fixing line-number reporting for errors on the last line of templates
that didn't have trailing newlines.
* Only displaying the text for the current line when reporting CSS parsing errors.
* Displaying the expected strings as strings rather than regular expressions
whenever possible.
### Minor Changes ### Minor Changes
* If a CSS or Sass function is used that has the name of a color, * If a CSS or Sass function is used that has the name of a color,