From: "Göktürk Yüksek" <gokturk@binghamton.edu>
To: gentoo-commits@lists.gentoo.org
Subject: [gentoo-commits] proj/devmanual:master commit in: ebuild-writing/misc-files/metadata/
Date: Wed, 18 May 2016 05:32:21 +0000 (UTC) [thread overview]
Message-ID: <1463546389.1ed9fb686fd3b10ee9a0f7f4b797765073508113.gokturk@gentoo> (raw)
commit: 1ed9fb686fd3b10ee9a0f7f4b797765073508113
Author: Göktürk Yüksek <gokturk <AT> binghamton <DOT> edu>
AuthorDate: Thu Apr 28 07:53:34 2016 +0000
Commit: Göktürk Yüksek <gokturk <AT> binghamton <DOT> edu>
CommitDate: Wed May 18 04:39:49 2016 +0000
URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=1ed9fb68
ebuild-writing/misc-files/metadata: add an example for slots and subslots
Signed-off-by: Göktürk Yüksek <gokturk <AT> binghamton.edu>
ebuild-writing/misc-files/metadata/text.xml | 50 +++++++++++++++++++++++++++++
1 file changed, 50 insertions(+)
diff --git a/ebuild-writing/misc-files/metadata/text.xml b/ebuild-writing/misc-files/metadata/text.xml
index 3d135a6..486af11 100644
--- a/ebuild-writing/misc-files/metadata/text.xml
+++ b/ebuild-writing/misc-files/metadata/text.xml
@@ -549,6 +549,56 @@ is demonstrated.
</body>
</subsubsection>
+<subsubsection>
+<title>Slots and Subslots</title>
+<body>
+
+<p>
+The main focus of this example is to demonstrate how slots and
+subslots are specified, by examining the metadata of
+<path>media-libs/libpng</path>. There may be multiple reasons for
+slotting depending on the nature of the package. For this particular
+package, it can be seen that the slots are used to provide different
+versions of the library with varying binary compatibility and that
+developers are advised to build against the slot 0. Furthermore,
+different versions of this package with the same subslot provide the
+same Application Binary Interface (ABI), according to the description
+specified in the <c><subslots></c> tag.
+</p>
+
+<codesample lang="sgml">
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE pkgmetadata SYSTEM "http://www.gentoo.org/dtd/metadata.dtd">
+<pkgmetadata>
+ <maintainer type="project">
+ <email>base-system@gentoo.org</email>
+ <name>Gentoo Base System</name>
+ </maintainer>
+ <use>
+ <flag name="apng">support unofficial APNG (Animated PNG) spec</flag>
+ </use>
+ <upstream>
+ <remote-id type="cpe">cpe:/a:libpng:libpng</remote-id>
+ <remote-id type="sourceforge">apng</remote-id>
+ </upstream>
+ <slots>
+ <slot name="0">
+ For building against. This is the only slot
+ that provides headers and command line tools.
+ </slot>
+ <slot name="1.2">
+ For binary compatibility, provides libpng12.so.0 only.
+ </slot>
+ <slot name="1.5">
+ For binary compatibility, provides libpng15.so.15 only.
+ </slot>
+ <subslots>Reflect ABI compatibility for libpng.so.</subslots>
+ </slots>
+</pkgmetadata>
+</codesample>
+
+</body>
+</subsubsection>
</body>
</subsection>
<subsection>
next reply other threads:[~2016-05-18 5:32 UTC|newest]
Thread overview: 25+ messages / expand[flat|nested] mbox.gz Atom feed top
2016-05-18 5:32 Göktürk Yüksek [this message]
-- strict thread matches above, loose matches on Subject: below --
2022-06-01 20:39 [gentoo-commits] proj/devmanual:master commit in: ebuild-writing/misc-files/metadata/ Ulrich Müller
2022-05-27 9:04 Ulrich Müller
2022-01-12 6:34 Ulrich Müller
2022-01-12 6:34 Ulrich Müller
2022-01-12 6:34 Ulrich Müller
2021-09-11 21:59 Ulrich Müller
2020-04-20 8:02 Ulrich Müller
2020-04-20 8:02 Ulrich Müller
2020-04-20 8:02 Ulrich Müller
2020-01-23 7:47 Ulrich Müller
2020-01-14 20:36 Göktürk Yüksek
2017-04-13 19:35 Göktürk Yüksek
2016-12-11 6:19 Göktürk Yüksek
2016-05-18 5:32 Göktürk Yüksek
2016-05-18 5:32 Göktürk Yüksek
2016-05-18 5:32 Göktürk Yüksek
2016-05-18 5:32 Göktürk Yüksek
2016-02-05 12:59 Ulrich Müller
2016-02-05 12:59 Ulrich Müller
2014-01-19 15:14 Markos Chandras
2014-01-03 18:32 Markos Chandras
2013-05-12 15:06 Markos Chandras
2012-11-11 19:33 Markos Chandras
2012-11-02 17:49 Markos Chandras
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=1463546389.1ed9fb686fd3b10ee9a0f7f4b797765073508113.gokturk@gentoo \
--to=gokturk@binghamton.edu \
--cc=gentoo-commits@lists.gentoo.org \
--cc=gentoo-dev@lists.gentoo.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox