summaryrefslogtreecommitdiffstats
path: root/doc/server/plugins/structures/deps.txt
diff options
context:
space:
mode:
Diffstat (limited to 'doc/server/plugins/structures/deps.txt')
-rw-r--r--doc/server/plugins/structures/deps.txt61
1 files changed, 61 insertions, 0 deletions
diff --git a/doc/server/plugins/structures/deps.txt b/doc/server/plugins/structures/deps.txt
new file mode 100644
index 000000000..7c5861d06
--- /dev/null
+++ b/doc/server/plugins/structures/deps.txt
@@ -0,0 +1,61 @@
+.. -*- mode: rst -*-
+
+.. _server-plugins-generators-deps:
+
+====
+Deps
+====
+
+The Deps Plugin allows you to make a series of assertions like "Package
+X requires Package Y (and optionally also Package Z etc). Note that only
+configuration entries, like Package, Path, etc can be used. Groupings
+(like Bundle) are not supported.
+
+Here are some examples:
+
+.. note::
+
+ These particular examples are not extremely useful when using the
+ Packages plugin as Packages will handle the dependency resolution for
+ you. However, there are certainly other use cases for the Deps plugin.
+
+Deps/bcfg2.xml
+==============
+
+.. code-block:: xml
+
+ <Dependencies priority='0'>
+ <Package name='bcfg2'>
+ <Package name='python-lxml'/>
+ <Package name='isprelink'/>
+ </Package>
+ </Dependencies>
+
+This basically causes any configuration specification that includes
+Package bcfg2 to include python-lxml and isprelink, in a second base
+clause.
+
+Deps/bcfg2-server.xml
+=====================
+
+.. code-block:: xml
+
+ <Dependencies priority='0'>
+ <Package name='bcfg2-server'>
+ <Package name='python-cheetah'/>
+ <Package name='gamin-python'/>
+ <Package name='sqlite'/>
+ <Package name='python-sqlite'/>
+ <Package name='Django'/>
+ <Package name='mod_python'/>
+ <Package name='graphviz'/>
+ <Package name='xorg-x11-font-utils'/>
+ <Package name='chkfontpath'/>
+ <Package name='ttmkfdir'/>
+ <Package name='xorg-x11-xfs'/>
+ <Package name='urw-fonts'/>
+ </Package>
+ </Dependencies>
+
+This states that the bcfg2-server package (it's a separate package on
+some distros) depends on a long list of other packages.