merge master

Signed-off-by: Steven Armstrong <steven@icarus.ethz.ch>

doc/man/cdist-best-practice.text

@@ -1,10 +1,10 @@
-cdist-best-practise(7)
+cdist-best-practice(7)
 ======================
 Nico Schottelius <nico-cdist--@--schottelius.org>
 
 NAME
 ----
-cdist-best-practise - Practises used in real environments
+cdist-best-practice - Practices used in real environments
 
 
 PASSWORDLESS CONNECTIONS
@@ -61,7 +61,6 @@ machine-b % git clone git://your-git-server/cdist
 --------------------------------------------------------------------------------
 
 
-
 SEE ALSO
 --------
 - cdist(7)

doc/man/cdist-cache.text

@@ -0,0 +1,31 @@
+cdist-cache(1)
+==============
+Nico Schottelius <nico-cdist--@--schottelius.org>
+
+
+NAME
+----
+cdist-cache - Cache output of last run
+
+
+SYNOPSIS
+--------
+cdist-cache TARGET_HOST
+
+
+DESCRIPTION
+-----------
+cdist-cache moves away the objects created during last run so the
+next run can use the previous information and compare them with
+the current status.
+
+
+SEE ALSO
+--------
+cdist(7)
+
+
+COPYING
+-------
+Copyright \(C) 2011 Nico Schottelius. Free use of this software is
+granted under the terms of the GNU General Public License version 3 (GPLv3).

doc/man/cdist.text

@@ -10,8 +10,13 @@ cdist - Configuration management system
 
 DESCRIPTION
 -----------
-Cdist is a very simple, elegant, cleanly designed configuration management
-system. The easiest way to get started with cdist is to run cdist-quickstart.
+Cdist is a usable configuration management system.
+The easiest way to get started with cdist is to initialise
+the environment and run cdist-quickstart:
+
+--------------------------------------------------------------------------------
+eval `./bin/cdist-env` && cdist-quickstart
+--------------------------------------------------------------------------------
 
 Cdist configurations are written in the shell scripting language.
 The mapping of configurations to hosts is defined in so called manifests,