Attachment 135934 Details for Bug 140180 – A start atleast

[patch] A start atleast

bug140180.patch (text/plain), 2.65 KB, created by Mark Loeser (RETIRED) on 2007-11-14 03:25:55 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Mark Loeser (RETIRED)

Created: 2007-11-14 03:25:55 UTC

Size: 2.65 KB

patch

obsolete

>Index: general-concepts/text.xml
>===================================================================
>--- general-concepts/text.xml	(revision 105)
>+++ general-concepts/text.xml	(working copy)
>@@ -43,4 +43,5 @@
> <include href="tree/"/>
> <include href="use-flags/"/>
> <include href="user-environment/"/>
>+<include href="virtuals/"/>
> </guide>
>Index: general-concepts/virtuals/text.xml
>===================================================================
>--- general-concepts/virtuals/text.xml	(revision 0)
>+++ general-concepts/virtuals/text.xml	(revision 0)
>@@ -0,0 +1,73 @@
>+<?xml version="1.0"?>
>+<guide self="general-concepts/viruals/">
>+<chapter>
>+<title>Virtuals</title>
>+
>+<body>
>+<p>
>+Currently there exist two different forms of virtuals, our regular
>+<c>PROVIDE</c> type virtuals, and so called <e>new-style</e> virtuals.
>+</p>
>+</body>
>+
>+<section>
>+<title><e>Old-style</e> Virtuals</title>
>+<body>
>+<p>
>+<e>Old-style</e> virtuals are not really packages, but are something you can depend
>+upon and install.  All <e>old-style</e> virtuals must have a category of
>+"virtual".  In order to use an <e>old-style</e> virtual there are a few things
>+that need to be present in the tree:
>+
>+<ul>
>+  <li>
>+    Atleast one ebuild must <c>PROVIDE</c> the virtual <d/> see
>+    <uri link="::ebuild-writing/variables#Optional Variables" />
>+  </li>
>+  <li>
>+    An entry in the virtuals file for each profile to list the default provider
>+  </li>
>+</ul>
>+
>+<e>Old-style</e> virtuals are not as flexible as <e>new-style</e> virtuals
>+because there is no concept of a version.  You can only depend upon a virtual,
>+but not a particular version of that virtual.
>+</p>
>+</body>
>+</section>
>+
>+<section>
>+<title><e>New-style</e> Virtuals</title>
>+<body>
>+<p>
>+<e>New-style</e> virtuals are merely packages that are in the category of
>+<c>virtual</c>.  They use their dependency string to specify the providers for
>+the virtual and should not install any files.  Since they are regular ebuilds,
>+there can be several versions of a virtual (which can be helpful when a package
>+may be provided by another in some versions, and not others <d/> see the perl
>+virtuals for an example of this).
>+</p>
>+
>+<p>
>+An example of a <e>new-style</e> virtual:
>+
>+<codesample lang="ebuild">
>+DESCRIPTION="Virtual for C++ tr1 &lt;type_traits&gt;"
>+HOMEPAGE="http://www.gentoo.org/proj/en/base/"
>+SRC_URI=""
>+LICENSE="as-is"
>+SLOT="0"
>+KEYWORDS="alpha amd64 arm hppa ia64 mips ppc ppc64 s390 sparc x86 ~x86-fbsd"
>+IUSE=""
>+RDEPEND="|| ( >=sys-devel/gcc-4.1 dev-libs/boost )"
>+DEPEND=""
>+</codesample>
>+
>+Looks familar...right?  It should since its going to look just like a regular
>+ebuild.
>+</p>
>+</body>
>+</section>
>+
>+</chapter>
>+</guide>

Actions: View | Diff

Attachments on bug 140180: 135934 | 136923 | 136931