1 |
shadow 08/07/25 14:06:00 |
2 |
|
3 |
Modified: hb-guide-metadata.xml |
4 |
Log: |
5 |
sync to 1.13 |
6 |
|
7 |
Revision Changes Path |
8 |
1.7 xml/htdocs/proj/pl/devrel/handbook/hb-guide-metadata.xml |
9 |
|
10 |
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/pl/devrel/handbook/hb-guide-metadata.xml?rev=1.7&view=markup |
11 |
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/pl/devrel/handbook/hb-guide-metadata.xml?rev=1.7&content-type=text/plain |
12 |
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/pl/devrel/handbook/hb-guide-metadata.xml?r1=1.6&r2=1.7 |
13 |
|
14 |
Index: hb-guide-metadata.xml |
15 |
=================================================================== |
16 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/pl/devrel/handbook/hb-guide-metadata.xml,v |
17 |
retrieving revision 1.6 |
18 |
retrieving revision 1.7 |
19 |
diff -u -r1.6 -r1.7 |
20 |
--- hb-guide-metadata.xml 31 Mar 2008 19:27:03 -0000 1.6 |
21 |
+++ hb-guide-metadata.xml 25 Jul 2008 14:06:00 -0000 1.7 |
22 |
@@ -1,13 +1,13 @@ |
23 |
<?xml version='1.0' encoding='UTF-8'?> |
24 |
<!DOCTYPE sections SYSTEM "/dtd/book.dtd"> |
25 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/pl/devrel/handbook/hb-guide-metadata.xml,v 1.6 2008/03/31 19:27:03 shadow Exp $ --> |
26 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/pl/devrel/handbook/hb-guide-metadata.xml,v 1.7 2008/07/25 14:06:00 shadow Exp $ --> |
27 |
|
28 |
<!-- The content of this document is licensed under the CC-BY-SA license --> |
29 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
30 |
|
31 |
<sections> |
32 |
-<version>1.0.5</version> |
33 |
-<date>2008-03-31</date> |
34 |
+<version>1.0.6</version> |
35 |
+<date>2008-07-10</date> |
36 |
|
37 |
<section> |
38 |
<title>Dlaczego metadata.xml jest potrzebne?</title> |
39 |
@@ -15,9 +15,9 @@ |
40 |
<body> |
41 |
|
42 |
<p> |
43 |
-Plik <c>metadata.xml</c> zawiera dodatkowe informacje o ebuildach i powinien |
44 |
-istnieć w każdym katalogu z pakietem. Jego plik szkieletowy ma nazwę |
45 |
-<c>skel.metadata.xml</c> i znajduje się w drzewie Portage. |
46 |
+Plik <path>metadata.xml</path> zawiera dodatkowe informacje o ebuildach i |
47 |
+powinien istnieć w każdym katalogu z pakietem. Jego plik szkieletowy ma |
48 |
+nazwę <path>skel.metadata.xml</path> i znajduje się w drzewie Portage. |
49 |
</p> |
50 |
|
51 |
</body> |
52 |
@@ -29,7 +29,7 @@ |
53 |
<body> |
54 |
|
55 |
<p> |
56 |
-Plik <c>metadata.xml</c> może zawierać kilka etykiet: |
57 |
+Plik <path>metadata.xml</path> może zawierać kilka etykiet: |
58 |
</p> |
59 |
|
60 |
<table> |
61 |
@@ -42,8 +42,8 @@ |
62 |
<brite><pkgmetadata></brite> |
63 |
</ti> |
64 |
<ti> |
65 |
- Jest to źródłowy element pliku metadata.xml dla pakietów. Nie posiada |
66 |
- żadnych atrybutów. Wymagana, drugorzędna etykieta tego pliku to: |
67 |
+ Jest to źródłowy element pliku <path>metadata.xml</path> dla pakietów. Nie |
68 |
+ posiada żadnych atrybutów. Wymagana, drugorzędna etykieta tego pliku to: |
69 |
<brite><herd></brite>. Następujące podrzędne etykiety są dozwolone: |
70 |
<brite><email></brite> czyli adres e-mail herdu, |
71 |
<brite><maintainer></brite> oraz |
72 |
@@ -55,9 +55,9 @@ |
73 |
<brite><catmetadata></brite> |
74 |
</ti> |
75 |
<ti> |
76 |
- Jest to główny element pliku metadata.xml dla kategorii, tak jak w <uri |
77 |
- link="/proj/en/glep/glep-0034.html">GLEP 34</uri>. Nie posiada on |
78 |
- atrybutów. Zawiera pewną ilość etykiet |
79 |
+ Jest to główny element pliku <path>metadata.xml</path> dla kategorii, tak |
80 |
+ jak w <uri link="/proj/en/glep/glep-0034.html">GLEP 34</uri>. Nie posiada |
81 |
+ on atrybutów. Zawiera pewną ilość etykiet |
82 |
<brite><longdescription></brite>, każda dla innego języka. |
83 |
</ti> |
84 |
</tr> |
85 |
@@ -110,7 +110,38 @@ |
86 |
<ti><brite><longdescription></brite></ti> |
87 |
<ti> |
88 |
Ta etykieta zawiera opis pakietu. Służy ona do powiększania pola OPISU w |
89 |
- ebuildach. |
90 |
+ ebuildach. Etykieta ta zawiera dwie opcjonalne podetykiety: |
91 |
+ <brite><pkg></brite> i <brite><cat></brite>. |
92 |
+ </ti> |
93 |
+</tr> |
94 |
+<tr> |
95 |
+ <ti><brite><use></brite></ti> |
96 |
+ <ti> |
97 |
+ Etykieta ta zawiera opis <uri |
98 |
+ link="/doc/en/handbook/handbook-x86.xml?part=2&chap=2">flag USE</uri>. |
99 |
+ Jest ona opcjonalna i jeśli jej użyjemy musimy dodatkowo dodać etykietę: |
100 |
+ <brite><flag></brite>. |
101 |
+ </ti> |
102 |
+</tr> |
103 |
+<tr> |
104 |
+ <ti><brite><flag></brite></ti> |
105 |
+ <ti> |
106 |
+ Etykieta ta zawiera opis w jaki sposób flaga USE wywiera wpływ na pakiety, |
107 |
+ z którym jest skojarzona. Jest ona wymagana w przypadku użycia etykiety |
108 |
+ <brite><use></brite>. Wymagane jest również nazwanie flagi USE w |
109 |
+ atrybucie <c>name</c>. Etykieta ta posiada dwie opcjonalne podetykiety: |
110 |
+ <brite><pkg></brite> i <brite><cat></brite>. |
111 |
+ </ti> |
112 |
+</tr> |
113 |
+<tr> |
114 |
+ <ti><brite><pkg></brite></ti> |
115 |
+ <ti>Etykieta ta zawiera poprawną nazwę pakietu w formacie DEPEND.</ti> |
116 |
+</tr> |
117 |
+<tr> |
118 |
+ <ti><brite><cat></brite></ti> |
119 |
+ <ti> |
120 |
+ Etykieta ta zawiera poprawną nazwę kategori zdefiniowaną w pliku |
121 |
+ <path>profiles/categories</path>. |
122 |
</ti> |
123 |
</tr> |
124 |
</table> |
125 |
@@ -129,7 +160,8 @@ |
126 |
<tr> |
127 |
<ti>lang</ti> |
128 |
<ti> |
129 |
- <brite><description></brite>, <brite><longdescription></brite> |
130 |
+ <brite><description></brite>, <brite><longdescription></brite>, |
131 |
+ <brite><use></brite> |
132 |
</ti> |
133 |
<ti> |
134 |
W każdym przypadku, gdy opis jest wymagany, musi istnieć |
135 |
@@ -143,7 +175,7 @@ |
136 |
<ti>restrict</ti> |
137 |
<ti> |
138 |
<brite><herd></brite>, <brite><maintainer></brite>, |
139 |
- <brite><longdescription></brite> |
140 |
+ <brite><longdescription></brite>, <brite><flag></brite> |
141 |
</ti> |
142 |
<ti> |
143 |
Atrybut restrict pozwala na ograniczanie aplikacji z konkretnymi etykietami |
144 |
@@ -152,9 +184,22 @@ |
145 |
nam jako domyślny przykład. Format atrybutu restrict jest taki sam jak |
146 |
format flagi DEPEND, z wyjątkiem "<" i ">", które |
147 |
muszą być określone poprzez &lt; i &gt;.<br /> <br /> Dla |
148 |
- przykładu, w pakiecie db <c>restrict=">=sys-libs/db-3.2.9-r5"</c> na |
149 |
- etykiecie maintainer wskazuje, iż zarządzający administruje w tej chwili |
150 |
- wszystkimi wersjami większymi od 3.2.9-r5. |
151 |
+ przykładu, w pakiecie <c>sys-lib/db</c> |
152 |
+ <c>restrict=">=sys-libs/db-3.2.9-r5"</c> na etykiecie maintainer |
153 |
+ wskazuje, iż zarządzający administruje w tej chwili wszystkimi wersjami |
154 |
+ większymi od 3.2.9-r5. |
155 |
+ </ti> |
156 |
+</tr> |
157 |
+<tr> |
158 |
+ <ti>name</ti> |
159 |
+ <ti> |
160 |
+ <brite><name></brite> |
161 |
+ </ti> |
162 |
+ <ti> |
163 |
+ Atrybut ten wymagany jest dla etykiety <brite><flag></brite>. |
164 |
+ Przechowuje on flagę USE. <br /><br /> |
165 |
+ Dla przykładu w pakiecie <c>sys-apps/hal</c>, <c>>flag |
166 |
+ name='acpi'>Enables ACPI</flag></c> |
167 |
</ti> |
168 |
</tr> |
169 |
</table> |
170 |
@@ -248,5 +293,59 @@ |
171 |
|
172 |
</body> |
173 |
</subsection> |
174 |
+<subsection> |
175 |
+<title>Trzeci przykład</title> |
176 |
+<body> |
177 |
+ |
178 |
+<p> |
179 |
+W trzecim przykładzie opiszemy plik <path>metadata.xml</path> pakietu |
180 |
+<c>sys-apps/hal</c>. Ebuild ten jest rozwijany przez herd <c>gentopia</c> i |
181 |
+zawiera opisy flag USE. |
182 |
+</p> |
183 |
+ |
184 |
+<pre caption="Opis flag USE"> |
185 |
+<?xml version="1.0" encoding="UTF-8"> |
186 |
+<!DOCTYPE pkgmetadata SYSTEM "http://www.gentoo.org/dtd/metadata.dtd"> |
187 |
+<pkgmetadata> |
188 |
+<herd>gentopia</herd> |
189 |
+<maintainer> |
190 |
+ <email>compnerd@g.o</email> |
191 |
+</maintainer> |
192 |
+<maintainer> |
193 |
+ <email>steev@g.o</email> |
194 |
+</maintainer> |
195 |
+<use> |
196 |
+ <flag name='acpi'>Enables HAL to attempt to read from |
197 |
+ /proc/acpi/event, if unavailable, HAL will read events from |
198 |
+ <pkg>sys-power/acpid</pkg>. If you need multiple acpi |
199 |
+ readers, ensure acpid is in your default runlevel along with HAL. This |
200 |
+ will also enable HAL to read Toshia and IBM acpi events which do not |
201 |
+ get sent via /proc/acpi/event</flag> |
202 |
+ <flag name='crypt'>Allows HAL to mount volumes that are encrypted using |
203 |
+ LUKS. <pkg>sys-fs/cryptsetup-luks</pkg> which has recently been renamed |
204 |
+ to <pkg>sys-fs/cryptsetup</pkg> allows you to create such encrypted |
205 |
+ volumes. HAL will be able to handle volumes that are removable or |
206 |
+ fixed.</flag> |
207 |
+ <flag name='dell'>Builds an installs the Dell addon, which reads data from |
208 |
+ the Dell SM BIOS via <pkg>sys-libs/libsmbios</pkg>. It will read your |
209 |
+ service tag information and your hardware backlight data as well as |
210 |
+ allow you to modify the backlight settings on a Dell laptop.</flag> |
211 |
+ <flag name='disk-partition'>Allows HAL to use libparted from |
212 |
+ <pkg>sys-apps/parted</pkg> to read raw partition data from your disks |
213 |
+ and process that data. Future versions of HAL (possibly 0.5.11 and |
214 |
+ higher) will allow you to create, modify, delete and format partitions |
215 |
+ from a GUI interface agnostic of your desktop environment.</flag> |
216 |
+ <flag name='doc'>Generates documentation that describes HAL's fdi |
217 |
+ format.</flag> |
218 |
+ <flag name='pcmcia'>Allows HAL to process PCMCIA/CardBus slot data which |
219 |
+ includes inserts and removals and act on these events.</flag> |
220 |
+ <flag name='selinux'>Installs SELinux policies and links HAL to the SELinux |
221 |
+ libraries.</flag> |
222 |
+</use> |
223 |
+</pkgmetadata> |
224 |
+</pre> |
225 |
+ |
226 |
+</body> |
227 |
+</subsection> |
228 |
</section> |
229 |
</sections> |