Attachment 368100 Details for Bug 421993 – Patch: Document mask policy for live ebuilds

[patch] Patch: Document mask policy for live ebuilds

0001-Document-mask-policy-for-live-ebuilds.patch (text/plain), 2.91 KB, created by Ulrich Müller on 2014-01-18 16:04:58 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Ulrich Müller

Created: 2014-01-18 16:04:58 UTC

Size: 2.91 KB

patch

obsolete

>From df1bce32bdae5ff8e80d39f49330c16a5cbc2db8 Mon Sep 17 00:00:00 2001
>From: =?UTF-8?q?Ulrich=20M=C3=BCller?= <ulm@gentoo.org>
>Date: Sat, 18 Jan 2014 17:04:50 +0100
>Subject: [PATCH] Document mask policy for live ebuilds.
>
>Bug 421993
>---
> ebuild-writing/functions/src_unpack/cvs-sources/text.xml | 10 +++++++++-
> ebuild-writing/functions/src_unpack/svn-sources/text.xml | 11 +++++++++--
> 2 files changed, 18 insertions(+), 3 deletions(-)
>
>diff --git a/ebuild-writing/functions/src_unpack/cvs-sources/text.xml b/ebuild-writing/functions/src_unpack/cvs-sources/text.xml
>index 54de8cb..2f24cc7 100644
>--- a/ebuild-writing/functions/src_unpack/cvs-sources/text.xml
>+++ b/ebuild-writing/functions/src_unpack/cvs-sources/text.xml
>@@ -17,7 +17,7 @@ need to test unreleased snapshots on a regular basis.
> 
> 
> Note that CVS ebuilds should not generally be added to the tree
>-(except with <c>KEYWORDS=""</c>) for the following reasons:
>+for the following reasons:
> 
> 
> <ul>
>@@ -76,6 +76,14 @@ date or revision are even worse candidates for tree inclusion:
> <title>Using CVS Sources</title>
> <body>
> 
>+<note>
>+CVS ebuilds must be either with empty <c>KEYWORDS</c> or
>+package.masked (but <e>not</e> both). Empty <c>KEYWORDS</c> are
>+strongly preferred. This applies to "live" ebuilds (<c>-9999</c>) and
>+to ebuilds that extract a static revision but still use CVS for
>+fetching.
>+</note>
>+
> 
> To use a CVS source, <c>cvs.eclass</c> must be inherited, and then a
> number of variables must be set. The following variables are often
>diff --git a/ebuild-writing/functions/src_unpack/svn-sources/text.xml b/ebuild-writing/functions/src_unpack/svn-sources/text.xml
>index c504947..e436c97 100644
>--- a/ebuild-writing/functions/src_unpack/svn-sources/text.xml
>+++ b/ebuild-writing/functions/src_unpack/svn-sources/text.xml
>@@ -19,8 +19,7 @@ ection.
> 
> 
> Note that Subversion ebuilds should not generally be added to
>-the tree (unless introduced with <c>KEYWORDS=""</c>) for much the same reasons
>-that live CVS ebuilds should not (see
>+the tree for much the same reasons that live CVS ebuilds should not (see
> <uri link="::ebuild-writing/functions/src_unpack/cvs-sources#Disadvantages of CVS Sources"/>).
> Indeed, there should be even less impetus to add a live Subversion ebuild than a live CVS ebuild, as
> Subversion checkouts are roughly a factor of five larger than an
>@@ -42,6 +41,14 @@ $ svn export svn://svn.berlios.de/svnroot/repos/gentoo-syntax -r HEAD gentoo-syn
> <title>Using Subversion Sources</title>
> <body>
> 
>+<note>
>+Subversion ebuilds must be either with empty <c>KEYWORDS</c> or
>+package.masked (but <e>not</e> both). Empty <c>KEYWORDS</c> are
>+strongly preferred. This applies to "live" ebuilds (<c>-9999</c>) and
>+to ebuilds that extract a static revision but still use Subversion for
>+fetching.
>+</note>
>+
> 
> To use a Subversion source, <c>subversion.eclass</c> must be
> inherited, and then at least <c>ESVN_REPO_URI</c> must be set. The
>-- 
>1.8.5.3
>

Actions: View | Diff

Attachments on bug 421993: 315765 | 362444 | 368100