+man

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

conf/type/__package/man.text

@@ -0,0 +1,61 @@
+cdist-type__user(7)
+===================
+Steven Armstrong <steven-cdist--@--armstrong.cc>
+
+
+NAME
+----
+cdist-type__package - Manage packages
+
+
+DESCRIPTION
+-----------
+This cdist type allows you to install or uninstall packages on the target.
+It dispatches the actual work to the package system dependant types.
+
+
+REQUIRED PARAMETERS
+-------------------
+state::
+   The state the package should be in, either "installed" or "uninstalled"
+
+
+OPTIONAL PARAMETERS
+-------------------
+name::
+   The name of the package to install. Default is to use the object_id as the
+   package name.
+version::
+   The version of the package to install. Default is to install the version 
+   choosen by the local package manager.
+type::
+   The package type to use. Default is determined based on the $os explorer
+   variable.
+   e.g. __package_apt for Debian
+        __package_emerge for Gentoo
+
+
+EXAMPLES
+--------
+
+--------------------------------------------------------------------------------
+# Install the package vim on the target
+__package vim --state installed
+
+# Same but install specific version
+__package vim --state installed --version 7.3.50
+
+# Force use of a specific package type
+__package vim --state installed --type __package_apt
+--------------------------------------------------------------------------------
+
+
+SEE ALSO
+--------
+- cdist-type(7)
+
+
+COPYING
+-------
+Copyright \(C) 2011 Steven Armstrong. Free use of this software is
+granted under the terms of the GNU General Public License version 3 (GPLv3).