Gentoo Archives: gentoo-commits

From: "Davide Cendron (scen)" <scen@g.o>
To: gentoo-commits@l.g.o
Subject: [gentoo-commits] gentoo commit in xml/htdocs/proj/it/devrel/handbook: handbook.xml hb-guide-common-mistakes.xml hb-guide-ebuild-maintaining.xml hb-guide-eclass.xml hb-guide-manifest-signing.xml hb-guide-metadata.xml hb-introduction-becoming-a-dev.xml hb-introduction-hierarchy.xml hb-introduction-whatyouget.xml hb-introduction.xml hb-policy-ebuild.xml hb-policy-etiquette.xml
Date: Thu, 28 Feb 2008 20:52:47
Message-Id: E1JUpkB-0006sf-4X@stork.gentoo.org
1 scen 08/02/28 20:52:43
2
3 Modified: handbook.xml hb-guide-common-mistakes.xml
4 hb-guide-ebuild-maintaining.xml hb-guide-eclass.xml
5 hb-guide-manifest-signing.xml hb-guide-metadata.xml
6 hb-introduction-becoming-a-dev.xml
7 hb-introduction-hierarchy.xml
8 hb-introduction-whatyouget.xml hb-introduction.xml
9 hb-policy-ebuild.xml hb-policy-etiquette.xml
10 Log:
11 Massive typo and repodoc fixes (aka "Aspell's Revenge")
12
13 Revision Changes Path
14 1.5 xml/htdocs/proj/it/devrel/handbook/handbook.xml
15
16 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/it/devrel/handbook/handbook.xml?rev=1.5&view=markup
17 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/it/devrel/handbook/handbook.xml?rev=1.5&content-type=text/plain
18 diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/it/devrel/handbook/handbook.xml?r1=1.4&r2=1.5
19
20 Index: handbook.xml
21 ===================================================================
22 RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/it/devrel/handbook/handbook.xml,v
23 retrieving revision 1.4
24 retrieving revision 1.5
25 diff -u -r1.4 -r1.5
26 --- handbook.xml 27 Sep 2007 21:26:13 -0000 1.4
27 +++ handbook.xml 28 Feb 2008 20:52:42 -0000 1.5
28 @@ -1,8 +1,8 @@
29 <?xml version='1.0' encoding='UTF-8'?>
30 <!DOCTYPE book SYSTEM "/dtd/book.dtd">
31 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/it/devrel/handbook/handbook.xml,v 1.4 2007/09/27 21:26:13 scen Exp $ -->
32 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/it/devrel/handbook/handbook.xml,v 1.5 2008/02/28 20:52:42 scen Exp $ -->
33
34 -<book link="handbook.xml" lang="it">
35 +<book link="/proj/it/devrel/handbook/handbook.xml" lang="it">
36 <title>Manuale per sviluppatori Gentoo</title>
37
38 <!-- Author names only -->
39
40
41
42 1.5 xml/htdocs/proj/it/devrel/handbook/hb-guide-common-mistakes.xml
43
44 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-guide-common-mistakes.xml?rev=1.5&view=markup
45 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-guide-common-mistakes.xml?rev=1.5&content-type=text/plain
46 diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-guide-common-mistakes.xml?r1=1.4&r2=1.5
47
48 Index: hb-guide-common-mistakes.xml
49 ===================================================================
50 RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-guide-common-mistakes.xml,v
51 retrieving revision 1.4
52 retrieving revision 1.5
53 diff -u -r1.4 -r1.5
54 --- hb-guide-common-mistakes.xml 27 Apr 2007 09:23:24 -0000 1.4
55 +++ hb-guide-common-mistakes.xml 28 Feb 2008 20:52:42 -0000 1.5
56 @@ -1,6 +1,8 @@
57 <?xml version='1.0' encoding='UTF-8'?>
58 <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
59
60 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-guide-common-mistakes.xml,v 1.5 2008/02/28 20:52:42 scen Exp $ -->
61 +
62 <!-- The content of this document is licensed under the CC-BY-SA license -->
63 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
64
65 @@ -133,7 +135,7 @@
66 <body>
67
68 <p>
69 -I campi DEPEND e RDEPEND deli ebuild proposti dagli utenti solitamente
70 +I campi DEPEND e RDEPEND degli ebuild proposti dagli utenti solitamente
71 contengono diversi errori. Questi sono i punti più importanti da seguire durante
72 la scrittura della parte delle dipendenze.
73 </p>
74 @@ -145,7 +147,7 @@
75 </li>
76 <li>
77 <e>Non mettere nessun asterisco (*) per dipendenze di tipo &gt;=.</e><br />
78 - Per esempio, dovrebbe essere <c>&gt;=x11-libs/gtk+-2</c> invece di
79 + Per esempio, dovrebbe essere <c>&gt;=x11-libs/gtk+-2</c> invece di
80 <c>&gt;=x11-libs/gtk+-2*</c>.
81 </li>
82 <li>
83
84
85
86 1.6 xml/htdocs/proj/it/devrel/handbook/hb-guide-ebuild-maintaining.xml
87
88 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-guide-ebuild-maintaining.xml?rev=1.6&view=markup
89 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-guide-ebuild-maintaining.xml?rev=1.6&content-type=text/plain
90 diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-guide-ebuild-maintaining.xml?r1=1.5&r2=1.6
91
92 Index: hb-guide-ebuild-maintaining.xml
93 ===================================================================
94 RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-guide-ebuild-maintaining.xml,v
95 retrieving revision 1.5
96 retrieving revision 1.6
97 diff -u -r1.5 -r1.6
98 --- hb-guide-ebuild-maintaining.xml 7 Nov 2007 20:21:07 -0000 1.5
99 +++ hb-guide-ebuild-maintaining.xml 28 Feb 2008 20:52:42 -0000 1.6
100 @@ -1,7 +1,7 @@
101 <?xml version='1.0' encoding='UTF-8'?>
102 <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
103
104 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-guide-ebuild-maintaining.xml,v 1.5 2007/11/07 20:21:07 scen Exp $ -->
105 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-guide-ebuild-maintaining.xml,v 1.6 2008/02/28 20:52:42 scen Exp $ -->
106
107 <!-- The content of this document is licensed under the CC-BY-SA license -->
108 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
109 @@ -38,7 +38,7 @@
110 </p>
111
112 <p>
113 -Se si sta aggiungendo un ebuild sottoposto da un utente, non presuporre che
114 +Se si sta aggiungendo un ebuild sottoposto da un utente, non presupporre che
115 l'utente abbia fatto il test nelle varie architetture: spesso, le variabili
116 <c>KEYWORDS</c> vengono clonate tra i diversi pacchetti o generate dalla
117 documentazione contenuta nei sorgenti del pacchetti, il che non significa che il
118 @@ -168,8 +168,8 @@
119 </p>
120
121 <p>
122 -Dopodichè cambiare tutti gli ebuild che dipendono (<c>DEPEND</c>) dal vecchio
123 -ebuild in modo di farli dipendere dal nuovo. Dopodichè aggiungere una voce
124 +Dopodiché cambiare tutti gli ebuild che dipendono (<c>DEPEND</c>) dal vecchio
125 +ebuild in modo di farli dipendere dal nuovo. Dopodiché aggiungere una voce
126 al file più recente presente in <path>profiles/updates/</path> nel Portage tree
127 seguendo questo formato:
128 </p>
129 @@ -218,14 +218,14 @@
130 <body>
131
132 <p>
133 -Quando viene rimosso un ebuild assicurarsi che im Portage non si creino
134 +Quando viene rimosso un ebuild assicurarsi che in Portage non si creino
135 dipendenze corrotte a seguito della rimozione - in più, il messaggio di commit
136 -sul CVS deve spiegare chiaramente perchè l'ebuild è stato rimosso.
137 +sul CVS deve spiegare chiaramente perché l'ebuild è stato rimosso.
138 </p>
139
140 <p>
141 Per rimuovere completamente un pacchetto da CVS, eliminare qualsiasi file dalla
142 -directory e effettuarne il commit, CVS si arrangerà ad eliminare da sè le
143 +directory e effettuarne il commit, CVS si arrangerà ad eliminare da sé le
144 directory vuote.
145 </p>
146
147 @@ -249,7 +249,7 @@
148 situazione prima di poter fare il commit dell'ebuild o, se si riscontra questo
149 problema con un pacchetto esistente, compilare un bug per il pacchetto (vedere
150 in seguito alcune eccezioni). Le ragioni per i conflitti dei file sono critiche
151 -perchè se "foo" fornisce il file <path>/usr/bin/example</path>, "bar" glielo
152 +perché se "foo" fornisce il file <path>/usr/bin/example</path>, "bar" glielo
153 sovrascrive, ed in seguito viene fatto l'unmerge di "bar", Portage rimuoverà
154 <path>/usr/bin/example</path> corrompendo di conseguenza "foo".
155 </p>
156 @@ -274,7 +274,7 @@
157 "bar" entrambi dipendenti ((R)DEPEND) da questo pacchetto.
158 </li>
159 <li>
160 - Cambiare la locazione in cui "foo" o "bar" installano i files in conflitto.
161 + Cambiare la locazione in cui "foo" o "bar" installano i file in conflitto.
162 </li>
163 </ul>
164
165 @@ -283,7 +283,7 @@
166 sistemati o non sono critici, al momento delle eccezioni conosciute sono le
167 pagine man dei moduli Perl (che sovrascrivono quelle installate direttamenta da
168 Perl) e i file gestiti da <c>CONFIG_PROTECT</c> (che devono ancora essere
169 -sistemati ma non sono critici perchè Portage non li sovrascrive).
170 +sistemati ma non sono critici perché Portage non li sovrascrive).
171 </p>
172
173 </body>
174
175
176
177 1.5 xml/htdocs/proj/it/devrel/handbook/hb-guide-eclass.xml
178
179 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-guide-eclass.xml?rev=1.5&view=markup
180 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-guide-eclass.xml?rev=1.5&content-type=text/plain
181 diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-guide-eclass.xml?r1=1.4&r2=1.5
182
183 Index: hb-guide-eclass.xml
184 ===================================================================
185 RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-guide-eclass.xml,v
186 retrieving revision 1.4
187 retrieving revision 1.5
188 diff -u -r1.4 -r1.5
189 --- hb-guide-eclass.xml 26 Apr 2007 22:23:04 -0000 1.4
190 +++ hb-guide-eclass.xml 28 Feb 2008 20:52:42 -0000 1.5
191 @@ -1,6 +1,8 @@
192 <?xml version='1.0' encoding='UTF-8'?>
193 <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
194
195 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-guide-eclass.xml,v 1.5 2008/02/28 20:52:42 scen Exp $ -->
196 +
197 <!-- The content of this document is licensed under the CC-BY-SA license -->
198 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
199
200 @@ -87,7 +89,7 @@
201 </pre>
202
203 <p>
204 -A questo puto il contenuto delle eclass verrà derivato. Ricordarsi che tutte le
205 +A questo punto il contenuto delle eclass verrà derivato. Ricordarsi che tutte le
206 variabili o funzioni definite nella eclass possono essere sovrascritte
207 nell'ebuild, il cui codice viene eseguito dopo qualsiasi eclass. Pertanto,
208 bisogna cercare di mettere nelle proprie eclass il maggior numero possibile di
209 @@ -144,7 +146,7 @@
210 <body>
211
212 <p>
213 -Delle buone funzioni predefinite di un'eclass posono essere spesso usate così
214 +Delle buone funzioni predefinite di un'eclass possono essere spesso usate così
215 come sono; in questo modo l'ebuild conterrà pochissimo codice (che è una buona
216 cosa). Qualche volta, ciononostante, l'eclass non fa esattamente quello di cui
217 si ha bisogno. In questo caso si può scrivere una nuova funzione nel proprio
218 @@ -171,7 +173,7 @@
219 Ora verrà analizzato momentaneamente un altro problema. Si supponga che entrambe
220 le eclass foo.eclass e bar.eclass definiscano src_compile(). Ereditando sia foo
221 che bar si otterrà una diversa funzione src_compile() in base all'ordine in cui
222 -esse vengono ereditate. QUesto è normale, in quanto si supponone di tener conto
223 +esse vengono ereditate. Questo è normale, in quanto si suppone di tener conto
224 dell'ordine dell'ereditarietà. Ma si potrebbe voler invocare entrambe le
225 dichiarazioni di src_compile() esplicitamente.
226 </p>
227 @@ -218,7 +220,7 @@
228 </pre>
229
230 <p>
231 -Ora, qualsivoglia eclass venga ereditato per ultimo, definerà la funzione
232 +Ora, qualsivoglia eclass venga ereditato per ultimo, definirà la funzione
233 predefinita src_compile(), ma, se necessario, entrambe le funzioni potranno
234 essere chiamate direttamente dall'ebuild.
235 </p>
236 @@ -233,7 +235,7 @@
237 <pre caption="Estendere le funzioni predefinite dell'eclass nel proprio build">
238 #in foo.eclass:
239 foo_src_compile() {
240 - [qui codice predefinito]
241 + [qui codice predefinito]
242 }
243
244 EXPORT_FUNCTIONS src_compile
245 @@ -245,9 +247,9 @@
246 inherit foo
247
248 src_compile() {
249 - [qui codice personalizzato]
250 - foo_src_compile
251 - [altro codice personalizzato]
252 + [qui codice personalizzato]
253 + foo_src_compile
254 + [altro codice personalizzato]
255 }
256 </pre>
257
258 @@ -315,7 +317,7 @@
259
260 <p>
261 Nel centro della nuova funzione c'è un blocco while;case...esac;shift;done.
262 -Questo blocco esegue un controllo di corrispondenza dui parametri della funzione
263 +Questo blocco esegue un controllo di corrispondenza dei parametri della funzione
264 con i nomi di sezioni definiti ed esegue le corrispondenti linee di codice.
265 </p>
266
267 @@ -368,7 +370,7 @@
268 Ci sono molte altre funzioni fornite da ebuild.sh. Esse aggiungono alle eclass
269 un output prolisso in fase di debug, per permettere di seguire più facilmente la
270 loro esecuzione senza dover leggere i lunghi messaggi forniti dal metodo di
271 -debug di bash. Tutte le eclass dell'autore di guesta guida usano molto spesso
272 +debug di bash. Tutte le eclass dell'autore di questa guida usano molto spesso
273 queste funzioni.
274 </p>
275
276 @@ -476,7 +478,7 @@
277 </p>
278
279 <p>
280 -QUesto capitolo documenta l'insieme delle relazioni tra le eclass kde*.
281 +Questo capitolo documenta l'insieme delle relazioni tra le eclass kde*.
282 </p>
283
284 </body>
285 @@ -683,7 +685,7 @@
286
287 <p>
288 need-kde() (o need-qt()) necessita di essere chiamata dalla sezione principale
289 -dell'ebuild (per esempio, non da una funzione), cosicchè ogni cambiamento a
290 +dell'ebuild (per esempio, non da una funzione), cosicché ogni cambiamento a
291 DEPEND e RDEPEND influenzi emerge.
292 </p>
293
294 @@ -697,7 +699,7 @@
295 di questo tipo impostate precedentemente. Per esempio, chiamando
296 'need-automake 1.4' verrà impostato NEED_AUTOMAKE_1_4=1 e deallocate tutte le
297 altre variabili WANT_AUTOMAKE*. Per maggiori informazioni, guardare il codice
298 -delle funzioni e i commenti all'inizio di /usr/bin/auto{conf,make} (su sistemi
299 +delle funzioni e i commenti all'inizio di /usr/bin/auto{conf,male} (su sistemi
300 Gentoo).
301 </p>
302
303 @@ -751,7 +753,7 @@
304 configure e dai makefile. Notare che al momento funziona soltanto nelle
305 sottodirectory di ${S}, non funziona nel secondo livello di sottodirectory. La
306 si può invocare con una lista di sottodirectory da eliminare; essa lavora a
307 -turno con ogni paramentro.
308 +turno con ogni parametro.
309 </p>
310
311 <p>
312 @@ -782,7 +784,7 @@
313
314 <p>
315 La sezione globale dell'eclass (per esempio, quella che viene eseguita quando la
316 -si eredita) aggiunge le corrette dipendenze su kde-env, automake, autoconf, make
317 +si eredita) aggiunge le corrette dipendenze su kde-env, automake, autoconf, male
318 e perl (quest'ultimo è usato dalle configurazioni standard degli script per la
319 generazione veloce dei makefile). Imposta inoltre in modo predefinito SLOT="0".
320 </p>
321 @@ -819,19 +821,19 @@
322 <p>
323 La sezione <c>configure</c> esegue lo script di configurazione in ${S},
324 passandole ${myconf}. Se lo script di configurazione non esiste, proverà a
325 -generarlo eseguendo make -f Makefile.cvs o make -f admin/Makefile.common. In
326 +generarlo eseguendo male -f Makefile.cvs o male -f admin/Makefile.common. In
327 questo modo, questo passo della compilazione (che è necessario per gli snapshot
328 del cvs, o per gli ebuild che applicano patch a file come configure.in) viene
329 anche eseguito automaticamente.
330 </p>
331
332 <p>
333 -La sezione <c>make</c> esegue semplicemente emake || die. Per finire, c'è una
334 +La sezione <c>male</c> esegue semplicemente emake || die. Per finire, c'è una
335 sezione <c>all</c> che esegue tutto quando appena spiegato.
336 </p>
337
338 <p>
339 -Infine, kde_src_install() possiede una sezione <c>make</c> che esegue make
340 +Infine, kde_src_install() possiede una sezione <c>male</c> che esegue male
341 install, e una sezione <c>dodoc</c> che esegue dodoc su alcuni nomi standard di
342 documenti in ${S}, come README e COPYING.
343 </p>
344 @@ -1021,7 +1023,7 @@
345
346 src_unpack() {
347 kde_src_install
348 - # installare alcuna documentazione extra non inclusa nel target di make
349 + # installare alcuna documentazione extra non inclusa nel target di male
350 # install
351 dodoc ${S}/doc/*
352 }
353 @@ -1050,7 +1052,7 @@
354 # Questo aggiungerà kdelibs, kde-env alla stringa delle dipendenze e imposta
355 # ${KDEDIR} con il valore corretto:
356
357 -need-kde ${version} # versione minina di kde richiesta dalla propria applicazione
358 +need-kde ${version} # versione minima di kde richiesta dalla propria applicazione
359
360 # Aggiunge tutto il resto di cui hai bisogno per il supporto di kde:
361 use kde &amp;&amp; myconf="${myconf} --with-my-parameter"
362
363
364
365 1.3 xml/htdocs/proj/it/devrel/handbook/hb-guide-manifest-signing.xml
366
367 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-guide-manifest-signing.xml?rev=1.3&view=markup
368 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-guide-manifest-signing.xml?rev=1.3&content-type=text/plain
369 diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-guide-manifest-signing.xml?r1=1.2&r2=1.3
370
371 Index: hb-guide-manifest-signing.xml
372 ===================================================================
373 RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-guide-manifest-signing.xml,v
374 retrieving revision 1.2
375 retrieving revision 1.3
376 diff -u -r1.2 -r1.3
377 --- hb-guide-manifest-signing.xml 27 Apr 2007 14:33:46 -0000 1.2
378 +++ hb-guide-manifest-signing.xml 28 Feb 2008 20:52:42 -0000 1.3
379 @@ -1,6 +1,8 @@
380 <?xml version='1.0' encoding='UTF-8'?>
381 <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
382
383 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-guide-manifest-signing.xml,v 1.3 2008/02/28 20:52:42 scen Exp $ -->
384 +
385 <!-- The content of this document is licensed under the CC-BY-SA license -->
386 <!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
387
388
389
390
391 1.6 xml/htdocs/proj/it/devrel/handbook/hb-guide-metadata.xml
392
393 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-guide-metadata.xml?rev=1.6&view=markup
394 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-guide-metadata.xml?rev=1.6&content-type=text/plain
395 diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-guide-metadata.xml?r1=1.5&r2=1.6
396
397 Index: hb-guide-metadata.xml
398 ===================================================================
399 RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-guide-metadata.xml,v
400 retrieving revision 1.5
401 retrieving revision 1.6
402 diff -u -r1.5 -r1.6
403 --- hb-guide-metadata.xml 2 Aug 2007 16:25:33 -0000 1.5
404 +++ hb-guide-metadata.xml 28 Feb 2008 20:52:42 -0000 1.6
405 @@ -1,6 +1,8 @@
406 <?xml version='1.0' encoding='UTF-8'?>
407 <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
408
409 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-guide-metadata.xml,v 1.6 2008/02/28 20:52:42 scen Exp $ -->
410 +
411 <!-- The content of this document is licensed under the CC-BY-SA license -->
412 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
413
414 @@ -12,7 +14,7 @@
415 <date>2007-07-31</date>
416
417 <section>
418 -<title>Perchè c'è il bisogno di metadata.xml</title>
419 +<title>Perché c'è il bisogno di metadata.xml</title>
420 <subsection>
421 <body>
422
423 @@ -152,12 +154,12 @@
424 L'attributo restrict permette di limitare l'applicazione di alcuni tag a
425 determinate versioni del pacchetto. Quando questo attributo è utilizzato,
426 deve esistere anche un tag senza questo attributo. Il tag senza l'attributo
427 - restrict verrà utilizzato come predefinito. Il formato dell' attributo
428 + restrict verrà utilizzato come predefinito. Il formato dell'attributo
429 restrict è quello della flag DEPEND, eccetto che per "&lt;" e per "&gt;"
430 - che devono essere specificati da &amp;lt; and &amp;gt;.<br />
431 + che devono essere specificati da &amp;lt; e &amp;gt;.<br />
432 <br/>
433 Ad esempio nel pacchetto db <c>restrict="&gt;=sys-libs/db-3.2.9-r5"</c>
434 - nel tag mantainer mostra che si stanno attualmente mantenendo tutte le
435 + nel tag maintainer mostra che si stanno attualmente mantenendo tutte le
436 versioni maggiori della 3.2.9-r5.
437 </ti>
438 </tr>
439
440
441
442 1.6 xml/htdocs/proj/it/devrel/handbook/hb-introduction-becoming-a-dev.xml
443
444 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-introduction-becoming-a-dev.xml?rev=1.6&view=markup
445 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-introduction-becoming-a-dev.xml?rev=1.6&content-type=text/plain
446 diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-introduction-becoming-a-dev.xml?r1=1.5&r2=1.6
447
448 Index: hb-introduction-becoming-a-dev.xml
449 ===================================================================
450 RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-introduction-becoming-a-dev.xml,v
451 retrieving revision 1.5
452 retrieving revision 1.6
453 diff -u -r1.5 -r1.6
454 --- hb-introduction-becoming-a-dev.xml 16 Apr 2007 20:36:01 -0000 1.5
455 +++ hb-introduction-becoming-a-dev.xml 28 Feb 2008 20:52:42 -0000 1.6
456 @@ -1,6 +1,8 @@
457 <?xml version='1.0' encoding='UTF-8'?>
458 <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
459
460 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-introduction-becoming-a-dev.xml,v 1.6 2008/02/28 20:52:42 scen Exp $ -->
461 +
462 <!-- The content of this document is licensed under the CC-BY-SA license -->
463 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
464
465 @@ -117,10 +119,10 @@
466 </p>
467
468 <p>
469 -In più, un nuovo sviluppatore deve essere reattivo a qualsiasi interrogazio
470 -ne posta da qualsiasie membro dei reclutatori - ogni sviluppatore che non
471 -risponde immediatamente vedrà chiuso il suo bug "New developer", che potrà
472 -essere riaperto a discrezione dei reclutatori Gentoo.
473 +In più, un nuovo sviluppatore deve essere reattivo a qualsiasi interrogazione
474 +posta da qualsiasi membro dei reclutatori - ogni sviluppatore che non risponde
475 +immediatamente vedrà chiuso il suo bug "New developer", che potrà essere
476 +riaperto a discrezione dei reclutatori Gentoo.
477 </p>
478
479 </body>
480
481
482
483 1.2 xml/htdocs/proj/it/devrel/handbook/hb-introduction-hierarchy.xml
484
485 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-introduction-hierarchy.xml?rev=1.2&view=markup
486 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-introduction-hierarchy.xml?rev=1.2&content-type=text/plain
487 diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-introduction-hierarchy.xml?r1=1.1&r2=1.2
488
489 Index: hb-introduction-hierarchy.xml
490 ===================================================================
491 RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-introduction-hierarchy.xml,v
492 retrieving revision 1.1
493 retrieving revision 1.2
494 diff -u -r1.1 -r1.2
495 --- hb-introduction-hierarchy.xml 16 Apr 2007 21:44:35 -0000 1.1
496 +++ hb-introduction-hierarchy.xml 28 Feb 2008 20:52:42 -0000 1.2
497 @@ -1,7 +1,7 @@
498 <?xml version='1.0' encoding='UTF-8'?>
499 <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
500
501 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-introduction-hierarchy.xml,v 1.1 2007/04/16 21:44:35 scen Exp $ -->
502 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-introduction-hierarchy.xml,v 1.2 2008/02/28 20:52:42 scen Exp $ -->
503
504 <!-- The content of this document is licensed under the CC-BY-SA license -->
505 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
506 @@ -112,7 +112,7 @@
507 I membri del consiglio che sono già stati ripresi più volte per essere stati
508 scansafatiche possono essere esclusi per le elezioni future, incluse le
509 elezioni per il loro rimpiazzo. Devono comunque giustificare le proprie
510 - assenze e devono aspettarsi che ciò venga fatto lorot notare, se non lo
511 + assenze e devono aspettarsi che ciò venga fatto loro notare, se non lo
512 fanno di loro spontanea volontà.
513 </li>
514 <li>
515 @@ -144,7 +144,7 @@
516 decisioni più piccole che influenzano soltanto un progetto o due e sono decise
517 all'interno dei progetti coinvolti, probabilmente con l'input di altri
518 sviluppatori. Il consiglio dovrebbe rappresentare equamente la base di
519 -sviluppatori poichè ogni sviluppatore ha il diritto a votare, per questo motivo
520 +sviluppatori poiché ogni sviluppatore ha il diritto a votare, per questo motivo
521 gli interessi devono essere rappresentati in modo giusto. Se il consiglio lavora
522 male e la base degli sviluppatori non è contenta del suo operato, il consiglio
523 può essere rivotato.
524
525
526
527 1.8 xml/htdocs/proj/it/devrel/handbook/hb-introduction-whatyouget.xml
528
529 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-introduction-whatyouget.xml?rev=1.8&view=markup
530 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-introduction-whatyouget.xml?rev=1.8&content-type=text/plain
531 diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-introduction-whatyouget.xml?r1=1.7&r2=1.8
532
533 Index: hb-introduction-whatyouget.xml
534 ===================================================================
535 RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-introduction-whatyouget.xml,v
536 retrieving revision 1.7
537 retrieving revision 1.8
538 diff -u -r1.7 -r1.8
539 --- hb-introduction-whatyouget.xml 7 Nov 2007 21:00:07 -0000 1.7
540 +++ hb-introduction-whatyouget.xml 28 Feb 2008 20:52:42 -0000 1.8
541 @@ -1,6 +1,6 @@
542 <?xml version='1.0' encoding='UTF-8'?>
543 <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
544 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-introduction-whatyouget.xml,v 1.7 2007/11/07 21:00:07 scen Exp $ -->
545 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-introduction-whatyouget.xml,v 1.8 2008/02/28 20:52:42 scen Exp $ -->
546
547 <!-- The content of this document is licensed under the CC-BY-SA license -->
548 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
549 @@ -186,8 +186,8 @@
550 progetto di Gentoo (come file illegali .torrents), l'infrastruttura di Gentoo
551 sospenderà l'account coinvolto che potrà essere sbloccato solo dopo
552 l'investigazione da parte dei membri del gruppo Relazioni tra Sviluppatori
553 -Gentoo. Nella maggior parte dei casi le eventuali appartenenze ai tem verranno
554 -sospese, se vengono trovati questi files. Le stesse regole vengono applicate al
555 +Gentoo. Nella maggior parte dei casi le eventuali appartenenze ai team verranno
556 +sospese, se vengono trovati questi file. Le stesse regole vengono applicate al
557 CVS di Gentoo e a qualsiasi altro servizio fornito da Gentoo e precedentemente
558 messo a disposizione.
559 </p>
560
561
562
563 1.3 xml/htdocs/proj/it/devrel/handbook/hb-introduction.xml
564
565 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-introduction.xml?rev=1.3&view=markup
566 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-introduction.xml?rev=1.3&content-type=text/plain
567 diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-introduction.xml?r1=1.2&r2=1.3
568
569 Index: hb-introduction.xml
570 ===================================================================
571 RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-introduction.xml,v
572 retrieving revision 1.2
573 retrieving revision 1.3
574 diff -u -r1.2 -r1.3
575 --- hb-introduction.xml 16 Apr 2007 20:07:24 -0000 1.2
576 +++ hb-introduction.xml 28 Feb 2008 20:52:42 -0000 1.3
577 @@ -1,6 +1,8 @@
578 <?xml version='1.0' encoding='UTF-8'?>
579 <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
580
581 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-introduction.xml,v 1.3 2008/02/28 20:52:42 scen Exp $ -->
582 +
583 <!-- The content of this document is licensed under the CC-BY-SA license -->
584 <!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
585
586
587
588
589 1.9 xml/htdocs/proj/it/devrel/handbook/hb-policy-ebuild.xml
590
591 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-policy-ebuild.xml?rev=1.9&view=markup
592 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-policy-ebuild.xml?rev=1.9&content-type=text/plain
593 diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-policy-ebuild.xml?r1=1.8&r2=1.9
594
595 Index: hb-policy-ebuild.xml
596 ===================================================================
597 RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-policy-ebuild.xml,v
598 retrieving revision 1.8
599 retrieving revision 1.9
600 diff -u -r1.8 -r1.9
601 --- hb-policy-ebuild.xml 3 Feb 2008 22:16:54 -0000 1.8
602 +++ hb-policy-ebuild.xml 28 Feb 2008 20:52:42 -0000 1.9
603 @@ -1,7 +1,7 @@
604 <?xml version='1.0' encoding='UTF-8'?>
605 <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
606
607 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-policy-ebuild.xml,v 1.8 2008/02/03 22:16:54 scen Exp $ -->
608 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-policy-ebuild.xml,v 1.9 2008/02/28 20:52:42 scen Exp $ -->
609
610 <!-- The content of this document is licensed under the CC-BY-SA license -->
611 <!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
612 @@ -245,7 +245,7 @@
613 numero della revisione, in quanto per tutti quelli a cui il pacchetto funziona
614 perfettamente non avranno benefici nell'installare una nuova revisione, e quelli
615 che hanno avuto problemi di installazione non avranno il pacchetto installato
616 -(perchè la compilazione è fallita) per cui non c'è bisogno di fare una nuova
617 +(perché la compilazione è fallita) per cui non c'è bisogno di fare una nuova
618 revisione per forzare un aggiornamento. La pubblicazione di una revisione non è
619 inoltre necessaria se il problema è stato riscontrato da un numero minimo di
620 utenti ed il pacchetto ha un tempo medio di compilazione non trascurabile; in
621 @@ -263,7 +263,7 @@
622 Gli ebuild devono essere basati sulla versione precedente dell'ebuild per
623 assicurare che i cambiamenti non vengano accidentalmente cancellati. Le
624 correzioni devono includere dei commenti appropriati nell'ebuild che spiegano
625 -cosa fanno ed il perchè sono necessarie. Se non si ha dimestichezza con le
626 +cosa fanno ed il perché sono necessarie. Se non si ha dimestichezza con le
627 correzioni, o non si riesce a determinare se sono veramente necessarie, non si
628 dovrebbe aggiornare l'ebuild.
629 </p>
630 @@ -502,7 +502,7 @@
631 <body>
632
633 <p>
634 -GLi ebuild sottoposti dagli utenti non dovrebbero mai essere accettati così come
635 +Gli ebuild sottoposti dagli utenti non dovrebbero mai essere accettati così come
636 sono e dovrebbero essere sempre ben testati e verificati prima di effettuarne il
637 commit nel CVS. <b>Se un ebuild sottoposto da un utente ha dei problemi, lo
638 sviluppatore che lo ha ricevuto e gestito ne sarà ritenuto responsabile.</b>
639 @@ -599,18 +599,18 @@
640 <p>
641 <path>/usr/portage/profiles/package.mask</path> contiene una lista di pacchetti
642 che non dovrebbero essere installati dagli utenti e i commenti che spiegano
643 -in modo dettagliato i motivi dello mascheramento. packege.mask è usato per
644 +in modo dettagliato i motivi dello mascheramento. package.mask è usato per
645 prevenire l'installazione di pacchetti malfunzionanti, che guastano qualcosa
646 d'altro o necessitano di test intensivi prima di essere aggiunti nel ~ARCH
647 KEYWORDS del Portage tree. Quando si aggiunge un pacchetto a package.mask, fare
648 sempre prima il commit di questo file prima del commit dell'ebuild mascherato,
649 in modo da prevenire che l'ebuild venga installato erroneamente dagli utenti,
650 -prima che il file package.mask aggiornato lo possa fare da sè.
651 +prima che il file package.mask aggiornato lo possa fare da sé.
652 </p>
653
654 <p>
655 Ogni volta che un pacchetto viene rimosso da <path>package.mask</path> bisogna
656 -fare molta attenzione, poichè c'è un motivo se un ebuild è elencato in questo
657 +fare molta attenzione, poiché c'è un motivo se un ebuild è elencato in questo
658 file. Se non si ha effettuato personalmente il mascheramento dell'ebuild,
659 contattare sempre lo sviluppatore elencato nei commenti di
660 <path>package.mask</path> prima di intraprendere qualsiasi azione. Inoltre, se
661 @@ -637,10 +637,10 @@
662 se <c>gimp-1.2.0</c> è la versione stabile per gli sviluppatori di Gimp,
663 ed è disponibile una nuova versione 1.2.1 contenente delle correzioni, uno
664 sviluppatore dovrà marcare l'ebuild come ~arch per poterlo testare in portage
665 -perchè il rilascio è valutato come stabile. In un altro caso, se Gimp decide di
666 +perché il rilascio è valutato come stabile. In un altro caso, se Gimp decide di
667 rilasciare una versione della serie instabile o di sviluppo marcata come 1.3.0,
668 -allora questi ebuild dovranno essere messi in <path>package.mask</path> perchè
669 -il software in sè è di una qualità di sviluppo e gli sviluppatori non ne
670 +allora questi ebuild dovranno essere messi in <path>package.mask</path> perché
671 +il software in sé è di una qualità di sviluppo e gli sviluppatori non ne
672 raccomandano la distribuzione.
673 </p>
674
675 @@ -739,7 +739,7 @@
676 <p>
677 Un pacchetto deve dipendere dalle versioni più vecchie che soddisfano le
678 dipendenze. Se esso funziona con <c>libfoo-1.2.x</c>, non farlo dipendere da
679 -<c>libfoo-2.x</c> solo perchè questa è la versione che si ha installato.
680 +<c>libfoo-2.x</c> solo perché questa è la versione che si ha installato.
681 </p>
682
683 <p>
684
685
686
687 1.5 xml/htdocs/proj/it/devrel/handbook/hb-policy-etiquette.xml
688
689 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-policy-etiquette.xml?rev=1.5&view=markup
690 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-policy-etiquette.xml?rev=1.5&content-type=text/plain
691 diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-policy-etiquette.xml?r1=1.4&r2=1.5
692
693 Index: hb-policy-etiquette.xml
694 ===================================================================
695 RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-policy-etiquette.xml,v
696 retrieving revision 1.4
697 retrieving revision 1.5
698 diff -u -r1.4 -r1.5
699 --- hb-policy-etiquette.xml 22 May 2007 12:00:52 -0000 1.4
700 +++ hb-policy-etiquette.xml 28 Feb 2008 20:52:42 -0000 1.5
701 @@ -4,7 +4,7 @@
702 <!-- The content of this document is licensed under the CC-BY-SA license -->
703 <!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
704
705 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-policy-etiquette.xml,v 1.4 2007/05/22 12:00:52 scen Exp $ -->
706 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/it/devrel/handbook/hb-policy-etiquette.xml,v 1.5 2008/02/28 20:52:42 scen Exp $ -->
707
708 <sections>
709 <version>1.0.2</version>
710 @@ -32,7 +32,7 @@
711 </p>
712
713 <p>
714 -Con stardard ragionevoli non s'intende il non poter esprimere la propria
715 +Con standard ragionevoli non s'intende il non poter esprimere la propria
716 opinione, piuttosto si reputa che <e>il modo</e>, il metodo ed la
717 professionalità usata per esprimere la propria opinione stabiliscano se uno
718 standard ragionevole viene soddisfatto, dato che, come sviluppatore, quello che
719 @@ -229,9 +229,9 @@
720 senza divagare.
721 </li>
722 <li>
723 - Cercare di essere attivi nello sviluppo. Se gli utenti chiedono perchè
724 + Cercare di essere attivi nello sviluppo. Se gli utenti chiedono perché
725 qualcosa è stato aggiunto, si prega di spiegarglielo. Se gli utenti chiedono
726 - perchè manca qualcosa, spiegarglielo. Usare la propria conoscenza e aiutare
727 + perché manca qualcosa, spiegarglielo. Usare la propria conoscenza e aiutare
728 nel limite delle proprie possibilità. Allo stesso tempo, se non si conosce
729 bene l'argomento, non creare confusione nella gente.
730 </li>
731 @@ -258,7 +258,7 @@
732 <li>
733 Quando si risponde ad una mail di un utente o di uno sviluppatore, essere
734 cortesi e non dire semplicemente all'utente di rivolgersi ad un altro
735 - sviluppatore: cercare di spiegare il perchè della situazione, se possibile.
736 + sviluppatore: cercare di spiegare il perché della situazione, se possibile.
737 Un esempio di una buona risposta da dare in questo caso è: "Fai riferimento
738 a <c>&lt;inserire nome qui&gt;</c> in quanto <c>&lt;persona&gt;</c> ora è il
739 manutentore del pacchetto. Perciò per ogni ulteriore problematica fai
740
741
742
743 --
744 gentoo-commits@l.g.o mailing list