cdist-language cleanup

Signed-off-by: Nico Schottelius <nico@kr.ethz.ch>

TODO-1.0

@@ -57,6 +57,8 @@ x execute code on client (stage 5)
                   - install packages only if not existent
                   - copy file only if different
             - cdist                 [IMPORTANT]
+               - explain the general approach
+               - give right pointers
             - cdist-explorers
          - add terminology
          - define steps within configuration apply
@@ -79,8 +81,9 @@ x execute code on client (stage 5)
    - cdist-type integration!
    - DOC document "cd $__object_dir, before running manifest" in doc/man/cdist-types.text
    - DOC document that $type/manifest is executed for every object/instance
-   - DOC: types can always access __cdist_out_objects, __cdist_out_explorers, __cdist_out_execs
+   - DOC: exported variables:
-      --> create cdist-variables document?
+      __type, __explorer, __type_explorer, __object, __object_id
+
    - cleanup READMEs
    - Check all references in manpages, ensure all manpages exist
 

doc/dev/todo/post-1.0

@@ -3,6 +3,9 @@ Core:
       - probably name them only_once and use that as the internal id!
    - remove remote_base_dir at beginning - otherwise fragments from
      previous runs may still be existing!
+      -> probably also local_base_dir!
+   - cdist-deploy-to: Configure more than one host
+      - plus parallel mode like in ccollect
 
 Type handler:
    - add dependency parameters to core available for every type

doc/man/cdist-language.text

@@ -16,31 +16,6 @@ A cdist configuration consists of the following parts:
 - library (cdist-language-library(7))
 - modules (cdist-language-modules(7))
 
-In short the configuration is built as follows:
-
-- conf/hosts/init is executed, the resulting output is used for module loading
-- the appropriate modules are loaded and executed, which
-- use library functions.
-
-The three stages are used to seperate configurations:
-
-- hosts contain mappings to created modules
-- modules create (probably site specific) configurations using library collections
-- the library is shipped with cdist, but can be extendet locally
-
-
-   - DSL: Shell!
-      - gives if, else and EVEN elsif for free!
-      - and case
-      - and and and
-      - and there's no os (solaris doesn't count) without a usable /bin/sh
-      - cdist defines what you can use
-         - you _can_ use os specific stuff
-         - but it's ugly and you shoot into your own foot
-      - "manifests" (use the same name here?) will be run/sourced
-         - inheritance possible via sourcing
-         - cdist-lib always preloaded
-
 - document exported variables!
    use __ prefix instead of __cdist (shorter writing, __ is defined as sytem anyway)
 

doc/man/cdist.text

@@ -8,35 +8,41 @@ NAME
 cdist - Configuration management system
 
 
+NEW DESCRIPTION
+-----------
+- is cm
+- quickstart - cdist-quickstart 
+- configured in shell dsl - pointers to posix and problems (sh != bash), os specific
+- how to apply - cdist-deploy-to
+- how to write - cdist-manifest, cdist-type
+- 
+
+
 DESCRIPTION
 -----------
-Cdist allows you to centrally define a configurations for
+Cdist is a very simple, elegant, cleanly designed configuration management
-UNIX systems and apply them. Cdist generally uses the push
+system. Cdist allows you to centrally define configurations for UNIX systems
-approach (a server pushes out the configuration to the clients),
+Cdist generally uses the push approach (a server pushes out the
-but can also be used the pull way (see cdist-push-pull(7)).
+configuration to the clients), but can also be used the pull way.
 
-Cdist-deploy-to(1) is the main command to be used to deploy
+Cdist-deploy-to is the main command to be used to configure a host.
-configurations to a host.
 
-The mapping of configurations to hosts is defined
+The mapping of configurations to hosts is defined in so called manifests,
-in so called manifests, which are written in shell
+which are written in shell script language.
-script language (see cdist-manifest(7)).
 
-Logical units of files and directives are called "types" in cdist jargon
+Logical units of functionality are called "types" in cdist jargon. Cdist ships
-(see cdist-types(7)). Cdist ships with some types, which you can change
+with some types, which you can change or create new ones or even submit your
-or create new ones or even submit your types for inclusion into mainstream
+types for inclusion into cdist.
-(see cdist-type-inclusion(7)).
 
-The fastest way to get a host configured using cdist is probably
+The fastest way to get a host configured using cdist is probably using
-cdist-quickstart(7).
+cdist-quickstart.
 
 
 SEE ALSO
 --------
 Website: http://www.nico.schottelius.org/cdist/[], cdist-push-pull(7),
 cdist-deploy-to(1), cdist-manifest(7), cdist-types(7), cdist-type-inclusion(7),
-cdist-quickstart(7)
+cdist-quickstart(1)
-
 
 COPYING
 -------