1 |
commit: 3ce975f9963111ad440c7e626552ed4de496e302 |
2 |
Author: André Erdmann <dywi <AT> mailerd <DOT> de> |
3 |
AuthorDate: Tue Aug 27 15:34:03 2013 +0000 |
4 |
Commit: André Erdmann <dywi <AT> mailerd <DOT> de> |
5 |
CommitDate: Tue Aug 27 15:34:03 2013 +0000 |
6 |
URL: http://git.overlays.gentoo.org/gitweb/?p=proj/R_overlay.git;a=commit;h=3ce975f9 |
7 |
|
8 |
doc/html: #! ERROR, deptype logging |
9 |
|
10 |
--- |
11 |
doc/html/usage.html | 15 +++++++++++---- |
12 |
1 file changed, 11 insertions(+), 4 deletions(-) |
13 |
|
14 |
diff --git a/doc/html/usage.html b/doc/html/usage.html |
15 |
index dfa9c70..153084d 100644 |
16 |
--- a/doc/html/usage.html |
17 |
+++ b/doc/html/usage.html |
18 |
@@ -1706,7 +1706,7 @@ is ignored.</p> |
19 |
simple rule.</p> |
20 |
</dd> |
21 |
<dt>Keywords</dt> |
22 |
-<dd><p class="first">There are two keywords that control how a rule file is read.</p> |
23 |
+<dd><p class="first">There are three keywords that control how a rule file is read.</p> |
24 |
<p>The important one is the <em>#deptype <dependency type></em> directive that |
25 |
defines that all rules until the next <em>deptype</em> directory or end of file, |
26 |
whatever comes first, will only match <em>dependency strings</em> |
27 |
@@ -1725,7 +1725,9 @@ Specifying <em>selfdep</em> alone does not resolve anything.</p> |
28 |
<p class="first admonition-title">Hint</p> |
29 |
<p class="last">Check the <em>dependency type</em> if a newly added rule has no effect.</p> |
30 |
</div> |
31 |
-<p class="last">The other keyword is <em>#! NOPARSE</em> which stops parsing of a rule file.</p> |
32 |
+<p class="last">The other keywords are <em>#! NOPARSE</em>, which stops parsing of a rule file |
33 |
+(ignore remaining file content), and <em>#! ERROR</em>, which raises a python |
34 |
+exception (program exits).</p> |
35 |
</dd> |
36 |
<dt>Dependencies</dt> |
37 |
<dd><p class="first">are strings that are recognized by portage as <strong>Dynamic DEPENDs</strong> |
38 |
@@ -3543,7 +3545,12 @@ results.</p> |
39 |
<dl class="docutils" id="log-file-unresolvable"> |
40 |
<dt>LOG_FILE_UNRESOLVABLE</dt> |
41 |
<dd><p class="first">A file where all unresolved dependency strings will be written into |
42 |
-on <em>roverlay</em> exit. Primarily useful for creating new rules.</p> |
43 |
+on <em>roverlay</em> exit. Primarily useful for creating new rules. |
44 |
+The file's format is <tt class="docutils literal"><dependency type mask in hex>, <dependency string></tt>, |
45 |
+where the <em>dependency type mask</em> is usually |
46 |
+<tt class="docutils literal">0x7</tt> (mandatory system dependency), |
47 |
+<tt class="docutils literal">0x8</tt> (optional R package dependency) |
48 |
+or <tt class="docutils literal">0xb</tt> (mandatory R package dependency).</p> |
49 |
<p class="last">Defaults to <not set>, which disables this feature.</p> |
50 |
</dd> |
51 |
</dl> |
52 |
@@ -4803,7 +4810,7 @@ becomes "loop until resolver closes".</p> |
53 |
</div> |
54 |
<div class="footer"> |
55 |
<hr class="footer" /> |
56 |
-Generated on: 2013-08-23. |
57 |
+Generated on: 2013-08-27. |
58 |
|
59 |
</div> |
60 |
</body> |