doc/html, package rules: 'add' action

1 files changed, 47 insertions, 25 deletions

diff --git a/doc/html/usage.html b/doc/html/usage.html
index 82d3f0e..dfa9c70 100644
--- a/doc/html/usage.html
+++ b/doc/html/usage.html
@@ -2151,10 +2151,10 @@ control <em>where</em>) and the number of values they accept:</p>
 <table border="1" class="docutils">
 <caption>action keywords</caption>
 <colgroup>
-<col width="23%" />
-<col width="25%" />
+<col width="22%" />
+<col width="26%" />
 <col width="18%" />
-<col width="34%" />
+<col width="33%" />
 </colgroup>
 <thead valign="bottom">
 <tr><th class="head">action keyword</th>
@@ -2193,9 +2193,9 @@ whenever this action
 is applied</td>
 </tr>
 <tr><td>set</td>
-<td rowspan="2">package
-metadata,
-overlay creaton</td>
+<td rowspan="6">package metadata,
+overlay creation,
+ebuild creation</td>
 <td>2</td>
 <td rowspan="2">set package
 information</td>
@@ -2204,9 +2204,6 @@ information</td>
 <td>1</td>
 </tr>
 <tr><td>rename</td>
-<td rowspan="2">package
-metadata,
-overlay creation</td>
 <td>2</td>
 <td rowspan="2">modify package
 information with
@@ -2217,51 +2214,76 @@ statements</td>
 <tr><td>rename_&lt;key&gt;</td>
 <td>1</td>
 </tr>
+<tr><td>add</td>
+<td>2</td>
+<td rowspan="2">similar to <em>set</em>, but
+can be applied
+multiple times without
+overwriting existing
+information</td>
+</tr>
+<tr><td>add_&lt;key&gt;</td>
+<td>1</td>
+</tr>
 <tr><td>null</td>
 <td rowspan="2"><em>n/a</em></td>
 <td rowspan="2">none</td>
 <td rowspan="2">does nothing
 (can be used for
-readability)</td>
+improving readability)</td>
 </tr>
 <tr><td>pass</td>
 </tr>
 </tbody>
 </table>
-<p>The two-arg form of the set/rename keywords expect a &lt;key&gt; as first and
+<p>The two-arg form of the set/rename/add keywords expect a &lt;key&gt; as first and
 a value / sed expression as second arg. The one-arg form expects the latter
-one only. The &quot;/&quot; delimitier in the sed expression can be any character.</p>
+one only. keys are case-insensitive. The &quot;/&quot; delimitier in the sed expression
+can be any other character.</p>
 <p>The following <em>info keys</em> can be set and/or modified:</p>
 <table border="1" class="docutils">
-<caption>info keys for set/rename</caption>
+<caption>info keys for set/rename/add</caption>
 <colgroup>
-<col width="19%" />
-<col width="29%" />
-<col width="51%" />
+<col width="18%" />
+<col width="33%" />
+<col width="49%" />
 </colgroup>
 <thead valign="bottom">
 <tr><th class="head">info key</th>
-<th class="head">supports set/rename</th>
+<th class="head">supports set/rename/add</th>
 <th class="head">description</th>
 </tr>
 </thead>
 <tbody valign="top">
 <tr><td>name</td>
-<td>yes / yes</td>
+<td>yes / yes / no</td>
 <td>rename the ebuild</td>
 </tr>
 <tr><td>category</td>
-<td>yes / yes
-(<em>repo_name</em>)</td>
+<td>yes / yes (<em>repo name</em>)
+/ no</td>
 <td>set or rename (based on the
 repository's name) the package's
 category</td>
 </tr>
 <tr><td>destfile</td>
-<td>yes / yes</td>
+<td>yes / yes / no</td>
 <td>rename ebuild destfile by using the
 '-&gt;' operator in <tt class="docutils literal">${SRC_URI}</tt></td>
 </tr>
+<tr><td>DEPEND</td>
+<td rowspan="3">no / no / <strong>yes</strong></td>
+<td rowspan="3"><p class="first">add additional dependencies to
+<em>DEPEND/RDEPEND/RSUGGESTS</em></p>
+<p class="last">The value has to be a string
+accepted by the package manager,
+e.g. a <em>DEPEND Atom</em>.</p>
+</td>
+</tr>
+<tr><td>RDEPEND</td>
+</tr>
+<tr><td>RSUGGESTS</td>
+</tr>
 </tbody>
 </table>
 <p>The <em>set</em> action also supports variable substitution  by means of python
@@ -2313,9 +2335,9 @@ followed by <tt class="docutils literal">roverlay create</tt>.</p>
 </div>
 <div class="note">
 <p class="first admonition-title">Note</p>
-<p class="last">Applying the same (non-incremental) ebuild variable, set or rename action
-more than once is possible, but only the last one will have an effect
-on ebuild creation.</p>
+<p class="last">Applying the same ebuild variable, set or rename action more than once
+is possible, but only the last one will have an effect on ebuild creation.
+add actions are cumulative by definition.</p>
 </div>
 <div class="section" id="extended-action-block-syntax">
 <h4><a class="toc-backref" href="#contents">8.1.2.1&nbsp;&nbsp;&nbsp;Extended Action Block Syntax</a></h4>
@@ -4781,7 +4803,7 @@ becomes &quot;loop until resolver closes&quot;.</p>
 </div>
 <div class="footer">
 <hr class="footer" />
-Generated on: 2013-08-20.
+Generated on: 2013-08-23.
 
 </div>
 </body>