1 |
Signed-off-by: Göktürk Yüksek <gokturk@××××××××××.edu> |
2 |
--- |
3 |
ebuild-writing/misc-files/metadata/text.xml | 50 +++++++++++++++++++++++++++++ |
4 |
1 file changed, 50 insertions(+) |
5 |
|
6 |
diff --git a/ebuild-writing/misc-files/metadata/text.xml b/ebuild-writing/misc-files/metadata/text.xml |
7 |
index 3d135a6..486af11 100644 |
8 |
--- a/ebuild-writing/misc-files/metadata/text.xml |
9 |
+++ b/ebuild-writing/misc-files/metadata/text.xml |
10 |
@@ -549,6 +549,56 @@ is demonstrated. |
11 |
|
12 |
</body> |
13 |
</subsubsection> |
14 |
+<subsubsection> |
15 |
+<title>Slots and Subslots</title> |
16 |
+<body> |
17 |
+ |
18 |
+<p> |
19 |
+The main focus of this example is to demonstrate how slots and |
20 |
+subslots are specified, by examining the metadata of |
21 |
+<path>media-libs/libpng</path>. There may be multiple reasons for |
22 |
+slotting depending on the nature of the package. For this particular |
23 |
+package, it can be seen that the slots are used to provide different |
24 |
+versions of the library with varying binary compatibility and that |
25 |
+developers are advised to build against the slot 0. Furthermore, |
26 |
+different versions of this package with the same subslot provide the |
27 |
+same Application Binary Interface (ABI), according to the description |
28 |
+specified in the <c><subslots></c> tag. |
29 |
+</p> |
30 |
+ |
31 |
+<codesample lang="sgml"> |
32 |
+<?xml version="1.0" encoding="UTF-8"?> |
33 |
+<!DOCTYPE pkgmetadata SYSTEM "http://www.gentoo.org/dtd/metadata.dtd"> |
34 |
+<pkgmetadata> |
35 |
+ <maintainer type="project"> |
36 |
+ <email>base-system@g.o</email> |
37 |
+ <name>Gentoo Base System</name> |
38 |
+ </maintainer> |
39 |
+ <use> |
40 |
+ <flag name="apng">support unofficial APNG (Animated PNG) spec</flag> |
41 |
+ </use> |
42 |
+ <upstream> |
43 |
+ <remote-id type="cpe">cpe:/a:libpng:libpng</remote-id> |
44 |
+ <remote-id type="sourceforge">apng</remote-id> |
45 |
+ </upstream> |
46 |
+ <slots> |
47 |
+ <slot name="0"> |
48 |
+ For building against. This is the only slot |
49 |
+ that provides headers and command line tools. |
50 |
+ </slot> |
51 |
+ <slot name="1.2"> |
52 |
+ For binary compatibility, provides libpng12.so.0 only. |
53 |
+ </slot> |
54 |
+ <slot name="1.5"> |
55 |
+ For binary compatibility, provides libpng15.so.15 only. |
56 |
+ </slot> |
57 |
+ <subslots>Reflect ABI compatibility for libpng.so.</subslots> |
58 |
+ </slots> |
59 |
+</pkgmetadata> |
60 |
+</codesample> |
61 |
+ |
62 |
+</body> |
63 |
+</subsubsection> |
64 |
</body> |
65 |
</subsection> |
66 |
<subsection> |
67 |
-- |
68 |
2.7.3 |