# HG changeset patch
# User Ludovic Chabant <ludovic@chabant.com>
# Date 1456980360 28800
# Node ID 8da29a497f61591d6dd43896e4b2590c16bf8405
# Parent  3ceeca7bb71c1e3444ab3748ff2685bcdb83069f
docs: Add information on more global `chef` options.

diff -r 3ceeca7bb71c -r 8da29a497f61 docs/docs/02_general/01_chef.md
--- a/docs/docs/02_general/01_chef.md	Tue Mar 01 22:27:28 2016 -0800
+++ b/docs/docs/02_general/01_chef.md	Wed Mar 02 20:46:00 2016 -0800
@@ -41,11 +41,29 @@
   run the command. This means you don't need to change the current working
   directory to that website, which can be necessary for scripting, for instance.
 
+* `--pid-file <file>` creates a PID file containing the PieCrust process ID for
+  the next command.
+
+
+### Configuration Changes
+
+Several global options relate to modifying the [website configuration][3]. This
+is useful if you want to override some of the configuration settings
+temporarily.
+
+> When you modify the configuration like this, PieCrust has to use a different
+> cache, because any change in the configuration can translate into any change
+> in the generated content. This means that you may notice some commands not
+> re-using cached outputs from previous commands.
+
 * `--config <name>` lets you specify a *configuration variant* to apply before
   running the command. A *configuration variant* is a fragment of website config
   that lets you override what's defined normally in `config.yml`. For more
   information, see the [website configuration][3] page.
 
+* `--config-set <name> <value>` lets you override _a specific configuration
+  setting_.
+
 [3]: {{docurl('general/website-config')}}
 
 
@@ -64,4 +82,6 @@
   debug information (like `--debug`) but only to the log file, which reduces
   spam in the console.
 
+* `--no-color` suppresses colored output. This can be useful if you want to
+  parse PieCrust's output without having to deal with weird ANSI color codes.