From 7243e220c0d44d29bff09d9a0c468dc5c96f541e Mon Sep 17 00:00:00 2001 From: Sol Jerome Date: Wed, 21 Apr 2010 21:26:12 -0500 Subject: doc: Add configuration notes for Recommended APT packages Signed-off-by: Sol Jerome --- doc/server/plugins/generators/packages.txt | 29 ++++++++++++++++++++++++----- 1 file 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 ` for specifying package entries for clients. Where Pkgmgr explicitly specifies package entry @@ -112,6 +114,23 @@ like this: +.. 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 + + True + 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 =========== -- cgit v1.2.3-1-g7c22