Bundler: improved XInclude support, added inter-bundle dependencies

1 files changed, 49 insertions, 0 deletions

diff --git a/doc/server/plugins/structures/bundler/index.txt b/doc/server/plugins/structures/bundler/index.txt
index 1b88627a5..8f767ba03 100644
--- a/doc/server/plugins/structures/bundler/index.txt
+++ b/doc/server/plugins/structures/bundler/index.txt
@@ -133,6 +133,55 @@ entries in the bundle.
 
 See :ref:`bcfg2-info <server-bcfg2-info>` for more details.
 
+Dependencies
+============
+
+Dependencies on other bundles can be specified by adding an empty
+bundle tag that adds another bundle by name, e.g.:
+
+.. code-block:: xml
+
+    <Bundle>
+      <Bundle name="nfs-client"/>
+      ...
+    </Bundle>
+
+The dependent bundle is added to the list of bundles sent to the
+client, *not* to the parent bundle itself.  In other words, if an
+entry in the dependent bundle changes, Services are restarted and
+Actions are run in the dependent bundle *only*.  An example:
+
+``nfs-client.xml``:
+
+.. code-block:: xml
+
+    <Bundle>
+      <Package name="nfs-utils"/>
+      <Service name="nfslock"/>
+      <Service name="rpcbind"/>
+      <Service name="nfs"/>
+    </Bundle>
+
+``automount.xml``:
+
+.. code-block:: xml
+
+    <Bundle>
+      <Bundle name="nfs-client"/>
+
+      <Path name="/mnt/home"/>
+      <Path name="/etc/auto.master"/>
+      <Path name="/etc/auto.misc"/>
+      <Service name="autofs"/>
+      <Package name="automount"/>
+    </Bundle>
+
+If a new ``nfs-utils`` package was installed, the ``nfslock``,
+``rpcbind``, and ``nfs`` services would be restarted, but *not* the
+``autofs`` service.  Similarly, if a new ``/etc/auto.misc`` file was
+sent out, the ``autofs`` service would be restarted, but the
+``nfslock``, ``rpcbind``, and ``nfs`` services would not be restarted.
+
 Altsrc
 ======