[gentoo-commits] gentoo commit in xml/htdocs/proj/pl/devrel/handbook: hb-guide-metadata.xml

[Damian Kuras (shadow)]

shadow      09/04/14 11:45:27

  Modified:             hb-guide-metadata.xml
  Log:
  sync to 1.15

Revision  Changes    Path
1.8                  xml/htdocs/proj/pl/devrel/handbook/hb-guide-metadata.xml

file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/pl/devrel/handbook/hb-guide-metadata.xml?rev=1.8&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/pl/devrel/handbook/hb-guide-metadata.xml?rev=1.8&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/pl/devrel/handbook/hb-guide-metadata.xml?r1=1.7&r2=1.8

Index: hb-guide-metadata.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/pl/devrel/handbook/hb-guide-metadata.xml,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- hb-guide-metadata.xml	25 Jul 2008 14:06:00 -0000	1.7
+++ hb-guide-metadata.xml	14 Apr 2009 11:45:27 -0000	1.8
@@ -1,13 +1,13 @@
 <?xml version='1.0' encoding='UTF-8'?>
 <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
-<!-- $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 $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/pl/devrel/handbook/hb-guide-metadata.xml,v 1.8 2009/04/14 11:45:27 shadow Exp $ -->
 
 <!-- The content of this document is licensed under the CC-BY-SA license -->
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 
 <sections>
-<version>1.0.6</version>
-<date>2008-07-10</date>
+<version>1.0.7</version>
+<date>2008-09-11</date>
 
 <section>
 <title>Dlaczego metadata.xml jest potrzebne?</title>
@@ -46,8 +46,10 @@
     posiada żadnych atrybutów. Wymagana, drugorzędna etykieta tego pliku to:
     <brite>&lt;herd&gt;</brite>. Następujące podrzędne etykiety są dozwolone:
     <brite>&lt;email&gt;</brite> czyli adres e-mail herdu,
-    <brite>&lt;maintainer&gt;</brite> oraz
-    <brite>&lt;longdescription&gt;</brite>.
+    <brite>&lt;maintainer&gt;</brite>,
+    <brite>&lt;longdescription&gt;</brite>,
+    <brite>&lt;use&gt;</brite> i
+    <brite>&lt;upstream&gt;</brite>.
   </ti>
 </tr>
 <tr>
@@ -70,7 +72,6 @@
     etykiety musi składać się z nazwy herd, jak przedstawia plik <uri
     link="http://sources.gentoo.org/viewcvs.py/*checkout*/gentoo/xml/htdocs/proj/en/metastructure/herds/herds.xml?content-type=text/plain&amp;rev=HEAD">herds.xml</uri>.
     Opcja ta musi się pojawić przynajmniej raz o ile nie wybrano no-herd.
-    
   </ti>
 </tr>
 <tr>
@@ -118,7 +119,7 @@
   <ti><brite>&lt;use&gt;</brite></ti>
   <ti>
     Etykieta ta zawiera opis <uri
-    link="/doc/en/handbook/handbook-x86.xml?part=2&amp;chap=2">flag USE</uri>.
+    link="/doc/pl/handbook/handbook-x86.xml?part=2&amp;chap=2">flag USE</uri>.
     Jest ona opcjonalna i jeśli jej użyjemy musimy dodatkowo dodać etykietę:
     <brite>&lt;flag&gt;</brite>.
   </ti>
@@ -134,6 +135,68 @@
   </ti>
 </tr>
 <tr>
+  <ti><brite>&lt;upstream&gt;</brite></ti>
+  <ti>
+    Etykieta ta zawiera informacje o deweloperach danego projektu.
+  </ti>
+</tr>
+<tr>
+  <ti><brite>&lt;maintainer&gt;</brite></ti>
+  <ti>
+    Nazwisko i adres e-mail opiekuna projektu. Może pojawić się kilka
+    razy.
+  </ti>
+</tr>
+<tr>
+  <ti><brite>&lt;name&gt;</brite></ti>
+  <ti>
+    Nazwa opiekuna projektu powinna zawierać blok tekstowy z nazwiskami
+    deweloperów projektu. Element ten jest obowiązkowy i może być użyty tylko
+    raz.
+  </ti>
+</tr>
+<tr>
+  <ti><brite>&lt;email&gt;</brite></ti>
+  <ti>
+    Adres email projektu może zostać użyty tylko raz.
+  </ti>
+</tr>
+<tr>
+  <ti><brite>&lt;changelog&gt;</brite></ti>
+  <ti>
+    Zawiera adres URL miejsca, w którym powinnien znajdować się changelog
+    projektu. Adres nie może być zależny od wersji pakietu i musi wskazywać na
+    changelog, który jest aktualizowany jedynie w przypadku nowych wydań danego
+    pakietu (Odnosi się to również do sytuacji, w której adres kieruje do
+    changelog generowanego automatycznie w przypadku migawek cvs).
+  </ti>
+</tr>
+<tr>
+  <ti><brite>&lt;doc&gt;</brite></ti>
+  <ti>
+    Zawiera adres URL miejsca, w którym znajduje się dokumentacja projektu.
+    Adres nie może kierować do dokumentacji stron trzecich i musi być
+    niezależna od wersji. W przypadku gdy dokumentacja dostępnach jest w wielu
+    językach, w adresie można zawrzeć atrybut odnoszący sie do danego języka,
+    na takich zasadach jak w etykiecie longdescription.
+  </ti>
+</tr>
+<tr>
+  <ti><brite>&lt;bugs-to&gt;</brite></ti>
+  <ti>
+    Powinna zawierać miejsce, w którym można zgłaszać błędy. Może to być adres
+    URL lub e-mail poprzedzony słowem mailto:.
+  </ti>
+</tr>
+<tr>
+  <ti><brite>&lt;remote-id&gt;</brite></ti>
+  <ti>
+    Etykieta, która powinna zawierać typ trakera identyfikującego pakiet.
+    remote-id powinno ułatwić indeksowanie takich informacji jak ID Freashmeat
+    czy nazwę CPAN.
+  </ti>
+</tr>
+<tr>
   <ti><brite>&lt;pkg&gt;</brite></ti>
   <ti>Etykieta ta zawiera poprawną nazwę pakietu w formacie DEPEND.</ti>
 </tr>
@@ -161,7 +224,7 @@
   <ti>lang</ti>
   <ti>
     <brite>&lt;description&gt;</brite>, <brite>&lt;longdescription&gt;</brite>,
-    <brite>&lt;use&gt;</brite>
+    <brite>&lt;use&gt;</brite>, <brite>&lt;doc&gt;</brite>
   </ti>
   <ti>
     W każdym przypadku, gdy opis jest wymagany, musi istnieć
@@ -187,7 +250,7 @@
     przykładu, w pakiecie <c>sys-lib/db</c>
     <c>restrict="&gt;=sys-libs/db-3.2.9-r5"</c> na etykiecie maintainer
     wskazuje, iż zarządzający administruje w tej chwili wszystkimi wersjami
-    większymi od 3.2.9-r5. 
+    większymi od 3.2.9-r5.
   </ti>
 </tr>
 <tr>
@@ -202,6 +265,31 @@
     name='acpi'&gt;Enables ACPI&lt;/flag&gt;</c>
   </ti>
 </tr>
+<tr>
+  <ti>status</ti>
+  <ti>
+    <brite>&lt;maintainer&gt;</brite>
+  </ti>
+  <ti>
+    Element ten posiada atrybut statusu, który może przyjąć wartość aktywny lub
+    nieaktywyny. Atrybut ten nie jest obowiązkowy. W przypadku gdy status nie
+    jest podany przyjmujemy go jako nieznany. Należy zwrócić uwagę, że atrybut
+    ten jest dozwolony jedynie w przypadku elementów &lt;upstream&gt;
+    &lt;maintainer&gt;.
+  </ti>
+</tr>
+<tr>
+  <ti>type</ti>
+  <ti>
+    <brite>&lt;remote-id&gt;</brite>
+  </ti>
+  <ti>
+    Element identyfikujący typ źródła deweloperów zajmujących się projektem.
+    Lista poprawnych wpisów przetrzymywana jest w pliku metadata.dtd. Przed
+    użyciem nowego typu deweloper powinien wysłać wiadomości na listę
+    dyskusyjną gentoo-dev.
+  </ti>
+</tr>
 </table>
 
 </body>
@@ -246,9 +334,9 @@
 &lt;herd&gt;
   &lt;name&gt;openoffice&lt;/name&gt;
   &lt;email&gt;openoffice@g.o&lt;/email&gt;
-  &lt;description&gt;openoffice related packages&lt;/description&gt;
+  &lt;description&gt;Openoffice related packages&lt;/description&gt;
   &lt;maintainer&gt;&lt;email&gt;pauldv@g.o&lt;/email&gt;&lt;/maintainer&gt;
-  &lt;maintainer&gt;&lt;email&gt;brad@g.o&lt;/email&gt;&lt;/maintainer&gt;
+  &lt;maintainer&gt;&lt;email&gt;suka@g.o&lt;/email&gt;&lt;/maintainer&gt;
 &lt;/herd&gt;
 </pre>
 
@@ -309,43 +397,72 @@
 &lt;pkgmetadata&gt;
 &lt;herd&gt;gentopia&lt;/herd&gt;
 &lt;maintainer&gt;
-	&lt;email&gt;compnerd@g.o&lt;/email&gt;
+        &lt;email&gt;compnerd@g.o&lt;/email&gt;
 &lt;/maintainer&gt;
 &lt;maintainer&gt;
-	&lt;email&gt;steev@g.o&lt;/email&gt;
+        &lt;email&gt;steev@g.o&lt;/email&gt;
 &lt;/maintainer&gt;
 &lt;use&gt;
-	&lt;flag name='acpi'&gt;Enables HAL to attempt to read from
-	/proc/acpi/event, if unavailable, HAL will read events from
-	&lt;pkg&gt;sys-power/acpid&lt;/pkg&gt;. If you need multiple acpi
-	readers, ensure acpid is in your default runlevel along with HAL. This
-	will also enable HAL to read Toshia and IBM acpi events which do not
-	get sent via /proc/acpi/event&lt;/flag&gt;
-	&lt;flag name='crypt'&gt;Allows HAL to mount volumes that are encrypted using
-	LUKS. &lt;pkg&gt;sys-fs/cryptsetup-luks&lt;/pkg&gt; which has recently been renamed
-	to &lt;pkg&gt;sys-fs/cryptsetup&lt;/pkg&gt; allows you to create such encrypted
-	volumes. HAL will be able to handle volumes that are removable or
-	fixed.&lt;/flag&gt;
-	&lt;flag name='dell'&gt;Builds an installs the Dell addon, which reads data from
-	the Dell SM BIOS via &lt;pkg&gt;sys-libs/libsmbios&lt;/pkg&gt;. It will read your
-	service tag information and your hardware backlight data as well as
-	allow you to modify the backlight settings on a Dell laptop.&lt;/flag&gt;
-	&lt;flag name='disk-partition'&gt;Allows HAL to use libparted from
-	&lt;pkg&gt;sys-apps/parted&lt;/pkg&gt; to read raw partition data from your disks
-	and process that data. Future versions of HAL (possibly 0.5.11 and
-	higher) will allow you to create, modify, delete and format partitions
-	from a GUI interface agnostic of your desktop environment.&lt;/flag&gt;
-	&lt;flag name='doc'&gt;Generates documentation that describes HAL's fdi
-	format.&lt;/flag&gt;
-	&lt;flag name='pcmcia'&gt;Allows HAL to process PCMCIA/CardBus slot data which
-	includes inserts and removals and act on these events.&lt;/flag&gt;
-	&lt;flag name='selinux'&gt;Installs SELinux policies and links HAL to the SELinux
-	libraries.&lt;/flag&gt;
+        &lt;flag name='acpi'&gt;Enables HAL to attempt to read from
+        /proc/acpi/event, if unavailable, HAL will read events from
+        &lt;pkg&gt;sys-power/acpid&lt;/pkg&gt;. If you need multiple acpi
+        readers, ensure acpid is in your default runlevel along with HAL. This
+        will also enable HAL to read Toshia and IBM acpi events which do not
+        get sent via /proc/acpi/event&lt;/flag&gt;
+        &lt;flag name='crypt'&gt;Allows HAL to mount volumes that are encrypted using
+        LUKS. &lt;pkg&gt;sys-fs/cryptsetup-luks&lt;/pkg&gt; which has recently been renamed
+        to &lt;pkg&gt;sys-fs/cryptsetup&lt;/pkg&gt; allows you to create such encrypted
+        volumes. HAL will be able to handle volumes that are removable or
+        fixed.&lt;/flag&gt;
+        &lt;flag name='dell'&gt;Builds an installs the Dell addon, which reads data from
+        the Dell SM BIOS via &lt;pkg&gt;sys-libs/libsmbios&lt;/pkg&gt;. It will read your
+        service tag information and your hardware backlight data as well as
+        allow you to modify the backlight settings on a Dell laptop.&lt;/flag&gt;
+        &lt;flag name='disk-partition'&gt;Allows HAL to use libparted from
+        &lt;pkg&gt;sys-apps/parted&lt;/pkg&gt; to read raw partition data from your disks
+        and process that data. Future versions of HAL (possibly 0.5.11 and
+        higher) will allow you to create, modify, delete and format partitions
+        from a GUI interface agnostic of your desktop environment.&lt;/flag&gt;
+        &lt;flag name='doc'&gt;Generates documentation that describes HAL's fdi
+        format.&lt;/flag&gt;
+        &lt;flag name='pcmcia'&gt;Allows HAL to process PCMCIA/CardBus slot data which
+        includes inserts and removals and act on these events.&lt;/flag&gt;
+        &lt;flag name='selinux'&gt;Installs SELinux policies and links HAL to the SELinux
+        libraries.&lt;/flag&gt;
 &lt;/use&gt;
 &lt;/pkgmetadata&gt;
 </pre>
 
 </body>
 </subsection>
+<subsection>
+<title>Przykład czwarty</title>
+<body>
+
+<p>
+W przykładzie tym zademonstrowano użycie elementu upstream:
+</p>
+
+<pre caption="Opis upstream">
+&lt;upstream&gt;
+       &lt;maintainer status="inactive"&gt;
+               &lt;name&gt;Foo Bar&lt;/name&gt;
+               &lt;email&gt;foo@×××.bar&lt;/email&gt;
+       &lt;/maintainer&gt;
+       &lt;maintainer status="active"&gt;
+               &lt;name&gt;Foo Gentoo&lt;/name&gt;
+               &lt;email&gt;foo@g.o&lt;/email&gt;
+       &lt;/maintainer&gt;
+       &lt;changelog&gt;http://foo.bar/changelog.txt&lt;/changelog&gt;
+       &lt;doc lang="en"&gt;http://foo.bar/doc/index.html&lt;/doc&gt;
+       &lt;doc lang="de"&gt;http://foo.bar/doc/index.de.html&lt;/doc&gt;
+       &lt;bugs-to&gt;https://bugs.foo.bar&lt;/bugs-to&gt;
+       &lt;remote-id type="freshmeat"&gt;foobar&lt;/remote-id&gt;
+       &lt;remote-id type="sourceforge"&gt;foobar&lt;/remote-id&gt;
+&lt;/upstream&gt;
+</pre>
+
+</body>
+</subsection>
 </section>
 </sections>