summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorSol Jerome <solj@ices.utexas.edu>2010-04-21 21:26:12 -0500
committerSol Jerome <solj@ices.utexas.edu>2010-04-21 21:27:22 -0500
commit7243e220c0d44d29bff09d9a0c468dc5c96f541e (patch)
treef8766325ec4462962c683d1b9b67a18b42da5134 /doc
parent6b86e92d058769c465c3514be859700e1b7f98b1 (diff)
downloadbcfg2-7243e220c0d44d29bff09d9a0c468dc5c96f541e.tar.gz
bcfg2-7243e220c0d44d29bff09d9a0c468dc5c96f541e.tar.bz2
bcfg2-7243e220c0d44d29bff09d9a0c468dc5c96f541e.zip
doc: Add configuration notes for Recommended APT packages
Signed-off-by: Sol Jerome <solj@ices.utexas.edu>
Diffstat (limited to 'doc')
-rw-r--r--doc/server/plugins/generators/packages.txt29
1 files changed, 24 insertions, 5 deletions
diff --git a/doc/server/plugins/generators/packages.txt b/doc/server/plugins/generators/packages.txt
index a96f3a725..8b3920bf6 100644
--- a/doc/server/plugins/generators/packages.txt
+++ b/doc/server/plugins/generators/packages.txt
@@ -6,6 +6,8 @@
Packages
========
+.. versionadded:: 1.0.0
+
This page documents the Packages plugin. Packages is an alternative to
:ref:`Pkgmgr <server-plugins-generators-pkgmgr>` for specifying package
entries for clients. Where Pkgmgr explicitly specifies package entry
@@ -112,6 +114,23 @@ like this:
</APTSource>
</Sources>
+.. note::
+
+ The default behavior of the Packages plugin is to not make
+ any assumptions about which packages you want to have added
+ automatically. For that reason, neither **Recommended**
+ nor **Suggested** packages are added as dependencies by
+ default. You will notice that the default behavior for apt is
+ to add Recommended packages as dependencies. You can configure
+ the Packages plugin to add recommended packages by adding
+ the following:
+
+ .. versionadded:: 1.1.0
+
+ .. code-block:: xml
+
+ <Recommended>True</Recommended>
+
Yum sources can be similarly specified:
.. code-block:: xml
@@ -182,16 +201,16 @@ sources in this file) will be reflected by the server at this point.
Availability
============
-Packages was added in 1.0pre1, with APT support. YUM support was added
-for 1.0pre2. Support for other package managers (Portage, Zypper, IPS,
-etc) remain to be added.
+Support for clients using yum and apt is currently available. Support for
+other package managers (Portage, Zypper, IPS, etc) remain to be added.
Validation
==========
A schema for Packages/config.xml is included; config.xml can be validated
-using bcfg2-repo-validate. Note that the schema requires that elements
-be specified in the above order.
+using ``bcfg2-repo-validate``.
+
+.. note:: The schema requires that elements be specified in the above order.
Limitations
===========