* [gentoo-commits] proj/devmanual:master commit in: general-concepts/virtuals/
@ 2013-09-26 7:41 Markos Chandras
0 siblings, 0 replies; 7+ messages in thread
From: Markos Chandras @ 2013-09-26 7:41 UTC (permalink / raw
To: gentoo-commits
commit: 3b620a3e22d5832a4a4223c2350a49e20ed286b6
Author: Manuel Rüger <mrueg <AT> rueg <DOT> eu>
AuthorDate: Thu Sep 26 03:22:31 2013 +0000
Commit: Markos Chandras <hwoarang <AT> gentoo <DOT> org>
CommitDate: Thu Sep 26 03:22:31 2013 +0000
URL: http://git.overlays.gentoo.org/gitweb/?p=proj/devmanual.git;a=commit;h=3b620a3e
Destabilizes architectures to be consistent with the tree
---
general-concepts/virtuals/text.xml | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/general-concepts/virtuals/text.xml b/general-concepts/virtuals/text.xml
index 6397883..96d9ba3 100644
--- a/general-concepts/virtuals/text.xml
+++ b/general-concepts/virtuals/text.xml
@@ -27,7 +27,7 @@ EAPI=4
DESCRIPTION="Virtual for C++ tr1 <type_traits>"
SLOT="0"
-KEYWORDS="alpha amd64 arm hppa ia64 mips ppc ppc64 s390 sparc x86 ~x86-fbsd"
+KEYWORDS="alpha amd64 arm hppa ia64 ~mips ppc ppc64 ~s390 sparc x86 ~x86-fbsd"
RDEPEND="|| ( >=sys-devel/gcc-4.1 dev-libs/boost )"
</codesample>
^ permalink raw reply related [flat|nested] 7+ messages in thread
* [gentoo-commits] proj/devmanual:master commit in: general-concepts/virtuals/
@ 2018-02-13 16:46 Göktürk Yüksek
0 siblings, 0 replies; 7+ messages in thread
From: Göktürk Yüksek @ 2018-02-13 16:46 UTC (permalink / raw
To: gentoo-commits
commit: 7266aee16fa73086a1d9553ab9129013d83a4761
Author: Michał Górny <mgorny <AT> gentoo <DOT> org>
AuthorDate: Fri Jan 12 23:23:30 2018 +0000
Commit: Göktürk Yüksek <gokturk <AT> gentoo <DOT> org>
CommitDate: Tue Feb 13 16:43:32 2018 +0000
URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=7266aee1
general-concepts/virtuals: Tips on virtual and subslots
general-concepts/virtuals/text.xml | 80 ++++++++++++++++++++++++++++++++++++++
1 file changed, 80 insertions(+)
diff --git a/general-concepts/virtuals/text.xml b/general-concepts/virtuals/text.xml
index 4809394..ff4995a 100644
--- a/general-concepts/virtuals/text.xml
+++ b/general-concepts/virtuals/text.xml
@@ -70,5 +70,85 @@ RDEPEND="|| ( dev-libs/liblinux dev-libs/libbsd )"
</section>
+<section>
+<title>Virtuals and subslots</title>
+
+<body>
+<warning>
+This section is only applicable if virtual providers include versions that
+are ABI-compatible with one another (and use matching SONAMEs) and/or
+the incompatible providers are being obsoleted.
+</warning>
+
+<p>
+Like regular packages, virtuals can define subslots that can be used
+to trigger rebuilds of their reverse dependencies. For this to work, a new
+version of the virtual is created for each subslot of the providers,
+where each version contains dependencies on a specific subslot.
+</p>
+
+<p>
+For example, a virtual for different packages providing ABI-compatible
+<c>libfoo.so.1</c> libraries could look like the following:
+</p>
+
+<codesample lang="ebuild">
+EAPI=6
+
+DESCRIPTION="Virtual for libfoo.so.1"
+SLOT="0/1"
+
+RDEPEND="
+ || (
+ dev-libs/libfoo:0/1
+ dev-libs/libfoo-alternate:0/1
+ dev-libs/bigpack:0/libfoo-1+libbar-0
+ dev-libs/bigpack:0/libfoo-1+libbar-1
+ )
+"
+</codesample>
+
+<p>
+Virtuals can also be used when one of the providers is being obsoleted in favor
+of another that breaks ABI compatibility while remaining API-compatible. In this
+case, multiple versions of the virtual are created, each specifying a single
+provider and a unique subslot.
+</p>
+
+<p>
+For example, if <c>dev-libs/libfoo</c> (<c>libfoo.so.0</c>) is being replaced
+by <c>dev-libs/newfoo</c> (<c>libfoo.so.1</c>), <c>virtual/libfoo-0.ebuild</c>
+would contain:
+</p>
+
+<codesample lang="ebuild">
+EAPI=6
+
+DESCRIPTION="Virtual for libfoo.so.0"
+SLOT="0/0"
+RDEPEND="dev-libs/libfoo:0/0"
+</codesample>
+
+<p>
+while <c>virtual/libfoo-1.ebuild</c> would contain:
+</p>
+
+<codesample lang="ebuild">
+EAPI=6
+
+DESCRIPTION="Virtual for libfoo.so.1"
+SLOT="0/1"
+RDEPEND="dev-libs/newfoo:0/1"
+</codesample>
+
+<note>
+In this case, the package manager will naturally want to upgrade
+to <c>dev-libs/newfoo</c> whenever possible. Therefore, this solution
+is not viable if clean choice between the two providers is desired.
+</note>
+
+</body>
+</section>
+
</chapter>
</guide>
^ permalink raw reply related [flat|nested] 7+ messages in thread
* [gentoo-commits] proj/devmanual:master commit in: general-concepts/virtuals/
@ 2018-02-13 16:46 Göktürk Yüksek
0 siblings, 0 replies; 7+ messages in thread
From: Göktürk Yüksek @ 2018-02-13 16:46 UTC (permalink / raw
To: gentoo-commits
commit: baa6f758e2f4f21b44b5db92bdba78d8c4b48021
Author: Michał Górny <mgorny <AT> gentoo <DOT> org>
AuthorDate: Fri Jan 12 22:57:47 2018 +0000
Commit: Göktürk Yüksek <gokturk <AT> gentoo <DOT> org>
CommitDate: Tue Feb 13 16:43:07 2018 +0000
URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=baa6f758
general-concepts/virtuals: Explain how keywording works on virtuals
general-concepts/virtuals/text.xml | 28 ++++++++++++++++++++++++++++
1 file changed, 28 insertions(+)
diff --git a/general-concepts/virtuals/text.xml b/general-concepts/virtuals/text.xml
index 5ba9ea5..4809394 100644
--- a/general-concepts/virtuals/text.xml
+++ b/general-concepts/virtuals/text.xml
@@ -42,5 +42,33 @@ from the Gentoo repository.
</note>
</body>
+<section>
+<title>KEYWORDS in virtual packages</title>
+
+<body>
+<p>
+Since virtual packages do not install any files, they do not follow the regular
+arch testing procedure. Instead, the developer can immediately set
+the <c>KEYWORDS</c> of a virtual to the union of <c>KEYWORDS</c> of its
+providers. In particular, if a new virtual is created for a stable package,
+the virtual is committed straight to stable.
+</p>
+
+<p>
+For example, if you have two packages: <c>dev-libs/liblinux</c> with
+<c>KEYWORDS="amd64 ~x86"</c> and <c>dev-libs/libbsd</c> with
+<c>KEYWORDS="~amd64-fbsd ~x86-fbsd"</c>, the resulting virtual will
+have:
+</p>
+
+<codesample lang="ebuild">
+KEYWORDS="amd64 ~x86 ~amd64-fbsd ~x86-fbsd"
+
+RDEPEND="|| ( dev-libs/liblinux dev-libs/libbsd )"
+</codesample>
+</body>
+
+</section>
+
</chapter>
</guide>
^ permalink raw reply related [flat|nested] 7+ messages in thread
* [gentoo-commits] proj/devmanual:master commit in: general-concepts/virtuals/
@ 2018-02-13 16:47 Göktürk Yüksek
0 siblings, 0 replies; 7+ messages in thread
From: Göktürk Yüksek @ 2018-02-13 16:47 UTC (permalink / raw
To: gentoo-commits
commit: 2e4e9c6914c6198fd50b935989034d389053d6aa
Author: Göktürk Yüksek <gokturk <AT> gentoo <DOT> org>
AuthorDate: Tue Feb 13 16:47:13 2018 +0000
Commit: Göktürk Yüksek <gokturk <AT> gentoo <DOT> org>
CommitDate: Tue Feb 13 16:47:13 2018 +0000
URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=2e4e9c69
general-concepts/virtuals: s/clean choice/a clean choice/
general-concepts/virtuals/text.xml | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/general-concepts/virtuals/text.xml b/general-concepts/virtuals/text.xml
index ff4995a..8eb9675 100644
--- a/general-concepts/virtuals/text.xml
+++ b/general-concepts/virtuals/text.xml
@@ -144,7 +144,7 @@ RDEPEND="dev-libs/newfoo:0/1"
<note>
In this case, the package manager will naturally want to upgrade
to <c>dev-libs/newfoo</c> whenever possible. Therefore, this solution
-is not viable if clean choice between the two providers is desired.
+is not viable if a clean choice between the two providers is desired.
</note>
</body>
^ permalink raw reply related [flat|nested] 7+ messages in thread
* [gentoo-commits] proj/devmanual:master commit in: general-concepts/virtuals/
@ 2020-03-11 13:43 Ulrich Müller
0 siblings, 0 replies; 7+ messages in thread
From: Ulrich Müller @ 2020-03-11 13:43 UTC (permalink / raw
To: gentoo-commits
commit: df0cda737a6c5e51907f0c90c568337de16f0400
Author: Ulrich Müller <ulm <AT> gentoo <DOT> org>
AuthorDate: Wed Mar 11 13:42:21 2020 +0000
Commit: Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Wed Mar 11 13:42:21 2020 +0000
URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=df0cda73
general-concepts/virtuals: Clarify definition.
Closes: https://bugs.gentoo.org/711936
Signed-off-by: Ulrich Müller <ulm <AT> gentoo.org>
general-concepts/virtuals/text.xml | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/general-concepts/virtuals/text.xml b/general-concepts/virtuals/text.xml
index b9889aa..6ac5832 100644
--- a/general-concepts/virtuals/text.xml
+++ b/general-concepts/virtuals/text.xml
@@ -6,7 +6,7 @@
<body>
<p>
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
+use their dependency string to specify the providers for the virtual and do
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
^ permalink raw reply related [flat|nested] 7+ messages in thread
* [gentoo-commits] proj/devmanual:master commit in: general-concepts/virtuals/
@ 2021-03-22 6:48 Ulrich Müller
0 siblings, 0 replies; 7+ messages in thread
From: Ulrich Müller @ 2021-03-22 6:48 UTC (permalink / raw
To: gentoo-commits
commit: 66c40c6d2685b1c8da029ad0519a0d30f7057570
Author: Sam James <sam <AT> gentoo <DOT> org>
AuthorDate: Mon Mar 22 01:45:27 2021 +0000
Commit: Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Mon Mar 22 06:47:43 2021 +0000
URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=66c40c6d
general-concepts/virtuals: fix typo
Closes: https://github.com/gentoo/devmanual/pull/213
Signed-off-by: Sam James <sam <AT> gentoo.org>
[Fix whitespace]
Signed-off-by: Ulrich Müller <ulm <AT> gentoo.org>
general-concepts/virtuals/text.xml | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/general-concepts/virtuals/text.xml b/general-concepts/virtuals/text.xml
index 377933f..d45c1ff 100644
--- a/general-concepts/virtuals/text.xml
+++ b/general-concepts/virtuals/text.xml
@@ -34,7 +34,7 @@ RDEPEND="|| ( >=sys-devel/gcc-4.1 dev-libs/boost )"
</codesample>
<p>
-Looks familar...right? It should since its going to look just like a regular
+Looks familar...right? It should since it's going to look just like a regular
ebuild.
</p>
^ permalink raw reply related [flat|nested] 7+ messages in thread
* [gentoo-commits] proj/devmanual:master commit in: general-concepts/virtuals/
@ 2021-12-09 4:24 Sam James
0 siblings, 0 replies; 7+ messages in thread
From: Sam James @ 2021-12-09 4:24 UTC (permalink / raw
To: gentoo-commits
commit: d19d95690f821f1a867f8e2095835056e988618f
Author: Sam James <sam <AT> gentoo <DOT> org>
AuthorDate: Thu Dec 9 04:21:47 2021 +0000
Commit: Sam James <sam <AT> gentoo <DOT> org>
CommitDate: Thu Dec 9 04:24:30 2021 +0000
URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=d19d9569
general-concepts/virtuals: use EAPI 8 in examples
Signed-off-by: Sam James <sam <AT> gentoo.org>
general-concepts/virtuals/text.xml | 12 +++++++-----
1 file changed, 7 insertions(+), 5 deletions(-)
diff --git a/general-concepts/virtuals/text.xml b/general-concepts/virtuals/text.xml
index d45c1ff..f6cf198 100644
--- a/general-concepts/virtuals/text.xml
+++ b/general-concepts/virtuals/text.xml
@@ -24,11 +24,11 @@ An example of a virtual:
</p>
<codesample lang="ebuild">
-EAPI=7
+EAPI=8
DESCRIPTION="Virtual for C++ tr1 <type_traits>"
SLOT="0"
-KEYWORDS="alpha amd64 arm hppa ia64 ~mips ppc ppc64 ~s390 sparc x86 ~x64-macos"
+KEYWORDS="~alpha amd64 arm hppa ~ia64 ~mips ppc ppc64 ~s390 sparc x86 ~x64-macos"
RDEPEND="|| ( >=sys-devel/gcc-4.1 dev-libs/boost )"
</codesample>
@@ -95,7 +95,7 @@ For example, a virtual for different packages providing ABI-compatible
</p>
<codesample lang="ebuild">
-EAPI=6
+EAPI=8
DESCRIPTION="Virtual for libfoo.so.1"
SLOT="0/1"
@@ -124,10 +124,11 @@ would contain:
</p>
<codesample lang="ebuild">
-EAPI=6
+EAPI=8
DESCRIPTION="Virtual for libfoo.so.0"
SLOT="0/0"
+
RDEPEND="dev-libs/libfoo:0/0"
</codesample>
@@ -136,10 +137,11 @@ while <c>virtual/libfoo-1.ebuild</c> would contain:
</p>
<codesample lang="ebuild">
-EAPI=6
+EAPI=8
DESCRIPTION="Virtual for libfoo.so.1"
SLOT="0/1"
+
RDEPEND="dev-libs/newfoo:0/1"
</codesample>
^ permalink raw reply related [flat|nested] 7+ messages in thread
end of thread, other threads:[~2021-12-09 4:24 UTC | newest]
Thread overview: 7+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2021-03-22 6:48 [gentoo-commits] proj/devmanual:master commit in: general-concepts/virtuals/ Ulrich Müller
-- strict thread matches above, loose matches on Subject: below --
2021-12-09 4:24 Sam James
2020-03-11 13:43 Ulrich Müller
2018-02-13 16:47 Göktürk Yüksek
2018-02-13 16:46 Göktürk Yüksek
2018-02-13 16:46 Göktürk Yüksek
2013-09-26 7:41 Markos Chandras
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox