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 ED2F51387FD for ; Fri, 18 Jul 2014 14:55:59 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id B980CE0920; Fri, 18 Jul 2014 14:55:58 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id C9526E093B for ; Fri, 18 Jul 2014 14:55:57 +0000 (UTC) Received: from spoonbill.gentoo.org (spoonbill.gentoo.org [81.93.255.5]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id E9C0A340389 for ; Fri, 18 Jul 2014 14:55:56 +0000 (UTC) Received: from localhost.localdomain (localhost [127.0.0.1]) by spoonbill.gentoo.org (Postfix) with ESMTP id A4E39193E8 for ; Fri, 18 Jul 2014 14:55:55 +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: <1405695233.ddc44b19a1310813ccbf1a533a1884685bd27ce3.dywi@gentoo> Subject: [gentoo-commits] proj/R_overlay:wip/addition_control commit in: doc/rst/ X-VCS-Repository: proj/R_overlay X-VCS-Files: doc/rst/usage.rst X-VCS-Directories: doc/rst/ X-VCS-Committer: dywi X-VCS-Committer-Name: André Erdmann X-VCS-Revision: ddc44b19a1310813ccbf1a533a1884685bd27ce3 X-VCS-Branch: wip/addition_control Date: Fri, 18 Jul 2014 14:55:55 +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: 53f37ecd-5fa2-4550-ad94-3a854ed059a4 X-Archives-Hash: 9d2b98a8f8a38f2fdcee79710ac56aa3 Message-ID: <20140718145555.GVzqyRysBw5757HgH5wpIgtBqpIRBvk4j4N3AyTCzaQ@z> commit: ddc44b19a1310813ccbf1a533a1884685bd27ce3 Author: André Erdmann mailerd de> AuthorDate: Fri Jul 18 14:53:53 2014 +0000 Commit: André Erdmann mailerd de> CommitDate: Fri Jul 18 14:53:53 2014 +0000 URL: http://git.overlays.gentoo.org/gitweb/?p=proj/R_overlay.git;a=commit;h=ddc44b19 doc/rst/usage.rst: document add-policy args --- doc/rst/usage.rst | 45 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 45 insertions(+) diff --git a/doc/rst/usage.rst b/doc/rst/usage.rst index f841f36..c8ffff9 100644 --- a/doc/rst/usage.rst +++ b/doc/rst/usage.rst @@ -514,6 +514,51 @@ to know in detail what *roverlay* does before running it. --no-incremental Force recreation of existing ebuilds +--package-revbump + Enforces a revbump of ````. + + ```` can be a package name (``${PN}``), a package name with + version (``${P}`` or ``${PF}``), optionally prefixed with its category + (``${CATEGORY}/${PN}``, ``${CATEGORY}/${PF}`` etc.). + Wildcard characters (``*``, ``?``) are supported, too. + + Incremental overlay creation only. + A revbump only occurs if the package exists in the overlay and is queued + for overlay creation. + +--package-force-replace + Enforces a recreation of ````. + + See ``--package-revbump``. + +--package-replace-only + Forbids ebuild creation for ```` if it does not exist in the + overlay already. + + Useful in conjunction with ``--package-revbump``, ``--package-replace``, + ``--package-list`` or ``--ebuild-list``: + + .. code:: text + + roverlay --package-revbump "sci-R/*" --package-replace-only "*" + + +--package-list + A file that lists packages that should be revbumped. + + Same as specifying ``--package-replace-only --package-revbump `` + for each line in the file. + + The file can also be in extended format. (TODO: NOT DOCUMENTED) + + +--ebuild-list + Same as ``--package-list``, but expects a file that lists ebuild files. + + Useful in combination with ``grep -rl `` scripts. + + The file can also be in extended format. (TODO: NOT DOCUMENTED) + --no-revbump Disable revbump checks in incremental overlay creation mode