| 1 |
commit: e1d57a113226f2a8147ebdd26d47e3224bda4179 |
| 2 |
Author: André Erdmann <dywi <AT> mailerd <DOT> de> |
| 3 |
AuthorDate: Wed Jun 5 18:05:51 2013 +0000 |
| 4 |
Commit: André Erdmann <dywi <AT> mailerd <DOT> de> |
| 5 |
CommitDate: Wed Jun 5 18:05:51 2013 +0000 |
| 6 |
URL: http://git.overlays.gentoo.org/gitweb/?p=proj/R_overlay.git;a=commit;h=e1d57a11 |
| 7 |
|
| 8 |
doc/html, package rules: set/rename actions |
| 9 |
|
| 10 |
--- |
| 11 |
doc/html/usage.html | 263 +++++++++++++++++++++++++++++++++++++--------------- |
| 12 |
1 file changed, 188 insertions(+), 75 deletions(-) |
| 13 |
|
| 14 |
diff --git a/doc/html/usage.html b/doc/html/usage.html |
| 15 |
index 62e4e9a..a02a772 100644 |
| 16 |
--- a/doc/html/usage.html |
| 17 |
+++ b/doc/html/usage.html |
| 18 |
@@ -329,111 +329,111 @@ ul.auto-toc { |
| 19 |
<div class="contents topic" id="contents"> |
| 20 |
<p class="topic-title first">Contents</p> |
| 21 |
<ul class="auto-toc simple"> |
| 22 |
-<li><a class="reference internal" href="#introduction" id="id5">1 Introduction</a></li> |
| 23 |
-<li><a class="reference internal" href="#installation" id="id6">2 Installation</a><ul class="auto-toc"> |
| 24 |
-<li><a class="reference internal" href="#prerequisites" id="id7">2.1 Prerequisites</a></li> |
| 25 |
-<li><a class="reference internal" href="#via-emerge-gentoo" id="id8">2.2 via emerge (Gentoo)</a></li> |
| 26 |
-<li><a class="reference internal" href="#manual-installation" id="id9">2.3 Manual Installation</a></li> |
| 27 |
-<li><a class="reference internal" href="#using-roverlay-without-installation" id="id10">2.4 Using <em>roverlay</em> without installation</a></li> |
| 28 |
+<li><a class="reference internal" href="#introduction" id="id4">1 Introduction</a></li> |
| 29 |
+<li><a class="reference internal" href="#installation" id="id5">2 Installation</a><ul class="auto-toc"> |
| 30 |
+<li><a class="reference internal" href="#prerequisites" id="id6">2.1 Prerequisites</a></li> |
| 31 |
+<li><a class="reference internal" href="#via-emerge-gentoo" id="id7">2.2 via emerge (Gentoo)</a></li> |
| 32 |
+<li><a class="reference internal" href="#manual-installation" id="id8">2.3 Manual Installation</a></li> |
| 33 |
+<li><a class="reference internal" href="#using-roverlay-without-installation" id="id9">2.4 Using <em>roverlay</em> without installation</a></li> |
| 34 |
</ul> |
| 35 |
</li> |
| 36 |
-<li><a class="reference internal" href="#running-roverlay" id="id11">3 Running Roverlay</a><ul class="auto-toc"> |
| 37 |
-<li><a class="reference internal" href="#required-configuration-steps" id="id12">3.1 Required configuration steps</a><ul class="auto-toc"> |
| 38 |
-<li><a class="reference internal" href="#extended-configuration-where-to-go-from-here" id="id13">3.1.1 Extended Configuration / Where to go from here?</a></li> |
| 39 |
+<li><a class="reference internal" href="#running-roverlay" id="id10">3 Running Roverlay</a><ul class="auto-toc"> |
| 40 |
+<li><a class="reference internal" href="#required-configuration-steps" id="id11">3.1 Required configuration steps</a><ul class="auto-toc"> |
| 41 |
+<li><a class="reference internal" href="#extended-configuration-where-to-go-from-here" id="id12">3.1.1 Extended Configuration / Where to go from here?</a></li> |
| 42 |
</ul> |
| 43 |
</li> |
| 44 |
-<li><a class="reference internal" href="#running-it" id="id14">3.2 Running it</a></li> |
| 45 |
-<li><a class="reference internal" href="#providing-a-package-mirror" id="id15">3.3 Providing a package mirror</a></li> |
| 46 |
+<li><a class="reference internal" href="#running-it" id="id13">3.2 Running it</a></li> |
| 47 |
+<li><a class="reference internal" href="#providing-a-package-mirror" id="id14">3.3 Providing a package mirror</a></li> |
| 48 |
</ul> |
| 49 |
</li> |
| 50 |
-<li><a class="reference internal" href="#basic-implementation-overview" id="id16">4 Basic Implementation Overview</a><ul class="auto-toc"> |
| 51 |
-<li><a class="reference internal" href="#how-roverlay-works" id="id17">4.1 How <em>roverlay</em> works</a></li> |
| 52 |
-<li><a class="reference internal" href="#expected-overlay-result-structure-of-the-generated-overlay" id="id18">4.2 Expected Overlay Result / Structure of the generated overlay</a><ul class="auto-toc"> |
| 53 |
-<li><a class="reference internal" href="#expected-ebuild-result" id="id19">4.2.1 Expected Ebuild Result</a></li> |
| 54 |
-<li><a class="reference internal" href="#expected-metadata-xml-result" id="id20">4.2.2 Expected <em>metadata.xml</em> Result</a></li> |
| 55 |
+<li><a class="reference internal" href="#basic-implementation-overview" id="id15">4 Basic Implementation Overview</a><ul class="auto-toc"> |
| 56 |
+<li><a class="reference internal" href="#how-roverlay-works" id="id16">4.1 How <em>roverlay</em> works</a></li> |
| 57 |
+<li><a class="reference internal" href="#expected-overlay-result-structure-of-the-generated-overlay" id="id17">4.2 Expected Overlay Result / Structure of the generated overlay</a><ul class="auto-toc"> |
| 58 |
+<li><a class="reference internal" href="#expected-ebuild-result" id="id18">4.2.1 Expected Ebuild Result</a></li> |
| 59 |
+<li><a class="reference internal" href="#expected-metadata-xml-result" id="id19">4.2.2 Expected <em>metadata.xml</em> Result</a></li> |
| 60 |
</ul> |
| 61 |
</li> |
| 62 |
</ul> |
| 63 |
</li> |
| 64 |
-<li><a class="reference internal" href="#repositories-getting-packages" id="id21">5 Repositories / Getting Packages</a><ul class="auto-toc"> |
| 65 |
-<li><a class="reference internal" href="#a-word-about-repo-config-files" id="id22">5.1 A word about repo config files</a></li> |
| 66 |
-<li><a class="reference internal" href="#rsync-repos" id="id23">5.2 Rsync repos</a></li> |
| 67 |
-<li><a class="reference internal" href="#getting-packages-from-a-repository-that-supports-http-only" id="id24">5.3 Getting packages from a repository that supports http only</a></li> |
| 68 |
-<li><a class="reference internal" href="#getting-packages-from-several-remotes-using-http-and-a-package-list" id="id25">5.4 Getting packages from several remotes using http and a package list</a></li> |
| 69 |
-<li><a class="reference internal" href="#using-local-directories" id="id26">5.5 Using local directories</a></li> |
| 70 |
+<li><a class="reference internal" href="#repositories-getting-packages" id="id20">5 Repositories / Getting Packages</a><ul class="auto-toc"> |
| 71 |
+<li><a class="reference internal" href="#a-word-about-repo-config-files" id="id21">5.1 A word about repo config files</a></li> |
| 72 |
+<li><a class="reference internal" href="#rsync-repos" id="id22">5.2 Rsync repos</a></li> |
| 73 |
+<li><a class="reference internal" href="#getting-packages-from-a-repository-that-supports-http-only" id="id23">5.3 Getting packages from a repository that supports http only</a></li> |
| 74 |
+<li><a class="reference internal" href="#getting-packages-from-several-remotes-using-http-and-a-package-list" id="id24">5.4 Getting packages from several remotes using http and a package list</a></li> |
| 75 |
+<li><a class="reference internal" href="#using-local-directories" id="id25">5.5 Using local directories</a></li> |
| 76 |
</ul> |
| 77 |
</li> |
| 78 |
-<li><a class="reference internal" href="#dependency-rules" id="id27">6 Dependency Rules</a><ul class="auto-toc"> |
| 79 |
-<li><a class="reference internal" href="#simple-dependency-rules" id="id28">6.1 Simple Dependency Rules</a><ul class="auto-toc"> |
| 80 |
-<li><a class="reference internal" href="#rule-variants" id="id29">6.1.1 Rule Variants</a></li> |
| 81 |
-<li><a class="reference internal" href="#rule-types" id="id30">6.1.2 Rule types</a></li> |
| 82 |
-<li><a class="reference internal" href="#rule-file-examples" id="id31">6.1.3 Rule File Examples</a></li> |
| 83 |
-<li><a class="reference internal" href="#rule-file-syntax" id="id32">6.1.4 Rule File Syntax</a></li> |
| 84 |
+<li><a class="reference internal" href="#dependency-rules" id="id26">6 Dependency Rules</a><ul class="auto-toc"> |
| 85 |
+<li><a class="reference internal" href="#simple-dependency-rules" id="id27">6.1 Simple Dependency Rules</a><ul class="auto-toc"> |
| 86 |
+<li><a class="reference internal" href="#rule-variants" id="id28">6.1.1 Rule Variants</a></li> |
| 87 |
+<li><a class="reference internal" href="#rule-types" id="id29">6.1.2 Rule types</a></li> |
| 88 |
+<li><a class="reference internal" href="#rule-file-examples" id="id30">6.1.3 Rule File Examples</a></li> |
| 89 |
+<li><a class="reference internal" href="#rule-file-syntax" id="id31">6.1.4 Rule File Syntax</a></li> |
| 90 |
</ul> |
| 91 |
</li> |
| 92 |
</ul> |
| 93 |
</li> |
| 94 |
-<li><a class="reference internal" href="#package-rules" id="id33">7 Package Rules</a><ul class="auto-toc"> |
| 95 |
-<li><a class="reference internal" href="#package-rule-file-syntax" id="id34">7.1 Package Rule File Syntax</a><ul class="auto-toc"> |
| 96 |
-<li><a class="reference internal" href="#match-blocks" id="id35">7.1.1 Match Blocks</a><ul class="auto-toc"> |
| 97 |
-<li><a class="reference internal" href="#extended-match-block-syntax" id="id36">7.1.1.1 Extended Match Block Syntax</a></li> |
| 98 |
+<li><a class="reference internal" href="#package-rules" id="id32">7 Package Rules</a><ul class="auto-toc"> |
| 99 |
+<li><a class="reference internal" href="#package-rule-file-syntax" id="id33">7.1 Package Rule File Syntax</a><ul class="auto-toc"> |
| 100 |
+<li><a class="reference internal" href="#match-blocks" id="id34">7.1.1 Match Blocks</a><ul class="auto-toc"> |
| 101 |
+<li><a class="reference internal" href="#extended-match-block-syntax" id="id35">7.1.1.1 Extended Match Block Syntax</a></li> |
| 102 |
</ul> |
| 103 |
</li> |
| 104 |
-<li><a class="reference internal" href="#action-blocks" id="id37">7.1.2 Action Blocks</a><ul class="auto-toc"> |
| 105 |
-<li><a class="reference internal" href="#extended-action-block-syntax" id="id38">7.1.2.1 Extended Action Block Syntax</a></li> |
| 106 |
+<li><a class="reference internal" href="#action-blocks" id="id36">7.1.2 Action Blocks</a><ul class="auto-toc"> |
| 107 |
+<li><a class="reference internal" href="#extended-action-block-syntax" id="id37">7.1.2.1 Extended Action Block Syntax</a></li> |
| 108 |
</ul> |
| 109 |
</li> |
| 110 |
-<li><a class="reference internal" href="#package-rule-examples" id="id39">7.1.3 Package Rule Examples</a></li> |
| 111 |
+<li><a class="reference internal" href="#package-rule-examples" id="id38">7.1.3 Package Rule Examples</a></li> |
| 112 |
</ul> |
| 113 |
</li> |
| 114 |
</ul> |
| 115 |
</li> |
| 116 |
-<li><a class="reference internal" href="#configuration-reference" id="id40">8 Configuration Reference</a><ul class="auto-toc"> |
| 117 |
-<li><a class="reference internal" href="#misc-options" id="id41">8.1 misc options</a></li> |
| 118 |
-<li><a class="reference internal" href="#overlay-options" id="id42">8.2 overlay options</a></li> |
| 119 |
-<li><a class="reference internal" href="#other-config-files" id="id43">8.3 other config files</a></li> |
| 120 |
-<li><a class="reference internal" href="#logging" id="id44">8.4 logging</a><ul class="auto-toc"> |
| 121 |
-<li><a class="reference internal" href="#console-logging" id="id45">8.4.1 console logging</a></li> |
| 122 |
-<li><a class="reference internal" href="#file-logging" id="id46">8.4.2 file logging</a></li> |
| 123 |
+<li><a class="reference internal" href="#configuration-reference" id="id39">8 Configuration Reference</a><ul class="auto-toc"> |
| 124 |
+<li><a class="reference internal" href="#misc-options" id="id40">8.1 misc options</a></li> |
| 125 |
+<li><a class="reference internal" href="#overlay-options" id="id41">8.2 overlay options</a></li> |
| 126 |
+<li><a class="reference internal" href="#other-config-files" id="id42">8.3 other config files</a></li> |
| 127 |
+<li><a class="reference internal" href="#logging" id="id43">8.4 logging</a><ul class="auto-toc"> |
| 128 |
+<li><a class="reference internal" href="#console-logging" id="id44">8.4.1 console logging</a></li> |
| 129 |
+<li><a class="reference internal" href="#file-logging" id="id45">8.4.2 file logging</a></li> |
| 130 |
</ul> |
| 131 |
</li> |
| 132 |
-<li><a class="reference internal" href="#options-for-debugging-manual-dependency-rule-creation-and-testing" id="id47">8.5 options for debugging, manual dependency rule creation and testing</a></li> |
| 133 |
+<li><a class="reference internal" href="#options-for-debugging-manual-dependency-rule-creation-and-testing" id="id46">8.5 options for debugging, manual dependency rule creation and testing</a></li> |
| 134 |
</ul> |
| 135 |
</li> |
| 136 |
-<li><a class="reference internal" href="#field-definition-config" id="id48">9 Field Definition Config</a><ul class="auto-toc"> |
| 137 |
-<li><a class="reference internal" href="#example-the-default-field-definition-file" id="id49">9.1 Example: The default field definition file</a></li> |
| 138 |
+<li><a class="reference internal" href="#field-definition-config" id="id47">9 Field Definition Config</a><ul class="auto-toc"> |
| 139 |
+<li><a class="reference internal" href="#example-the-default-field-definition-file" id="id48">9.1 Example: The default field definition file</a></li> |
| 140 |
</ul> |
| 141 |
</li> |
| 142 |
-<li><a class="reference internal" href="#dependency-resolution-console" id="id50">10 Dependency Resolution Console</a></li> |
| 143 |
-<li><a class="reference internal" href="#implementation-overview" id="id51">11 Implementation Overview</a><ul class="auto-toc"> |
| 144 |
-<li><a class="reference internal" href="#packageinfo" id="id52">11.1 PackageInfo</a></li> |
| 145 |
-<li><a class="reference internal" href="#repository-management" id="id53">11.2 Repository Management</a><ul class="auto-toc"> |
| 146 |
-<li><a class="reference internal" href="#id4" id="id54">11.2.1 Repositories</a><ul class="auto-toc"> |
| 147 |
-<li><a class="reference internal" href="#adding-new-repository-types" id="id55">11.2.1.1 Adding new repository types</a></li> |
| 148 |
+<li><a class="reference internal" href="#dependency-resolution-console" id="id49">10 Dependency Resolution Console</a></li> |
| 149 |
+<li><a class="reference internal" href="#implementation-overview" id="id50">11 Implementation Overview</a><ul class="auto-toc"> |
| 150 |
+<li><a class="reference internal" href="#packageinfo" id="id51">11.1 PackageInfo</a></li> |
| 151 |
+<li><a class="reference internal" href="#repository-management" id="id52">11.2 Repository Management</a><ul class="auto-toc"> |
| 152 |
+<li><a class="reference internal" href="#repository" id="id53">11.2.1 Repository</a><ul class="auto-toc"> |
| 153 |
+<li><a class="reference internal" href="#adding-new-repository-types" id="id54">11.2.1.1 Adding new repository types</a></li> |
| 154 |
</ul> |
| 155 |
</li> |
| 156 |
</ul> |
| 157 |
</li> |
| 158 |
-<li><a class="reference internal" href="#overlay" id="id56">11.3 Overlay</a><ul class="auto-toc"> |
| 159 |
-<li><a class="reference internal" href="#metadata-creation" id="id57">11.3.1 Metadata Creation</a></li> |
| 160 |
-<li><a class="reference internal" href="#manifest-creation" id="id58">11.3.2 Manifest Creation</a></li> |
| 161 |
+<li><a class="reference internal" href="#overlay" id="id55">11.3 Overlay</a><ul class="auto-toc"> |
| 162 |
+<li><a class="reference internal" href="#metadata-creation" id="id56">11.3.1 Metadata Creation</a></li> |
| 163 |
+<li><a class="reference internal" href="#manifest-creation" id="id57">11.3.2 Manifest Creation</a></li> |
| 164 |
</ul> |
| 165 |
</li> |
| 166 |
-<li><a class="reference internal" href="#ebuild-creation" id="id59">11.4 Ebuild Creation</a><ul class="auto-toc"> |
| 167 |
-<li><a class="reference internal" href="#ebuild-variables" id="id60">11.4.1 Ebuild Variables</a></li> |
| 168 |
+<li><a class="reference internal" href="#ebuild-creation" id="id58">11.4 Ebuild Creation</a><ul class="auto-toc"> |
| 169 |
+<li><a class="reference internal" href="#ebuild-variables" id="id59">11.4.1 Ebuild Variables</a></li> |
| 170 |
</ul> |
| 171 |
</li> |
| 172 |
-<li><a class="reference internal" href="#overlay-creation" id="id61">11.5 Overlay Creation</a></li> |
| 173 |
-<li><a class="reference internal" href="#dependency-resolution" id="id62">11.6 Dependency Resolution</a><ul class="auto-toc"> |
| 174 |
-<li><a class="reference internal" href="#dependency-types" id="id63">11.6.1 Dependency types</a><ul class="auto-toc"> |
| 175 |
-<li><a class="reference internal" href="#description-file-dependency-fields" id="id64">11.6.1.1 DESCRIPTION file dependency fields</a></li> |
| 176 |
+<li><a class="reference internal" href="#overlay-creation" id="id60">11.5 Overlay Creation</a></li> |
| 177 |
+<li><a class="reference internal" href="#dependency-resolution" id="id61">11.6 Dependency Resolution</a><ul class="auto-toc"> |
| 178 |
+<li><a class="reference internal" href="#dependency-types" id="id62">11.6.1 Dependency types</a><ul class="auto-toc"> |
| 179 |
+<li><a class="reference internal" href="#description-file-dependency-fields" id="id63">11.6.1.1 DESCRIPTION file dependency fields</a></li> |
| 180 |
</ul> |
| 181 |
</li> |
| 182 |
-<li><a class="reference internal" href="#dependency-environments" id="id65">11.6.2 Dependency Environments</a></li> |
| 183 |
-<li><a class="reference internal" href="#ebuildjob-channel" id="id66">11.6.3 EbuildJob Channel</a></li> |
| 184 |
-<li><a class="reference internal" href="#dependency-rule-pools" id="id67">11.6.4 Dependency Rule Pools</a></li> |
| 185 |
-<li><a class="reference internal" href="#dependency-resolver-modules" id="id68">11.6.5 Dependency Resolver Modules</a></li> |
| 186 |
-<li><a class="reference internal" href="#dependency-resolver" id="id69">11.6.6 Dependency Resolver</a></li> |
| 187 |
+<li><a class="reference internal" href="#dependency-environments" id="id64">11.6.2 Dependency Environments</a></li> |
| 188 |
+<li><a class="reference internal" href="#ebuildjob-channel" id="id65">11.6.3 EbuildJob Channel</a></li> |
| 189 |
+<li><a class="reference internal" href="#dependency-rule-pools" id="id66">11.6.4 Dependency Rule Pools</a></li> |
| 190 |
+<li><a class="reference internal" href="#dependency-resolver-modules" id="id67">11.6.5 Dependency Resolver Modules</a></li> |
| 191 |
+<li><a class="reference internal" href="#dependency-resolver" id="id68">11.6.6 Dependency Resolver</a></li> |
| 192 |
</ul> |
| 193 |
</li> |
| 194 |
</ul> |
| 195 |
@@ -791,6 +791,11 @@ the faster write mechanism (at ca. 95% ebuild creation success rate), |
| 196 |
the default package repositories.</p> |
| 197 |
</td></tr> |
| 198 |
<tr><td class="option-group" colspan="2"> |
| 199 |
+<kbd><span class="option">--fixup-category-move</span>, <span class="option">--fixup-category-move-reverse</span></kbd></td> |
| 200 |
+</tr> |
| 201 |
+<tr><td> </td><td>Remove ebuilds that have been moved to a different category. |
| 202 |
+See <a class="reference internal" href="#action-blocks">Action Blocks</a> in <a class="reference internal" href="#package-rules">Package Rules</a> for details.</td></tr> |
| 203 |
+<tr><td class="option-group" colspan="2"> |
| 204 |
<kbd><span class="option">--config <var>file</var></span>, <span class="option">-c <var>file</var></span></kbd></td> |
| 205 |
</tr> |
| 206 |
<tr><td> </td><td>Path to the config file</td></tr> |
| 207 |
@@ -1636,9 +1641,16 @@ but without the file extension, e.g. |
| 208 |
<td>package file name without version |
| 209 |
and file extension, e.g. <em>seewave</em></td> |
| 210 |
</tr> |
| 211 |
+<tr><td>ebuild_name</td> |
| 212 |
+<td><em>implicit</em></td> |
| 213 |
+<td>ebuild name <tt class="docutils literal">${PN}</tt>, which is the |
| 214 |
+package_name with special chars |
| 215 |
+removed or replaced (e.g., |
| 216 |
+<em>R.oo</em> (pkg) => <em>R_oo</em> (ebuild))</td> |
| 217 |
+</tr> |
| 218 |
<tr><td>name</td> |
| 219 |
<td><em>implicit</em></td> |
| 220 |
-<td><em>alias to package_name</em></td> |
| 221 |
+<td><em>alias to ebuild_name</em></td> |
| 222 |
</tr> |
| 223 |
</tbody> |
| 224 |
</table> |
| 225 |
@@ -1837,22 +1849,91 @@ an ebuild for it</td> |
| 226 |
<tr><td rowspan="2">trace</td> |
| 227 |
<td rowspan="2">package rules</td> |
| 228 |
<td>none</td> |
| 229 |
-<td>marks a package as |
| 230 |
+<td>mark a package as |
| 231 |
modified</td> |
| 232 |
</tr> |
| 233 |
<tr><td>1</td> |
| 234 |
-<td>adds the stored string |
| 235 |
+<td>add the stored string |
| 236 |
to a package's |
| 237 |
<em>modified</em> variable |
| 238 |
whenever this action |
| 239 |
is applied</td> |
| 240 |
</tr> |
| 241 |
+<tr><td>set</td> |
| 242 |
+<td rowspan="2">package |
| 243 |
+metadata, |
| 244 |
+overlay creaton</td> |
| 245 |
+<td>2</td> |
| 246 |
+<td rowspan="2">set package |
| 247 |
+information</td> |
| 248 |
+</tr> |
| 249 |
+<tr><td>set_<key></td> |
| 250 |
+<td>1</td> |
| 251 |
+</tr> |
| 252 |
+<tr><td>rename</td> |
| 253 |
+<td rowspan="2">package |
| 254 |
+metadata, |
| 255 |
+overlay creation</td> |
| 256 |
+<td>2</td> |
| 257 |
+<td rowspan="2">modify package |
| 258 |
+information with |
| 259 |
+sed-like |
| 260 |
+<em>s/expr/repl/</em> |
| 261 |
+statements</td> |
| 262 |
+</tr> |
| 263 |
+<tr><td>rename_<key></td> |
| 264 |
+<td>1</td> |
| 265 |
+</tr> |
| 266 |
</tbody> |
| 267 |
</table> |
| 268 |
+<p>The two-arg form of the set/rename keywords expect a <key> as first and |
| 269 |
+a value / sed expression as second arg. The one-arg form expects the latter |
| 270 |
+one only. The "/" delimitier in the sed expression can be any character.</p> |
| 271 |
+<p>The following <em>info keys</em> can be set and/or modified:</p> |
| 272 |
+<table border="1" class="docutils"> |
| 273 |
+<caption>info keys for set/rename</caption> |
| 274 |
+<colgroup> |
| 275 |
+<col width="19%" /> |
| 276 |
+<col width="29%" /> |
| 277 |
+<col width="51%" /> |
| 278 |
+</colgroup> |
| 279 |
+<thead valign="bottom"> |
| 280 |
+<tr><th class="head">info key</th> |
| 281 |
+<th class="head">supports set/rename</th> |
| 282 |
+<th class="head">description</th> |
| 283 |
+</tr> |
| 284 |
+</thead> |
| 285 |
+<tbody valign="top"> |
| 286 |
+<tr><td>name</td> |
| 287 |
+<td>yes / yes</td> |
| 288 |
+<td>rename the ebuild</td> |
| 289 |
+</tr> |
| 290 |
+<tr><td>category</td> |
| 291 |
+<td>yes / <strong>no</strong></td> |
| 292 |
+<td>set package category</td> |
| 293 |
+</tr> |
| 294 |
+<tr><td>destfile</td> |
| 295 |
+<td>yes / yes</td> |
| 296 |
+<td>rename ebuild destfile by using the |
| 297 |
+'->' operator in <tt class="docutils literal">${SRC_URI}</tt></td> |
| 298 |
+</tr> |
| 299 |
+</tbody> |
| 300 |
+</table> |
| 301 |
+<div class="caution"> |
| 302 |
+<p class="first admonition-title">Caution!</p> |
| 303 |
+<p class="last">Category moves are not handled automatically. In incremental mode, overlay |
| 304 |
+creation has to be called with either <tt class="docutils literal"><span class="pre">--fixup-category-move</span></tt> or |
| 305 |
+<tt class="docutils literal"><span class="pre">--fixup-category-move-reverse</span></tt>, depending on whether the package(s) |
| 306 |
+have been moved away from the default category or back to the default |
| 307 |
+category ("reverse"). Configuring both category move types at once requires |
| 308 |
+a full recreation of the overlay, that is <tt class="docutils literal">rm <span class="pre">-rf</span> <overlay dir></tt> |
| 309 |
+followed by <tt class="docutils literal">roverlay create</tt>.</p> |
| 310 |
+</div> |
| 311 |
<div class="note"> |
| 312 |
<p class="first admonition-title">Note</p> |
| 313 |
-<p class="last">Applying the same (non-incremental) ebuild variable action more than once |
| 314 |
-is possible, but only the last one will have an effect on ebuild creation.</p> |
| 315 |
+<p class="last">Applying the same (non-incremental) ebuild variable, set or rename action |
| 316 |
+more than once is possible, but only the last one will have an effect |
| 317 |
+on ebuild creation.</p> |
| 318 |
</div> |
| 319 |
<div class="section" id="extended-action-block-syntax"> |
| 320 |
<h4><a class="toc-backref" href="#contents">7.1.2.1 Extended Action Block Syntax</a></h4> |
| 321 |
@@ -1911,6 +1992,37 @@ ACTION: |
| 322 |
END; |
| 323 |
END; |
| 324 |
</pre> |
| 325 |
+<p>A rule that assigns all packages from BIOC-2.10/bioc to sci-bioc:</p> |
| 326 |
+<pre class="code literal-block"> |
| 327 |
+MATCH: |
| 328 |
+ repo == BIOC-2.10/bioc |
| 329 |
+ACTION: |
| 330 |
+ set category sci-bioc |
| 331 |
+END; |
| 332 |
+ |
| 333 |
+# alternatively: |
| 334 |
+MATCH: |
| 335 |
+ repo == BIOC-2.10/bioc |
| 336 |
+ACTION: |
| 337 |
+ set_category sci-bioc |
| 338 |
+END; |
| 339 |
+</pre> |
| 340 |
+<p>The following example prefixes all <em>yaml</em> packages with <em>Rpkg_</em>:</p> |
| 341 |
+<pre class="code literal-block"> |
| 342 |
+MATCH: |
| 343 |
+ ebuild_name ,= yaml |
| 344 |
+ACTION: |
| 345 |
+ rename destfile s/^/Rpkg_/ |
| 346 |
+END; |
| 347 |
+</pre> |
| 348 |
+<p>Moving such packages to a "R-package" sub directory would be possible, too:</p> |
| 349 |
+<pre class="code literal-block"> |
| 350 |
+MATCH: |
| 351 |
+ name ,= yaml |
| 352 |
+ACTION: |
| 353 |
+ rename_destfile s=^=R-package= |
| 354 |
+END; |
| 355 |
+</pre> |
| 356 |
</div> |
| 357 |
</div> |
| 358 |
</div> |
| 359 |
@@ -1988,8 +2100,9 @@ location (see <a class="reference internal" href="#repo-config-options">repo con |
| 360 |
<dl class="docutils" id="ebuild-prog"> |
| 361 |
<dt>EBUILD_PROG</dt> |
| 362 |
<dd><p class="first">Name or path of the ebuild executables that is required for (external) |
| 363 |
-Manifest file creation. A wrong value will cause ebuild creation late, |
| 364 |
-which is a huge time loss, so make sure that this option is properly set.</p> |
| 365 |
+Manifest file creation. A wrong value will cause ebuild creation to fail |
| 366 |
+late, which is a huge time loss, so make sure that this option is properly |
| 367 |
+set.</p> |
| 368 |
<p class="last">Defaults to <em>ebuild</em>, which should be fine in most cases.</p> |
| 369 |
</dd> |
| 370 |
</dl> |
| 371 |
@@ -2639,8 +2752,8 @@ functionality:</p> |
| 372 |
<li><em>sync</em> all repos and <em>nosync</em> all repos (offline mode)</li> |
| 373 |
<li>create <em>PackageInfo</em> instances for R packages from all repositories</li> |
| 374 |
</ul> |
| 375 |
-<div class="section" id="id4"> |
| 376 |
-<h3><a class="toc-backref" href="#contents">11.2.1 Repositories</a></h3> |
| 377 |
+<div class="section" id="repository"> |
| 378 |
+<h3><a class="toc-backref" href="#contents">11.2.1 Repository</a></h3> |
| 379 |
<p>The functionality described above is an abstraction layer that calls the |
| 380 |
respective function for each repository and collects the result. |
| 381 |
So, while the <em>RepoList</em> object knows <em>what</em> to do for all repositories, |
| 382 |
@@ -3116,7 +3229,7 @@ becomes "loop until resolver closes".</p> |
| 383 |
</div> |
| 384 |
<div class="footer"> |
| 385 |
<hr class="footer" /> |
| 386 |
-Generated on: 2013-04-23. |
| 387 |
+Generated on: 2013-06-05. |
| 388 |
|
| 389 |
</div> |
| 390 |
</body> |
Archives