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

[Davide Cendron (scen)]

scen        08/11/05 21:48:42

  Modified:             hb-guide-metadata.xml
  Log:
  Version 1.0.7, revision 1.14 of EN CVS

Revision  Changes    Path
1.9                  xml/htdocs/proj/it/devrel/handbook/hb-guide-metadata.xml

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

Index: hb-guide-metadata.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-guide-metadata.xml,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -r1.8 -r1.9
--- hb-guide-metadata.xml	24 Jul 2008 20:42:36 -0000	1.8
+++ hb-guide-metadata.xml	5 Nov 2008 21:48:42 -0000	1.9
@@ -1,7 +1,7 @@
 <?xml version='1.0' encoding='UTF-8'?>
 <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
 
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-guide-metadata.xml,v 1.8 2008/07/24 20:42:36 scen Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-guide-metadata.xml,v 1.9 2008/11/05 21:48:42 scen Exp $ -->
 
 <!-- The content of this document is licensed under the CC-BY-SA license -->
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
@@ -10,8 +10,8 @@
      cvs://gentoo/gentoo/xml/htdocs/doc/en/metadata.xml :: R1.4.  -->
 
 <sections>
-<version>1.0.6</version>
-<date>2008-07-10</date>
+<version>1.0.7</version>
+<date>2008-09-11</date>
 
 <section>
 <title>Perché c'è il bisogno di metadata.xml</title>
@@ -132,6 +132,69 @@
   </ti>
 </tr>
 <tr>
+  <ti><brite>&lt;upstream&gt;</brite></ti>
+  <ti>
+    Questo tag contiene informazioni riguardo il progetto/sviluppatori di
+    origine ("upstream", NdT).
+  </ti>
+</tr>
+<tr>
+  <ti><brite>&lt;maintainer&gt;</brite></ti>
+  <ti>
+    Nome ed e-mail di un mantenitore "upstream". Tale tag può apparire più di
+    una volta.
+  </ti>
+</tr>
+<tr>
+  <ti><brite>&lt;name&gt;</brite></ti>
+  <ti>
+    Il nome di un mantenitore "upstream" dovrebbe contenere un blocco di testo
+    con il nome dell'upstream.
+    Questo elemento è obbligatori per un mantenitore upstream e deve apparire
+    solo una volta.
+  </ti>
+</tr>
+<tr>
+  <ti><brite>&lt;email&gt;</brite></ti>
+  <ti>L'indirizzo email di un upstream dovrebbe apparire solo una volta.</ti>
+</tr>
+<tr>
+  <ti><brite>&lt;changelog&gt;</brite></ti>
+  <ti>
+    Dovrebbe contenere un URL dov'è possibile reperire il changelog originale
+    del pacchetto. L'URL deve essere indipendente dalla versione e deve puntare
+    ad un changelog che viene aggiornato solamente sui nuovi rilasci del
+    pacchetto corrispondente. (Ciò implica anche che uno può inserire un link ad
+    un changelog aggiornato automaticamente solo un caso di snapshot vcs.)
+  </ti>
+</tr>
+<tr>
+  <ti><brite>&lt;doc&gt;</brite></ti>
+  <ti>
+    Dovrebbe contenere un URL dov'è può essere trovata la locazione della
+    documentazione originale. Il link non deve puntare a nessuna documentazione
+    di terze parti e deve essere indipendente dalla versione. Se la
+    documentazione è disponibile in più di una lingua, può essere usato un
+    attributo lang che segue le stesse regole di longdescription.
+  </ti>
+</tr>
+<tr>
+  <ti><brite>&lt;bugs-to&gt;</brite></ti>
+  <ti>
+    Dovrebbe contenere un luogo dove possono essere inseriti, un URL o indirizzo
+    e-mail preceduto da mailto:.
+  </ti>
+</tr>
+<tr>
+  <ti><brite>&lt;remote-id&gt;</brite></ti>
+  <ti>
+    Dovrebbe specificare un tipo di indicatore di tracciamento del pacchetto e
+    l'identificazione che corrisponde al pacchetto in questione. remote-id
+    dovrebbe facilifare l'indicizzazione di informazioni come il proprio ID
+    Freshmeat o nome CPAN.
+  </ti>
+</tr>
+<tr>
   <ti><brite>&lt;pkg&gt;</brite></ti>
   <ti>
     Questo tag contiene un nome valido di pacchetto nel formato usato per
@@ -162,7 +225,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>
     In ogni caso in cui sia richiesta una descrizione, ci deve essere
@@ -204,6 +267,27 @@
     name='acpi'&gt; Enables ACPI&lt;/flag&gt;</c>
   </ti>
 </tr>
+<tr>
+  <ti>status</ti>
+  <ti><brite>&lt;maintainer&gt;</brite></ti>
+  <ti>
+    L'elemento upstream maintainer ha un attributo status, che può essere active
+    ("attivo", NdT) o inactive ("inattivo", NdT). Questo attributo non è
+    obbligatorio. La sua assenza può essere interpretata come informazione
+    sconosciuta. Notare bene: Questo attributo è permesso solamente
+    nell'elemento &lt;upstream&gt; &lt;maintainer&gt;!
+  </ti>
+</tr>
+<tr>
+  <ti>type</ti>
+  <ti><brite>&lt;remote-id&gt;</brite></ti>
+  <ti>
+    Una stringa di identificazione della sorgente "upstream". Una lista di
+    stringhe valide viene tenuta all'interno di metadata.dtd. Gli sviluppatori
+    dovrebbero inviare un'e-mail alla mailing list gentoo-dev prima di usare un
+    nuovo tipo di valore.
+  </ti>
+</tr>
 </table>
 
 </body>
@@ -350,5 +434,34 @@
 
 </body>
 </subsection>
+<subsection>
+<title>Quarto Esempio</title>
+<body>
+
+<p>
+Questo esempio mostra l'uso dell'elemento upstream:
+</p>
+
+<pre caption="Descrizione per 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>