From mboxrd@z Thu Jan 1 00:00:00 1970
Return-Path:
Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80])
by finch.gentoo.org (Postfix) with ESMTP id 4B5371381F3
for ; Thu, 13 Jun 2013 16:35:14 +0000 (UTC)
Received: from pigeon.gentoo.org (localhost [127.0.0.1])
by pigeon.gentoo.org (Postfix) with SMTP id 794E3E09A5;
Thu, 13 Jun 2013 16:34:44 +0000 (UTC)
Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183])
(using TLSv1 with cipher AECDH-AES256-SHA (256/256 bits))
(No client certificate requested)
by pigeon.gentoo.org (Postfix) with ESMTPS id EF5E1E09A5
for ; Thu, 13 Jun 2013 16:34:33 +0000 (UTC)
Received: from hornbill.gentoo.org (hornbill.gentoo.org [94.100.119.163])
(using TLSv1 with cipher AECDH-AES256-SHA (256/256 bits))
(No client certificate requested)
by smtp.gentoo.org (Postfix) with ESMTPS id A0EE933E4AF
for ; Thu, 13 Jun 2013 16:34:32 +0000 (UTC)
Received: from localhost.localdomain (localhost [127.0.0.1])
by hornbill.gentoo.org (Postfix) with ESMTP id 3BDDEE5464
for ; Thu, 13 Jun 2013 16:34:29 +0000 (UTC)
From: "André Erdmann"
To: gentoo-commits@lists.gentoo.org
Content-Transfer-Encoding: 8bit
Content-type: text/plain; charset=UTF-8
Reply-To: gentoo-dev@lists.gentoo.org, "André Erdmann"
Message-ID: <1370455551.e1d57a113226f2a8147ebdd26d47e3224bda4179.dywi@gentoo>
Subject: [gentoo-commits] proj/R_overlay:master commit in: doc/html/
X-VCS-Repository: proj/R_overlay
X-VCS-Files: doc/html/usage.html
X-VCS-Directories: doc/html/
X-VCS-Committer: dywi
X-VCS-Committer-Name: André Erdmann
X-VCS-Revision: e1d57a113226f2a8147ebdd26d47e3224bda4179
X-VCS-Branch: master
Date: Thu, 13 Jun 2013 16:34:29 +0000 (UTC)
Precedence: bulk
List-Post:
List-Help:
List-Unsubscribe:
List-Subscribe:
List-Id: Gentoo Linux mail
X-BeenThere: gentoo-commits@lists.gentoo.org
X-Archives-Salt: ea346452-d2e7-40e0-81fc-afca178f888e
X-Archives-Hash: 798ad24d8066a186eb211bf82cecfd8a
Message-ID: <20130613163429.jS-8BWec1SOqteLCJBDjaWPaffuB-FZJa8BTcEfaRyA@z>
commit: e1d57a113226f2a8147ebdd26d47e3224bda4179
Author: André Erdmann mailerd de>
AuthorDate: Wed Jun 5 18:05:51 2013 +0000
Commit: André Erdmann mailerd de>
CommitDate: Wed Jun 5 18:05:51 2013 +0000
URL: http://git.overlays.gentoo.org/gitweb/?p=proj/R_overlay.git;a=commit;h=e1d57a11
doc/html, package rules: set/rename actions
---
doc/html/usage.html | 263 +++++++++++++++++++++++++++++++++++++---------------
1 file changed, 188 insertions(+), 75 deletions(-)
diff --git a/doc/html/usage.html b/doc/html/usage.html
index 62e4e9a..a02a772 100644
--- a/doc/html/usage.html
+++ b/doc/html/usage.html
@@ -329,111 +329,111 @@ ul.auto-toc {
Contents
-- 1 Introduction
-- 2 Installation
-- 2.1 Prerequisites
-- 2.2 via emerge (Gentoo)
-- 2.3 Manual Installation
-- 2.4 Using roverlay without installation
+- 1 Introduction
+- 2 Installation
-- 3 Running Roverlay
-- 3.1 Required configuration steps
-- 3.1.1 Extended Configuration / Where to go from here?
+- 3 Running Roverlay
-- 4 Basic Implementation Overview
-- 4.1 How roverlay works
-- 4.2 Expected Overlay Result / Structure of the generated overlay
-- 4.2.1 Expected Ebuild Result
-- 4.2.2 Expected metadata.xml Result
+- 4 Basic Implementation Overview
-- 5 Repositories / Getting Packages
-- 5.1 A word about repo config files
-- 5.2 Rsync repos
-- 5.3 Getting packages from a repository that supports http only
-- 5.4 Getting packages from several remotes using http and a package list
-- 5.5 Using local directories
+- 5 Repositories / Getting Packages
-- 6 Dependency Rules
-- 6.1 Simple Dependency Rules
-- 6.1.1 Rule Variants
-- 6.1.2 Rule types
-- 6.1.3 Rule File Examples
-- 6.1.4 Rule File Syntax
+- 6 Dependency Rules
-- 7 Package Rules
-- 7.1 Package Rule File Syntax
-- 7.1.1 Match Blocks
-- 7.1.1.1 Extended Match Block Syntax
+- 7 Package Rules
+- 7.1 Package Rule File Syntax
-- 8 Configuration Reference
-- 8.1 misc options
-- 8.2 overlay options
-- 8.3 other config files
-- 8.4 logging
-- 8.4.1 console logging
-- 8.4.2 file logging
+- 8 Configuration Reference
-- 9 Field Definition Config
-- 9.1 Example: The default field definition file
+- 9 Field Definition Config
-- 10 Dependency Resolution Console
-- 11 Implementation Overview
-- 11.1 PackageInfo
-- 11.2 Repository Management
-- 11.2.1 Repositories
-- 11.2.1.1 Adding new repository types
+- 10 Dependency Resolution Console
+- 11 Implementation Overview
+- 11.1 PackageInfo
+- 11.2 Repository Management
-- 11.3 Overlay
-- 11.3.1 Metadata Creation
-- 11.3.2 Manifest Creation
+- 11.3 Overlay
-- 11.4 Ebuild Creation
-- 11.4.1 Ebuild Variables
+- 11.4 Ebuild Creation
-- 11.5 Overlay Creation
-- 11.6 Dependency Resolution
-- 11.6.1 Dependency types
@@ -791,6 +791,11 @@ the faster write mechanism (at ca. 95% ebuild creation success rate),
the default package repositories.
+--fixup-category-move, --fixup-category-move-reverse |
+
+ | Remove ebuilds that have been moved to a different category.
+See Action Blocks in Package Rules for details. |
+
--config file, -c file |
| Path to the config file |
@@ -1636,9 +1641,16 @@ but without the file extension, e.g.
package file name without version
and file extension, e.g. seewave |
+ebuild_name |
+implicit |
+ebuild name ${PN}, which is the
+package_name with special chars
+removed or replaced (e.g.,
+R.oo (pkg) => R_oo (ebuild)) |
+
name |
implicit |
-alias to package_name |
+alias to ebuild_name |
@@ -1837,22 +1849,91 @@ an ebuild for it
trace |
package rules |
none |
-marks a package as
+ | mark a package as
modified |
1 |
-adds the stored string
+ | add the stored string
to a package's
modified variable
whenever this action
is applied |
+set |
+package
+metadata,
+overlay creaton |
+2 |
+set package
+information |
+
+set_<key> |
+1 |
+
+rename |
+package
+metadata,
+overlay creation |
+2 |
+modify package
+information with
+sed-like
+s/expr/repl/
+statements |
+
+rename_<key> |
+1 |
+
+The two-arg form of the set/rename keywords expect a <key> as first and
+a value / sed expression as second arg. The one-arg form expects the latter
+one only. The "/" delimitier in the sed expression can be any character.
+The following info keys can be set and/or modified:
+
+info keys for set/rename
+
+
+
+
+
+
+info key |
+supports set/rename |
+description |
+
+
+
+name |
+yes / yes |
+rename the ebuild |
+
+category |
+yes / no |
+set package category |
+
+destfile |
+yes / yes |
+rename ebuild destfile by using the
+'->' operator in ${SRC_URI} |
+
+
+
+
+
Caution!
+
Category moves are not handled automatically. In incremental mode, overlay
+creation has to be called with either --fixup-category-move or
+--fixup-category-move-reverse, depending on whether the package(s)
+have been moved away from the default category or back to the default
+category ("reverse"). Configuring both category move types at once requires
+a full recreation of the overlay, that is rm -rf <overlay dir>
+followed by roverlay create.
+
Note
-
Applying the same (non-incremental) ebuild variable action more than once
-is possible, but only the last one will have an effect on ebuild creation.
+
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.
@@ -1911,6 +1992,37 @@ ACTION:
END;
END;
+
A rule that assigns all packages from BIOC-2.10/bioc to sci-bioc:
+
+MATCH:
+ repo == BIOC-2.10/bioc
+ACTION:
+ set category sci-bioc
+END;
+
+# alternatively:
+MATCH:
+ repo == BIOC-2.10/bioc
+ACTION:
+ set_category sci-bioc
+END;
+
+
The following example prefixes all yaml packages with Rpkg_:
+
+MATCH:
+ ebuild_name ,= yaml
+ACTION:
+ rename destfile s/^/Rpkg_/
+END;
+
+
Moving such packages to a "R-package" sub directory would be possible, too:
+
+MATCH:
+ name ,= yaml
+ACTION:
+ rename_destfile s=^=R-package=
+END;
+
@@ -1988,8 +2100,9 @@ location (see repo con
- EBUILD_PROG
Name or path of the ebuild executables that is required for (external)
-Manifest file creation. A wrong value will cause ebuild creation late,
-which is a huge time loss, so make sure that this option is properly set.
+Manifest file creation. A wrong value will cause ebuild creation to fail
+late, which is a huge time loss, so make sure that this option is properly
+set.
Defaults to ebuild, which should be fine in most cases.
@@ -2639,8 +2752,8 @@ functionality:
sync all repos and nosync all repos (offline mode)
create PackageInfo instances for R packages from all repositories
-
-
+
+
The functionality described above is an abstraction layer that calls the
respective function for each repository and collects the result.
So, while the RepoList object knows what to do for all repositories,
@@ -3116,7 +3229,7 @@ becomes "loop until resolver closes".