aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorAndré Erdmann <dywi@mailerd.de>2014-07-14 16:27:12 +0200
committerAndré Erdmann <dywi@mailerd.de>2014-07-14 16:27:12 +0200
commitb3f70f945ce6b9f74397031d5161b5908e30d9ee (patch)
tree4e8abeca64114dbabb313f9719de0e508eff1a98 /doc
parentroverlay/packagerules: addition control actions (diff)
downloadR_overlay-b3f70f945ce6b9f74397031d5161b5908e30d9ee.tar.gz
R_overlay-b3f70f945ce6b9f74397031d5161b5908e30d9ee.tar.bz2
R_overlay-b3f70f945ce6b9f74397031d5161b5908e30d9ee.zip
doc/rst/usage.rst: document package rule changes
Diffstat (limited to 'doc')
-rw-r--r--doc/rst/usage.rst28
1 files changed, 27 insertions, 1 deletions
diff --git a/doc/rst/usage.rst b/doc/rst/usage.rst
index 6d2879e..5ef6289 100644
--- a/doc/rst/usage.rst
+++ b/doc/rst/usage.rst
@@ -1819,6 +1819,16 @@ These *match keywords* are recognized:
+---------------+------------------+--------------------------------------+
| name | *implicit* | *alias to ebuild_name* |
+---------------+------------------+--------------------------------------+
+ | category | exact-string | the package's overlay category, |
+ | | | which is unknown (represented by |
+ | | | ``@default``) unless it has been set |
+ | | | by a package rule action |
+ +---------------+------------------+--------------------------------------+
+ | default\_\ | *n/a* | **pseudo-statement** |
+ | category | | |
+ | | | shorthand for |
+ | | | ``category == @default`` |
+ +---------------+------------------+--------------------------------------+
Note the **implicit operator**. It will be used whenever no explicit operator
has been specified in the match statement and the match keyword does not
@@ -2019,8 +2029,24 @@ control *where*) and the number of values they accept:
+----------------+-------------------+-------------+------------------------+
| null | *n/a* | none | does nothing |
+----------------+ | | (can be used for |
- | pass | | | improving readability) |
+ | pass | | | better readability) |
+----------------+-------------------+-------------+------------------------+
+ | add-policy | overlay creation | 1 | sets the addition |
+ | | | | control policy |
+ | | | | |
+ | | | | Possible values are |
+ | | | | *force-deny*, |
+ | | | | *force-add*, |
+ | | | | *deny-replace*, |
+ | | | | *revbump-on-\ |
+ | | | | collision*, |
+ | | | | and *default* |
+ | | | | |
+ | | | | Not meant to be set |
+ | | | | hand-written rule |
+ | | | | files. |
+ +----------------+-------------------+-------------+------------------------+
+
The two-arg form of the set/rename/add keywords expect a <key> as first and
a value / sed expression as second arg. The one-arg form expects the latter