+man __package_emerge/man.text

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

conf/type/__package_emerge/man.text

@@ -0,0 +1,58 @@
+cdist-type__user(7)
+===================
+Steven Armstrong <steven-cdist--@--armstrong.cc>
+
+
+NAME
+----
+cdist-type__package_emerge - Manage packages on Gentoo Linux
+
+
+DESCRIPTION
+-----------
+This cdist type allows you to install or uninstall packages on a Gentoo Linux
+target.
+
+
+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::
+   FIXME: not yet implemented
+   The version of the package to install. Default is to install the version 
+   choosen by the local package manager.
+
+
+EXAMPLES
+--------
+
+--------------------------------------------------------------------------------
+# Install the package vim on the target
+__package_emerge screen --state installed
+
+# Same but use full qualified package name
+__package_emerge app-misc/screen --state installed
+
+# Same but use install specific package version
+# FIXME: not yet implemented
+__package_emerge app-misc/screen --state installed --version 4.0.3
+--------------------------------------------------------------------------------
+
+
+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).