Update README.md (#909)

Fixes wrong variable name in usage demo

Bumps web interface to version 4.0.8.

Version 4.0.8 release notes.

Fixes #899 - regression in optimizing pseudo class arguments.

Why:

* `+` character is both a 1) relation or 2) operator within
  pseudo class arguments; so these two use cases should be
  distinct.

Fixes edge case in remote stylesheet fetching.

Why:

* When a request results in an error or timeout then any further
  fetching should be aborted as callback has already been called.

Version 3.4.25 release notes.

Fixes #886 - better multi pseudo class / element merging.

Why:

* 4.0 introduced a stricter mergeability rules, however in some
  cases merging is still possible but harder to determine;
* tests suggested all multi pseudo class / element rules can be
  merged unless those contain more than one of the following:
  `:after`, `::after`, `:before`, `::before`, `:first-letter`,
  `::first-letter`, `:first-line`, `::first-line`, or `:lang`;
* there's also a new compatibility switch,
  `{ compatibility: { selectors: { multiplePseudoMerging: false } } }`
  which, if set to false, disables merging for all rules with
  multiple pseudo classes / elements.

Fixes #890 - adds toggle to disable empty tokens removal.

Why:

* Removing empty tokens (rules & blocks) was the only "optimization"
  which was not toggabble;
* introduces a side-effect in level 2 optimizations where rules that
  become empty as a result of complex optimizations are preserved.

Adds readme section about upcoming changes.

Covers changes introduced in #893.

Fixes #893 - `inline: false` as alias to `inline: 'none'`.

Why:

* So it matches other options where `false` means 'disable'.

Bumps version on master to 4.1.0-pre.

Bumps web interface to version 4.0.7.

Version 4.0.7 release notes.

Fixes #891 - merging vendor-prefixed pseudo classes.

Why:

* When a pseudo-class or pseudo-element was positioned after
  quoted string it was not extracted for mergeability comparison.

See #892 - adds better `inline` option docs.

Bumps web interface to version 4.0.6.

Version 4.0.6 release notes.

Fixes #885 - don't strip quotes from `font-feature-settings`.

Why:

* Browsers don't get it right when without quotes;
* it'll all be better with whitelist based optimizations, see #889.

Bumps web interface to version 4.0.5.

Version 4.0.5 release notes.

Fixes #884 - handling absolute paths on Windows.

Why:

* There's a built-in `path.isAbsolute` which should have been used
  in the first place;
* `inlineLocalStylesheets` absolute path handling with be gone in
  the next major version when virtual absolute paths will be gone.

Fixes #880 - incorrect token type identification.

Why:

* When there is no space after nested block scope, e.g.
  `@media(` in `@media(min-width:100px)` it should still be
  handled correctly by tokenizer.

Adds #881 changelog entry.

Fix wrong require arity (#881)

Bumps web interface to version 4.0.4.

Version 4.0.4 release notes.

Fixes #879 - incorrect handling of spaces in paths.

Why:

* When reading sources passed in as array, paths need to be wrapped
  in `url()` so spaces are handled correctly.

Fixes #878 - invalid double backshlash tokenization.

Why:

* Any subsequent backslash escape character was treated as
  another escape sequence.

fix typo (#877)

s/ontrols/controls/

Fixes a typo in History.md.

Thx to @ngyikp for reporting.

Bumps web interface to version 4.0.3.

Version 4.0.3 release notes.

See #875 - adds missing History.md entry.

Fixes #875 - :facepalm: bug in semantic merging.

Why:

* This is still an under tested feature but we'll get there.

Bumps web interface to version 4.0.2.

Version 4.0.2 release notes.

Fixes #874 - regression in at-rule tokenization.

Why:

* Another case after #872 where at-rules were incorrectly
  tokenized because `propertyToken` wasn't reset.

Bumps web interface to version 4.0.1.

Version 4.0.1 release notes.

See #872 - two additional cases.

Unrelated to the ticket but should still be handled correctly.

Fixes #872 - edge case in tokenization.

Why:

* On closing curly brace `}` both `ruleToken` and `propertyToken`
  should be nullified to prevent incorrect property assignments.

Fixes #868 - accept absolute paths in input hash.

Thanks to @madwizard-thomas for bug investigation which turned
out to be correct.

Why:

* Internally all local URIs should be represented as relative
  paths normalized to *nix format so nothing else gets propagated
  to output styles or source maps;
* all remote URIs are kept as is.

Fixes #867 - skips optimizing variable values.

Why:

* It may not be the best idea as we don't know what a value
  represents and where it'll end up.

Fixes #866 - edge case in `inline` flag handling.

Why:

* When reverse order of options was used, so `remote,local`,
  a resource was incorrectly marked as not allowed;
* apparently we should always default remote URLs to disallowed,
  while local ones should be allowed by default.

chore(package): update browserify to version 14.0.0 (#871)

https://greenkeeper.io/

Re-enables batch tests on Windows. (#869)

Fix up assertEqualLineByLine(), checks if number of lines are equal before verifying content.

See #858 - updates web interface for clean-css 4.

Why:

* 4.0 changes lots of options and web users should still be able to
  apply all of them.

Version 4.0.0.

Updates acknowledgements section.

Thanks @alexlamsl, @ben-eb, @madwizard-thomas, and @ngyikp.

See #864 - adds better docs for optimization levels.

It's not obvious if level 2 is used that level 1 is on by
default, and that both configurations can be applied
at the same time.

Re-enables protocol tests on Windows.

Thanks to @alexlamsl for bringing it up and testing.

Why:

* Disabled as they errored on Windows in the past, but they seem to
  work fine now.

Reworks Readme to be more readable.

Why:

* Provides Table of contents at the top with quick links to
  interesting sections;
* Provides detailed description of available options with examples;
* Provides a FAQ section with various usage scenarios.

See #846 - moves CLI to a separate repository.

Moved to https://github.com/jakubpawlowicz/clean-css-cli

Why:

* At least 85% of top dependants use the API (see ticket) so
  removing CLI removes `commander` dependency for them;
* docs will be easier to follow as they describe API only;
* tests run 10x as fast since binary tests took 90% of time;
* CLI will be able to provide its own set of features which
  are not necessarilly provided or requred in API.

Drawbacks:

* It won't be straightforward to quickly test arbitrary CSS
  as binary is not available out of the box.

Cleans up serializer code.

Why:

* Makes serialization context always the first argument;
* renamed function names for better clarity.

Renames 'star' to 'asterisk'.

Why:

* This is the character's name.

Renames curly bracket constants.

Why:

* To match other bracket constants.

Renames `Token.BLOCK` to `Token.NESTED_BLOCK`.

Why:

* All CSS blocks can be nested so this name reflects
  this rule better.

Simplifies `split` helper code.

Why:

* Much of its complexity was due to old tokenizer which is no more;
* currently it serves as a way to splitting strings where commas
  inside round brackets are ignored.

Bumps copyright timestamps to 2017.

Fixes linting warning in specificity module.

Moves API options setup to `options` folder-space.

Why:

* So it lives alongside optimization level and formatting setup.

Bumps online version to clean-css 3.4.24.

Version 3.4.24 release notes.

Fixes #859 - avoids `-webkit-border-radius` optimizations.

Why:

* Apparently it doesn't support shortening 4 values to 2, as the
  latter is taken as a horizontal + vertical radius in all corners;
* disabling any optimizations as a precaution;
* see http://jsfiddle.net/qnGKj/2881/

See #856 - adds missing History.md entry.

Fixes #863 - adds `transform` callback for custom optimizations.

Why:

* So users can apply custom optimizations without forking clean-css
  and learning how to plug such optimization in;
* may also aid in rewriting URLs after introduction of `rebaseTo`.

Fixes #856 - allows `minify` to return a promise.

Why:

* Useful as an alternative to callback API;
* future Node.js versions will support `await` mechanism
  which requires supporting promises.

Adds `overrideProperties` level 2 optimizations flag.

Why:

* Previously property overriding was controlled via `mergeIntoShorthands`
  flag which was confusing.

Moves 'compacting' code to 'properties' folder-space.

Why:

* All those optimizations are dealing with properties so the new
  name better reflects its role;

Also:

* renames `overrideCompactor` to `overrideProperties`;
* renames `compactorOptimize` to `optimizeProperties`.
* cleans up property optimizing code calling from level 2 optimizations
  due to removal of aggressive merging, see #290.

Renames `compactShorthands` level 2 option to `mergeIntoShorthands`.

Why:

* It better describes what this option does.

Makes compactable code more explicit.

Why:

* All unprefixed properties has to be declared explicitely,
  while vendor prefixed ones can be generated from them.

See #290 - adds removing IE filters.

Why:

* Internet Explorer `filter` / `-ms-filter` are unsupported since
  IE 10, which is also clean-css new default compatibility;
* can be restored by using `ie7`, `ie8`, or `ie9` compatibility
  modes.

See #290 - removes aggressive merging.

Why:

* Aggressive merging was replaced by override merging;
* it supports much more properties now so aggressive merging won't
  be missed;
* it also overrides based on understandability not merely a
  position in output file.

Side notes:

* This is a safe change as if a property is not configured to
  be overridable it won't be;
* overhauls `canOverride` functionality to prevent features like
  vendor prefixes or variables from overriding widely supported
  values;
* overhauls validating values by allowing known values, which
  strictly doesn't make it a full validator but rather a way
  of telling if a value *may* be valid.

See #290 - reworks `border` overriding.

Why:

* Border is a complex case where both `border` and all its
  components: `border-color`, `border-style`, and `border-width`
  are components. Also `border-(bottom|left|right|top)` are
  shorthands too.
* this commit restores aggressive merging shorthand overriding right
  inside shorthand compacting code.

See #290 - disables `font` shorthand overriding.

Why:

* It's a shorthand property, so not straightforward to implement
  in shorthand/override compacting;
* pending in #254.

See #290 - disables `transition` shorthand overriding.

Why:

* It's a shorthand property, so not straightforward to implement
  in shorthand/override compacting;
* pending in #861.

See #290 - disables `animation` shorthand overriding.

Why:

* It's a shorthand property, so not straightforward to implement
  in shorthand/override compacting;
* pending in #860.

See #857 - removes redundant source map code.

Thanks to @alexlamsl for spotting it.

Why:

* Tracking input source map is done in #minify method already.

Fixes #857 - normalizes CleanCSS API interface.

Why:

* `sourceMap` option has to be a boolean now;
* input source map can be passed as a 2nd argument to `minify`
  method, making callback a 3rd;
* all other options are stateless so should be the `sourceMap`.

Refactors validator into a set of functions.

Why:

* There's no need to keep it as an object, since configuration
  can also be passed in.

See #799 - speeds up serializing code.

Why:

* Instead of using an `if` branch implements wrapping and tracking
  as a callback with `no-op` implementation when wrapping is disabled.

See #799 - adds an option to wrap output at arbitrary column.

Why:

* As not all clients (i.e. email clients) like CSS in one line.

See #799 - changes formatting defaults.

Why:

* When formatting is turned on it defaults to no formatting, so
  any options need to be applied on top of these;
* adds `beautify` preset for the previous default, e.g.
  `cleancss --format beautify one.css`.

See #799 - renames `beautify` option to `format`.

Why:

* It makes more sense as it controls formatting in general;
* see #209 where `beautify` was introduced.

See #799 - adds granular formatting options.

Why:

* To allow better control over how output is formatted;
* also gets rid of `keepBreaks` option in favor to
  `{ beautify: 'keep-breaks' }` shortcut.

See #773 - speeds up specificity lookup.

Why:

* Calculating it is slow, but, since it's done repeatedly for
  the same selectors, it can be cached quite effectively.

Fixes #773 - adds reordering based on selector specificity.

Why:

* Rules with different specificity can be safely reordered as those
  with higher value will always override those with lower;
* there is no way to determine whether the latter can be ignored
  because HTML context is not known;
* this is a level 2 optimization which are off by default.

See #425 - nitpicking natural sorting algorithm.

Thanks to @alexlamsl for spotting these.

Fixes #425 - enables natural method of sorting selectors.

Still defaults to standard sorting but natural becomes
a new option. Controlled via `selectorsSortingMethod`
option in level 1 optimizations.

Why:

* Natural way could be a more compression-efficient way;
* it's easier to read for a human.

See #425 - adds natural sorting algorithm.

Why:

* We need it to sort selectors accordingly.

Always run CI on Node.js 7 too.

At this moment it's a current version of Node.js so it'd be good
to run tests on it.

See: https://github.com/nodejs/LTS

Fixes #853 - renames level 2 options.

Why:

* To match level 1 wording which feels more natural.

Restores proper multiple level handling in CLI.

Why:

* Apparently the earlier change to a single dash option
  broke using multiple optimization levels at once.
  This commit restores it.

Adds examples of `all` keyword in level 1/2 optimizations.

Why:

* So the option is documented properly.

Allows `all` shortcut in level 1 optimizations config.

Why:

* To enable/disable all options at once;
* note non-boolean options are ignored when `all` / `*` is used.

Inverts some level 1 options for consistency.

@alexlamsl made a good point that when we have `all` shortcut,
to set all options at once, it'd be good if value given would
mean the same to all options.

Adds granular control over level 1 optimizations.

Why:

* So users can turn them on/off selectively;
* still keeping sane defaults for most users.

Note: moves `properties.fontWeight` compatibility flag to level 1
optimizations as that's not a compatibility flag, but rather a
user preference - see #756.

Renames level 1 optimizations test file.

Reorganizes level 1 optimizations.

Why:

* Slightly more coherent now, will get more love in 4.1.

See #731 - adds granular control over level 2 optimizations.

Why:

* So users can selectively disable certain optimizations if they
  want to.