From 7d4325f5e12a40b5b8ae8fc85a4e934b94dd1adf Mon Sep 17 00:00:00 2001
From: "Chris St. Pierre" <chris.a.st.pierre@gmail.com>
Date: Thu, 3 Nov 2011 09:15:12 -0400
Subject: added support for default/mandatory/optional package groups

---
 doc/server/plugins/generators/packages.txt | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

(limited to 'doc')

diff --git a/doc/server/plugins/generators/packages.txt b/doc/server/plugins/generators/packages.txt
index f49b12a68..0f4a9bb96 100644
--- a/doc/server/plugins/generators/packages.txt
+++ b/doc/server/plugins/generators/packages.txt
@@ -465,6 +465,25 @@ group name::
     <Package group="SNMP Support"/>
     <Package group="system-management-snmp"/>
 
+By default, only those packages considered the "default" packages in a
+group will be installed.  You can change this behavior using the
+"type" attribute::
+
+    <Package group="development" type="optional"/>
+    <Package group="Administration Tools" type="mandatory"/>
+
+Valid values of "type" are:
+
+* ``mandatory``: Only install mandatory packages in the group.
+* ``default``: Install default packages from the group (the default).
+* ``optional`` or ``all``: Install all packages in the group,
+  including mandatory, default, and optional packages.
+
+You can view the packages in a group by category with the ``yum
+groupinfo`` command.  More information about the different levels can
+be found at
+http://fedoraproject.org/wiki/How_to_use_and_edit_comps.xml_for_package_groups#Installation
+
 .. _pulp-source-support:
 
 Pulp Support
-- 
cgit v1.2.3-1-g7c22