From c8e4d51396bedae937348334e7951fa5b5853a83 Mon Sep 17 00:00:00 2001
From: Nico Schottelius <nico@brief.schottelius.org>
Date: Mon, 16 Jan 2012 18:11:28 +0100
Subject: [PATCH] manifest, not initial

Signed-off-by: Nico Schottelius <nico@brief.schottelius.org>
---
 doc/dev/todo/niconext                 |  3 +--
 doc/man/man7/cdist-best-practice.text |  1 -
 doc/man/man7/cdist-manifest.text      | 39 ++++++++++++++++-----------
 doc/man/man7/cdist-tutorial.text      |  4 +--
 4 files changed, 26 insertions(+), 21 deletions(-)

diff --git a/doc/dev/todo/niconext b/doc/dev/todo/niconext
index 64ff681b..e1c19869 100644
--- a/doc/dev/todo/niconext
+++ b/doc/dev/todo/niconext
@@ -1,7 +1,6 @@
 - write tutorial
     - containing many links?!
-        - quickstart
-        - cdist-environment/startup/initial-setup (setup env)
+        - cdist-manifest
         - cdist-type
         - ...
         - cdist-hacker
diff --git a/doc/man/man7/cdist-best-practice.text b/doc/man/man7/cdist-best-practice.text
index 79bad2f9..6e5a476c 100644
--- a/doc/man/man7/cdist-best-practice.text
+++ b/doc/man/man7/cdist-best-practice.text
@@ -136,7 +136,6 @@ The following **.git/config** is taken from a a real world scenario:
 --------------------------------------------------------------------------------
 
 Have a look at git-remote(1) to adjust the remote configuration, which allows
-you to push certain branches to certain remotes.
 
 
 MULTI DEVELOPERS/DIFFERENT TRUST RELATIONSHIP/CENTRAL SERVER APPROACH
diff --git a/doc/man/man7/cdist-manifest.text b/doc/man/man7/cdist-manifest.text
index e7e783a3..917ea697 100644
--- a/doc/man/man7/cdist-manifest.text
+++ b/doc/man/man7/cdist-manifest.text
@@ -5,7 +5,20 @@ Nico Schottelius <nico-cdist--@--schottelius.org>
 
 NAME
 ----
-cdist-manifest - Define types to be used
+cdist-manifest - Using types
+
+DESCRIPTION
+-----------
+Manifests exist to define which configurations should be applied to a specific
+host as well as to define which configurations should be applied within a
+type. Manifests are executed locally and the resulting objects are stored in
+an internal database.
+
+The same object can be redefined in multiple different manifests as long as
+the parameters are exactly the same.
+
+In general, manifests are used to define which types are used depending
+on given conditions.
 
 
 DEFINE STATE IN THE INITIAL MANIFEST
@@ -47,23 +60,15 @@ command. Use **ls conf/type** to get a list of available types. If you have
 setup the MANPATH correctly as, you can use **man cdist-reference** to access
 the reference with pointers to the manpages.
 
+INITIAL VS. TYPE MANIFEST
+-------------------------
 
-DESCRIPTION
------------
-Manifests exist to define which configurations should be applied to a specific
-host as well as to define which configurations should be applied within a
-type. Manifests are executed locally and the resulting objects are stored in
-an internal database.
-
-The same object can be redefined in multiple different manifests as long as
-the parameters are exactly the same.
-
-In general, manifests are used to define which types are used depending
-on given conditions.
+MANAGING YOUR OWN CONFIGURATION
 
 
-EXAMPLE
--------
+
+EXAMPLES
+--------
 The initial manifest may for instance contain the following code:
 
 --------------------------------------------------------------------------------
@@ -106,10 +111,14 @@ require="__file/etc/cdist-configured __link/tmp/cdist-testfile" \
 
 --------------------------------------------------------------------------------
 
+If you do not specify
+
+FIXME: autorequire
 
 SEE ALSO
 --------
 - cdist-type(7)
+- cdist-tutorial(7)
 
 
 COPYING
diff --git a/doc/man/man7/cdist-tutorial.text b/doc/man/man7/cdist-tutorial.text
index efdd1e58..e50ccc3c 100644
--- a/doc/man/man7/cdist-tutorial.text
+++ b/doc/man/man7/cdist-tutorial.text
@@ -22,11 +22,9 @@ cdist-quickstart::
 cdist-bootstrap::
     The comprehensive guide to your first cdist installation [beginner]
 
-cdist-initial-manifest::
+cdist-manifest::
     Learn how to define which hosts get which configurations [beginner]
 
-    MANAGING YOUR OWN CONFIGURATION
-
 cdist-type::
     Understand how types are working and created [intermediate]