Add starting versions for Dart CLI features

I'm leaving these out for features that have been supported since
1.0.0, since they're available in effectively all versions.
This commit is contained in:
Natalie Weizenbaum 2019-04-30 11:05:53 -07:00
parent 6729c6fb54
commit bbdac76437

View File

@ -36,6 +36,8 @@ SCSS unless the [`--indented` flag][] is passed.
### Many-to-many Mode
<% impl_status dart: '1.4.0' %>
```
sass [<input.css>:<output.css>] [<input/>:<output/>]...
```
@ -138,6 +140,8 @@ h1{font-size:40px}
#### `--no-charset`
<% impl_status dart: '1.19.0' %>
This flag tells Sass never to emit a `@charset` declaration or a UTF-8
[byte-order mark][]. By default, or if `--charset` is passed, Sass will insert
either a `@charset` declaration (in expanded output mode) or a byte-order mark
@ -160,6 +164,8 @@ h1::before {
#### `--update`
<% impl_status dart: '1.4.0' %>
If the `--update` flag is passed, Sass will only compile stylesheets whose
dependencies have been modified more recently than the corresponding CSS file
was generated. It will also print status messages when updating stylesheets.
@ -171,6 +177,8 @@ Compiled themes/light.scss to public/css/light.css.
### Source Maps
<% impl_status dart: '1.3.0' %>
<%= partial 'documentation/snippets/source-maps' %>
Dart Sass generates source maps by default for every CSS file it emits.
@ -231,6 +239,8 @@ $ sass --embed-source-map sass/style.scss css.style.css
#### `--watch`
<% impl_status dart: '1.6.0' %>
This flag acts like the [`--update` flag][], but after the first round
compilation is done Sass stays open and continues compiling stylesheets whenever
they or their dependencies change.
@ -247,6 +257,8 @@ Compiled themes/dark.scss to public/css/dark.css.
#### `--poll`
<% impl_status dart: '1.8.0' %>
This flag, which may only be passed along with `--watch`, tells Sass to manually
check for changes to the source files every so often instead of relying on the
operating system to notify it when something changes. This may be necessary if
@ -263,6 +275,8 @@ Compiled themes/dark.scss to public/css/dark.css.
#### `--stop-on-error`
<% impl_status dart: '1.8.0' %>
This flag tells Sass to stop compiling immediately when an error is detected,
rather than trying to compile other Sass files that may not contain errors. It's
mostly useful in [many-to-many mode][].
@ -279,6 +293,8 @@ Error: Expected expression.
#### `--interactive`
<% impl_status dart: '1.5.0' %>
This flag (abbreviated `-i`) tells Sass to run in interactive mode, where you
can write [SassScript expressions][] and see their results. Interactive mode
also supports [variables][].
@ -322,6 +338,8 @@ Error: Incompatible units em and px.
#### `--no-unicode`
<% impl_status dart: '1.17.0' %>
This flag tells Sass only to emit ASCII characters to the terminal as part of
error messages. By default, or if `--unicode` is passed, Sass will emit non-ASCII
characters for these messages. This flag does not affect the CSS output.