From: Jakub Pawlowicz <contact@jakubpawlowicz.com>
Date: Mon, 23 Jan 2017 14:53:21 +0000 (+0100)
Subject: See #864 - adds better docs for optimization levels.
X-Git-Url: https://git.ndcode.org/public/gitweb.cgi?a=commitdiff_plain;h=80e2f4513f231865b6863abd3744de7153cad563;p=clean-css.git

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.
---

diff --git a/README.md b/README.md
index d9499fe7..9216052c 100644
--- a/README.md
+++ b/README.md
@@ -42,6 +42,7 @@ According to [tests](http://goalsmashers.github.io/css-minification-benchmark/)
   * [How to preserve a comment block?](#how-to-preserve-a-comment-block)
   * [How to rebase relative image URLs?](#how-to-rebase-relative-image-urls)
   * [How to work with source maps?](#how-to-work-with-source-maps)
+  * [How to apply level 1 & 2 optimizations at the same time?](#how-to-apply-level-1--2-optimizations-at-the-same-time)
   * [What level 2 optimizations do?](#what-level-2-optimizations-do)
   * [How to use clean-css with build tools?](#how-to-use-clean-css-with-build-tools)
   * [How to use clean-css from web browser?](#how-to-use-clean-css-from-web-browser)
@@ -299,6 +300,8 @@ new CleanCSS({
 
 Level 2 optimizations operate at rules or multiple properties level, e.g. can remove duplicate rules, remove properties redefined further down a stylesheet, or restructure rules by moving them around.
 
+Please note that if level 2 optimizations are turned on then, unless explicitely disabled, level 1 optimizations are applied as well.
+
 Here is a full list of available options:
 
 ```js
@@ -326,7 +329,7 @@ There is an `all` shortcut for toggling all options at the same time, e.g.
 ```js
 new CleanCSS({
   level: {
-    1: {
+    2: {
       all: false, // sets all values to `false`
       removeDuplicateRules: true // turns on removing duplicate rules
     }
@@ -512,6 +515,26 @@ new CleanCSS({ sourceMap: true, rebaseTo: pathToOutputDirectory }).minify({
 });
 ```
 
+## How to apply level 1 & 2 optimizations at the same time?
+
+Using the hash configuration specifying both optimization levels, e.g.
+
+```js
+new CleanCSS({
+  level: {
+    1: {
+      all: true,
+      normalizeUrls: false
+    },
+    2: {
+      restructureRules: true
+    }
+  }
+})
+```
+
+will apply level 1 optimizations, except url normalization, and default level 2 optimizations with rule restructuring.
+
 ## What level 2 optimizations do?
 
 All level 2 optimizations are dispatched [here](https://github.com/jakubpawlowicz/clean-css/blob/master/lib/optimizer/level-2/optimize.js#L67), and this is what they do: