summaryrefslogtreecommitdiffstats
path: root/doc/server/plugins/structures
diff options
context:
space:
mode:
authorHolger Weiß <holger@zedat.fu-berlin.de>2011-06-22 14:47:01 +0200
committerHolger Weiß <holger@zedat.fu-berlin.de>2011-06-22 14:47:01 +0200
commit1186eae0c62ba6810ea597083bd8e56d487811c0 (patch)
treed1969c51a20a227b42ffb4c077ba1df79d784240 /doc/server/plugins/structures
parentc6c8af67d58b7c653e2c70e2ac91bfca4cfbd9fe (diff)
downloadbcfg2-1186eae0c62ba6810ea597083bd8e56d487811c0.tar.gz
bcfg2-1186eae0c62ba6810ea597083bd8e56d487811c0.tar.bz2
bcfg2-1186eae0c62ba6810ea597083bd8e56d487811c0.zip
doc: Move Deps to the Structure plugins
Deps is a Structure plugin, not a Generator.
Diffstat (limited to 'doc/server/plugins/structures')
-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.