[jhbuild] docs: Document <altdep> tag



commit 2dd50730b87aa0ba4104b9926c0d91263c15112f
Author: Ting-Wei Lan <lantw src gnome org>
Date:   Tue Dec 15 20:12:36 2015 +0800

    docs: Document <altdep> tag
    
    https://bugzilla.gnome.org/show_bug.cgi?id=754041

 doc/C/index.docbook |   32 ++++++++++++++++++++++++++++++++
 1 files changed, 32 insertions(+), 0 deletions(-)
---
diff --git a/doc/C/index.docbook b/doc/C/index.docbook
index 2138dfa..6228fac 100644
--- a/doc/C/index.docbook
+++ b/doc/C/index.docbook
@@ -3150,6 +3150,38 @@ Optional packages: (JHBuild will build the missing packages)
   &lt;/systemdependencies&gt;
 &lt;/systemmodule&gt;
 </programlisting>
+
+        <para>If the system module may be installed in different locations
+          or installed with different names by different distributions,
+          <sgmltag class="element">altdep</sgmltag> tag can be used as
+          subelements of <sgmltag class="element">dep</sgmltag> tag to
+          specify alternative locations or names.
+          <sgmltag class="element">altdep</sgmltag> tag support the same
+          attributes as <sgmltag class="element">dep</sgmltag> tag does.</para>
+
+<programlisting>
+&lt;systemmodule id="<replaceable>modulename</replaceable>"&gt;
+  &lt;branch repo="<replaceable>system</replaceable>" version="<replaceable>version</replaceable>" /&gt;
+  &lt;systemdependencies&gt;
+    &lt;dep type="path" name="<replaceable>executable-name</replaceable>"&gt;
+      &lt;altdep type="path" name="<replaceable>alternative-executable-name-1</replaceable>" /&gt;
+      &lt;altdep type="path" name="<replaceable>alternative-executable-name-2</replaceable>" /&gt;
+      ...
+    &lt;dep&gt;
+  &lt;/systemdependencies&gt;
+&lt;/systemmodule&gt;
+
+&lt;systemmodule id="<replaceable>modulename</replaceable>"&gt;
+  &lt;branch repo="<replaceable>system</replaceable>" version="<replaceable>version</replaceable>" /&gt;
+  &lt;systemdependencies&gt;
+    &lt;dep type="c_include" name="<replaceable>header-name</replaceable>"&gt;
+      &lt;altdep type="c_include" name="<replaceable>alternative-header-name-1</replaceable>" /&gt;
+      &lt;altdep type="c_include" name="<replaceable>alternative-header-name-2</replaceable>" /&gt;
+      ...
+    &lt;dep&gt;
+  &lt;/systemdependencies&gt;
+&lt;/systemmodule&gt;
+</programlisting>
       </section>
 
       <section id="moduleset-syntax-defs-waf">


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]