en to it translation catalogue (969 entries)

note: type: Attribute 'lang' of: <book>
en: en
it: it

note: type: Content of: <book><title>
en: Debian New Maintainers' Guide
it: Guida per il nuovo Maintainer

note: type: Content of: <book><bookinfo><authorgroup><author><contrib>
en: original contents
it: contenuti originali

note: type: Content of: <book><bookinfo><authorgroup><author><contrib>
en: updated contents
it: contenuti aggiornati

note: type: Content of: <book><bookinfo><releaseinfo>
en: version &docversion;
it: versione &docversion;

note: type: Content of: <book><bookinfo><legalnotice><para>
en: This document may be used under the terms of the GNU General Public License version 2 or higher.
it: Questo documento può essere utilizzata nei termini della GNU General Public License versione 2 o successive.

note: type: Content of: <book><bookinfo><legalnotice><para>
en: This document was made using these two documents as examples:
it: Questo documento è stato realizzato utilizzando come modello i due documenti seguenti:

note: type: Content of: <book><bookinfo><legalnotice><itemizedlist><listitem><para>
en: Making a Debian Package (AKA the Debmake Manual), copyright © 1997 Jaldhar Vyas.
it: Making a Debian Package (noto come Manuale di Debmake), copyright © 1997 Jaldhar Vyas.

note: type: Content of: <book><chapter><title>
en: Getting started The Right Way
it: Partire nel modo giusto

note: type: Content of: <book><appendix><para>
en: The rewrite of this tutorial document with updated contents and more practical examples is available as <ulink url="&guidedeb;">Guide for Debian Maintainers</ulink>.  Please use this new tutorial as the primary tutorial document.
it: È disponibile la riscrittura di questo tutorial, con contenuti aggiornati e con esempi più pratici, denominato <ulink url="&guidedeb;">Guide for Debian Maintainers</ulink>.  Si prega di utilizzare il nuovo tutorial come documento primario.

note: type: Content of: <book><chapter><para>
en: This document tries to describe the building of a Debian package to ordinary Debian users and prospective developers.  It uses fairly non-technical language, and it's well covered with working examples.  There is an old Latin saying: <emphasis>Longum iter est per praecepta, breve et efficax per exempla</emphasis> (It's a long way by the rules, but short and efficient with examples).
it: Questo documento cerca di descrivere la costruzione di un pacchetto Debian GNU/Linux, sia per un normale utente Debian che per un aspirante sviluppatore. Utilizzando un linguaggio immediato, non tecnico e con l'ausilio di esempi concreti.  C'è un detto latino che dice <emphasis>Longum iter est per preaecepta, breve et efficax per exempla!</emphasis> (La via è lunga usando la teoria, ma breve ed efficiente con gli esempi!).

note: type: Content of: <book><chapter><para><footnote><para>
en: The document assumes you are using a <literal>&base-release;</literal> or newer system.  If you need to follow this text in an older system (including an older Ubuntu system etc.), you must install backported <systemitem role="package">dpkg</systemitem> and <systemitem role="package">debhelper</systemitem> packages, at least.
it: Nel documento si suppone l'utilizzo di un sistema <literal>&base-release;</literal> o superiore.  Se si intende seguire questo documento per un vecchio sistema (incluse le vecchie versioni di Ubuntu), bisognerebbe almeno installare delle versioni backport (n.d.t. versioni dei programmi presenti nei pacchetti di testing e unstable, compilate per poter funzionare in un sistema stable) di <systemitem role="package">dpkg</systemitem> e <systemitem role="package">debhelper</systemitem>.

note: type: Content of: <book><chapter><para>
en: This document is made available for the Debian <literal>Buster</literal> release since this offers many translations.  This document will be dropped in the following releases since contents are getting outdated.  <placeholder type="footnote" id="0"/>
it: Questo documento sarà disponibile fino alle release <literal>Buster</literal> di Debian, dato che è stato tradotto in molte lingue. Dato che i contenuti non sono aggiornati, questo documento verrà eliminato nelle release successive.   <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><para><footnote><para>
en: You can learn about the basic handling of a Debian system from the <ulink url="&debref;">Debian Reference</ulink>.  It contains some pointers to learn about Unix programming, too.
it: Si possono avere più informazioni sulla gestione base di un sistema Debian dal documento <ulink url="&debref;">Debian Reference</ulink>.  Questo documento contiene anche alcune riferimenti utili per approfondire la programmazioni Unix.

note: type: Content of: <book><chapter><para>
en: One of the things that makes Debian such a top-notch distribution is its package system.  While there is a vast quantity of software already in the Debian format, sometimes you need to install software that isn't.  You may be wondering how you can make your own packages; and perhaps you think it is a very difficult task.  Well, if you are a real novice on Linux, it is hard, but if you were a rookie, you wouldn't be reading this document now&nbsp;:-)  You do need to know a little about Unix programming but you certainly don't need to be a wizard.  <placeholder type="footnote" id="0"/>
it: Una delle cose che rende Debian una delle distribuzioni più importanti, è il suo sistema di pacchettizzazione.  Sebbene ci sia una vasta quantità di software disponibile sotto forma di pacchetto Debian, qualche volta è necessario installare del software per il quale non è stato ancora creato il pacchetto.  Si potrebbe pensare che creare dei pacchetti sia un compito molto difficile.  In effetti, se si è alle prime armi con GNU/Linux è dura, ma se si ha esperienza non si può non leggere questo documento&nbsp;:-) Servirà conoscere dei rudimenti di programmazione Unix, ma di sicuro non sarà necessario essere un mago della programmazione.  <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><para>
en: One thing is certain, though: to properly create and maintain Debian packages takes many hours.  Make no mistake, for our system to work the maintainers need to be both technically competent and diligent.
it: Una cosa però è certa: per creare in maniera corretta e manutenere dei pacchetti Debian serviranno svariate ore di lavoro.  Per far funzionare il nostro sistema, i maintainer devono stare attenti a non commettere errori, essere scrupolosi e tecnicamente competenti.

note: type: Content of: <book><chapter><para>
en: If you need some help with packaging, please read <xref linkend="helpme"/>.
it: Se è necessario qualche aiuto sulla pacchettizzazione, si consiglia la lettura di <xref linkend="helpme"/>.

note: type: Content of: <book><chapter><para>
en: Newer versions of this document should always be available online at <ulink url="&maint-guide;"/> and in the <systemitem role="package">maint-guide</systemitem> package.  The translations may be available in packages such as <systemitem role="package">maint-guide-es</systemitem>.  Please note that this documentation may be slightly outdated.
it: Le versioni aggiornate di questo documento dovrebbero sempre essere disponibile online all'indirizzo <ulink url="&maint-guide;"/> e nel pacchetto <systemitem role="package">maint-guida</systemitem>. Le traduzioni saranno disponibili in pacchetti come <systemitem role="package">maint-guide-es</systemitem> . Si noti che questa documentazione può essere leggermente obsoleta.

note: type: Content of: <book><chapter><para>
en: Since this is a tutorial, I choose to explain each detailed step for some important topics.  Some of them may look irrelevant to you.  Please be patient.  I have also intentionally skipped some corner cases and provided only pointers to keep this document simple.
it: Poiché si tratta di un tutorial, si è scelto di spiegare dettagliatamente ogni passo per alcuni argomenti importanti. Alcuni passi possono apparire irrilevanti per alcuni di voi. Si prega di essere pazienti. Si sono anche volutamente evitati alcuni casi particolari fornendo solo dei riferimenti, per mantenere questo semplice documento.

note: type: Content of: <book><chapter><section><title>
en: Social dynamics of Debian
it: Dinamiche sociali di Debian

note: type: Content of: <book><chapter><section><para>
en: Here are some observations of Debian's social dynamics, presented in the hope that it will prepare you for interactions with Debian:
it: Qui sono presenti alcune osservazioni delle dinamiche sociali di Debian, nella speranza che siano di aiuto per le interazioni con Debian:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: We all are volunteers.
it: Siamo tutti volontari.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: You cannot impose on others what to do.
it: Non si può imporre agli altri cosa fare.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: You should be motivated to do things by yourself.
it: Si dovrebbe essere motivati a fare le cose da soli.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Friendly cooperation is the driving force.
it: La coooperazione amichevole è la forza motrice.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Your contribution should not overstrain others.
it: Il vostro contributo non deve affaticare gli altri.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Your contribution is valuable only when others appreciate it.
it: Il vostro contributo è prezioso solo quando gli altri lo apprezzano.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Debian is not your school where you get automatic attention of teachers.
it: Debian non è la vostra scuola in cui si ottiene in automatico l'attenzione degli insegnanti.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: You should be able to learn many things by yourself.
it: Dovreste essere in grado di imparare molte cose da soli.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Attention from other volunteers is a very scarce resource.
it: L'attenzione degli altri volontari è una risorsa molto scarsa.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Debian is constantly improving.
it: Debian è in costante miglioramento.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: You are expected to make high quality packages.
it: Ci si aspetta che vengano creati pacchetti di alta qualità.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: You should adapt yourself to change.
it: Si consiglia di adattarsi al cambiamento.

note: type: Content of: <book><chapter><section><para>
en: There are several types of people interacting around Debian with different roles:
it: Ci sono molti tipi di persone, che interagiscono nel mondo Debian, con ruoli diversi:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <emphasis role="strong">upstream author</emphasis>: the person who made the original program.
it: <emphasis role="strong">autore originale (upstream author)</emphasis>: La persona che ha iniziato lo sviluppo del programma.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <emphasis role="strong">upstream maintainer</emphasis>: the person who currently maintains the program.
it: <emphasis role="strong">responsabile del programma (upstream maintainer)</emphasis>: La persona che attualmente sviluppa il programma.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <emphasis role="strong">maintainer</emphasis>: the person making the Debian package of the program.
it: <emphasis role="strong">responsabile del pacchetto (maintainer)</emphasis>: La persona che ha creato il pacchetto Debian del programma.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <emphasis role="strong">sponsor</emphasis>: a person who helps maintainers to upload packages to the official Debian package archive (after checking their contents).
it: <emphasis role="strong">sponsor</emphasis>: La persona che aiuta i responsabili dei pacchetti a verificarne la correttezza dei contenuti ed a depositarli nell'archivio Debian ufficiale.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <emphasis role="strong">mentor</emphasis>: a person who helps novice maintainers with packaging etc.
it: <emphasis role="strong">mentore</emphasis>: La persona che aiuta i responsabili dei pacchetti alle prime armi nelle operazioni di creazione del pacchetto, ecc.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <emphasis role="strong">Debian Developer</emphasis> (DD): a member of the Debian project with full upload rights to the official Debian package archive.
it: <emphasis role="strong">sviluppatore Debian (Debian Developer)</emphasis> (DD): membro del progetto Debian con i permessi di depositare i pacchetti all'interno dell'archivio Debian ufficiale.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <emphasis role="strong">Debian Maintainer</emphasis> (DM): a person with limited upload rights to the official Debian package archive.
it: <emphasis role="strong">responsabile Debian (Debian Maintainer)</emphasis> (DM): persona con permessi di accesso limitati all'archivio ufficiale dei pacchetti di Debian.

note: type: Content of: <book><chapter><section><para>
en: Please note that you cannot become an official <emphasis role="strong">Debian Developer</emphasis> (DD) overnight, because it takes more than technical skill.  Please do not be discouraged by this.  If it is useful to others, you can still upload your package either as a <emphasis role="strong">maintainer</emphasis> through a <emphasis role="strong">sponsor</emphasis> or as a <emphasis role="strong">Debian Maintainer</emphasis>.
it: Si noti che non è possibile diventare uno <emphasis role="strong">sviluppatore Debian</emphasis> (DD) ufficiale dal giorno alla notte, poiché questo richiede più che delle semplici conoscenze tecniche.  Ma non ci si deve lasciare scoraggiare da questo.  Se il lavoro che si è fatto è utile a qualcun altro, si può sempre depositare il proprio pacchetto sia come <emphasis role="strong">maintainer</emphasis> attraverso uno <emphasis role="strong">sponsor</emphasis> che come <emphasis role="strong">maintainer Debian</emphasis>.

note: type: Content of: <book><chapter><section><para>
en: Please note that you do not need to create any new package to become an official Debian Developer.  Contributing to the existing packages can provide a path to becoming an official Debian Developer too.  There are many packages waiting for good maintainers (see <xref linkend="choose"/>).
it: Si noti che non è necessario creare un nuovo pacchetto per diventare uno sviluppatore Debian ufficiale. Lo si può diventare anche semplicemente contribuendo alla manutenzione di pacchetti già esistenti.  Ci sono molti pacchetti che aspettano solo dei bravi responsabili (vedere <xref linkend="choose"/>).

note: type: Content of: <book><chapter><section><para>
en: Since we focus only on technical aspects of packaging in this document, please refer to the following to learn how Debian functions and how you can get involved:
it: Dal momento che in questo documento si trattano solo gli aspetti tecnici della pacchettizzazione, si prega di fare riferimento a quanto segue per conoscere come relazionarsi con Debian e come partecipare:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&logiciellibre;">Debian: 17 years of Free Software, "do-ocracy", and democracy</ulink> (Introductory slides)
it: <ulink url="&logiciellibre;"> Debian: 17 anni di Software Libero, "do-ocracy", e la democrazia</ulink> (Slides introduttive)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&debianorghelp;">How can you help Debian?</ulink> (official)
it: <ulink url="&debianorghelp;">Come aiutare Debian?</ulink> (Ufficiale)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&debianfaqhelp;">The Debian GNU/Linux FAQ, Chapter 13 - "Contributing to the Debian Project"</ulink> (semi-official)
it: <ulink url="&debianfaqhelp;">Debian GNU/Linux FAQ, capitolo 13 - "Contribuire al Progetto Debian"</ulink> (Semi-ufficiale)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&debianwikihelp;">Debian Wiki, HelpDebian</ulink> (supplemental)
it: <ulink url="&debianwikihelp;">Il Wiki di Debian, HelpDebian</ulink> (supplementare)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&nm-do;">Debian New Member site</ulink> (official)
it: <ulink url="&nm-do;">Sito del New Member Debian</ulink> (ufficiale)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&debianmentorfaq;">Debian Mentors FAQ</ulink> (supplemental)
it: <ulink url="&debianmentorfaq;">Debian Mentors FAQ</ulink> (supplementare)

note: type: Content of: <book><chapter><section><title>
en: Programs needed for development
it: Programmi necessari per lo sviluppo

note: type: Content of: <book><chapter><section><para>
en: Before you start anything, you should make sure that you have properly installed some additional packages needed for development.  Note that the list doesn't contain any packages marked <literal>essential</literal> or <literal>required</literal> - we expect that you have those installed already.
it: Prima di iniziare, bisogna assicurarsi di avere installato correttamente alcuni pacchetti aggiuntivi, necessari per lo sviluppo.  Da notare che la lista non contiene nessun pacchetto etichettato come <literal>essenziale</literal> o <literal>richiesto</literal> - ci aspettiamo che siano già installati nel sistema.

note: type: Content of: <book><chapter><section><para>
en: The following packages come with the standard Debian installation, so you probably have them already (along with any additional packages they depend on).  Still, you should check them with <literal>aptitude show <replaceable>package</replaceable></literal> or with <literal>dpkg -s <replaceable>package</replaceable></literal>.
it: I seguenti pacchetti fanno parte dell'installazione standard di Debian, per cui probabilmente sono già presenti nel sistema (insieme ai pacchetti aggiuntivi dai quali dipendono).  Si può effettuare un controllo con <literal>aptitude show <replaceable>pacchetto</replaceable></literal> o con <literal>dpkg -s <replaceable>pacchetto</replaceable></literal>.

note: type: Content of: <book><chapter><section><para>
en: The most important package to install on your development system is the <systemitem role="package">build-essential</systemitem> package.  Once you try to install that, it will <emphasis>pull in</emphasis> other packages required to have a basic build environment.
it: Il pacchetto più importante da installare in un sistema in cui si ha intenzione di sviluppare è <systemitem role="package">build-essential</systemitem>.  Questo <emphasis>includerà</emphasis> altri pacchetti necessari per avere un ambiente di base per la compilazione dei programmi.

note: type: Content of: <book><chapter><section><para>
en: For some types of packages, that is all you will require; however, there is another set of packages that while not essential for all package builds are useful to have installed or may be required by your package:
it: Per alcuni tipi di pacchetti questo è tutto quello che serve, ci sono però una serie di pacchetti che, pur non essendo essenziali per lo sviluppo, vengono in aiuto allo sviluppatore o possono essere richiesti dal pacchetto su cui si lavora:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">autoconf</systemitem>, <systemitem role="package">automake</systemitem>, and <systemitem role="package">autotools-dev</systemitem> - many newer programs use configure scripts and <filename>Makefile</filename> files preprocessed with the help of programs like these (see <literal>info autoconf</literal>, <literal>info automake</literal>).  <systemitem role="package">autotools-dev</systemitem> keeps up-to-date versions of certain auto files and has documentation about the best way to use those files.
it: <systemitem role="package">autoconf</systemitem>, <systemitem role="package">automake</systemitem> e <systemitem role="package">autotools-dev</systemitem> - diversi programmi recenti usano script di configurazione e <filename>Makefile</filename> preprocessati con l'aiuto di programmi come questi.  (vedere <literal>info autoconf</literal>, <literal>info automake</literal>) <systemitem role="package">autotools-dev</systemitem> tiene aggiornate le versioni di alcuni file di automazione e contiene la documentazione che spiega il modo migliore per utilizzare questi file.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para><footnote><para>
en: There are also some more specialized but similar packages such as <systemitem role="package">dh-make-perl</systemitem>, <systemitem role="package">dh-make-php</systemitem>, etc.
it: Ci sono un paio di pacchetti specializzati ma simili, come <systemitem role="package">dh-make-perl</systemitem>, <systemitem role="package">dh-make-php</systemitem>, ecc.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">debhelper</systemitem> and <systemitem role="package">dh-make</systemitem> - <systemitem role="package">dh-make</systemitem> is necessary to create the skeleton of our example package, and it will use some of the <systemitem role="package">debhelper</systemitem> tools for creating packages.  They are not essential for this purpose, but are <emphasis>highly</emphasis> recommended for new maintainers.  It makes the whole process very much easier to start, and to control afterwards.  (See <citerefentry> <refentrytitle>dh_make</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>debhelper</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.) <placeholder type="footnote" id="0"/>
it: <systemitem role="package">debhelper</systemitem> e <systemitem role="package">dh-make</systemitem> - <systemitem role="package">dh-make</systemitem> è necessario per creare lo scheletro del pacchetto, utilizza alcuni strumenti di <systemitem role="package">debhelper</systemitem> per creare i pacchetti.  Non sono essenziali per la creazione di pacchetti, ma sono <emphasis>fortemente</emphasis> consigliati per i nuovi maintainer.  Questo rende l'intero processo molto più semplice da iniziare e controllare successivamente.  (vedere <citerefentry> <refentrytitle>dh_make</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>debhelper</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.) <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The new <systemitem role="package">debmake</systemitem> may be used as the alternative to the standard <systemitem role="package">dh-make</systemitem>.  It does more and comes with HTML documentation with extensive packaging examples in <systemitem role="package">debmake-doc</systemitem>.
it: Il nuovo <systemitem role="package">debmake</systemitem> può essere utilizzato in alternativa a <systemitem role="package">dh-make</systemitem>.  Ha più funzionalità e comprende la documentazione HTML con esempi dettagliati di pacchettizzazione, presenti in <systemitem role="package">debmake-doc</systemitem>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">devscripts</systemitem> - this package contains some useful scripts that can be helpful for maintainers, but they are also not necessary for building packages.  Packages recommended and suggested by this package are worth looking into.  (See <filename>&devscripts-readme;</filename>.)
it: <systemitem role="package">devscripts</systemitem> - questo pacchetto contiene alcuni pratici script che possono essere utili ai maintainer, anche se non sono strettamente necessari per la creazione dei pacchetti.  I pacchetti consigliati o suggeriti da questo pacchetto andrebbero presi in considerazione.  (vedere <filename>&devscripts-readme;</filename>.)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">fakeroot</systemitem> - this utility lets you emulate being root, which is necessary for some parts of the build process.  (See <citerefentry> <refentrytitle>fakeroot</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.)
it: <systemitem role="package">fakeroot</systemitem> - questo programma permette di fingere di essere root, dato che è necessario per l'esecuzione di alcune parti del processo di creazione del pacchetto.  (vedere <citerefentry> <refentrytitle>fakeroot</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">file</systemitem> - this handy program can determine what type a file is.  (See <citerefentry> <refentrytitle>file</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.)
it: <systemitem role="package">file</systemitem> - questo semplice programma determina la tipologia di un file.  (vedere <citerefentry> <refentrytitle>file</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">gfortran</systemitem> - the GNU Fortran 95 compiler, necessary if your program is written in Fortran.  (See <citerefentry> <refentrytitle>gfortran</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.)
it: <systemitem role="package">gfortran</systemitem> - il compilatore GNU Fortran 95, necessario se il programma è scritto in Fortran.  (vedere <citerefentry> <refentrytitle>gfortran</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">git</systemitem> - this package provides a popular version control system designed to handle very large projects with speed and efficiency; it is used for many high profile open source projects, most notably the Linux kernel.  (See <citerefentry> <refentrytitle>git</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, git Manual (<filename>&git-doc;</filename>).)
it: <systemitem role="package">git</systemitem> - questo pacchetto contiene un famoso sistema per il controllo delle versioni, progettato per gestire progetti molto grandi con velocità ed efficienza; è utilizzato da molti progetti open source, tra cui il kernel Linux.  (Vedere <citerefentry> <refentrytitle>git</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, Manuale di git (<filename>&git-doc;</filename>).)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">gnupg</systemitem> - a tool that enables you to digitally <emphasis>sign</emphasis> packages.  This is especially important if you want to distribute packages to other people, and you will certainly be doing that when your work gets included in the Debian distribution.  (See <citerefentry> <refentrytitle>gpg</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.)
it: <systemitem role="package">gnupg</systemitem> - questo programma consente di <emphasis>firmare</emphasis> elettronicamente i pacchetti.  Questo è importante soprattutto se si vuole distribuirli ad altre persone, e verrà sicuramente fatto quando un pacchetto sarà pronto per essere incluso nella distribuzione Debian.  (vedere <citerefentry> <refentrytitle>gpg</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">gpc</systemitem> - the GNU Pascal compiler, necessary if your program is written in Pascal.  Worthy of note here is <systemitem role="package">fp-compiler</systemitem>, the Free Pascal Compiler, which is also good at this task.  (See <citerefentry> <refentrytitle>gpc</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>ppc386</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.)
it: <systemitem role="package">gpc</systemitem> - il compilatore GNU Pascal, necessario se il programma è scritto in Pascal.  Un sostituto degno di nota è <systemitem role="package">fp-compiler</systemitem>, il Compilatore Free Pascal.  (vedere <citerefentry> <refentrytitle>gpc</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>ppc386</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">lintian</systemitem> - this is the Debian package checker, which lets you know of any common mistakes after you build the package and explains the errors found.  (See <citerefentry> <refentrytitle>lintian</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, <ulink url="&lintian-doc;">Lintian User's Manual</ulink>.)
it: <systemitem role="package">lintian</systemitem> - questo è l'analizzatore dei pacchetti Debian, una volta costruito il pacchetto, permette di scoprire gli errori più comuni, cercando di spiegarli.  (vedere <citerefentry> <refentrytitle>lintian</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, <ulink url="&lintian-doc;">Lintian User's Manual</ulink>.)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">patch</systemitem> - this very useful utility will take a file containing a difference listing (produced by the <command>diff</command> program) and apply it to the original file, producing a patched version.  (See <citerefentry> <refentrytitle>patch</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.)
it: <systemitem role="package">patch</systemitem> - questo utile programma usa un file contenente una serie di differenze (prodotta dal programma diff) e le applica al file originale, per produrre una versione modificata.  (vedere <citerefentry> <refentrytitle>patch</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">patchutils</systemitem> - this package contains some utilities to work with patches such as the <command>lsdiff</command>, <command>interdiff</command> and <command>filterdiff</command> commands.
it: <systemitem role="package">patchutils</systemitem> - questo pacchetto contiene dei programmi che lavorano con le patch, come <command>lsdiff</command>, <command>interdiff</command> e <command>filterdiff</command>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">pbuilder</systemitem> - this package contains programs which are used for creating and maintaining a <command>chroot</command> environment.  Building a Debian package in this <command>chroot</command> environment verifies the proper build dependency and avoids FTBFS (Fails To Build From Source) bugs.  (see <citerefentry> <refentrytitle>pbuilder</refentrytitle> <manvolnum>8</manvolnum> </citerefentry> and <citerefentry> <refentrytitle>pdebuild</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>)
it: <systemitem role="package">pbuilder</systemitem> - questo pacchetto contiene i programmi che vengono usati per creare e manutenere un ambiente <command>chroot</command>.  Creare pacchetti Debian nell'ambiente <command>chroot</command> permette di verificare le dipendenze appropriate ed evitare bug di tipo FTBFS (Fails To Build From Source, non compila da sorgente).  (vedere <citerefentry> <refentrytitle>pbuilder</refentrytitle> <manvolnum>8</manvolnum> </citerefentry> e <citerefentry> <refentrytitle>pdebuild</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">perl</systemitem> - Perl is one of the most used interpreted scripting languages on today's Unix-like systems, often referred to as Unix's Swiss Army Chainsaw. (See <citerefentry> <refentrytitle>perl</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.)
it: <systemitem role="package">perl</systemitem> - Perl è uno dei linguaggi di scripting interpretato più utilizzati sugli odierni sistemi Unix e derivati, spesso definito come il coltellino svizzero di Unix.  (vedere <citerefentry> <refentrytitle>perl</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">python</systemitem> - Python is another of the most used interpreted scripting languages on the Debian system, combining remarkable power with very clear syntax. (See <citerefentry> <refentrytitle>python</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.)
it: <systemitem role="package">python</systemitem> - Python è un altro linguaggio di scripting interpretato molto utilizzato sui sistemi Debian, combina una notevole potenza con una sintassi molto chiara.  (vedere <citerefentry> <refentrytitle>python</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">quilt</systemitem> - this package helps you to manage large numbers of patches by keeping track of the changes each patch makes. Patches can be applied, un-applied, refreshed, and more.  (See <citerefentry> <refentrytitle>quilt</refentrytitle> <manvolnum>1</manvolnum></citerefentry>, and <filename>&quilt-pdf;</filename>.)
it: <systemitem role="package">quilt</systemitem> - questo pacchetto aiuta a gestire una gran numero di patch, tenendo traccia dei cambiamenti apportati.  Le patch sono organizzate in maniera logica come una pila, è possibile applicare(=push) le modifiche apportate dalla patch, oppure annullarle(=pop), semplicemente muovendosi attraverso la pila.  (vedere <citerefentry> <refentrytitle>quilt</refentrytitle> <manvolnum>1</manvolnum></citerefentry> e <filename>&quilt-pdf;</filename>.)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">xutils-dev</systemitem> - some programs, usually those made for X11, also use these programs to generate <filename>Makefile</filename> files from sets of macro functions.  (See <citerefentry> <refentrytitle>imake</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>xmkmf</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.)
it: <systemitem role="package">xutils-dev</systemitem> - alcuni programmi, generalmente quelli fatti per X11, usano questi strumenti per generare i <filename>Makefile</filename> da una serie di funzioni macro.  (vedere <citerefentry> <refentrytitle>imake</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>xmkmf</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.)

note: type: Content of: <book><chapter><section><para>
en: The short descriptions that are given above only serve to introduce you to what each package does.  Before continuing please read the documentation of each relevant program including ones installed through the package dependency such as <command>make</command>, at least, for the standard usage.  It may seem like heavy going now, but later on you'll be <emphasis>very</emphasis> glad you read it.  If you have specific questions later, I would suggest re-reading the documents mentioned above.
it: Le brevi note elencate qui sopra servono solo ad accennare lo scopo di ogni pacchetto.  Prima di continuare, è opportuno leggere la documentazione di ogni programma rilevante, compresi quelli installati per via delle dipendenze del pacchetto come <command>make</command>, almeno per un utilizzo di base.  Può sembrare molto pesante farlo adesso, ma in seguito ci si renderà conto che sarà stato <emphasis>utilissimo</emphasis>. Se si hanno dubbi specifici potrebbe essere utile rileggere i documenti di cui sopra.

note: type: Content of: <book><chapter><section><title>
en: Documentation needed for development
it: Documentazione necessaria per lo sviluppo

note: type: Content of: <book><chapter><section><para>
en: The following is the <emphasis>very important</emphasis> documentation which you should read along with this document:
it: Segue una serie di documenti <emphasis>molto importanti</emphasis> che è consigliabile leggere insieme a questo documento:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">debian-policy</systemitem> - the <ulink url="&debian-policy;">Debian Policy Manual</ulink> includes explanations of the structure and contents of the Debian archive, several OS design issues, the <ulink url="&fhs;">Filesystem Hierarchy Standard</ulink> (FHS, which says where each file and directory should be), etc.  For you, the most important thing is that it describes requirements that each package must satisfy to be included in the distribution. (See the local copies of <filename>&policy-pdf;</filename> and <filename>&fhs-pdf;</filename>.)
it: <systemitem role="package">debian-policy</systemitem> - il <ulink url="&debian-policy;">manuale delle policy Debian</ulink> comprende le spiegazioni riguardanti la struttura e il contenuto dell'archivio Debian, numerose problematiche inerenti la progettazione del sistema operativo, lo <ulink url="&fhs;">Standard della Gerarchia del Filesystem</ulink> (ndr.  Filesystem Hierarchy Standard), (che indica la posizione prevista per ogni file e directory), ecc.  In questo contesto, l'argomento più importante è la descrizione dei requisiti che ogni pacchetto deve soddisfare per essere incluso nella distribuzione. (vedere le copie locali di <filename>&policy-pdf;</filename> and <filename>&fhs-pdf;</filename>.)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">developers-reference</systemitem> - the <ulink url="&developers-reference;">Debian Developer's Reference</ulink> describes all matters not specifically about the technical details of packaging, like the structure of the archive, how to rename, orphan, or adopt packages, how to do NMUs, how to manage bugs, best packaging practices, when and where to upload, etc.  (See the local copy of <filename>&developers-refpdf;</filename>.)
it: <systemitem role="package">developers-reference</systemitem> - la <ulink url="&developers-reference;">Debian Developer's Reference</ulink> descrive tutte le questioni non prettamente legate alle tecniche di pacchettizzazione, come la struttura dell'archivio, come rinominare, abbandonare o adottare un pacchetto, come fare gli NMUs, come gestire i bug, suggerimenti pratici di pacchettizzazione, quando e dove fare i caricamenti, ecc.  (Si veda la copia locale di <filename>&developers-refpdf;</filename>.)

note: type: Content of: <book><chapter><section><para>
en: The following is the <emphasis>important</emphasis> documentation which you should read along with this document:
it: Segue una serie di documenti <emphasis>importanti</emphasis> che è consigliabile leggere insieme a questo documento:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&autotools-tutorial;">Autotools Tutorial</ulink> provides a very good tutorial for <ulink url="&gnu-build-system;">the GNU Build System known as the GNU Autotools</ulink>, whose most important components are Autoconf, Automake, Libtool, and gettext.
it: <ulink url="&autotools-tutorial;">Autotools Tutorial</ulink> contiene un ottimo tutorial su <ulink url="&gnu-build-system;">the GNU Build System known as the GNU Autotools</ulink> i cui componenti più importanti sono Autoconf, Automake, Libtool, e gettext.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">gnu-standards</systemitem> - this package contains two pieces of documentation from the GNU project: <ulink url="&gnu-standard;">GNU Coding Standards</ulink>, and <ulink url="&gnu-maintainer;">Information for Maintainers of GNU Software</ulink>.  Although Debian does not require these to be followed, these are still helpful as guidelines and common sense.  (See the local copies of <filename>&gnu-standard-pdf;</filename> and <filename>&gnu-maintainer-pdf;</filename>.)
it: <systemitem role="package">gnu-standards</systemitem> - questo pacchetto contiene due documenti provenienti dal progetto GNU: <ulink url="&gnu-standard;">GNU Coding Standards</ulink>, and <ulink url="&gnu-maintainer;">Information for Maintainers of GNU Software</ulink>.  Nonostante Debian non necessiti del loro utilizzo, sono comunque utili come linee guida e buona prassi.  (vedere le copie locali di <filename>&gnu-standard-pdf;</filename> e <filename>&gnu-maintainer-pdf;</filename>.)

note: type: Content of: <book><chapter><section><para>
en: If this document contradicts any of the documents mentioned above, they are correct.  Please file a bug report on the <systemitem role="package">maint-guide</systemitem> package using <command>reportbug</command>.
it: Se questo documento contraddice uno dei documenti cui sopra, si considerino corretti quest'ultimi.  Si prega di inviare una segnalazione di bug relativa al pacchetto <systemitem role="package">maint-guide</systemitem> usando <command>reportbug</command>.

note: type: Content of: <book><chapter><section><para>
en: The following is an alternative tutorial document that you may read along with this document:
it: Segue una serie di tutorial alternativi che si possono leggere insieme a questo documento:

note: type: Content of: <book><chapter><section><title>
en: Where to ask for help
it: Dove chiedere aiuto

note: type: Content of: <book><chapter><section><para>
en: Before you decide to ask your question in some public place, please read this fine documentation:
it: Prima di decidere di fare una domanda in qualche luogo pubblico, si prega di leggere la documentazione:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: files in <filename>/usr/share/doc/<replaceable>package</replaceable></filename> for all pertinent packages
it: i file in <filename>/usr/share/doc/<replaceable>pacchetto</replaceable></filename> per tutti i pacchetti pertinenti

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: contents of <literal><command>man</command> <replaceable>command</replaceable></literal> for all pertinent commands
it: il contenuto di <literal><command>man</command><replaceable>comando</replaceable></literal> per tutti i comandi pertinenti

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: contents of <literal><command>info</command> <replaceable>command</replaceable></literal> for all pertinent commands
it: il contenuto di <literal><command>info</command><replaceable>comando</replaceable></literal> per tutti i comandi pertinenti

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: contents of <ulink url="&debian-mentors-ldo;">debian-mentors@lists.debian.org mailing list archive</ulink>
it: il contenuto dell'archivio della lista<ulink url="&debian-mentors-ldo;">debian-mentors@lists.debian.org</ulink>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: contents of <ulink url="&debian-devel-ldo;">debian-devel@lists.debian.org mailing list archive</ulink>
it: il contenuto dell'archivio della lista<ulink url="&debian-devel-ldo;">debian-devel@lists.debian.org</ulink>

note: type: Content of: <book><chapter><section><para>
en: You can use web search engines more effectively by including search strings such as <literal>site:lists.debian.org</literal> to limit the domain.
it: È possibile utilizzare i motori di ricerca web più efficacemente includendo stringhe di ricerca come <literal>sito:lists.debian.org</literal> per limitare le ricerca ad un determinato dominio.

note: type: Content of: <book><chapter><section><para>
en: Making a small test package is a good way to learn details of packaging.  Inspecting existing well maintained packages is the best way to learn how other people make packages.
it: Creare un piccolo pacchetto di test è un ottimo metodo per imparare i dettagli della pacchettizzazione. Analizzare dei pacchetti già esistenti e ben manutenuti, è invece, il metodo migliore per capire come creano i pacchetti le altre persone.

note: type: Content of: <book><chapter><section><para>
en: If you still have questions about packaging that you couldn't find answers to in the available documentation and web resources, you can ask them interactively:
it: Se si hanno ancora domande sulla pacchettizzazione alle quale non si trova risposta nella documentazione disponibile e le risorse web, si può chiedere aiuto nei seguenti luoghi:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&debian-mentors-ldo;">debian-mentors@lists.debian.org mailing list</ulink>. (This mailing list is for the novice.)
it: <ulink url="&debian-mentors-ldo;">debian-mentors@lists.debian.org mailing list</ulink>. (Questa è la mailing list per i principianti.)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&debian-devel-ldo;">debian-devel@lists.debian.org mailing list</ulink>. (This mailing list is for the expert.)
it: <ulink url="&debian-devel-ldo;">debian-devel@lists.debian.org mailing list</ulink>. (Questa è la mailing list per gli esperti.)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&irc-debian;">IRC</ulink> such as <literal>#debian-mentors</literal>.
it: su <ulink url="&irc-debian;">IRC</ulink> in canali come <literal>#debian-mentors</literal>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Teams focusing on a specific set of packages. (Full list at <ulink url="&wikiteams;">https://wiki.debian.org/Teams</ulink>)
it: Team concentrati su uno specifico insieme di pacchetti. (Lista completa su <ulink url="&wikiteams;">https://wiki.debian.org/Teams</ulink>)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Language-specific mailing lists such as debian-devel-{french,italian,portuguese,spanish}@lists.debian.org or debian-devel@debian.or.jp. (Full listing at <ulink url="&listdevel;">https://lists.debian.org/devel.html</ulink> and <ulink url="&listusers;">https://lists.debian.org/users.html</ulink>)
it: Mailing list specifiche per lingua come debian-devel-{french,italian,portuguese,spanish}@lists.debian.org o debian-devel@debian.or.jp. (Elenco completo su <ulink url="&listdevel;">https://lists.debian.org/devel.html</ulink> e <ulink url="&listusers;">https://lists.debian.org/users.html</ulink>)

note: type: Content of: <book><chapter><section><para>
en: The more experienced Debian developers will gladly help you, if you ask properly after making your required efforts.
it: Gli sviluppatori di Debian più esperti saranno lieti di aiutare, se viene chiesto correttamente e dopo aver fatto gli sforzi necessari.

note: type: Content of: <book><chapter><section><para>
en: When you receive a bug report (yes, actual bug reports!), you will know that it is time for you to dig into the <ulink url="&bts;">Debian Bug Tracking System</ulink> and read the documentation there, to be able to deal with the reports efficiently.  I highly recommend reading the <ulink url="&devref-bug-handling;">Debian Developer's Reference, 5.8.  "Handling bugs"</ulink>.
it: Quando si ricevono delle segnalazioni di bug (sì, proprio quelle!), si dovrà approfondire l'utilizzo del <ulink url="&bts;">Sistema di tracciamento dei bug di Debian</ulink> e leggere la relativa documentazione, per essere in grado di gestire le segnalazioni in maniera efficiente.  È vivamente consigliato leggere <ulink url="&devref-bug-handling;">Debian Developer's Reference, 5.8.  "Handling bugs"</ulink>.

note: type: Content of: <book><chapter><section><para>
en: Even if it all worked well, it's time to start praying.  Why? Because in just a few hours (or days) users from all around the world will start to use your package, and if you made some critical error you'll get mailbombed by numerous angry Debian users&#x2026; Just kidding.  :-)
it: Anche se tutto è andato per il meglio, è arrivato il momento di pregare.  Perché? Perché in poche ore (o giorni) utenti da tutto il mondo cominceranno ad usare il vostro pacchetto, e se si è commesso qualche errore grave, la propria email sarà inondata da messaggi di molti utenti Debian incavolati&#x2026; Si scherza ovviamente.  :-)

note: type: Content of: <book><chapter><section><para>
en: Relax and be ready for bug reports, because there is a lot more work to be done before your package will be fully in line with Debian policies and its best practice guidelines (once again, read the <emphasis>real documentation</emphasis> for details).  Good luck!
it: Ci si deve rilassare ed essere pronti per le segnalazioni di bug, perché c'è molto lavoro prima che un pacchetto sia completamente conforme alle policy di Debian (ancora una volta, si legga la <emphasis>vera documentazione</emphasis> per i dettagli).  In bocca al lupo!

note: type: Content of: <book><chapter><title>
en: First steps
it: Primi passi

note: type: Content of: <book><chapter><para>
en: Let's start by creating a package of your own (or, even better, adopting an existing one).
it: Iniziamo a creare un pacchetto (o, meglio ancora, adottiamone uno già esistente).

note: type: Content of: <book><chapter><section><title>
en: Debian package building workflow
it: Flusso di lavoro per la costruzione dei pacchetti Debian

note: type: Content of: <book><chapter><section><para>
en: If you are making a Debian package with an upstream program, the typical workflow of Debian package building involves generating several specifically named files for each step as follows:
it: Se si sta facendo un pacchetto Debian con un programma, il flusso di lavoro tipico per la costruzione di pacchetti Debian comporta la generazione di  diversi file indicati in modo specifico per ogni passo come segue:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Get a copy of the upstream software, usually in a compressed tar format.
it: Procuriamoci una copia del programma, di solito in formato tar compresso.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><literal>
en: <replaceable>package</replaceable>-<replaceable>version</replaceable>.tar.gz
it: <replaceable>pacchetto</replaceable>-<replaceable>versione</replaceable>.tar.gz

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Add Debian-specific packaging modifications to the upstream program under the <filename>debian</filename> directory, and create a non-native source package (that is, the set of input files used for Debian package building) in <literal>3.0 (quilt)</literal> format.
it: Aggiungiamo le modifiche specifiche per il pacchetto Debian del programma, nella directory <filename>debian</filename>, e creiamo un archivio sorgente non nativo (ovvero con l'insieme di file di input utilizzati per la creazione del pacchetto) in formato <literal>3.0 (quilt)</literal>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><literal>
en: <replaceable>package</replaceable>_<replaceable>version</replaceable>.orig.tar.gz
it: <replaceable>pacchetto</replaceable>_<replaceable>versione</replaceable>.orig.tar.gz

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><literal>
en: <replaceable>package</replaceable>_<replaceable>version</replaceable>-<replaceable>revision</replaceable>.debian.tar.gz
it: <replaceable>pacchetto</replaceable>_<replaceable>versione</replaceable>-<replaceable>revisione</replaceable>.debian.tar.gz

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><footnote><para>
en: For the older style of non-native Debian source packages in <literal>1.0</literal> format, <literal><replaceable>package</replaceable>_<replaceable>version</replaceable>-<replaceable>revision</replaceable>.diff.gz</literal> is used instead.
it: Per gli archivi non nativi nel vecchio formato <literal>1.0</literal>, viene utilizzato il nome <literal><replaceable>pacchetto</replaceable>_<replaceable>versione</replaceable>-<replaceable>revisione</replaceable>.diff.gz</literal>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><literal>
en: <replaceable>package</replaceable>_<replaceable>version</replaceable>-<replaceable>revision</replaceable>.dsc
it: <replaceable>pacchetto</replaceable>_<replaceable>versione</replaceable>-<replaceable>revisione</replaceable>.dsc

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Build Debian binary packages, which are ordinary installable package files in <literal>.deb</literal> format (or <literal>.udeb</literal> format, used by the Debian Installer) from the Debian source package.
it: Costruiamo i pacchetti binari Debian, che sono normali pacchetti installabili nel formato <literal>.deb</literal> (o nel formato <literal>.udeb</literal>, usato dall'installer Debian) dal sorgente del pacchetto Debian.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><literal>
en: <replaceable>package</replaceable>_<replaceable>version</replaceable>-<replaceable>revision</replaceable>_<replaceable>arch</replaceable>.deb
it: <replaceable>pacchetto</replaceable>_<replaceable>versione</replaceable>-<replaceable>revisione</replaceable>_<replaceable>arch</replaceable>.deb

note: type: Content of: <book><chapter><section><para>
en: Please note that the character separating <literal><replaceable>package</replaceable></literal> and <literal><replaceable>version</replaceable></literal> was changed from <literal>-</literal> (hyphen) in the tarball name to <literal>_</literal> (underscore) in the Debian package filenames.
it: Si prega di notare che il carattere di separazione tra <literal><replaceable>pacchetto</replaceable></literal> e <literal><replaceable>versione</replaceable></literal> è stato modificato da <literal>-</literal> (trattino) nel nome dell'archivio, a <literal>_</literal> (trattino basso) nel nome del pacchetto Debian.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&policy-source;">5.6.1 "Source"</ulink>, <ulink url="&policy-package;">5.6.7 "Package"</ulink>, and <ulink url="&policy-version;">5.6.12 "Version"</ulink>.  The <emphasis role="strong">package architecture</emphasis> follows the <ulink url="&policy-architecture;">Debian Policy Manual, 5.6.8 "Architecture"</ulink> and is automatically assigned by the package build process.
it: Vedere <ulink url="&policy-source;">5.6.1 "Sorgente"</ulink>, <ulink url="&policy-package;">5.6.7 "Pacchetto"</ulink>, e <ulink url="&policy-version;">5.6.12 "Versione"</ulink>.  L'<emphasis role="strong">architettura del pacchetto</emphasis> è conforme al manuale delle Policy di Debian: <ulink url="&policy-architecture;">5.6.8 "Architettura"</ulink> ed è assegnata automaticamente al processo di creazione del pacchetto.

note: type: Content of: <book><chapter><section><para>
en: In the file names above, replace the <literal><replaceable>package</replaceable></literal> part with the <emphasis role="strong">package name</emphasis>, the <literal><replaceable>version</replaceable></literal> part with the <emphasis role="strong">upstream version</emphasis>, the <literal><replaceable>revision</replaceable></literal> part with the <emphasis role="strong">Debian revision</emphasis>, and the <literal><replaceable>arch</replaceable></literal> part with the <emphasis role="strong">package architecture</emphasis>, as defined in the Debian Policy Manual.  <placeholder type="footnote" id="0"/>
it: Nel file di nomi di cui sopra, sostituire la parte relativa al <literal><replaceable>pacchetto</replaceable></literal> con il <emphasis role="strong">nome del pacchetto</emphasis>, la <literal><replaceable>versione</replaceable></literal> con la <emphasis role="strong">versione originale</emphasis>, la <literal><replaceable>revisione</replaceable></literal> con la <emphasis role="strong">revisione Debian</emphasis>, e l'<literal><replaceable> architettura</replaceable></literal> con l'<emphasis role="strong">architettura del pacchetto</emphasis>, come definito nel manuale delle Policy di Debian. <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: Each step of this outline is explained with detailed examples in later sections.
it: Ogni passo di questo schema è spiegato con esempi dettagliati nelle sezioni successive.

note: type: Content of: <book><chapter><section><title>
en: Choose your program
it: Scegliamo il programma

note: type: Content of: <book><chapter><section><para>
en: You have probably chosen the package you want to create.  The first thing you need to do is check if the package is in the distribution archive already by using the following:
it: Probabilmente avete già scelto il pacchetto da creare. La prima cosa da fare è controllare se il pacchetto è già presente negli archivi della distribuzione, utilizzando i seguenti strumenti:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: the <command>aptitude</command> command
it: il comando <command>aptitude</command>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: the <ulink url="&packages-do;">Debian packages</ulink> web page
it: la pagina web <ulink url="&packages-do;">Pacchetti Debian</ulink>

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&devref-adopt;">Debian Developer's Reference 5.9.5 "Adopting a package"</ulink>.
it: Per maggiori informazioni, consulta la <ulink url="&developers-reference;">Guida di riferimento per lo sviluppatore Debian 5.9.5. "Adottare un pacchetto"</ulink>.

note: type: Content of: <book><chapter><section><para>
en: If the package already exists, well, install it! :-) If it happens to be <emphasis role="strong">orphaned</emphasis> (that is, if its maintainer is set to <ulink url="&qa-do;">Debian QA Group</ulink>), you may be able to pick it up if it's still available.  You may also adopt a package whose maintainer has filed a Request for Adoption (<emphasis role="strong">RFA</emphasis>).<placeholder type="footnote" id="0"/>
it: Se il pacchetto esiste già, bene, basta installarlo! :-) Se dovesse essere <emphasis role="strong">orfano</emphasis> (cioè, se il maintainer è <ulink url="&qa-do;">Debian QA Group</ulink>), lo si può prendere in carico se è ancora disponibile.  Si può adottare anche un pacchetto per il quale il suo manutentore ha presentato una richiesta di adozione (<emphasis role="strong">RFA</emphasis>).<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: There are several package ownership status resources:
it: Ci sono diverse risorse per controllare lo stato di appartenenza dei pacchetti:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The <command>wnpp-alert</command> command from the <systemitem role="package">devscripts</systemitem> package
it: Il comando <command>wnpp-alert</command> dal pacchetto <systemitem role="package">devscripts</systemitem>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&wnpp-bts;">Debian Bug report logs: Bugs in pseudo-package <systemitem role="package">wnpp</systemitem> in <literal>unstable</literal></ulink>
it: <ulink url="&wnpp-bts;">Registri di Debian delle segnalazioni dei bug: bug nello pseudo-pacchetto <systemitem role="package">wnpp</systemitem> in <literal>unstable</literal></ulink>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&wnpp-dn;">Debian Packages that Need Lovin'</ulink>
it: <ulink url="&wnpp-dn;">Pacchetti Debian che hanno bisogno d'amore</ulink>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&wnpp-debtags;">Browse <systemitem role="package">wnpp</systemitem> bugs based on debtags</ulink>
it: <ulink url="&wnpp-debtags;">Sfogliare i bug di <systemitem role="package">wnpp</systemitem> basati su debtags</ulink>

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Having said that, there will of course always be new programs that are worth packaging.
it: Detto questo, ovviamente ci sarà sempre qualche nuovo programma che vale la pena pacchettizzare.

note: type: Content of: <book><chapter><section><para>
en: As a side note, it's important to point out that Debian already has packages for most kinds of programs, and the number of packages already in the Debian archive is much larger than that of contributors with upload rights.  Thus, contributions to packages already in the archive are far more appreciated (and more likely to receive sponsorship) by other developers <placeholder type="footnote" id="0"/>.  You can contribute in various ways:
it: Come nota a margine, è importante sottolineare che Debian ha già i pacchetti per la maggior parte dei programmi e che il numero di pacchetti presenti nell'archivio Debian è molto più grande di quello dei contribuenti con permessi di caricamento.  Pertanto, i contributi sui pacchetti già presenti in archivio sono molto più apprezzati dagli altri sviluppatori (ed è molto più probabile che si ottenga una sponsorizzazione).  <placeholder type="footnote" id="0"/>.  Si può contribuire in diversi modi:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: taking over orphaned, yet actively used, packages
it: adottando dei pacchetti orfani, ma ancora attivamente utilizzati

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: joining <ulink url="&teams;">packaging teams</ulink>
it: entrando a far parte dei <ulink url="&teams;">team di pacchettizzazione</ulink>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: triaging bugs of very popular packages
it: aiutando nella risoluzione dei bug di pacchetti molto popolari

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: preparing <ulink url="&devref-nmu;">QA or NMU uploads</ulink>
it: preparando <ulink url="&devref-nmu;">QA o caricando NMU</ulink>

note: type: Content of: <book><chapter><section><para>
en: If you are able to adopt the package, get the sources (with something like <literal>apt-get source <replaceable>packagename</replaceable></literal>) and examine them.  This document unfortunately doesn't include comprehensive information about adopting packages.  Thankfully you shouldn't have a hard time figuring out how the package works since someone has already done the initial setup for you.  Keep reading, though; a lot of the advice below will still be applicable to your case.
it: Appena ci si sente in grado di adottare un pacchetto, bisogna scaricare i sorgenti (con qualcosa tipo <literal>apt-get source <replaceable>pacchetto</replaceable></literal>) ed esaminarli.  Questo documento purtroppo non include tutte le informazioni che riguardano l'adozione dei pacchetti.  Fortunatamente non sarà difficile capire come funziona il pacchetto dal momento che qualcuno avrà già effettuato la configurazione iniziale.  Continua comunque a leggere, molti dei suggerimenti qui di seguito saranno utili per il nostro scopo.

note: type: Content of: <book><chapter><section><para>
en: If the package is new, and you decide you'd like to see it in Debian, proceed as follows:
it: Se il pacchetto è nuovo, e si pensa che sarebbe bello entrare a far parte di Debian, ecco come procedere:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: First, you must know that the program works, and have tried it for some time to confirm its usefulness.
it: Prima di tutto bisogna capire se il programma funziona in modo corretto, e averlo provato per almeno un po' di tempo e dimostrarne l'utilità.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: You must check that no one else is already working on the package on the <ulink url="&wnpp-do;">Work-Needing and Prospective Packages</ulink> site.  If no one else is working on it, file an ITP (Intent To Package) bug report to the <systemitem role="package">wnpp</systemitem> pseudo-package using <command>reportbug</command>.  If someone's already on it, contact them if you feel you need to.  If not &#x2014; find another interesting program that nobody is maintaining.
it: Bisogna controllare nella <ulink url="&wnpp-do;being_packaged">lista dei pacchetti sui quali si lavora</ulink> che nessun altro stia lavorando sullo stesso pacchetto.  Se nessuno ci sta lavorando, si può segnalare un bug di tipo ITP (Intent To Package) allo pseudo-pacchetto <systemitem role="package">wnpp</systemitem> usando il programma <command>reportbug</command>.  Se qualcuno ci sta lavorando e si ritiene necessario si potrebbe contattare il maintainer.  Altrimenti &#x2014; si potrebbe trovare un altro programma interessante che è non manutenuto.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The software <emphasis role="strong">must have a license</emphasis>.
it: Il programma <emphasis role="strong">deve avere una licenza</emphasis>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: For the <literal>main</literal> section, Debian Policy requires it <emphasis role="strong">to be fully compliant with the Debian Free Software Guidelines</emphasis> (<ulink url="&dfsg;">DFSG</ulink>)  and <emphasis role="strong">not to require a package outside of <literal>main</literal></emphasis> for compilation or execution.  This is the desired case.
it: I programmi nella sezione <literal>main</literal>, <emphasis role="strong">devono essere completamente compatibili con le Linee Guida per il Software Libero Debian (DFSG, Debian Free Software Guidelines)</emphasis> (vedere <ulink url="&dfsg;">DSFG</ulink>)  e <emphasis role="strong">non devono richiede nessun pacchetto che non sia presente nella sezione <literal>main</literal></emphasis>, per la compilazione o l'esecuzione.  Questo è il caso preferito.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: For the <literal>contrib</literal> section, it must comply with the DFSG but it may require a package outside of <literal>main</literal> for compilation or execution.
it: I programmi nella sezione <literal>contrib</literal>, devono essere conformi alle DFSG, ma potrebbero richiedere, per la compilazione o l'esecuzione, un pacchetto che non è presente nella sezione <literal>main</literal>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: For the <literal>non-free</literal> section, it may be non-compliant with the DFSG but it <emphasis role="strong">must be distributable</emphasis>.
it: I programmi nella sezione <literal>non-free</literal>, possono non essere conformi alle DFSG, ma <emphasis role="strong">devono poter essere distribuibili</emphasis>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: If you are unsure about where it should go, post the license text on <ulink url="&debian-legal-ldo;">debian-legal@lists.debian.org</ulink> and ask for advice.
it: Se non si è sicuri su quale sezione il pacchetto dovrebbe essere incluso, si può mandare il testo della licenza alla mailing list <ulink url="&debian-legal-ldo;">debian-legal@lists.debian.org</ulink> e chiedere consigli.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The program should <emphasis role="strong">not</emphasis> introduce security and maintenance concerns into the Debian system.
it: Il programma <emphasis role="strong">non</emphasis> dovrebbe introdurre problemi si sicurezza e di manutenzione al il sistema Debian.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: The program should be well documented and its code needs to be understandable (i.e., not obfuscated).
it: Il programma dovrebbe essere ben documentato e il suo codice facilmente comprensibile (ad es.  non offuscato).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: You should contact the program's author(s) to check if they agree with packaging it and are amicable to Debian.  It is important to be able to consult with the author(s)  in case of any problems with the program, so don't try to package unmaintained software.
it: Si dovrebbe contattare l'autore o gli autori del programma per verificare che siano d'accordo con la sua pacchettizzazione.  È importante essere in grado di consultarsi con l'autore/i sul programma nel caso di problemi specifici del programma, per questo è meglio non provare a pacchettizzare programmi non più manutenuti.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: The program certainly should <emphasis role="strong">not</emphasis> run setuid root, or even better, it shouldn't need to be setuid or setgid to anything.
it: Il programma <emphasis role="strong">non</emphasis> dovrebbe certamente girare come setuid root, o meglio, non dovrebbe per niente richiedere di essere setuid o setgid.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: The program should not be a daemon, or go in an <filename>*/sbin</filename> directory, or open a port as root.
it: Il programma non dovrebbe essere un daemon, o essere installato nelle directory <filename>*/sbin</filename>, o aprire una porta come root.

note: type: Content of: <book><chapter><section><para>
en: Of course, the last one is just a safety measure, and is intended to save you from enraging users if you do something wrong in some setuid daemon&#x2026; When you gain more experience in packaging, you'll be able to package such software.
it: Ovviamente queste sono solo misure di sicurezza, fatte per salvarti dall'ira degli utenti se si commette qualche errore in qualche daemon setuid&#x2026; Una volta acquisita esperienza nella pacchettizzazione, sarai in grado di creare pure quel tipo di pacchetti.

note: type: Content of: <book><chapter><section><para>
en: As a new maintainer, you are encouraged to get some experience in packaging with easier packages and discouraged from creating complicated packages.
it: Visto che si è alle prime armi come maintainer, si consiglia di acquisire un po' d'esperienza creando dei pacchetti semplici cercando di evitare quelli più complicati.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Simple packages
it: Pacchetti semplici

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: single binary package, arch = all (collection of data such as wallpaper graphics)
it: pacchetto binario singolo, arch = all (collezione di dati, come le immagini di sfondo)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: single binary package, arch = all (executables written in an interpreted language such as POSIX shell)
it: pacchetto binario singolo, arch = all (eseguibili scritti in un linguaggio interpretato come lo shell POSIX)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Intermediate complexity packages
it: Pacchetti di media difficoltà

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: single binary package, arch = any (ELF binary executables compiled from languages such as C and C++)
it: pacchetto binario singolo, arch = any (binari ELF eseguibili compilati da linguaggi come C e C++)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: multiple binary packages, arch = any + all (packages for ELF binary executables + documentation)
it: pacchetti binari multipli, arch = any + all (pacchetti per binari ELF eseguibili + documentazione)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: upstream source in a format other than <filename>tar.gz</filename> or <filename>tar.bz2</filename>
it: sorgente originale in un formato diverso da <filename>tar.gz</filename> o <filename>tar.bz2</filename>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: upstream source containing undistributable contents
it: l'archivio dei sorgenti originale ha contenuti non distribuibili

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: High complexity packages
it: Pacchetti complessi

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: interpreter module package used by other packages
it: pacchetto di un modulo di un interprete utilizzato da altri pacchetti

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: generic ELF library package used by other packages
it: libreria ELF generica utilizzata da altri pacchetti

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: multiple binary packages including an ELF library package
it: pacchetti binari multipli che includono un pacchetto di una libreria ELF

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: source package with multiple upstream sources
it: pacchetto con molteplici sorgenti originali

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: kernel module packages
it: pacchetti di moduli del kernel

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: kernel patch packages
it: pacchetti di patch del kernel

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: any package with non-trivial maintainer scripts
it: ogni pacchetto con degli script di manutenzione non banali

note: type: Content of: <book><chapter><section><para>
en: Packaging high complexity packages is not too hard, but it requires a bit more knowledge. You should seek specific guidance for every complex feature. For example, some languages have their own sub-policy documents:
it: Creare pacchetti complessi non è troppo difficile, ma richiede un po' più di conoscenza. Si dovrebbe cercare una guida specifica per ogni caratteristica complessa. Ad esempio, alcuni linguaggi hanno dei loro documenti con le loro linee guida:

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Do not worry about the missing <filename>Makefile</filename>.  You can install the <command>hello</command> command by simply using <command>debhelper</command> as in <xref linkend="install"/>, or by modifying the upstream source to add a new <filename>Makefile</filename> with the <literal>install</literal> target as in <xref linkend="modify"/>.
it: Non ci si preoccupi della mancanza dei <filename>Makefile</filename>. È possibile installare il programma <command>hello</command> semplicemente usando il comando <command>debhelper</command> come in <xref linkend="install"/>, oppure modificando il sorgente originale aggiungendo un nuovo <filename>Makefile</filename> con la destinazione dell' <literal>install</literal> come in <xref linkend="modify"/> .

note: type: Content of: <book><chapter><section><para>
en: There is another old Latin saying: <emphasis>fabricando fit faber</emphasis> (practice makes perfect).  It is <emphasis>highly</emphasis> recommended to practice and experiment with all the steps of Debian packaging with simple packages while reading this tutorial.  A trivial upstream tarball, <filename>hello-sh-1.0.tar.gz</filename>, created as follows may offer a good starting point:<placeholder type="footnote" id="0"/>
it: C'è un altro vecchio detto latino che dice: <emphasis>fabricando fit faber</emphasis> (la pratica rende perfetti). Si tratta di una pratica <emphasis>vivamente</emphasis> consigliata, sperimentate tutte le fasi di pacchettizzazione Debian con un pacchetto semplice durante la lettura di questo tutorial. Un archivio compresso banale come <filename>hello-sh-1.0.tar.gz</filename> creato come segue, può offrire un buon punto di partenza:<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><title>
en: Get the program, and try it out
it: Prendere il programma e provarlo

note: type: Content of: <book><chapter><section><para>
en: So the first thing to do is to find and download the original source code.  Presumably you already have the source file that you picked up at the author's homepage.  Sources for free Unix programs usually come in <command>tar</command>+<command>gzip</command> format with the extension <filename>.tar.gz</filename>, <command>tar</command>+<command>bzip2</command> format with the extension <filename>.tar.bz2</filename>, or <command>tar</command>+<command>xz</command> format with the extension <filename>.tar.xz</filename>.  These usually contain a directory called <filename><replaceable>package</replaceable>-<replaceable>version</replaceable></filename> with all the sources inside.
it: La prima cosa da fare è trovare e scaricare il codice sorgente originale del programma.  Supponendo che si è recuperato il file dal sito web dell'autore.  Generalmente il codice sorgente dei programmi liberi per Unix e derivati sono in formato <command>tar</command>+<command>gzip</command> con estensione <filename>.tar.gz</filename>, oppure in formato <command>tar</command>+<command>bzip2</command> con estensione <filename>.tar.bz2</filename>.  Di solito, questi file, contengono la sottodirectory dal nome <filename><replaceable>pacchetto</replaceable>-<replaceable>versione</replaceable></filename> con tutti i sorgenti.

note: type: Content of: <book><chapter><section><para>
en: If the latest version of the source is available through a Version Control System (VCS) such as Git, Subversion, or CVS, you need to get it with <literal>git clone</literal>, <literal>svn co</literal>, or <literal>cvs co</literal> and repack it into <command>tar</command>+<command>gzip</command> format yourself by using the <literal>--exclude-vcs</literal> option.
it: Se è presente un sistema di controllo di versione (VCS) come Git, Subversion o CVS, è possibile scaricare l'ultima versione del codice sorgente con <literal>git clone</literal>, <literal>svn co</literal>, o <literal>cvs co</literal> e comprimerlo in formato <command>tar</command>+<command>gzip</command> utilizzando l'opzione <literal>--exclude-vcs</literal>.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: You can identify the archive format using the <command>file</command> command when the file extension is not enough.
it: Si può utilizzare il comando <command>file</command> per scoprire il formato di archiviazione.

note: type: Content of: <book><chapter><section><para>
en: If your program's source comes as some other sort of archive (for instance, the filename ends in <filename>.Z</filename> or <filename>.zip</filename><placeholder type="footnote" id="0"/>), you should also unpack it with the appropriate tools and repack it.
it: Se il codice sorgente è in qualche altro formato di archiviazione (per esempio, con estensione <filename>.Z</filename> o <filename>.zip</filename><placeholder type="footnote" id="0"/>), scompattarlo con i programmi appropriati, e ricomprimerlo.

note: type: Content of: <book><chapter><section><para>
en: If your program's source comes with some contents which do not comply with DFSG, you should also unpack it to remove such contents and repack it with a modified upstream version containing <literal>dfsg</literal>.
it: Se il sorgente del programma viene fornito con alcuni contenuti che non sono conformi con il DFSG, si dovrebbe scompattarlo, rimuovere questi contenuti e ricomprimerlo con una versione modificata dei sorgenti originali contenenti <literal>dfsg</literal> .

note: type: Content of: <book><chapter><section><para><footnote><para>
en: This program is already packaged. The <ulink url="&gentoo-package;">current version</ulink> uses Autotools as its build structure and is substantially different from the following examples, which were based on version 0.9.12.
it: Il programma in questione è già stato pacchettizzato. La <ulink url="&gentoo-package;">versione corrente</ulink> usa gli Autotools e la sua costruzione e struttura è molto sostanzialmente differente dagli esempi seguenti, che sono basati sulla versione 0.9.12.

note: type: Content of: <book><chapter><section><para>
en: As an example, I'll use a program called <command>gentoo</command>, a GTK+ file manager.  <placeholder type="footnote" id="0"/>
it: A titolo di esempio, verrà utilizzato il programma <command>gentoo</command>, un gestore file grafico basato su GTK+.<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: Create a subdirectory under your home directory named <filename>debian</filename> or <filename>deb</filename> or anything you find appropriate (e.g.  just <filename>~/gentoo</filename> would do fine in this case).  Place the downloaded archive in it, and extract it (with <literal>tar xzf gentoo-0.9.12.tar.gz</literal>).  Make sure there are no warning messages, even <emphasis>irrelevant</emphasis> ones, because other people's unpacking tools may or may not ignore these anomalies, so they may have problems unpacking them.  Your shell command line may look something like this:
it: È buona regola creare una sottodirectory nella directory home e nominarla <filename>debian</filename> o <filename>deb</filename> o qualsiasi altro nome appropriato (ad es.  in questo caso <filename>~/gentoo</filename> andrebbe più che bene).  Scaricare l'archivio e scompattarlo (con il comando <literal>tar xzf gentoo-0.9.12.tar.gz</literal>).  Bisogna assicurarsi che non ci siano errori, per quanto in apparenza <emphasis>irrilevanti</emphasis>, perché potrebbero causare problemi nell'estrazione dell'archivio sul sistema di altre persone, alcuni strumenti di estrazione a volte ignorano queste anomalie.  Nella console dovrebbe esserci quanto segue:

note: type: Content of: <book><chapter><section><para>
en: Now you have another subdirectory, called <filename>gentoo-0.9.12</filename>.  Change to that directory and <emphasis>thoroughly</emphasis> read the provided documentation.  Usually there are files named <filename>README*</filename>, <filename>INSTALL*</filename>, <filename>*.lsm</filename> or <filename>*.html</filename>.  You must find instructions on how to compile and install the program (most probably they'll assume you want to install to the <filename>/usr/local/bin</filename> directory; you won't be doing that, but more on that later in <xref linkend="destdir"/>).
it: A questo punto si avrà un'altra sottodirectory, dal nome <filename>gentoo-0.9.12</filename>.  Spostarsi in questa directory e leggere <emphasis>attentamente</emphasis> la documentazione fornita.  Di solito si avranno dei file come <filename>README*</filename>, <filename>INSTALL*</filename>, <filename>*.lsm</filename> o <filename>*.html</filename>.  È necessario trovare istruzioni su come compilare e installare correttamente il programma (si potrebbe supporre di installare il programma nella directory <filename>/usr/local/bin</filename>, ma questo non è il comportamento corretto, tratteremo l'argomento più avanti <xref linkend="destdir"/>).

note: type: Content of: <book><chapter><section><para>
en: You should start packaging with a completely clean (pristine) source directory, or simply with freshly unpacked sources.
it: Si dovrebbe iniziare la pacchettizzazione con la directory dei sorgenti completamente ripulita, o semplicemente partendo da una nuova estrazione dall'archivio dei sorgenti.

note: type: Content of: <book><chapter><section><title>
en: Simple build systems
it: Sistemi di compilazione semplici

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Many modern programs come with a script named <filename>configure</filename>, which when executed creates a <filename>Makefile</filename> customized for your system.
it: Molti programmi moderni sono dotati di uno script <filename>configure</filename> che, una volta eseguito, crea un <filename>Makefile</filename> personalizzato per il proprio sistema.

note: type: Content of: <book><chapter><section><para>
en: Simple programs usually come with a <filename>Makefile</filename> and can be compiled just by invoking <literal>make</literal>.<placeholder type="footnote" id="0"/> Some of them support <literal>make check</literal>, which runs included self-tests.  Installation to the destination directories is usually done with <literal>make install</literal>.
it: I programmi più semplici sono dotati di un file <filename>Makefile</filename>, e possono essere compilati semplicemente con il comando <literal>make</literal>.<placeholder type="footnote" id="0"/>  Alcuni supportano <literal>make check</literal>, che esegue dei controlli automatici.  Per installare il programma nella directory di destinazione, di solito basta eseguire <literal>make install</literal>.

note: type: Content of: <book><chapter><section><para>
en: Now try to compile and run your program, to make sure it works properly and doesn't break something else while it's installing or running.
it: Adesso si provi a compilare ed eseguire il programma, assicurandosi che funzioni correttamente e che niente sia andato storto durante l'installazione o l'esecuzione.

note: type: Content of: <book><chapter><section><para>
en: Also, you can usually run <literal>make clean</literal> (or better <literal>make distclean</literal>) to clean up the build directory.  Sometimes there's even a <literal>make uninstall</literal> which can be used to remove all the installed files.
it: Di solito, per ripulire la directory di compilazione, si usa il comando <literal>make clean</literal> (o meglio ancora <literal>make distclean</literal>).  Talvolta c'è anche il comando <literal>make uninstall</literal> che serve a rimuovere tutti i file installati.

note: type: Content of: <book><chapter><section><title>
en: Popular portable build systems
it: Sistemi di compilazione portabili più utilizzati

note: type: Content of: <book><chapter><section><para>
en: A lot of free software programs are written in the <ulink url="&c-program;">C</ulink> and <ulink url="&cxx;">C++</ulink> languages.  Many of these use Autotools or CMake to make them portable across different platforms.  These build tools need to be used to generate the <filename>Makefile</filename> and other required source files first.  Then, such programs are built using the usual <literal>make; make install</literal>.
it: Molti programmi liberi sono scritti utilizzando i linguaggi di programmazione <ulink url="&c-program;">C</ulink> e <ulink url="&cxx;">C++</ulink>.  Molti di questi utilizzano Autotools o CMake per essere portabili su diverse piattaforme.  Questi strumenti vengono utilizzati per generare il <filename>Makefile</filename> e altri file sorgenti necessari.  Dopo di questo, i programmi vengono compilati utilizzando il solito <literal>make; make install</literal>.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Autotools is too big to deal with in this small tutorial. This section is meant to provide keywords and references only.  Please make sure to read the <ulink url="&autotools-tutorial;">Autotools Tutorial</ulink> and the local copy of <filename>&autotools-readme;</filename>, if you need to use it.
it: Autotools è troppo vasto per essere approfondito in questo piccolo tutorial. Questa sezione ha lo scopo di fornire solo i concetti base ed i riferimenti.  Assicurarsi di leggere il <ulink url="&autotools-tutorial;">tutorial Autotools</ulink> e la copia locale di <filename>&autotools-readme;</filename>, se si intende usarlo.

note: type: Content of: <book><chapter><section><para>
en: <ulink url="&gnu-build-system;">Autotools</ulink> is the GNU build system comprising <ulink url="&autoconf;">Autoconf</ulink>, <ulink url="&automake;">Automake</ulink>, <ulink url="&libtool;">Libtool</ulink>, and <ulink url="&gettext;">gettext</ulink>.  You can recognize such sources by the <filename>configure.ac</filename>, <filename>Makefile.am</filename>, and <filename>Makefile.in</filename> files.  <placeholder type="footnote" id="0"/>
it: <ulink url="&gnu-build-system;">Autotools</ulink> è il sistema di compilazione della GNU, che comprendere <ulink url="&autoconf;">Autoconf</ulink>, <ulink url="&automake;">Automake</ulink>, <ulink url="&libtool;">Libtool</ulink>, e <ulink url="&gettext;">gettext</ulink>.  Per capire meglio ciò che avviene, si possono leggere i seguenti file sorgenti: <filename>configure.ac</filename>, <filename>Makefile.am</filename>, e <filename>Makefile.in</filename>.  <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: The first step of the Autotools workflow is usually that upstream runs <literal>autoreconf -i -f</literal> in the source directory and distributes the generated files along with the source.
it: Il primo passo del flusso di lavoro degli Autotools consiste solitamente nell'esecuzione del comando <literal>autoreconf -i -f</literal> per i sorgenti che verranno successivamente distribuiti insieme ai file generati.

note: type: Content of: <book><chapter><section><para>
en: Editing <filename>configure.ac</filename> and <filename>Makefile.am</filename> files requires some knowledge of <command>autoconf</command> and <command>automake</command>.  See <literal>info autoconf</literal> and <literal>info automake</literal>.
it: La modifica dei file <filename>configure.ac</filename> e <filename>Makefile.am</filename> richiede una minima conoscenza di <command>autoconf</command> e <command>automake</command>.  Vedere<literal>info autoconf</literal> e <literal>info automake</literal>.

note: type: Content of: <book><chapter><section><para>
en: The second step of the Autotools workflow is usually that the user obtains this distributed source and runs <literal>./configure &amp;&amp; make</literal> in the source directory to compile the program into an executable command <command><replaceable>binary</replaceable></command>.
it: Il passo successivo da compiere con Autotools, di solito, consiste nel procurarsi il sorgente del programma e nel compilarlo nella directory <command><replaceable>binary</replaceable></command> tramite l'esecuzione dei comandi <literal>./configure &amp;&amp; make</literal> all'interno della directory dei sorgenti stessi.

note: type: Content of: <book><chapter><section><para>
en: You can change many things in the <filename>Makefile</filename>; for instance you can change the default location for file installation using the option <literal>./configure --prefix=/usr</literal>.
it: Si possono modificare molte cose nel file <filename>Makefile</filename>, come la posizione predefinita di installazione dei file utilizzando l'opzione <command>./configure --prefix=/usr</command>.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: You can automate this by using <systemitem role="package">dh-autoreconf</systemitem> package.  See <xref linkend="customrules"/>.
it: Si possono automatizzare queste operazioni utilizzando il pacchetto  <systemitem role="package">dh-autoreconf</systemitem>.  Vedere <xref linkend="customrules"/>.

note: type: Content of: <book><chapter><section><para>
en: Although it is not required, updating the <filename>configure</filename> and other files with <literal>autoreconf -i -f</literal> may improve the compatibility of the source.  <placeholder type="footnote" id="0"/>
it: Nonostante non sia richiesto, l'aggiornamento di <filename>configure</filename> e degli altri file con <literal>autoreconf -i -f</literal> può migliorare la compatibilità del sorgente.  <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: <ulink url="&cmake;">CMake</ulink> is an alternative build system.  You can recognize such sources by the <filename>CMakeLists.txt</filename> file.
it: <ulink url="&cmake;">CMake</ulink> è un alternativo sistema di compilazione.  Per conoscerlo meglio si può leggere il file <filename>CMakeLists.txt</filename>.

note: type: Content of: <book><chapter><section><title>
en: Package name and version
it: Nome e versione del pacchetto

note: type: Content of: <book><chapter><section><para>
en: If the upstream source comes as <filename>gentoo-0.9.12.tar.gz</filename>, you can take <literal>gentoo</literal> as the (source) <emphasis role="strong">package name</emphasis> and <literal>0.9.12</literal> as the <emphasis role="strong">upstream version</emphasis>.  These are used in the <filename>debian/changelog</filename> file described later in <xref linkend="changelog"/>, too.
it: Se il sorgente del programma originale è nominato <filename>gentoo-0.9.12.tar.gz</filename>, si può usare <literal>gentoo</literal> come <emphasis role="strong">nome pacchetto</emphasis> e <literal>0.9.12</literal> come <emphasis role="strong">versione del programma originale</emphasis>. Queste stringhe saranno utilizzate nel file <filename>debian/changelog</filename> come vedremo più avanti nel <xref linkend="changelog"/>.

note: type: Content of: <book><chapter><section><para>
en: Although this simple approach works most of the time, you may need to adjust <emphasis role="strong">package name</emphasis> and <emphasis role="strong">upstream version</emphasis> by renaming the upstream source to follow Debian Policy and existing convention.
it: Sebbene questo semplice approccio il più delle volte funzioni, può essere necessario modificare il <emphasis role="strong">nome pacchetto</emphasis> e la <emphasis role="strong">versione del programma originale</emphasis> rinominando il sorgente originale in qualcosa conforme alla policy di Debian ed alle convenzioni esistenti.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: The default package name field length of <command>aptitude</command> is 30.  For more than 90% of packages, the package name is less than 24 characters.
it: Il campo di default di <command>aptitude</command> del nome del pacchetto è di 30 caratteri. Oltre il 90% dei pacchetti ha un nome più piccolo di 24 caratteri.

note: type: Content of: <book><chapter><section><para>
en: You must choose the <emphasis role="strong">package name</emphasis> to consist only of lower case letters (<literal>a-z</literal>), digits (<literal>0-9</literal>), plus (<literal>+</literal>) and minus (<literal>-</literal>) signs, and periods (<literal>.</literal>). It must be at least two characters long, must start with an alphanumeric character, and must not be the same as existing packages.  It is a good idea to keep its length within 30 characters.  <placeholder type="footnote" id="0"/>
it: È necessario scegliere il <emphasis role="strong">nome del pacchetto</emphasis> utilizzando solo lettere minuscole (<literal>a-z</literal>), cifre (<literal>0-9</literal>), il segno più (<literal>+</literal>) e il segno meno (<literal>-</literal>), e il punto ( <literal>.</literal> ). Il nome deve essere di almeno due caratteri, deve iniziare con un carattere alfanumerico, e non deve essere la stesso di quelli già esistenti.  È consigliabile mantenere la lunghezza intorno ai 30 caratteri.  <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para><footnote><para>
en: If you follow the <ulink url="&devref-newpackage;">Debian Developer's Reference 5.1. "New packages"</ulink>, the ITP process will usually catch this kind of issue.
it: Se si segue la <ulink url="&devref-newpackage;">guida dello sviluppatore Debian 5.1. "New packages"</ulink>, il processo di ITP di solito dovrebbe risolvere questo tipo di problemi.

note: type: Content of: <book><chapter><section><para>
en: If upstream uses some generic term such as <literal>test-suite</literal> for its name, it is a good idea to rename it to identify its contents explicitly and avoid namespace pollution.  <placeholder type="footnote" id="0"/>
it: Se il sorgente originale usa un nome troppo generico come <literal>test-suite</literal> è consigliabile rinominarlo, in modo da identificare meglio il suo contenuto e per non rischiare di sporcare il namespace.  <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para><footnote><para>
en: This stricter rule should help you avoid confusing file names.
it: Questa regola dovrebbe aiutare ad evitare confusione con i nome dei file.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: The default version field length of <command>aptitude</command> is 10.  The Debian revision with preceding hyphen usually consumes 2.  For more than 80% of packages, the upstream version is less than 8 characters and the Debian revision is less than 2 characters.  For more than 90% of packages, the upstream version is less than 10 characters and the Debian revision is less than 3 characters.
it: La lunghezza predefinita del campo "versione" di <command>aptitude</command> è di 10 caratteri.  Di solito le revisioni Debian precedute da un trattino ne utilizzano 2.  Per più dell'80% dei pacchetti, la lunghezza della versione dei sorgenti originali è più piccola di 10 caratteri e la revisione Debian è inferiore a 3 caratteri.

note: type: Content of: <book><chapter><section><para>
en: You should choose the <emphasis role="strong">upstream version</emphasis> to consist only of alphanumerics (<literal>0-9A-Za-z</literal>), plus signs (<literal>+</literal>), tildes (<literal>~</literal>), and periods (<literal>.</literal>). It must start with a digit (<literal>0-9</literal>).  <placeholder type="footnote" id="0"/> It is good idea to keep its length within 8 characters if possible.  <placeholder type="footnote" id="1"/>
it: Si consiglia di scegliere un nome della <emphasis role="strong">versione del programma originale</emphasis> contenente solo caratteri alfanumerici (<literal>0-9A-Za-z</literal>), il segno più (<literal>+</literal>), il simbolo tilde (<literal>~</literal>), e il punto (<literal>.</literal>). Il nome deve iniziare con una cifra (<literal>0-9</literal>).  <placeholder type="footnote" id="0"/> È consigliabile, se possibile, mantenere una lunghezza entro gli 8 caratteri.  <placeholder type="footnote" id="1"/>

note: type: Content of: <book><chapter><section><para>
en: If upstream does not use a normal versioning scheme such as <literal>2.30.32</literal> but uses some kind of date such as <literal>11Apr29</literal>, a random codename string, or a VCS hash value as part of the version, make sure to remove them from the <emphasis role="strong">upstream version</emphasis>.  Such information can be recorded in the <filename>debian/changelog</filename> file.  If you need to invent a version string, use the <literal>YYYYMMDD</literal> format such as <literal>20110429</literal> as upstream version.  This ensures that <command>dpkg</command> interprets later versions correctly as upgrades.  If you need to ensure smooth transition to the normal version scheme such as <literal>0.1</literal> in the future, use the <literal>0~YYMMDD</literal> format such as <literal>0~110429</literal> as the upstream version.
it: Se il programma originale non utilizza un normale sistema di versioning, come ad esempio <literal>2.30.32</literal>, ma utilizza qualche tipo di data, come <literal>11Apr29</literal>, un stringa con un codice casuale, o un valoro di hash di un VCS, bisogna assicurarsi di rimuoverli dalla  <emphasis role="strong">versione originale</emphasis>.  Queste informazioni possono essere registrate nel file <filename>debian/changelog</filename>.  Se si ha bisogno di inventare una stringa di versione, bisogna utilizzare il formato <literal>YYYYMMDD</literal>, ad esempio <literal>20110429</literal> come versione originale. Questo fa in modo che <command>dpkg</command> interpreti in modo corretto le versioni successive del programma, per gli aggiornamenti. Se ci si vuole assicurare, in futuro, una transazione indolore ad un normale sistema di versioning, come <literal>0.1</literal>, si utilizzi il formato <literal>0~YYMMDD</literal>, ed esempio <literal>0~110429</literal>, anzichè la versione originale.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Version strings may be <emphasis role="strong">upstream version</emphasis> (<literal><replaceable>version</replaceable></literal>), <emphasis role="strong">Debian revision</emphasis> (<literal><replaceable>revision</replaceable></literal>), or <emphasis role="strong">version</emphasis> (<literal><replaceable>version</replaceable>-<replaceable>revision</replaceable></literal>).  See <xref linkend="newrevision"/> for how the <emphasis role="strong">Debian revision</emphasis> is incremented.
it: La stringa della versione può essere costituita da <emphasis role="strong">versione del programma originale</emphasis> (<literal><replaceable>versione</replaceable></literal>), <emphasis role="strong">revisione Debian</emphasis> (<literal><replaceable>revisione</replaceable></literal>), oppure da <emphasis role="strong">versione</emphasis> (<literal><replaceable>versione</replaceable>-<replaceable>revisione</replaceable></literal>).  Vedere <xref linkend="newrevision"/> per conoscere come incrementare il numero della <emphasis role="strong">revisione Debian</emphasis>.

note: type: Content of: <book><chapter><section><para>
en: Version strings <placeholder type="footnote" id="0"/> can be compared using <citerefentry> <refentrytitle>dpkg</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> as follows:
it: Le stringhe di versione <placeholder type="footnote" id="0"/> possono essere confrontate usando <citerefentry> <refentrytitle>dpkg</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> come segue:

note: type: Content of: <book><chapter><section><para>
en: The version comparison rule can be summarized as:
it: Le regole per il confronto delle versioni possono essere riassunte in questo modo:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Strings are compared from the head to the tail.
it: Le stringhe sono confrontate dall'inizio alla fine (da sinistra verso destra).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Letters are larger than digits.
it: Le lettere hanno più priorità delle cifre.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Numbers are compared as integers.
it: I numeri sono confrontati come interi.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Letters are compared in ASCII code order.
it: Le lettere sono confrontate in ordine di codice ASCII.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: There are special rules for period (<literal>.</literal>), plus (<literal>+</literal>), and tilde (<literal>~</literal>) characters, as follows:
it: Ci sono regole speciali per il punto (<literal>.</literal>), il segno più (<literal>+</literal>), e il carattere tilde (<literal>~</literal>), eccole descritte:

note: type: Content of: <book><chapter><section><para>
en: One tricky case occurs when upstream releases <filename>gentoo-0.9.12-ReleaseCandidate-99.tar.gz</filename> as the pre-release of <filename>gentoo-0.9.12.tar.gz</filename>.  You need to make sure that the upgrade works properly by renaming the upstream source to <filename>gentoo-0.9.12~rc99.tar.gz</filename>.
it: Un esempio di caso intricato si ha, ad esempio, quando una è presente una pre-release RC come <filename>gentoo-0.9.12-ReleaseCandidate-99.tar.gz</filename> per il programma <filename>gentoo-0.9.12.tar.gz</filename>. In questo caso è necessario assicurarsi che l'aggiornamento funzioni correttamente, rinominando il sorgente originale <filename>gentoo-0.9.12~rc99.tar.gz</filename>.

note: type: Content of: <book><chapter><section><title>
en: Setting up <command>dh_make</command>
it: Configurare <command>dh_make</command>

note: type: Content of: <book><chapter><section><para><footnote><para>
en: The following text assumes you are using Bash as your login shell.  If you use some other login shell such as Z shell, use their corresponding configuration files instead of <filename>~/.bashrc</filename>.
it: Il seguente testo assume che stiate utilizzando Bash come shell di login.  Se si utilizza un'altra shell di login, come la Z shell, bisognerà usare i suoi file di configurazione al posto di <filename>~/.bashrc</filename>.

note: type: Content of: <book><chapter><section><para>
en: Set up the shell environment variables <literal>$DEBEMAIL</literal> and <literal>$DEBFULLNAME</literal> so that various Debian maintenance tools recognize your email address and name to use for packages. <placeholder type="footnote" id="0"/>
it: Una delle prime cose da fare è impostare le variabili d'ambiente della shell <literal>$DEBEMAIL</literal> e <literal>$DEBFULLNAME</literal> visto che molti strumenti di gestione di Debian usano queste variabili per recuperare il nome e l'email da utilizzare nei pacchetti. <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><title>
en: Initial non-native Debian package
it: Il primo pacchetto non nativo per Debian

note: type: Content of: <book><chapter><section><para>
en: Normal Debian packages are non-native Debian packages made from upstream programs.  If you wish to create a non-native Debian package of an upstream source <filename>gentoo-0.9.12.tar.gz</filename>, you can create an initial non-native Debian package for it by issuing the <command>dh_make</command> command as follows:
it: I pacchetti classici per Debian sono pacchetti non-nativi, ovvero non specificamente pensati per debian, come ad esempio qualche programma di manutenzione per Debian. Se si desidera creare un pacchetto Debian non-nativo del programma con il sorgente <filename>gentoo-0.9.12.tar.gz</filename> si può utilizzare il programma <command>dh_make</command> come segue:

note: type: Content of: <book><chapter><section><para><footnote><para>
en: If the upstream source provides the <filename>debian</filename> directory and its contents, run the <command>dh_make</command> command with the extra option <literal>--addmissing</literal>.  The new source <literal>3.0 (quilt)</literal> format is robust enough not to break even for these packages.  You may need to update the contents provided by the upstream version for your Debian package.
it: Se i sorgenti originali contengono già la directory <filename>debian</filename> e il suo contenuto, si deve eseguire il comando <command>dh_make</command> con l'opzione <literal>--addmissing</literal>.  Il nuovo formato dei sorgenti <literal>3.0 (quilt)</literal> è abbastanza maturo da non danneggiare questi pacchetti.  Potrebbe essere necessario aggiornare i contenuti forniti nei sorgenti originali per il pacchetto Debian.

note: type: Content of: <book><chapter><section><para>
en: Of course, replace the filename with the name of your original source archive.  <placeholder type="footnote" id="0"/> See <citerefentry> <refentrytitle>dh_make</refentrytitle> <manvolnum>8</manvolnum> </citerefentry> for details.
it: Ovviamente, si deve sostituire il nome del file con il nome dell'archivio dei sorgenti originali.  <placeholder type="footnote" id="0"/> Vedere <citerefentry> <refentrytitle>dh_make</refentrytitle> <manvolnum>8</manvolnum> </citerefentry> per i dettagli.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: There are several choices here: <literal>s</literal> for Single binary package, <literal>i</literal> for arch-Independent package, <literal>m</literal> for Multiple binary packages, <literal>l</literal> for Library package, <literal>k</literal> for Kernel module package, <literal>n</literal> for kernel patch package, and <literal>b</literal> for <systemitem role="package">cdbs</systemitem> package.  This document focuses on the use of the <command>dh</command> command (from the package <systemitem role="package">debhelper</systemitem>) to create a single binary package, but also touches on how to use it for arch-independent or multiple binary packages.  The package <systemitem role="package">cdbs</systemitem> offers an alternative packaging script infrastructure to the <command>dh</command> command and is outside the scope of this document.
it: Ecco le varie opzioni: <literal>s</literal> che sta per binario Singolo, <literal>i</literal> per Indipendente dall'architettura, <literal>m</literal> per binario Multiplo, <literal>l</literal> per Libreria, <literal>k</literal> per modulo del Kernel, <literal>n</literal> per patch del kernel e <literal>b</literal> per <systemitem role="package">cdbs</systemitem>.  Questo documento si basa sull'uso del comando <command>dh</command> (contenuto nel pacchetto <systemitem role="package">debhelper</systemitem>) per la creazione di un pacchetto contenente un singolo binario, verrà trattato anche il funzionamento dei pacchetti indipendenti dall'architettura e i pacchetti con binari multipli.  Il pacchetto <systemitem role="package">cdbs</systemitem> offre un'infrastruttura di script alternativa al comando <command>dh</command> e non rientra nell'ambito di questo documento.

note: type: Content of: <book><chapter><section><para>
en: You should see some output asking you what sort of package you want to create.  Gentoo is a single binary package &#x2014; it creates only one binary package, i.e., one <filename>.deb</filename> file &#x2014; so we will select the first option (with the <literal>s</literal> key), check the information on the screen, and confirm by pressing <literal><replaceable>ENTER</replaceable></literal>.  <placeholder type="footnote" id="0"/>
it: Verranno visualizzate alcune informazioni e verrà chiesto che tipo di pacchetto creare.  Gentoo è un pacchetto binario singolo &#x2014; crea un solo binario, e quindi un solo file <filename>.deb</filename> &#x2014; per cui si dovrà selezionare la prima opzione (con il tasto <literal>s</literal>), controllare le informazioni sullo schermo e confermare la scelta con <literal><replaceable>ENTER</replaceable></literal>.  <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: This execution of <command>dh_make</command> creates a copy of the upstream tarball as <filename>gentoo_0.9.12.orig.tar.gz</filename> in the parent directory to accommodate the creation of the non-native Debian source package with the name <filename>debian.tar.gz</filename> later:
it: L'esecuzione di <command>dh_make</command>, creerà una copia dell'archivio originale del programma, come nome <filename>gentoo_0.9.12.orig.tar.gz</filename>, nella directory superiore, per consentire, più avanti, la creazione di un pacchetto Debian sorgente non-nativo con nome <filename>debian.tar.gz</filename>:

note: type: Content of: <book><chapter><section><para>
en: Please note two key features of this filename <filename>gentoo_0.9.12.orig.tar.gz</filename>:
it: Si presti attenzione a due caratteristiche chiave presenti nel nome del file <filename>gentoo_0.9.12.orig.tar.gz</filename>:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Package name and version are separated by the character <literal>_</literal> (underscore).
it: Il nome del pacchetto e la versione sono separati da <literal>_</literal> (trattino basso).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The string <filename>.orig</filename> is inserted before the <filename>.tar.gz</filename>.
it: La stringa <filename>.orig</filename> è inserita prima di <filename>.tar.gz</filename>.

note: type: Content of: <book><chapter><section><para>
en: You should also notice that many template files are created in the source under the <filename>debian</filename> directory.  These will be explained in <xref linkend="dreq"/> and <xref linkend="dother"/>.  You should also understand that packaging cannot be a fully automated process.  You will need to modify the upstream source for Debian (see <xref linkend="modify"/>).  After this, you need to use the proper methods for building Debian packages (<xref linkend="build"/>), testing them (<xref linkend="checkit"/>), and uploading them (<xref linkend="upload"/>).  All the steps will be explained.
it: Si dovrebbe aver notato che nella sottodirectory dei sorgenti <filename>debian</filename> sono stati creati molti modelli di file.  Questo verrà trattato in <xref linkend="dreq"/> e <xref linkend="dother"/>.  Dovreste aver capito che la pacchettizzazione non è un processo automatico.  È necessario modificare il sorgente originale per Debian (come descritto in <xref linkend="modify"/>).  Dopo di questo, è necessario creare i pacchetti Debian in maniera appropriata (<xref linkend="build"/>), provarli <xref linkend="checkit"/>, e caricarli (<xref linkend="upload"/>). Tutti i passaggi verranno approfonditi in seguito.

note: type: Content of: <book><chapter><section><para>
en: If you accidentally erased some template files while working on them, you can recover them by running <command>dh_make</command> with the <literal>--addmissing</literal> option again in a Debian package source tree.
it: Se accidentalmente viene cancellato qualche modello di file mentre ci si lavora, è possibile recuperarlo eseguendo <command>dh_make</command> con l'opzione <literal>--addmissing</literal> nella directory dei sorgenti del pacchetto Debian.

note: type: Content of: <book><chapter><section><para>
en: Updating an existing package may get complicated since it may be using older techniques.  While learning the basics, please stick to creating a fresh package; further explanations are given in <xref linkend="update"/>.
it: L'aggiornamento di un pacchetto già esistente può diventare complicato, perché è possibile che si siano usate vecchie tecniche di pacchettizzazione.  Per adesso, è consigliabile, concentrarsi sulla creazione di nuovi pacchetti per imparare le basi.  Si tornerà ad approfondire l'argomento più avanti su <xref linkend="update"/>.

note: type: Content of: <book><chapter><section><para>
en: Please note that the source file does not need to contain any build system discussed in <xref linkend="simplemake"/> and <xref linkend="portable"/>.  It could be just a collection of graphical data, etc.  Installation of files may be carried out using only <systemitem role="package">debhelper</systemitem> configuration files such as <filename>debian/install</filename> (see <xref linkend="install"/>).
it: Si tenga presente che non è necessario che il file dei sorgenti contenga qualsiasi sistema di creazione, discusso in <xref linkend="simplemake"/> and <xref linkend="portable"/>. Potrebbe essere solo una collezione di file grafici, ecc. L'installazione di questi file può essere effettuata utilizzando solamente i file di configurazione di <systemitem role="package">debhelper</systemitem>, come <filename>debian/install</filename> (vedere <xref linkend="install"/>).

note: type: Content of: <book><chapter><title>
en: Modifying the source
it: Modificare i sorgenti

note: type: Content of: <book><chapter><para>
en: Please note that there isn't space here to go into <emphasis>all</emphasis> the details of fixing upstream sources, but here are some basic steps and problems people often run across.
it: Non c'è spazio qui per approfondire <emphasis>tutti</emphasis> i dettagli su come modificare i sorgenti originali, ma verranno trattati alcuni passaggi fondamentali e le problematiche più comuni.

note: type: Content of: <book><chapter><section><title>
en: Setting up <command>quilt</command>
it: Configurare <command>quilt</command>

note: type: Content of: <book><chapter><section><para>
en: The program <command>quilt</command> offers a basic method for recording modifications to the upstream source for Debian packaging.  It's useful to have a slightly customized default, so let's create an alias <command>dquilt</command> for Debian packaging by adding the following lines to <filename>~/.bashrc</filename>.  The second line provides the same shell completion feature of the <command>quilt</command> command to the <command>dquilt</command> command:
it: Il programma <command>quilt</command> offre un metodo semplice per registrare le modifiche dei sorgenti originali per la pacchettizzazione Debian.  È comodo averlo leggermente personalizzato per la pacchettizzazione Debian, utilizzando l'alias <command>dquilt</command>, aggiungendo le seguenti linee al file <filename>~/.bashrc</filename>. La seconda riga fornisce la stessa funzionalità di shell completion del comando <command>quilt</command> al comando <command>dquilt</command>:

note: type: Content of: <book><chapter><section><para>
en: Then let's create <filename>~/.quiltrc-dpkg</filename> as follows:
it: Si crei il file <filename>~/.quiltrc-dpkg</filename> come segue:

note: type: Content of: <book><chapter><section><para>
en: See <citerefentry> <refentrytitle>quilt</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> and <filename>&quilt-pdf;</filename> on how to use <command>quilt</command>.
it: Per l'utilizzo di <command>quilt</command> si veda <citerefentry> <refentrytitle>quilt</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> e <filename>&quilt-pdf;</filename>.

note: type: Content of: <book><chapter><section><title>
en: Fixing upstream bugs
it: Correggere i bug nel sorgente originale

note: type: Content of: <book><chapter><section><para>
en: Let's assume you find an error in the upstream <filename>Makefile</filename> as follows, where <literal>install: gentoo</literal> should have been <literal>install: gentoo-target</literal>.
it: Si supponga di trovare un errore, nel file <filename>Makefile</filename> distribuito con il programma originale, ad esempio la stringa <literal>install: gentoo</literal> avrebbe dovuto essere <literal>install: gentoo-target</literal>.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: The <filename>debian/patches</filename> directory should exist now if you ran <command>dh_make</command> as described before.  This example operation creates it just in case you are updating an existing package.
it: La directory <filename>debian/patches</filename> dovrebbe essere stata creata se si è eseguito <command>dh_make</command>, come descritto prima.  Questo esempio crea la directory nel caso in cui si stia aggiornando un pacchetto esistente.

note: type: Content of: <book><chapter><section><para>
en: Let's fix this and record it with the <command>dquilt</command> command as <filename>fix-gentoo-target.patch</filename>: <placeholder type="footnote" id="0"/>
it: Si può correggere questo errore e registrarlo, con il comando <command>dquilt</command> utilizzando come file <filename>fix-gentoo-target.patch</filename>:  <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: You change the <filename>Makefile</filename> file as follows:
it: Si modifichi il file <filename>Makefile</filename> come segue:

note: type: Content of: <book><chapter><section><para>
en: Ask <command>dquilt</command> to generate the patch to create <filename>debian/patches/fix-gentoo-target.patch</filename> and add its description following <ulink url="&dep3;">DEP-3: Patch Tagging Guidelines</ulink>:
it: Adesso bisogna chiedere a <command>dquilt</command> di generare la patch <filename>debian/patches/fix-gentoo-target.patch</filename> e di aggiungere una descrizione conforme a <ulink url="&dep3;">DEP-3: Patch Tagging Guidelines</ulink>:

note: type: Content of: <book><chapter><section><title>
en: Installation of files to their destination
it: Installazione dei file nei loro percorsi

note: type: Content of: <book><chapter><section><para>
en: Most third-party software installs itself in the <filename>/usr/local</filename> directory hierarchy.  On Debian this is reserved for private use by the system administrator, so packages must not use directories such as <filename>/usr/local/bin</filename> but should instead use system directories such as <filename>/usr/bin</filename>, obeying the <ulink url="&fhs;">Filesystem Hierarchy Standard</ulink> (FHS).
it: La maggiorparte dei programmi di terze parti si auto-installano in sottodirectory di <filename>/usr/local</filename>.  I pacchetti Debian invece non devono usare quella directory, dal momento che è riservata agli amministratori (o utenti)  del sistema per uso privato, ma dovrebbero usare le directory di sistema come la sottodirectory <filename>/usr/bin</filename>, conformi allo Standard di Gerarchia dei Filesystem (<ulink url="&fhs;">FHS</ulink>, <filename>/usr/share/doc/debian-policy/fhs/fhs-2.3.html</filename>).

note: type: Content of: <book><chapter><section><para>
en: Normally, <citerefentry> <refentrytitle>make</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> is used to automate building the program, and executing <literal>make install</literal> installs programs directly to the desired destination (following the <literal>install</literal> target in the <filename>Makefile</filename>).  In order for Debian to provide pre-built installable packages, it modifies the build system to install programs into a file tree image created under a temporary directory instead of the actual destination.
it: Normalmente, <citerefentry> <refentrytitle>make</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> è usato per costruire automaticamente il programma, invece l'esecuzione di <literal>make install</literal> installa il programma direttamente nella destinazione prestabilita (configurata nella sezione <literal>install</literal> nel file <filename>Makefile</filename>).  Per far in modo che Debian fornisca dei pacchetti installabili pre-compilati, viene modificato il sistema di compilazione in modo da installare i programmi in un'immagine dell'albero dei file, creata dentro una directory temporanea, anziché nella destinazione prestabilita.

note: type: Content of: <book><chapter><section><para>
en: These two differences between normal program installation on one hand and the Debian packaging system on the other can be transparently addressed by the <systemitem role="package">debhelper</systemitem> package through the <command>dh_auto_configure</command> and <command>dh_auto_install</command> commands if the following conditions are met:
it: Le 2 differenze tra la normale installazione di un programma e l'installazione tramite il sistema di pacchettizzazione Debian può essere affrontato in modo trasparente dal pacchetto <systemitem role="package">debhelper</systemitem>, attraverso i comandi <command>dh_auto_configure</command> e <command>dh_auto_install</command>, se le seguenti condizioni sono soddisfatte:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para><footnote><para>
en: See <ulink url="&gnu-destdir;">GNU Coding Standards: 7.2.4 DESTDIR: Support for Staged Installs</ulink>.
it: Vedere <ulink url="&gnu-destdir;">GNU Coding Standards: 7.2.4 DESTDIR: Support for Staged Installs</ulink>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The <filename>Makefile</filename> must follow GNU conventions and support the <literal>$(DESTDIR)</literal> variable.  <placeholder type="footnote" id="0"/>
it: Il file <filename>Makefile</filename> deve seguire le convenzioni GNU e supportare la variabile <literal>$(DESTDIR)</literal>.  <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The source must follow the Filesystem Hierarchy Standard (FHS).
it: Il sorgente deve essere conforme allo Standard di Gerarchia dei Filesystem (FHS).

note: type: Content of: <book><chapter><section><para>
en: Programs that use GNU <command>autoconf</command> follow the GNU conventions automatically, so they can be trivial to package.  On the basis of this and other heuristics, it is estimated that the <systemitem role="package">debhelper</systemitem> package will work for about 90% of packages without making any intrusive changes to their build system.  So packaging is not as complicated as it may seem.
it: I programmi che usano GNU <command>autoconf</command> sono automaticamente conformi alle convenzioni GNU e la loro pacchettizzazione può essere molto semplice.  Con questi ed altri accorgimenti, si stima che il pacchetto <systemitem role="package">debhelper</systemitem> funzioni su quasi il 90% dei pacchetti senza apportare pesanti modifiche al loro sistema di compilazione.  La pacchettizzazione non è così complicata come potrebbe sembrare.

note: type: Content of: <book><chapter><section><para>
en: If you need to make changes in the <filename>Makefile</filename>, you should be careful to support the <literal>$(DESTDIR)</literal> variable.  Although it is unset by default, the <literal>$(DESTDIR)</literal> variable is prepended to each file path used for the program installation.  The packaging script will set <literal>$(DESTDIR)</literal> to the temporary directory.
it: Se è necessario apportare delle modifiche al <filename>Makefile</filename>, si dovrebbe fare attenzione a supportare la variabile <literal>$(DESTDIR)</literal>.  Anche se non è impostata di default, la variabile <literal>$(DESTDIR)</literal> viene anteposta ad ogni percorso usato per l'installazione del programma.  Lo script di pacchettizzazione imposta la variabile <literal>$(DESTDIR)</literal> nella directory temporanea.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: For a source package generating multiple binary packages, the <command>dh_auto_install</command> command uses <filename>debian/tmp</filename> as the temporary directory while the <command>dh_install</command> command with the help of <filename>debian/<replaceable>package-1</replaceable>.install</filename> and <filename>debian/<replaceable>package-2</replaceable>.install</filename> files will split the contents of <filename>debian/tmp</filename> into <filename>debian/<replaceable>package-1</replaceable></filename> and <filename>debian/<replaceable>package-2</replaceable></filename> temporary directories, to create <filename><replaceable>package-1</replaceable>_*.deb</filename> and <filename><replaceable>package-2</replaceable>_*.deb</filename> binary packages.
it: Per il pacchetto sorgente che genera pacchetti binari multipli, il comando <command>dh_auto_install</command> utilizza la directory temporanea <filename>debian/tmp</filename>, mentre il comando <command>dh_install</command>, con l'aiuto dei file <filename>debian/<replaceable>pacchetto-1</replaceable>.install</filename> e <filename>debian/<replaceable>pacchetto-2</replaceable>.install</filename> suddivide il contenuto di <filename>debian/tmp</filename> nelle directory temporanee <filename>debian/<replaceable>pacchetto-1</replaceable></filename> e <filename>debian/<replaceable>pacchetto-2</replaceable></filename> per creare pacchetti binari <filename><replaceable>pacchetto-1</replaceable>_*.deb</filename> e <filename><replaceable>pacchetto-2</replaceable>_*.deb</filename>.

note: type: Content of: <book><chapter><section><para>
en: For a source package generating a single binary package, the temporary directory used by the <command>dh_auto_install</command> command will be set to <filename>debian/<replaceable>package</replaceable></filename>.  <placeholder type="footnote" id="0"/> Everything that is contained in the temporary directory will be installed on users' systems when they install your package; the only difference is that <command>dpkg</command> will be installing the files to paths relative to the root directory rather than your working directory.
it: Per il pacchetto sorgente che genera un singolo pacchetto binario, la directory temporanea, utilizzata dal comando <command>dh_auto_install</command>, è <filename>debian/<replaceable>pacchetto</replaceable></filename>.  <placeholder type="footnote" id="0"/> Tutto quello contenuto nella directory temporanea verrà installato sul sistema dell'utente, appena si installa il pacchetto, l'unica differenza è che <command>dpkg</command> installerà i file nella radice del file system anzichè nella directory di lavoro.

note: type: Content of: <book><chapter><section><para>
en: Bear in mind that even though your program installs in <filename>debian/<replaceable>package</replaceable></filename>, it still needs to behave correctly when installed from the <filename>.deb</filename> package under the root directory.  So you must not allow the build system to hardcode strings like <literal>/home/me/deb/<replaceable>package</replaceable>-<replaceable>version</replaceable>/usr/share/<replaceable>package</replaceable></literal> into files in the package.
it: Bisogna tenere in considerazione che, anche se il programma viene installato in <filename>debian/<replaceable>pacchetto</replaceable></filename>, deve comunque potersi installare nella directory radice dal pacchetto <filename>.deb</filename>.  Per questo motivo non bisogna consentire al sistema di compilazione di utilizzare stringhe impostate manualmente come costanti, ad esempio <literal>/home/me/deb/<replaceable>pacchetto</replaceable>-<replaceable>versione</replaceable>/usr/share/<replaceable>pacchetto</replaceable></literal> nei file del pacchetto.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: This is just an example to show what a <filename>Makefile</filename> should look like.  If the <filename>Makefile</filename> is created by the <command>./configure</command> command, the correct way to fix this kind of <filename>Makefile</filename> is to execute <command>./configure</command> from the <command>dh_auto_configure</command> command with default options including <literal>--prefix=/usr</literal>.
it: Questo è solo un esempio che mostra come un <filename>Makefile</filename> dovrebbe apparire.  Se il <filename>Makefile</filename> è creato dal comando <command>./configure</command>, il modo giusto per correggere il <filename>Makefile</filename> è eseguire il comando <command>./configure</command> dal comando <command>dh_auto_configure</command> includendo come opzione predefinita <literal>--prefix=/usr</literal>.

note: type: Content of: <book><chapter><section><para>
en: Here's the relevant part of <systemitem role="package">gentoo</systemitem>'s <filename>Makefile</filename><placeholder type="footnote" id="0"/>:
it: Questa è la parte più importante del <filename>Makefile</filename> del pacchetto <systemitem role="package">gentoo</systemitem> <placeholder type="footnote" id="0"/>:

note: type: Content of: <book><chapter><section><para>
en: We see that the files are set to install under <filename>/usr/local</filename>.  As explained above, that directory hierarchy is reserved for local use on Debian, so change those paths as follows:
it: Da notare che i file verranno installati in <filename>/usr/local</filename>.  Come descritto sopra, questa directory, in Debian, è riservata per l'utilizzo locale, si modifichino questi percorsi con:

note: type: Content of: <book><chapter><section><para>
en: The exact locations that should be used for binaries, icons, documentation, etc. are specified in the Filesystem Hierarchy Standard (FHS).  You should browse through it and read the sections relevant to your package.
it: Le posizioni che dovrebbero essere usate per i binari, le icone, la documentazione, ecc. sono specificate nella Gerarchia dei Filesystem (FHS).  Si consiglia di sfogliarlo e leggere le sezioni riguardanti il pacchetto interessato.

note: type: Content of: <book><chapter><section><para>
en: So, we should install executable commands in <filename>/usr/bin</filename> instead of <filename>/usr/local/bin</filename>, the manual page in <filename>/usr/share/man/man1</filename> instead of <filename>/usr/local/man/man1</filename>, and so on.  Notice how there's no manual page mentioned in <systemitem role="package">gentoo</systemitem>'s <filename>Makefile</filename>, but since Debian Policy requires that every program has one, we'll make one later and install it in <filename>/usr/share/man/man1</filename>.
it: Si dovrà installare, quindi, il file eseguibile in <filename>/usr/bin</filename> anziché in <filename>/usr/local/bin</filename>, la pagina di manuale in <filename>/usr/share/man/man1</filename> anziché <filename>/usr/local/man/man1</filename>, ecc.  Da notare che nel <filename>Makefile</filename> del pacchetto <systemitem role="package">gentoo</systemitem> non è presente una pagina di manuale, ma dal momento che la policy di Debian prevede che ogni programma ne abbia una, ne verrà creata una e sarà installata in <filename>/usr/share/man/man1</filename>.

note: type: Content of: <book><chapter><section><para>
en: Some programs don't use <filename>Makefile</filename> variables to define paths such as these.  This means you might have to edit some real C sources in order to fix them to use the right locations.  But where to search, and exactly what for? You can find this out by issuing:
it: Alcuni programmi non usano le variabili nel <filename>Makefile</filename> per definire dei percorsi come questi.  Questo indica che potrebbe essere necessario modificare qualche sorgente in C, per fargli usare il percorso giusto.  Ma dove cercarlo, e per farci cosa? Lo si può scoprire eseguendo questo:

note: type: Content of: <book><chapter><section><para>
en: <command>grep</command> will run recursively through the source tree and tell you the filename and the line number for all matches.
it: <command>grep</command> cercherà tutte le corrispondenze in maniera ricorsiva attraverso tutto l'albero dei sorgenti, indicando il nome del file e il numero della riga.

note: type: Content of: <book><chapter><section><para>
en: Edit those files and in those lines replace <literal>usr/local/lib</literal> with <literal>usr/lib</literal>.  This can be done automatically as follows:
it: Si modifichino quei file in quelle righe, sostituendo <literal>usr/local/lib</literal> con <literal>/usr/lib</literal>. Questo può essere fatto automaticamente, come mostrato di seguito:

note: type: Content of: <book><chapter><section><para>
en: If you want to confirm each substitution instead, this can be done interactively as follows:
it: Se invece si vuole dare la conferma per ogni sostituzione, si può utilizzare il seguente comando:

note: type: Content of: <book><chapter><section><para>
en: Next you should find the <literal>install</literal> target (searching for the line that starts with <literal>install:</literal> will usually work) and rename all references to directories other than ones defined at the top of the <filename>Makefile</filename>.
it: A questo punto si dovrebbe trovare il target <literal>install</literal> (si cerchi la riga che inizia con <literal>install:</literal>, di solito è quella corretta) e modificare tutti i riferimenti alle directory diverse da quelle definite nel <filename>Makefile</filename>.

note: type: Content of: <book><chapter><section><para>
en: Originally, <systemitem role="package">gentoo</systemitem>'s <literal>install</literal> target said:
it: Originariamente, il target del pacchetto <systemitem role="package">gentoo</systemitem> riporterà:

note: type: Content of: <book><chapter><section><para>
en: Let's fix this upstream bug and record it with the <command>dquilt</command> command as <filename>debian/patches/install.patch</filename>.
it: Si può correggere e registrare la modifica con il comando <command>dquilt</command> salvandola come <filename>debian/patches/install.patch</filename>.

note: type: Content of: <book><chapter><section><para>
en: In your editor, change this for the Debian package as follows:
it: Per il pacchetto debian si modifichi come segue, utilizzando un editor:

note: type: Content of: <book><chapter><section><para>
en: You'll have noticed that there's now an <literal>install -d</literal> command before the other commands in the rule.  The original <filename>Makefile</filename> didn't have it because usually <literal>/usr/local/bin</literal> and other directories already exist on the system where you are running <literal>make install</literal>.  However, since we will be installing into a newly created private directory tree, we will have to create each and every one of those directories.
it: Si sarà fatto caso che adesso c'è un comando <literal>install -d</literal> prima degli altri, nella regola.  Il <filename>Makefile</filename> originale non ce l'ha perché generalmente usa <literal>/usr/local/bin</literal> e altre directory che già esistono nel sistema su cui si esegue <literal>make install</literal>.  Tuttavia, dal momento che verrà installato nella nostra directory vuota (o anche inesistente), si dovrà creare ogni singola directory.

note: type: Content of: <book><chapter><section><para>
en: We can also add in other things at the end of the rule, like the installation of additional documentation that the upstream authors sometimes omit:
it: È possibile anche aggiungere altre cose alla fine della regola, come l'installazione di documentazione aggiuntiva che gli autori originali talvolta omettono:

note: type: Content of: <book><chapter><section><para>
en: Check carefully, and if everything is okay, ask <command>dquilt</command> to generate the patch to create <filename>debian/patches/install.patch</filename> and add its description:
it: Dopo un'attenta analisi, se tutto è andato bene, si può generare con <command>dquilt</command> la patch che crea il file <filename>debian/patches/install.patch</filename> ed aggiungendogli una descrizione:

note: type: Content of: <book><chapter><section><para>
en: Now you have a series of patches.
it: Adesso si avranno una serie di patch.

note: type: Content of: <book><chapter><section><orderedlist><listitem><para>
en: Upstream bug fix: <filename>debian/patches/fix-gentoo-target.patch</filename>
it: Correzione del bug riguardante il sorgente originale: <filename>debian/patches/fix-gentoo-target.patch</filename>

note: type: Content of: <book><chapter><section><orderedlist><listitem><para>
en: Debian specific packaging modification: <filename>debian/patches/install.patch</filename>
it: Modifica specifica per il sistema di pacchettizzazione Debian: <filename>debian/patches/install.patch</filename>

note: type: Content of: <book><chapter><section><para>
en: Whenever you make changes that are not specific to the Debian package such as <filename>debian/patches/fix-gentoo-target.patch</filename>, be sure to send them to the upstream maintainer so they can be included in the next version of the program and be useful to everyone else.  Also remember to avoid making your fixes specific to Debian or Linux &#x2014; or even Unix! Make them portable.  This will make your fixes much easier to apply.
it: Ogni volta che si apportano delle modifiche che non sono specificatamente legate alla pacchettizzazione Debian, come <filename>debian/patches/fix-gentoo-target.patch</filename>, bisogna assicurarsi di inviare le modifiche al manutentore originale, in modo che possano essere incluse nella prossima versione del programma e possano beneficiarne altri utenti.  Ci si ricordi, di creare delle correzioni portabili, ovvero di non renderle specifiche per Debian o Linux &#x2014; o altri Unix!.  Questo renderà più semplice applicare le correzioni.

note: type: Content of: <book><chapter><section><para>
en: Note that you don't have to send the <filename>debian/*</filename> files upstream.
it: Da notare che non è necessario inviare i file <filename>debian/*</filename> all'autore originale.

note: type: Content of: <book><chapter><section><title>
en: Differing libraries
it: Distinguere le librerie

note: type: Content of: <book><chapter><section><para>
en: There is one other common problem: libraries are often different from platform to platform.  For example, a <filename>Makefile</filename> can contain a reference to a library that doesn't exist on the Debian system.  In that case, we need to change it to a library that does exist in Debian, and serves the same purpose.
it: C'è un altro problema comune: le librerie sono spesso diverse da piattaforma a piattaforma.  Per esempio, il <filename>Makefile</filename> può contenere un riferimento a una libreria che non esiste nei sistemi Debian.  In tal caso occorre cambiare il riferimento ad una libreria che serve allo stesso scopo e che esista in Debian.

note: type: Content of: <book><chapter><section><para>
en: Let's assume a line in your program's <filename>Makefile</filename> (or <filename>Makefile.in</filename>) as the following.
it: Supponiamo che una riga nel <filename>Makefile</filename> del programma (o nel <filename>Makefile.in</filename>) che riporta qualcosa come segue.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: If there are API changes from the <literal>foo</literal> library to the <literal>foo2</literal> library, required changes to the source code need to be made to match the new API.
it: Se ci sono modifiche delle API dalla libreria<literal>foo</literal> alla libreria <literal>foo2</literal>, le modifiche necessarie per il codice sorgente devono essere fatte basandosi sulle nuove API.

note: type: Content of: <book><chapter><section><para>
en: If your program doesn't compile since the <literal>foo</literal> library doesn't exist and its equivalent is provided by the <literal>foo2</literal> library on the Debian system, you can fix this build problem as <filename>debian/patches/foo2.patch</filename> by changing <literal>foo</literal> into <literal>foo2</literal>:<placeholder type="footnote" id="0"/>
it: Se il programma non viene compilato perché la libreria <literal>foo</literal> non esiste e il suo equivalente, su un sistema Debian, è fornito dalla libreria <literal>foo2</literal>, è possibile risolvere questo problema di compilazione, modificando il file <filename>debian/patches/foo2.patch</filename> cambiando <literal>foo</literal> con <literal>foo2</literal>: <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><title>
en: Required files under the <filename>debian</filename> directory
it: File richiesti nella directory <filename>debian</filename>

note: type: Content of: <book><chapter><para>
en: In this chapter, files in the <filename>debian</filename> directory are referred to without the leading <filename>debian/</filename> for simplicity whenever the meaning is obvious.
it: In questo capitolo, per semplicità, i file nella directory <filename>debian</filename> sono indicati senza la directory radice <filename>debian/</filename>, ogni volta che il loro significato è scontato.

note: type: Content of: <book><chapter><para>
en: There is a new subdirectory under the program's source directory, called <filename>debian</filename>.  There are a number of files in this directory that we should edit in order to customize the behavior of the package.  The most important of them are <filename>control</filename>, <filename>changelog</filename>, <filename>copyright</filename>, and <filename>rules</filename>, which are required for all packages.  <placeholder type="footnote" id="0"/>
it: C'è una nuova sottodirectory all'interno della cartella contenente i sorgenti del programma ed è chiamata <filename>debian</filename>.  All'interno di questa vi sono una serie di file che dovranno essere modificati per personalizzare il comportamento del pacchetto.  I più importanti fra tutti questi sono i file <filename>control</filename>, <filename>changelog</filename>, <filename>copyright</filename> e <filename>rules</filename>, che vengono richiesti per tutti i pacchetti.  <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: This file contains various values which <command>dpkg</command>, <command>dselect</command>, <command>apt-get</command>, <command>apt-cache</command>, <command>aptitude</command>, and other package management tools will use to manage the package.  It is defined by the <ulink url="&policy-control;">Debian Policy Manual, 5 "Control files and their fields"</ulink>.
it: Questo file contiene diversi valori che <command>dpkg</command>, <command>dselect</command>, <command>apt-get</command>, <command>apt-cache</command>, <command>aptitude</command>, ed altri strumenti utilizzeranno per gestire il pacchetto.  Il tutto è definito nel <ulink url="&policy-control;">Manuale delle policy di Debian, 5 "File di controllo ed i loro campi"</ulink>.

note: type: Content of: <book><chapter><section><para>
en: Here is the <filename>control</filename> file <command>dh_make</command> created for us:
it: Questo è il file di <filename>control</filename> che <command>dh_make</command> crea:

note: type: Content of: <book><chapter><section><para>
en: (I've added the line numbers.)
it: (Sono stati aggiunti i numeri di riga.)

note: type: Content of: <book><chapter><section><para>
en: Lines 1&#x2013;7 are the control information for the source package.  Lines 9&#x2013;13 are the control information for the binary package.
it: Le righe 1&#x2013;7 contengono le informazioni di controllo per il pacchetto sorgente.  Le righe 9-13 contengono le informazioni di controllo per il pacchetto binario.

note: type: Content of: <book><chapter><section><para>
en: Line 1 is the name of the source package.
it: La riga 1 contiene il nome del pacchetto sorgente.

note: type: Content of: <book><chapter><section><para>
en: Line 2 is the section of the distribution the source package goes into.
it: La riga 2 indica la sezione della distribuzione in cui il pacchetto sorgente dovrà andare.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&policy-subsections;">Debian Policy Manual, 2.4 "Sections"</ulink> and <ulink url="&sections-unstable;">List of sections in <literal>sid</literal></ulink>.
it: Vedere <ulink url="&policy-subsections;">Manuale delle policy di Debian, 2.4 "Sezioni"</ulink> e <ulink url="&sections-unstable;">Elenco delle sezioni in <literal>sid</literal></ulink>.

note: type: Content of: <book><chapter><section><para>
en: As you may have noticed, the Debian archive is divided into multiple areas: <literal>main</literal> (the free software), <literal>non-free</literal> (the not really free software) and <literal>contrib</literal> (free software that depends on non-free software).  Each of these is divided into sections that classify packages into rough categories.  So we have <literal>admin</literal> for administrator-only programs, <literal>devel</literal> for programmer tools, <literal>doc</literal> for documentation, <literal>libs</literal> for libraries, <literal>mail</literal> for email readers and daemons, <literal>net</literal> for network apps and daemons, <literal>x11</literal> for X11 programs that don't fit anywhere else, and many more.  <placeholder type="footnote" id="0"/>
it: Come si sarà notato, l'archivio Debian è diviso in diverse aree: <literal>main</literal> (software libero), <literal>non-free</literal> (software non propriamente libero) e <literal>contrib</literal> (software libero che dipende da software non libero).  All'interno di queste esistono delle sezioni che descrivono brevemente quali pacchetti vi si possono trovare.  Quindi si hanno le sezioni <literal>admin</literal> per i programmi legati all'amministrazione di sistema, <literal>base</literal> per gli strumenti di base, <literal>devel</literal> per gli strumenti di sviluppo, <literal>doc</literal> per la documentazione, <literal>libs</literal> per le librerie, <literal>mail</literal> per client di posta e server associati, <literal>net</literal> per applicazioni e servizi di rete, <literal>x11</literal> per programmi X11 che non appartengono alle altre categorie, e tanti altri. <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: Let's change it then to x11.  (A <literal>main/</literal> prefix is implied so we can omit it.)
it: Si può cambiare il valore in x11.  (Il prefisso <literal>main/</literal> è implicito e può essere omesso.)

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&policy-priorities;">Debian Policy Manual, 2.5 "Priorities"</ulink>.
it: Vedere <ulink url="&policy-priorities;">Manuale delle policy di Debian, 2.5 "Priorità"</ulink>.

note: type: Content of: <book><chapter><section><para>
en: Line 3 describes how important it is that the user installs this package.  <placeholder type="footnote" id="0"/>
it: La riga numero 3 indica quanto sia importante per l'utente installare questo pacchetto. <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The <literal>optional</literal> priority will usually work for new packages that do not conflict with others claiming <literal>required</literal>, <literal>important</literal>, or <literal>standard</literal> priority.
it: La priorità <literal>optional</literal> solitamente viene usata per i nuovi pacchetti che non vanno in conflitto con altri pacchetti con priorità <literal>required</literal>, <literal>important</literal> o <literal>standard</literal>.

note: type: Content of: <book><chapter><section><para>
en: Section and priority are used by front-ends like <command>aptitude</command> when they sort packages and select defaults.  Once you upload the package to Debian, the value of these two fields can be overridden by the archive maintainers, in which case you will be notified by email.
it: Le sezioni e le priorità vengono solitamente utilizzate da interfacce come <command>aptitude</command> in cui i pacchetti vengono suddivisi e vengono selezionati quelli predefiniti.  Una volta caricato il pacchetto in Debian, il valore di ciascuno di questi due campi può essere sovrascritto dai manutentori dell'archivio, in tal caso si verrà avvertiti via mail.

note: type: Content of: <book><chapter><section><para>
en: As this is a normal priority package and doesn't conflict with anything else, we will change the priority to <literal>optional</literal>.
it: Dal momento che il pacchetto trattato ha una priorità normale e non va in conflitto con altri, si cambierà la priorità a <literal>optional</literal>.

note: type: Content of: <book><chapter><section><para>
en: Line 4 is the name and email address of the maintainer.  Make sure that this field includes a valid <literal>To</literal> header for email, because after you upload it, the bug tracking system will use it to deliver bug emails to you.  Avoid using commas, ampersands, or parentheses.
it: La riga 4 indica il nome e l'indirizzo email del manutentore.  Ci si assicuri che questo campo includa una testata <literal>To</literal> valida per un indirizzo mail, perché una volta caricato il pacchetto, il sistema di rilevazione bug la userà per inviare le mail contenenti i bug.  Si eviti di utilizzare virgole, 'e' commerciali o parentesi.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&policy-relationships;#s-sourcebinarydeps">Debian Policy Manual, 7.7 "Relationships between source and binary packages - Build-Depends, Build-Depends-Indep, Build-Conflicts, Build-Conflicts-Indep"</ulink>.
it: Vedere <ulink url="&policy-relationships;#s-sourcebinarydeps">Manuale delle policy di Debian, 7.7 "Relazioni tra pacchetti sorgenti e i pacchetti  binari - Build-Depends, Build-Depends-Indep, Build-Conflicts, Build-Conflicts-Indep"</ulink>.

note: type: Content of: <book><chapter><section><para>
en: Line 5 includes the list of packages required to build your package as the <literal>Build-Depends</literal> field.  You can also have the <literal>Build-Depends-Indep</literal> field as an additional line here.  <placeholder type="footnote" id="0"/> Some packages like <systemitem role="package">gcc</systemitem> and <systemitem role="package">make</systemitem> which are required by the <systemitem role="package">build-essential</systemitem> package are implied.  If you need to have other tools to build your package, you should add them to these fields.  Multiple entries are separated with commas; read on for the explanation of binary package dependencies to find out more about the syntax of these lines.
it: La riga 5 include la lista dei pacchetti richiesti per costruire il pacchetto, ad es.  il campo <literal>Build-Depends</literal>.  Si può, inoltre, avere una riga contenente il campo <literal>Build-Depends-Indep</literal>. <placeholder type="footnote" id="0"/> .  Alcuni pacchetti come <systemitem role="package">gcc</systemitem> e <systemitem role="package">make</systemitem> sono richiesti implicitamente, dal pacchetto <systemitem role="package">build-essential</systemitem>.  Se si ha la necessità di avere altri strumenti per costruire il pacchetto, questi devono essere aggiunti negli appositi campi.  I campi multipli sono separati con le virgole; si legga una spiegazione sulle dipendenze binarie per scoprirne di più sulla sintassi di queste righe.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: For all packages packaged with the <command>dh</command> command in the <filename>debian/rules</filename> file, you must have <literal>debhelper (&gt;=9)</literal> in the <literal>Build-Depends</literal> field to satisfy the Debian Policy requirement for the <literal>clean</literal> target.
it: Per tutti i pacchetti creati utilizzando il comando <command>dh</command> nel file <filename>debian/rules</filename>, è necessario avere <literal>debhelper (&gt;=9)</literal> nel campo <literal>Build-Depends</literal>, per aderire alle policy di Debian che richiedono per l'obiettivo <literal>clean</literal>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Source packages which have binary packages with <literal>Architecture: any</literal> are rebuilt by the autobuilder.  Since this autobuilder procedure installs only the packages listed in the <literal>Build-Depends</literal> field before running <literal>debian/rules build</literal> (see <xref linkend="autobuilder"/>), the <literal>Build-Depends</literal> field needs to list practically all the required packages, and <literal>Build-Depends-Indep</literal> is rarely used.
it: I sorgenti dei pacchetti che hanno i pacchetti binari con il campo <literal>Architecture: any</literal>, vengono ricompilati con autobuilder. Poichè questa procedura installa i soli pacchetti elencati nel campo <literal>Build-Depends</literal>, prima di eseguire <literal>debian/rules build</literal> (vedere <xref linkend="autobuilder"/>), il campo <literal>Build-Depends</literal> ha bisogno di tutti i pacchetti necessari, ed il campo <literal>Build-Depends-Indep</literal> è raramente utilizzato.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: For source packages with binary packages all of which are <literal>Architecture: all</literal>, the <literal>Build-Depends-Indep</literal> field may list all the required packages unless they are already listed in the <literal>Build-Depends</literal> field to satisfy the Debian Policy requirement for the <literal>clean</literal> target.
it: Per i sorgenti dei pacchetti che hanno i pacchetti binari con campo <literal>Architecture: all</literal>, il campo <literal>Build-Depends-Indep</literal> elenca tutti i pacchetti necessari, se non sono già elencati nel campo <literal>Build-Depends</literal>, per essere conforme alle linee guida di Debian riguardanti il target <literal>clean</literal>.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: This somewhat strange situation is a feature well documented in the <ulink url="&policy-build-depends-indep;">Debian Policy Manual, Footnotes 55</ulink>.  This is not due to the use of the <command>dh</command> command in the <filename>debian/rules</filename> file but due to how the <command>dpkg-buildpackage</command> works.  The same situation applies to the <ulink url="https://bugs.launchpad.net/launchpad-buildd/+bug/238141">auto build system for Ubuntu</ulink>.
it: Questa strana situazione è ben documentata in <ulink url="&policy-build-depends-indep;">Debian Policy Manual, Footnotes 55</ulink>.  Questo non è dovuto all'uso del comando <command>dh</command> nel file <filename>debian/rules</filename>, ma bensì al funzionamento di <command>dpkg-buildpackage</command>.La stessa situazione si presenta per il <ulink url="https://bugs.launchpad.net/launchpad-buildd/+bug/238141">sistema automatico di compilazione di Ubuntu</ulink>.

note: type: Content of: <book><chapter><section><para>
en: If you are not sure which one should be used, use the <literal>Build-Depends</literal> field to be on the safe side.  <placeholder type="footnote" id="0"/>
it: Se non si è sicuri sul campo da utilizzare, si può scegliere il campo <literal>Build-Depends</literal>.<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: To find out what packages your package needs to be built run the command:
it: Per scoprire di quali pacchetti si ha bisogno per la compilazione si può eseguire il comando:

note: type: Content of: <book><chapter><section><para>
en: To manually find exact build dependencies for <command><replaceable>/usr/bin/foo</replaceable></command>, execute
it: Per scoprire manualmente le esatte dipendenze per <command><replaceable>/usr/bin/foo</replaceable></command>, basta eseguire

note: type: Content of: <book><chapter><section><para>
en: and for each library listed (e.g., <command>libfoo.so.6</command>), execute
it: e per ogni libreria elencata (ad esempio, <command>libfoo.so.6</command>), si esegue

note: type: Content of: <book><chapter><section><para>
en: Then just take the <literal>-dev</literal> version of every package as a <literal>Build-Depends</literal> entry.  If you use <command>ldd</command> for this purpose, it will report indirect lib dependencies as well, resulting in the problem of excessive build dependencies.
it: A questo punto si indica la versione <literal>-dev</literal> di ogni pacchetto come voce <literal>Build-Depends</literal>.  Se si usa <command>ldd</command> per questo scopo, verranno considerate anche le dipendenze indirette, il che potrà portare ad avere un numero eccessivo di dipendenze.

note: type: Content of: <book><chapter><section><para>
en: <systemitem role="package">gentoo</systemitem> also happens to require <systemitem role="package">xlibs-dev</systemitem>, <systemitem role="package">libgtk1.2-dev</systemitem> and <systemitem role="package">libglib1.2-dev</systemitem> to build, so we'll add them here next to <systemitem role="package">debhelper</systemitem>.
it: Il pacchetto <systemitem role="package">gentoo</systemitem> richiede anche <systemitem role="package">xlibs-dev</systemitem>, <systemitem role="package">libgtk1.2-dev</systemitem> e <systemitem role="package">libglib1.2-dev</systemitem> per poter essere costruito, quindi tali dipendenze si aggiungeranno subito dopo <systemitem role="package">debhelper</systemitem>.

note: type: Content of: <book><chapter><section><para>
en: Line 6 is the version of the <ulink url="&debian-policy;">Debian Policy Manual</ulink> standards this package follows, the one you read while making your package.
it: La riga 6 indica la versione delle delle <ulink url="&debian-policy;">linee guida Debian</ulink> che il pacchetto deve rispettare, che corrisponde a quello che si legge quando lo si crea.

note: type: Content of: <book><chapter><section><para>
en: On line 7 you can put the URL of the software's upstream homepage.
it: Nella riga 7 si può inserire l'URL della pagina del programma originale.

note: type: Content of: <book><chapter><section><para>
en: Line 9 is the name of the binary package.  This is usually the same as the name of the source package, but it doesn't necessarily have to be that way.
it: La riga 9 indica il nome del pacchetto binario.  Questo è normalmente lo stesso nome del pacchetto sorgente, ma non deve essere necessariamente così.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&policy-architecture;">Debian Policy Manual, 5.6.8 "Architecture"</ulink> for exact details.
it: Vedere <ulink url="&policy-architecture;">Manuale delle policy di Debian, 5.6.8 "Architettura"</ulink> per maggiori informazioni.

note: type: Content of: <book><chapter><section><para>
en: Line 10 describes the architectures the binary package can be compiled for.  This value is usually one of the following depending on the type of the binary package: <placeholder type="footnote" id="0"/>
it: La riga 10 specifica le architetture per cui è possibile compilare il pacchetto. Questo valore è di solito uno dei seguenti, a seconda del tipo di pacchetto binario:  <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: The generated binary package is an architecture dependent one usually in a compiled language.
it: Il pacchetto binario generato è compatibile con una sola architettura, solitamente è utilizzato in programmi creati con un linguaggio compilato.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: The generated binary package is an architecture independent one usually consisting of text, images, or scripts in an interpreted language.
it: Il pacchetto binario generato è indipendente dall'architettura, di solito si tratta di testo, immagini o script in un linguaggio interpretato.

note: type: Content of: <book><chapter><section><para>
en: We leave line 10 as is since this is written in C.  <citerefentry><refentrytitle>dpkg-gencontrol</refentrytitle><manvolnum>1</manvolnum></citerefentry> will fill in the appropriate architecture value for any machine this source package gets compiled on.
it: Si lasci la riga 10 così com'è visto che il programma è scritto in C.<citerefentry><refentrytitle>dpkg-gencontrol</refentrytitle><manvolnum>1</manvolnum></citerefentry> riempirà il campo dell'architettura con un valore adeguato per ciascuna macchina in cui il pacchetto viene compilato.

note: type: Content of: <book><chapter><section><para>
en: If your package is architecture independent (for example, a shell or Perl script, or a document), change this to <literal>all</literal>, and read later in <xref linkend="rules"/> about using the <literal>binary-indep</literal> rule instead of <literal>binary-arch</literal> for building the package.
it: Se il pacchetto è indipendente dall'architettura (per esempio, uno script shell o Perl, o un documento), si cambi questo valore in <literal>all</literal>, e si legga in seguito in <xref linkend="rules"/> riguardo l'utilizzo della regola <literal>binary-indep</literal> al posto di <literal>binary-arch</literal> per costruire il pacchetto.

note: type: Content of: <book><chapter><section><para>
en: Line 11 shows one of the most powerful features of the Debian packaging system.  Packages can relate to each other in various ways.  Apart from <literal>Depends</literal>, other relationship fields are <literal>Recommends</literal>, <literal>Suggests</literal>, <literal>Pre-Depends</literal>, <literal>Breaks</literal>, <literal>Conflicts</literal>, <literal>Provides</literal>, and <literal>Replaces</literal>.
it: La riga 11 mostra una delle caratteristiche più potenti del sistema di pacchettizzazione Debian. I pacchetti possono relazionarsi tra di loro in vari modi. A parte <literal>Depends</literal>, altri campi di relazione sono <literal>Recommends</literal>, <literal>Suggests</literal>, <literal>Pre-Depends</literal>, <literal>Breaks</literal>, <literal>Conflicts</literal>, <literal>Provides</literal> e <literal>Replaces</literal>.

note: type: Content of: <book><chapter><section><para>
en: The package management tools usually behave the same way when dealing with these relations; if not, it will be explained.  (See <citerefentry> <refentrytitle>dpkg</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>dselect</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>apt</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>aptitude</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, etc.)
it: Gli strumenti di gestione dei pacchetti solitamente si comportano allo stesso modo quando si occupano di tali relazioni; in caso contrario, il comportamento verrà spiegato.  (si legga <citerefentry> <refentrytitle>dpkg</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>dselect</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>apt</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>aptitude</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> ecc.)

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&policy-relationships;">Debian Policy Manual, 7 "Declaring relationships between packages"</ulink>.
it: Vedere <ulink url="&policy-relationships;">Manuale delle policy di Debian, 7 "Dichiarare le relazioni tra i pacchetti"</ulink>.

note: type: Content of: <book><chapter><section><para>
en: Here is a simplified description of package relationships: <placeholder type="footnote" id="0"/>
it: Ecco una descrizione semplificata delle relazioni tra i pacchetti: <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The package will not be installed unless the packages it depends on are installed.  Use this if your program absolutely will not run (or will cause severe breakage) unless a particular package is present.
it: Il pacchetto non verrà installato a meno che tutti i pacchetti da cui dipende vengono installati.  Si usi questa relazione se il programma non funzionerà assolutamente (o sarà praticamente inutilizzabile) a meno della presenza di particolari pacchetti.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Use this for packages that are not strictly necessary but are typically used with your program.  When a user installs your program, all front-ends will probably prompt them to install the recommended packages.  <command>aptitude</command> and <command>apt-get</command> install recommended packages along with your package by default (but the user can disable this behavior).  <command>dpkg</command> will ignore this field.
it: Si usi questa relazione per i pacchetti che non sono strettamente necessari ma sono solitamente utilizzati dal programma.  Quando un utente installa il programma, tutte le interfacce di APT probabilmente chiederanno l'installazione dei pacchetti raccomandati.  <command>aptitude</command> e <command>apt-get</command> installano, in modo predefinito, i pacchetti raccomandati insieme al pacchetto principale (ma l'utente può disabilitare questo comportamento predefinito).  <command>dpkg</command> ignorerà questo campo.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Use this for packages which will work nicely with your program but are not at all necessary.  When a user installs your program, they will probably not be prompted to install suggested packages.  <command>aptitude</command> can be configured to install suggested packages along with your package but this is not its default.  <command>dpkg</command> and <command>apt-get</command> will ignore this field.
it: Si usi questa relazione per pacchetti che funzionano bene con il programma ma non sono per niente necessari.  Quando un utente installa il programma, probabilmente non verrà chiesta l'installazione dei pacchetti consigliati.  <command>aptitude</command> può essere configurato per installare i pacchetti consigliati insieme al pacchetto principale ma questo non è il comportamento predefinito.  <command>dpkg</command> ed <command>apt-get</command> ignoreranno questo campo.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: This is stronger than <literal>Depends</literal>.  The package will not be installed unless the packages it pre-depends on are installed and <emphasis>correctly configured</emphasis>.  Use this <emphasis>very</emphasis> sparingly and only after discussing it on the <ulink url="&debian-devel-ldo;">debian-devel@lists.debian.org</ulink> mailing list.  Read: don't use it at all.  :-)
it: Questa relazione è più forte di <literal>Depends</literal>.  Il pacchetto non verrà installato a meno che i pacchetti da cui pre-dipende sono stati installati e <emphasis>correttamente configurati</emphasis>.  Si usi questa relazione con <emphasis>molta</emphasis> parsimonia e solo dopo averne discusso sulla mailing list <ulink url="&debian-devel-ldo;">debian-devel@lists.debian.org</ulink>.  Leggasi: non utilizzarla affatto.  :-)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The package will not be installed until all the packages it conflicts with have been removed.  Use this if your program absolutely will not run or will cause severe problems if a particular package is present.
it: Il pacchetto non verrà installato a meno che tutti i pacchetti con i quali va in conflitto siano rimossi.  Si usi questa relazione se il programma non funzionerà o causerà gravi problemi se un certo pacchetto è presente.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: When installed the package will break all the listed packages.  Normally a <literal>Breaks</literal> entry specifies that it applies to versions earlier than a certain value.  The resolution is generally to use higher-level package management tools to upgrade the listed packages.
it: Una volta installato il pacchetto verranno marcati come "guasti" tutti i pacchetti elencati.  Normalmente la voce <literal>Breaks</literal> specifica che si applica a version precedenti di un certo valore.  Per risolvere il problema, generalmente, basta aggiornare la lista dei pacchetti utilizzando uno strumento di gestione di alto livello, del sistema di pacchettizzazione.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: For some types of packages where there are multiple alternatives, virtual names have been defined.  You can get the full list in the <ulink url="&virtual-package;">virtual-package-names-list.txt.gz</ulink> file.  Use this if your program provides a function of an existing virtual package.
it: Per alcuni tipi di pacchetto di cui vi sono molteplici alternative, sono stati definiti dei nomi virtuali.  Si può trovare la lista completa nel file <ulink url="&virtual-package;">virtual-package-names-list.txt.gz</ulink>.  Si consulti questo file se il programma da pacchettizzare fornisce la funzione di un pacchetto virtuale esistente.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Use this when your program replaces files from another package, or completely replaces another package (used in conjunction with <literal>Conflicts</literal>).  Files from the named packages will be overwritten with the files from your package.
it: Si usi questa relazione quando il programma rimpiazza i file di un altro pacchetto, o lo rimpiazza completamente (utilizzato in congiunzione con <literal>Conflicts</literal>).  I file dei pacchetti indicati saranno sovrascritti con i file del nuovo pacchetto.

note: type: Content of: <book><chapter><section><para>
en: All these fields have uniform syntax.  They are a list of package names separated by commas.  These package names may also be lists of alternative package names, separated by vertical bar symbols <literal>|</literal> (pipe symbols).
it: Tutti i campi qui descritti hanno una sintassi uniforme.  Sono costituiti da una lista contenente i nomi dei pacchetti separati da virgole.  Questi possono essere anche costituiti da liste di nomi di pacchetto alternativi, separati da barre verticali <literal>|</literal> (simboli pipe).

note: type: Content of: <book><chapter><section><para>
en: The fields may restrict their applicability to particular versions of each named package.  The restriction of each individual package is listed in parentheses after its name, and should contain a relation from the list below followed by a version number value.  The relations allowed are: <literal>&lt;&lt;</literal>, <literal>&lt;=</literal>, <literal>=</literal>, <literal>&gt;=</literal>, and <literal>&gt;&gt;</literal> for strictly lower, lower or equal, exactly equal, greater or equal, and strictly greater, respectively.  For example,
it: I campi possono limitare la loro applicabilità a particolari versioni di ogni pacchetto indicato.  Le restrizioni di ogni singolo sono elencate tra parentesi dopo il nome de pacchetto, e dovrebbero contenere una relazione presa dalla lista qui sotto, seguita dal numero di versione.  Le relazioni permesse sono: <literal>&lt;&lt;</literal>, <literal>&lt;=</literal>, <literal>=</literal>, <literal>&gt;=</literal> e <literal>&gt;&gt;</literal> per strettamente inferiore, inferiore o uguale, esattamente uguale, superiore o uguale e strettamente superiore, rispettivamente.  Per esempio,

note: type: Content of: <book><chapter><section><para>
en: The last feature you need to know about is <literal>${shlibs:Depends}</literal>, <literal>${perl:Depends}</literal>, <literal>${misc:Depends}</literal>, etc.
it: L'ultima caratteristica utile da conoscere è <literal>${shlibs:Depends}</literal>, <literal>${perl:Depends}</literal>, <literal>${misc:Depends}</literal>, ecc.

note: type: Content of: <book><chapter><section><para>
en: <citerefentry> <refentrytitle>dh_shlibdeps</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> calculates shared library dependencies for binary packages.  It generates a list of <ulink url="&elf;">ELF</ulink> executables and shared libraries it has found for each binary package.  This list is used for substituting <literal>${shlibs:Depends}</literal>.
it: <citerefentry> <refentrytitle>dh_shlibdeps</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> calcola le dipendenze delle librerie condivise per i pacchetti binari. Questo genera un'elenco di eseguibili <ulink url="&elf;">ELF</ulink> e di librerie condivise che sono stati trovati in ogni pacchetto binario.  Questa lista è utilizzata per <literal>${shlibs:Depends}</literal>.

note: type: Content of: <book><chapter><section><para>
en: <citerefentry> <refentrytitle>dh_perl</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> calculates Perl dependencies.  It generates a list of a dependencies on <literal>perl</literal> or <literal>perlapi</literal> for each binary package.  This list is used for substituting <literal>${perl:Depends}</literal>.
it: <citerefentry> <refentrytitle>dh_perl</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> calcola le dipendenze perl. Questo genera un elenco di dipendenze <literal>perl</literal> o <literal>perlapi</literal> per ogni pacchetto binario. Questa lista è utilizzata per <literal>${perl:Depends}</literal>.

note: type: Content of: <book><chapter><section><para>
en: Some <systemitem role="package">debhelper</systemitem> commands may cause the generated package to depend on some additional packages.  All such commands generate a list of required packages for each binary package.  This list is used for substituting <literal>${misc:Depends}</literal>.
it: Alcuni comandi <systemitem role="package">debhelper</systemitem> possono far si che il pacchetto generato abbia bisogno di dipendere da altri pacchetti.  Questa lista di pacchetti richiesti è utilizzata per <literal>${misc:Depends}</literal>.

note: type: Content of: <book><chapter><section><para>
en: <citerefentry> <refentrytitle>dh_gencontrol</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> generates <filename>DEBIAN/control</filename> for each binary package while substituting <literal>${shlibs:Depends}</literal>, <literal>${perl:Depends}</literal>, <literal>${misc:Depends}</literal>, etc.
it: <citerefentry> <refentrytitle>dh_gencontrol</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> genera il file <filename>DEBIAN/control</filename> per ogni pacchetto binario che utilizza <literal>${shlibs:Depends}</literal>, <literal>${perl:Depends}</literal>, <literal>${misc:Depends}</literal>, ecc.

note: type: Content of: <book><chapter><section><para>
en: Having said all that, we can leave the <literal>Depends</literal> field exactly as it is now, and insert another line after it saying <literal>Suggests: file</literal>, because <systemitem role="package">gentoo</systemitem> can use some features provided by the <systemitem role="package">file</systemitem> package.
it: Detto ciò, si può lasciare la riga <literal>Depends</literal> esattamente come è ora, e si può inserire un'altra riga dopo questa che dica <literal>Suggests: file</literal>, perché <systemitem role="package">gentoo</systemitem> può utilizzare alcune caratteristiche fornite dal pacchetto <systemitem role="package">file</systemitem>.

note: type: Content of: <book><chapter><section><para>
en: Line 9 is the Homepage URL.  Let's assume this to be at <ulink url="&gentoo;"/>.
it: La riga 9 è l'URL dell'homepage. Supponiamo che questa sia <ulink url="&gentoo;"/> .

note: type: Content of: <book><chapter><section><para>
en: Line 12 is the short description.  Terminals are conventionally 80 columns wide so this shouldn't be longer than about 60 characters.  I'll change it to <literal>fully GUI-configurable, two-pane X file manager</literal>.
it: La riga 12 contiene una breve descrizione del pacchetto.  Usualmente la larghezza dei terminali è di 80 colonne quindi il contenuto non dovrebbe superare i 60 caratteri.  Si cambia questo valore in <literal>fully GUI-configurable, two-pane X file manager</literal>.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: These descriptions are in English.  Translations of these descriptions are provided by <ulink url="&ddtp;">The Debian Description Translation Project - DDTP</ulink>.
it: Queste descrizioni sono in inglese.  Le traduzioni di queste descrizioni sono fornite da <ulink url="&ddtp;">The Debian Description Translation Project - DDTP</ulink>.

note: type: Content of: <book><chapter><section><para>
en: Line 13 is where the long description goes.  This should be a paragraph which gives more details about the package.  Column 1 of each line should be empty.  There must be no blank lines, but you can put a single <literal>.</literal> (dot) in a column to simulate that.  Also, there must be no more than one blank line after the long description. <placeholder type="footnote" id="0"/>
it: Nella riga 13 va messa la descrizione lunga.  Questa dovrebbe consistere in un paragrafo che fornisce più dettagli sul pacchetto.  La prima colonna di ogni riga dovrebbe essere vuota.  Non ci dovrebbero essere linee vuote, ma si può mettere un singolo <literal>.</literal> (punto) in una colonna per simularle.  Inoltre non ci dovrebbe essere più di una linea vuota dopo questa descrizione. <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&devref-bpp-vcs;">Debian Developer's Reference, 6.2.5. "Version Control System location"</ulink>.
it: Vedere <ulink url="&devref-bpp-vcs;">Guida di riferimento per lo sviluppatore Debian, 6.2.5. "Version Control System location"</ulink>.

note: type: Content of: <book><chapter><section><para>
en: We can insert <literal>Vcs-*</literal> fields to document the Version Control System (VCS) location between lines 6 and 7.  <placeholder type="footnote" id="0"/> Let's assume that the <systemitem role="package">gentoo</systemitem> package has its VCS located in the Debian Alioth Git Service at <literal>git://git.debian.org/git/collab-maint/gentoo.git</literal>.
it: Si possono inseriscono i campi <literal>Vcs-*</literal> per documentare  il Version Control System (VCS) tra la linea 6 e 7.  <placeholder type="footnote" id="0"/>  Si supponga che il pacchetto <systemitem role="package">gentoo</systemitem> abbia il suo VCS nel servizio Git Debian Alioth su <literal>git://git.debian.org/git/collab-maint/gentoo.git</literal>.

note: type: Content of: <book><chapter><section><para>
en: Finally, here is the updated <filename>control</filename> file:
it: E per concludere, questo è il file <filename>control</filename> aggiornato:

note: type: Content of: <book><chapter><section><para>
en: This file contains information about the copyright and license of the upstream sources.  <ulink url="&policy-copyright;">Debian Policy Manual, 12.5 "Copyright information"</ulink> dictates its content and <ulink url="&dep5;">DEP-5: Machine-parseable <filename>debian/copyright</filename></ulink> provides guidelines for its format.
it: Questo file contiene le informazioni sul copyright e la licenza del programma originale. Il suo contenuto è descritto nel <ulink url="&policy-copyright;">Manuale delle policy di Debian, 12.5 'Informazioni di copyright'</ulink>, e il documento <ulink url="&dep5;">DEP-5: Machine-parseable debian/copyright</ulink> fornisce le linee guida del suo formato.

note: type: Content of: <book><chapter><section><para>
en: <command>dh_make</command> can give you a template <filename>copyright</filename> file.  Let's use the <literal>--copyright gpl2</literal> option here to get a template file for the <systemitem role="package">gentoo</systemitem> package released under GPL-2.
it: <command>dh_make</command> può fornire un modello di file del <filename>copyright</filename>, basta utilizzare l'opzione <literal>--copyright</literal> per selezionare quello giusto, se si desidera rilasciare il pacchetto <systemitem role="package">gentoo</systemitem> sotto licenza GPL-2.

note: type: Content of: <book><chapter><section><para>
en: In short, here's what <systemitem role="package">gentoo</systemitem>'s <filename>copyright</filename> file should look like:
it: Brevemente, ecco come il file di <filename>copyright</filename> del pacchetto <systemitem role="package">gentoo</systemitem> dovrebbe apparire:

note: type: Content of: <book><chapter><section><para>
en: Please follow the HOWTO provided by the ftpmasters and sent to debian-devel-announce: <ulink url="&howto-copyright;"/>.
it: Si prega di seguire l'HOWTO fornito da ftpmasters ed inviato a debian-devel-announce: <ulink url="&howto-copyright;"/>.

note: type: Content of: <book><chapter><section><para>
en: This is a required file, which has a special format described in <ulink url="&policy-dpkgchangelog;">Debian Policy Manual, 4.4 "debian/changelog"</ulink>.  This format is used by <command>dpkg</command> and other programs to obtain the version number, revision, distribution, and urgency of your package.
it: Questo è un file obbligatorio, che ha un formato speciale descritto nel <ulink url="&policy-dpkgchangelog;">Manuale delle policy di Debian, 4.4 "debian/changelog"</ulink>.  Questo formato è utilizzato da <command>dpkg</command> ed altri programmi per ottenere il numero di versione, revisione, distribuzione ed urgenza del pacchetto.

note: type: Content of: <book><chapter><section><para>
en: For you, it is also important, since it is good to have documented all changes you have done.  It will help people downloading your package to see whether there are issues with the package that they should know about.  It will be saved as <filename>/usr/share/doc/gentoo/changelog.Debian.gz</filename> in the binary package.
it: Tale file è anche utile allo scopo di aver documentato tutti i cambiamenti che sono stati fatti.  Sarà inoltre d'aiuto agli utenti che scaricano il pacchetto per vedere se ci sono problemi di cui dovrebbero essere al corrente.  Il file verrà salvato come <filename>/usr/share/doc/gentoo/changelog.Debian.gz</filename> nel pacchetto binario.

note: type: Content of: <book><chapter><section><para>
en: <command>dh_make</command> created a default one, and this is what it looks like:
it: <command>dh_make</command> ne crea uno predefinito, ecco come appare:

note: type: Content of: <book><chapter><section><para>
en: Line 1 is the package name, version, distribution, and urgency.  The name must match the source package name; distribution should be <literal>unstable</literal>, and urgency should be set to medium unless there is any particular reason for other values.
it: La riga 1 indica il nome del pacchetto, la versione, la distribuzione e l'urgenza.  Il nome deve corrispondere al nome del pacchetto sorgente, mentre la distribuzione dovrebbe essere <literal>unstable</literal>, e l'urgenza dovrebbe essere impostata come media, a meno chè non ci sia un motivo valido per impostarlo diversamente.

note: type: Content of: <book><chapter><section><para>
en: Lines 3-5 are a log entry, where you document changes made in this package revision (not the upstream changes &#x2014; there is a special file for that purpose, created by the upstream authors, which you will later install as <filename>/usr/share/doc/gentoo/changelog.gz</filename>).  Let's assume your ITP (Intent To Package) bug report number was <literal>12345</literal>.  New lines must be inserted just below the uppermost line that begins with <literal>*</literal> (asterisk).  You can do it with <citerefentry> <refentrytitle>dch</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.  You can edit this manually with a text editor as long as you follow the formatting convention used by the <citerefentry> <refentrytitle>dch</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.
it: Le righe 3-5 sono una voce del registro, in cui vengono documentati i cambiamenti fatti nella revisione del pacchetto (non dei cambiamenti del pacchetto originario &#x2014; c'è un file apposta per questo scopo, creato dagli autori originali, che verrà installato successivamente <filename>/usr/share/doc/gentoo/changelog.gz</filename>).  Supponiamo che il numero di servizio del ticket ITP fosse <literal>12345</literal>.  Nuove righe devono essere aggiunte appena prima della riga più in alto che comincia con <literal>*</literal> (asterisco).  Ciò si può fare con <citerefentry> <refentrytitle>dch</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, o manualmente con un editor testuale.

note: type: Content of: <book><chapter><section><para>
en: In order to prevent a package being accidentally uploaded before completing the package, it is a good idea to change the distribution value to an invalid distribution value of <literal>UNRELEASED</literal>.
it: Per evitare che un pacchetto venga accidentalmente caricato prima che il quest'ultimo sia pronto, è buona prassi cambiare il valore del campo distribuzione, con il valore fittizio <literal>UNRELEASED</literal>.

note: type: Content of: <book><chapter><section><para>
en: You will end up with something like this:
it: Alla fine si avrà qualcosa del genere:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para><footnote><para>
en: If you use the <literal>dch -r</literal> command to make this last change, please make sure to save the <filename>changelog</filename> file explicitly by the editor.
it: Se si utilizza il comando <literal>dch -r</literal> per effettuare quest'ultima modifica, ci si assicuri che l'editor salvi il file con il nome <filename>changelog</filename>.

note: type: Content of: <book><chapter><section><para>
en: Once you are satisfied with all the changes and documented them in <filename>changelog</filename>, you should change the distribution value from <literal>UNRELEASED</literal> to the target distribution value <literal>unstable</literal> (or even <literal>experimental</literal>).  <placeholder type="footnote" id="0"/>
it: Quando si è soddisfatti di tutte le modifiche e quest'ultime sono state documentate nel file <filename>changelog</filename>, si può modificare il valore del campo distribuzione da <literal>UNRELEASED</literal> a <literal>unstable</literal> (o anche <literal>experimental</literal>).  <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: You can read more about updating the <filename>changelog</filename> file later in <xref linkend="update"/>.
it: Si possono avere più informazioni su come aggiornare il file <filename>changelog</filename> nel capitolo <xref linkend="update"/>.

note: type: Content of: <book><chapter><section><title>
en: <filename>rules</filename>
it: Il file <filename>rules</filename>

note: type: Content of: <book><chapter><section><para>
en: Now we need to take a look at the exact rules that <citerefentry> <refentrytitle>dpkg-buildpackage</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> will use to actually create the package.  This file is in fact another <filename>Makefile</filename>, but different from the one(s) in the upstream source.  Unlike other files in <filename>debian</filename>, this one is marked as executable.
it: Ora si darà uno sguardo alle regole esatte che <citerefentry> <refentrytitle>dpkg-buildpackage</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> userà per creare il pacchetto.  In realtà questo file non è che un altro <filename>Makefile</filename>, ma diverso da quelli della sorgente originale.  Differentemente dagli altri file sotto <filename>debian</filename>, questo è marcato come eseguibile.

note: type: Content of: <book><chapter><section><section><title>
en: Targets of the <filename>rules</filename> file
it: Target del file <filename>rules</filename>

note: type: Content of: <book><chapter><section><section><para><footnote><para>
en: You can start learning how to write a <filename>Makefile</filename> from <ulink url="&debref-make;">Debian Reference, 12.2. "Make"</ulink>.  The full documentation is available as <ulink url="&gnu-make;"></ulink> or as the <systemitem role="package">make-doc</systemitem> package in the <literal>non-free</literal> archive area.
it: Si può imparare come scrivere il <filename>Makefile</filename> dalla <ulink url="&debref-make;">Guida di riferimento Debian, 12.2. "Make"</ulink>.  La documentazione completa è disponibile su <ulink url="&gnu-make;"></ulink> o come pacchetto <systemitem role="package">make-doc</systemitem> nella sezione <literal>non-free</literal> del repository.

note: type: Content of: <book><chapter><section><section><para><footnote><para>
en: <ulink url="&policy-debianrules;">Debian Policy Manual, 4.9 "Main building script: debian/rules"</ulink> explains the details.
it: Il <ulink url="&policy-debianrules;">manuale delle policy Debian, 4.9 "Main building script: debian/rules"</ulink> descrive i dettagli.

note: type: Content of: <book><chapter><section><section><para>
en: Every <filename>rules</filename> file, like any other <filename>Makefile</filename>, consists of several rules, each of which defines a target and how it is carried out.  <placeholder type="footnote" id="0"/> A new rule begins with its target declaration in the first column.  The following lines beginning with the TAB code (ASCII 9) specify the recipe for carrying out that target.  Empty lines and lines beginning with <literal>#</literal> (hash) are treated as comments and ignored.  <placeholder type="footnote" id="1"/>
it: Ogni file <filename>rules</filename>, come ogni altro <filename>Makefile</filename>, si compone di diverse regole, ciascuno dei quali definisce un target e descrive come eseguirlo.  <placeholder type="footnote" id="0"/> Una nuova regola inizia con la dichiarazione del target, nella prima colonna. Le righe seguenti che iniziano con il TAB (codice ASCII 9) specificano il come effettuare il target. Le righe vuote e quelle che iniziano con <literal>#</literal> (cancelletto) vengono trattate come commenti e ignorate.  <placeholder type="footnote" id="1"/>

note: type: Content of: <book><chapter><section><section><para>
en: A rule that you want to execute is invoked by its target name as a command line argument.  For example, <literal>debian/rules <replaceable>build</replaceable></literal> and <literal>fakeroot make -f debian/rules <replaceable>binary</replaceable></literal> execute rules for <literal><replaceable>build</replaceable></literal> and <literal><replaceable>binary</replaceable></literal> targets, respectively.
it: Quando si vuole eseguire una regola basta eseguire il comando passandogli come argomento il nome del target.  Ad esempio, <literal>debian/rules <replaceable>build</replaceable></literal> e <literal>fakeroot make -f debian/rules <replaceable>binary</replaceable></literal> esegue le regole per i target <literal><replaceable>build</replaceable></literal> e <literal><replaceable>binary</replaceable></literal>.

note: type: Content of: <book><chapter><section><section><para>
en: Here is a simplified explanation of the targets:
it: Ecco una spiegazione semplificata dei target:

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>clean</literal> target: to clean all compiled, generated, and useless files in the build-tree.  (Required)
it: target <literal>clean</literal>: ripulisce tutti i file compilati, generati ed inutili nella struttura delle directory del pacchetto.  (richiesto)

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>build</literal> target: to build the source into compiled programs and formatted documents in the build-tree.  (Required)
it: target <literal>build</literal>: costruisce tutti i sorgenti per ottenere programmi compilati e documenti formattati nella struttura delle directory del pacchetto.  (richiesto)

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>build-arch</literal> target: to build the source into arch-dependent compiled programs in the build-tree.  (Required)
it: target <literal>build-arch</literal>: costruisce i sorgenti per ottenere programmi compilati, dipendenti dall'architettura, nella radice dei sorgenti.  (richiesto)

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>build-indep</literal> target: to build the source into arch-independent formatted documents in the build-tree.  (Required)
it: target <literal>build-indep</literal>: costruisce i sorgenti per ottenere documenti formattati indipendenti dall'architettura nella radice dei sorgenti.  (richiesto)

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>install</literal> target: to install files into a file tree for each binary package under the <filename>debian</filename> directory.  If defined, <literal>binary*</literal> targets effectively depend on this target.  (Optional)
it: target <literal>install</literal>: installa i file in una struttura ad albero per ogni pacchetto binario nella directory <filename>debian</filename>.  Se definito, tutti i target <literal>binary*</literal> dipenderanno effettivamente da quest'ultimo.  (opzionale)

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para><footnote><para>
en: This target is used by <literal>dpkg-buildpackage</literal> as in <xref linkend="completebuild"/>.
it: Questo obiettivo è utilizzato da <literal>dpkg-buildpackage</literal> come in <xref linkend="completebuild"/>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>binary</literal> target: to create all binary packages (effectively a combination of <literal>binary-arch</literal> and <literal>binary-indep</literal> targets).  (Required)<placeholder type="footnote" id="0"/>
it: target <literal>binary</literal>: crea tutta una serie di pacchetti binari (combinando i target <literal>binary-arch</literal> e <literal>binary-indep</literal>).  (richiesto)<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para><footnote><para>
en: This target is used by <literal>dpkg-buildpackage -B</literal> as in <xref linkend="autobuilder"/>.
it: Questo target è usato da <literal>dpkg-buildpackage -B</literal> come descritto in <xref linkend="autobuilder"/>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>binary-arch</literal> target: to create arch-dependent (<literal>Architecture: any</literal>) binary packages in the parent directory.  (Required)<placeholder type="footnote" id="0"/>
it: target <literal>binary-arch</literal>: crea una serie di pacchetti binari dipendenti dall'architettura (<literal>Architecture: any</literal>) nella directory padre.  (richiesto)<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para><footnote><para>
en: This target is used by <literal>dpkg-buildpackage -A</literal>.
it: Questo target è utilizzato da <literal>dpkg-buildpackage -A</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>binary-indep</literal> target: to create arch-independent (<literal>Architecture: all</literal>) binary packages in the parent directory.  (Required)<placeholder type="footnote" id="0"/>
it: target <literal>binary-indep</literal>: crea una serie di pacchetti binari indipendenti dall'architettura (<literal>Architecture: all</literal>) nella directory padre.  (richiesto)<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>get-orig-source</literal> target: to obtain the most recent version of the original source package from an upstream archive.  (Optional)
it: target <literal>get-orig-source</literal>: ottiene la versione più recente del pacchetto sorgente originale dal relativo archivio originale.  (optional)

note: type: Content of: <book><chapter><section><section><para>
en: You are probably overwhelmed by now, but things are much simpler upon examination of the <filename>rules</filename> file that <command>dh_make</command> gives us as a default.
it: È probabile che adesso ci sia un po' di confusione, ma sarà tutto più chiaro una volta esaminato il file <filename>rules</filename> che <command>dh_make</command> fornisce in modo predefinito.

note: type: Content of: <book><chapter><section><section><title>
en: Default <filename>rules</filename> file
it: Il file <filename>rules</filename> predefinito

note: type: Content of: <book><chapter><section><section><para>
en: Newer <command>dh_make</command> generates a very simple but powerful default <filename>rules</filename> file using the <command>dh</command> command:
it: Le nuove versioni di <command>dh_make</command> generano un file <filename>rules</filename> molto semplice ma potente utilizzando il comando <command>dh</command>:

note: type: Content of: <book><chapter><section><section><para>
en: (I've added the line numbers and trimmed some comments.  In the actual <filename>rules</filename> file, the leading spaces are a TAB code.)
it: (Sono stati aggiunti i numeri di riga ed eliminati alcuni commenti. Nel vero file <filename>rules</filename>, gli spazi vengono sostituiti da TAB.)

note: type: Content of: <book><chapter><section><section><para>
en: You are probably familiar with lines like line 1 from shell and Perl scripts.  It tells the operating system that this file is to be processed with <filename>/usr/bin/make</filename>.
it: Probabilmente si sarà già familiari con le righe tipo la prima che ricordano gli script shell e Perl.  In pratica indica al sistema operativo che il file andrà elaborato con <filename>/usr/bin/make</filename>.

note: type: Content of: <book><chapter><section><section><para>
en: Line 4 can be uncommented to set the <literal>DH_VERBOSE</literal> variable to 1, so that the <command>dh</command> command outputs which <command>dh_*</command> commands it is executing.  You can also add a line <literal>export DH_OPTIONS=-v</literal> here, so that each <command>dh_*</command> command outputs which commands it is executing.  This helps you to understand exactly what is going on behind this simple <filename>rules</filename> file and to debug its problems.  This new <command>dh</command> is designed to form a core part of the <systemitem role="package">debhelper</systemitem> tools, and not to hide anything from you.
it: La riga 4 può essere decommentata per impostare la variabile <literal>DH_VERBOSE</literal> a 1, in modo da mostrare gli output del comando <command>dh</command> che generano i programmi <command>dh_*</command> in esecuzione.  È anche possibile aggiungere la riga  <literal>export DH_OPTIONS=-v</literal>, in modo che ogni comando <command>dh_*</command> stampi quale comando sta eseguendo.  Questo aiuta a comprendere esattamente cosa c'è dietro al singolo file <filename>rules</filename> file ed a diagnosticare i problemi.  Il nuovo <command>dh</command> è progettato per formare una parte fondamentale degli strumenti <systemitem role="package">debhelper</systemitem> e per essere trasparente, ovvero non nascondere nulla all'utente.

note: type: Content of: <book><chapter><section><section><para><footnote><para>
en: This uses the new <systemitem role="package">debhelper</systemitem> v7+ features.  Its design concepts are explained in <ulink url="&debhelper-slides;">Not Your Grandpa's Debhelper</ulink> presented at DebConf9 by the <systemitem role="package">debhelper</systemitem> upstream.  Under <literal>lenny</literal>, <command>dh_make</command> created a much more complicated <filename>rules</filename> file with explicit rules and many <command>dh_*</command> scripts listed for each one, most of which are now unnecessary (and show the package's age). The new <command>dh</command> command is simpler and frees us from doing the routine work "manually". You still have full power to customize the process with <literal>override_dh_*</literal> targets. See <xref linkend="customrules"/>.  It is based only on the <systemitem role="package">debhelper</systemitem> package and does not obfuscate the package building process as the <systemitem role="package">cdbs</systemitem> package tends to do.
it: Questo è una nuova caratteristica di <systemitem role="package">debhelper</systemitem> v7+.  La sua architettura è documentata su <ulink url="&debhelper-slides;">Not Your Grandpa's Debhelper</ulink> ed è stata presentata alla Debconf9 dall'autore di <systemitem role="package">debhelper</systemitem>.  Su sistemi Debian <literal>lenny</literal>, <command>dh_make</command> crea file <filename>rules</filename> molto più complicati, con molti script <command>dh_*</command> elencati per ogni target, la maggior parte dei quali sono ormai inutili (e rispecchiano l'anzianità del pacchetto).  La nuova versione del programma <command>dh</command> è molto più semplice e ci libera da questo vincolo.  Si continuerà ad avere il pieno potere di personalizzazione utilizzando i target <literal>override_dh_*</literal>.  Si veda <xref linkend="customrules"/>.  Esso si basa solo sul pacchetto <systemitem role="package">debhelper</systemitem> e non offusca il processo di compilazione come il pacchetto <systemitem role="package">cdbs</systemitem>.

note: type: Content of: <book><chapter><section><section><para>
en: Lines 16 and 17 are where all the work is done with an implicit rule using the pattern rule.  The percent sign means "any targets", which then call a single program, <command>dh</command>, with the target name.  <placeholder type="footnote" id="0"/> The <command>dh</command> command is a wrapper script that runs appropriate sequences of <command>dh_*</command> programs depending on its argument.  <placeholder type="footnote" id="1"/>
it: Tutto il lavoro è svolto nelle righe 20 e 21, grazie ad una regola implicita dichiarata nel modello.  Il simbolo della percentuale significa che "ogni target" esegue una chiamata ad un singolo programma, <command>dh</command> con il nome del target stesso.  <placeholder type="footnote" id="0"/> Il comando <command>dh</command> è uno script wrapper, che esegue una sequenza appropriata di programmi <command>dh_*</command> in base all'argomento passato.  <placeholder type="footnote" id="1"/>

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>debian/rules clean</literal> runs <literal>dh clean</literal>, which in turn runs the following:
it: <literal>debian/rules clean</literal> esegue <literal>dh clean</literal>; che a sua volta esegue i seguenti:

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>debian/rules build</literal> runs <literal>dh build</literal>, which in turn runs the following:
it: <literal>debian/rules build</literal> esegue <literal>dh build</literal>, che a sua volta esegue i seguenti:

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para><footnote><para>
en: The following example assumes your <filename>debian/compat</filename> has a value equal or more than 9 to avoid invoking any python support commands automatically.
it: Il seguente esempio assume che il file <filename>debian/compat</filename> abbia un valore uguale o superiore a 9, per evitare l'esecuzione automatica di qualsiasi comando python di supporto.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>fakeroot debian/rules binary</literal> runs <literal>fakeroot dh binary</literal>, which in turn runs the following<placeholder type="footnote" id="0"/>:
it: <literal>fakeroot debian/rules binary</literal> esegue <literal>fakeroot dh binary</literal>, che a sua volta esegue i seguenti<placeholder type="footnote" id="0"/>:

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>fakeroot debian/rules binary-arch</literal> runs <literal>fakeroot dh binary-arch</literal>, which in turn runs the same sequence as <literal>fakeroot dh binary</literal> but with the <literal>-a</literal> option appended for each command.
it: <literal>fakeroot debian/rules binary-arch</literal> esegue <literal>fakeroot dh binary-arch</literal>, che a sua volta esegue la stessa sequenza di <literal>fakeroot dh binary</literal> ma con l'opzione <literal>-a</literal> aggiunta ad ogni comando.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>fakeroot debian/rules binary-indep</literal> runs <literal>fakeroot dh binary-indep</literal>, which in turn runs almost the same sequence as <literal>fakeroot dh binary</literal> but excluding <command>dh_strip</command>, <command>dh_makeshlibs</command>, and <command>dh_shlibdeps</command> with the <literal>-i</literal> option appended for each remaining command.
it: <literal>fakeroot debian/rules binary-indep</literal> esegue <literal>fakeroot dh binary-indep</literal>, che a sua volta esegue la stessa sequenza di <literal>fakeroot dh binary</literal> ma escludendo <command>dh_strip</command>, <command>dh_makeshlibs</command>, e <command>dh_shlibdeps</command> con l'opzione <literal>-i</literal> aggiunta ad ogni comando rimanente.

note: type: Content of: <book><chapter><section><section><para><footnote><para>
en: For complete information on what all these <command>dh_*</command> scripts do exactly, and what their other options are, please read their respective manual pages and the <systemitem role="package">debhelper</systemitem> documentation.
it: Per informazioni dettagliate sul funzionamento di tutti questi script <command>dh_ *</command>, e sulle loro opzioni, leggere le rispettive pagine del manuale e <systemitem role="package">debhelper</systemitem> documentazione.

note: type: Content of: <book><chapter><section><section><para><footnote><para>
en: These commands support other build environments, such as <filename>setup.py</filename>, which can be listed by executing <literal>dh_auto_build --list</literal> in a package source directory.
it: Questi comandi supportano altri ambienti di sviluppo, come <filename>setup.py</filename> che può essere elencato eseguendo <literal>dh_auto_build --list</literal> nella directory del sorgente del pacchetto.

note: type: Content of: <book><chapter><section><section><para>
en: The functions of <command>dh_*</command> commands are largely self-evident from their names.  <placeholder type="footnote" id="0"/> There are a few notable ones that are worth giving (over)simplified explanations here assuming a typical build environment based on a <filename>Makefile</filename>: <placeholder type="footnote" id="1"/>
it: Le funzioni dei comandi <command>dh_*</command> sono, in gran parte, auto-esplicativi.  <placeholder type="footnote" id="0"/> Ce ne sono alcune però, per cui vale la pena dare più spiegazioni, tenendo conto che si stia lavorando su un ambiente di sviluppo basato sul <filename>Makefile</filename>:  <placeholder type="footnote" id="1"/>

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para><footnote><para>
en: It actually looks for the first available target in the <filename>Makefile</filename> out of <literal>distclean</literal>, <literal>realclean</literal>, or <literal>clean</literal>, and executes that.
it: Attualmente il programma esegue il primo target presente nel <filename>Makefile</filename>, tra <literal>distclean</literal>, <literal>realclean</literal> o <literal>clean</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <command>dh_auto_clean</command> usually executes the following if a <filename>Makefile</filename> exists with the <literal>distclean</literal> target.  <placeholder type="footnote" id="0"/>
it: <command>dh_auto_clean</command> normalmente esegue i seguenti comandi se nel <filename>Makefile</filename> è presente il target <literal>distclean</literal>.<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <command>dh_auto_configure</command> usually executes the following if <filename>./configure</filename> exists (arguments abbreviated for readability).
it: <command>dh_auto_configure</command> normalmente esegue i seguenti comandi se esiste il file <filename>./configure</filename> (argomenti abbreviati for una maggiore leggibilità).

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <command>dh_auto_build</command> usually executes the following to execute the first target of <filename>Makefile</filename> if it exists.
it: <command>dh_auto_build</command> normalmente lancia il seguente comando per eseguire, se esiste, il primo target del <filename>Makefile</filename>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para><footnote><para>
en: It actually looks for the first available target in the <filename>Makefile</filename> out of <literal>test</literal> or <literal>check</literal>, and executes that.
it: Attualmente il programma esegue il primo target <literal>test</literal> o <literal>check</literal> disponibile nel <filename>Makefile</filename>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <command>dh_auto_test</command> usually executes the following if a <filename>Makefile</filename> exists with the <literal>test</literal> target.  <placeholder type="footnote" id="0"/>
it: <command>dh_auto_clean</command> normalmente esegue i seguenti comandi, se nel <filename>Makefile</filename> esiste il target <literal>test</literal>.<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <command>dh_auto_install</command> usually executes the following if a <filename>Makefile</filename> exists with the <literal>install</literal> target (line folded for readability).
it: <command>dh_auto_install</command> normalmente esegue il seguente comando se nel <filename>Makefile</filename> esiste il target <literal>install</literal> (riga spezzata per aumentare la leggibilità).

note: type: Content of: <book><chapter><section><section><para>
en: All targets which require the <command>fakeroot</command> command will contain <command>dh_testroot</command>, which exits with an error if you are not using this command to pretend to be root.
it: Tutti i target che richiedono il comando <command>fakeroot</command> dovrebbero contenere <command>dh_testroot</command>, che restituisce un errore se non si utilizza questo comando per fingere di essere root.

note: type: Content of: <book><chapter><section><section><para>
en: The important part to know about the <filename>rules</filename> file created by <command>dh_make</command> is that it is just a suggestion.  It will work for most packages but for more complicated ones, don't be afraid to customize it to fit your needs.
it: La cosa importante da sapere riguardo al file <filename>rules</filename> creato da <command>dh_make</command>, è che il suo contenuto contiene dei semplici consigli.  Funzionerà per la maggior parte dei pacchetti ma per i più complicati non si esiti a personalizzarlo secondo le proprie esigenze.

note: type: Content of: <book><chapter><section><section><para>
en: Although <literal>install</literal> is not a required target, it is supported.  <literal>fakeroot dh install</literal> behaves like <literal>fakeroot dh binary</literal> but stops after <command>dh_fixperms</command>.
it: Anche se il target <literal>install</literal> non è richiesto, è comunque supportato.  <literal>fakeroot dh install</literal> si comporta come <literal>fakeroot dh binary</literal> ma si ferma dopo <command>dh_fixperms</command>.

note: type: Content of: <book><chapter><section><section><title>
en: Customization of <filename>rules</filename> file
it: Personalizzazione del file <filename>rules</filename>

note: type: Content of: <book><chapter><section><section><para>
en: There are many ways to customize the <filename>rules</filename> file created with the new <command>dh</command> command.
it: Verrà qui spiegata la personalizzazione del file <filename>rules</filename>, creato con il nuovo comando <command>dh</command>.

note: type: Content of: <book><chapter><section><section><para><footnote><para>
en: If a package installs the <filename>/usr/share/perl5/Debian/Debhelper/Sequence/<replaceable>custom_name</replaceable>.pm</filename> file, you should activate its customization function by <literal>dh $@ --with <replaceable>custom-name</replaceable></literal>.
it: Se il pacchetto installa il file <filename>/usr/share/perl5/Debian/Debhelper/Sequence/<replaceable>nome_personalizzato</replaceable>.pm</filename>, si deve attivare la funzione di personalizzazione tramite il comando <literal>dh $@ --with <replaceable>nome-personalizzato</replaceable></literal>.

note: type: Content of: <book><chapter><section><section><para>
en: The <literal>dh $@</literal> command can be customized as follows: <placeholder type="footnote" id="0"/>
it: Il comando <literal>dh $@</literal> può essere personalizzato come segue:  <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para><footnote><para>
en: Use of the <command>dh_python2</command> command is preferred over use of <command>dh_pysupport</command> or <command>dh_pycentral</command> commands.  Do not use the <command>dh_python</command> command.
it: L'uso del comando <command>dh_python2</command> è preferito rispetto all'uso di dei comandi <command>dh_pysupport</command> o <command>dh_pycentral</command>.  Non si deve utilizzare il comando <command>dh_python</command>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>dh_python2</command> command.  (The best choice for Python.) <placeholder type="footnote" id="0"/>
it: Aggiunge il supporto per il comando <command>dh_python2</command>.  (La scelta migliore per Python) <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Include the <systemitem role="package">python</systemitem> package in <literal>Build-Depends</literal>.
it: Include il pacchetto <systemitem role="package">python</systemitem> in <literal>Build-Depends</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with python2</literal>.
it: Utilizza <literal>dh $@ --with python2</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This handles Python modules using the <systemitem role="package">python</systemitem> framework.
it: Gestisce i moduli Python utilizzando il framework <systemitem role="package">python</systemitem>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>dh_pysupport</command> command. (deprecated)
it: Aggiunge il supporto per il comando <command>dh_pysupport</command>. (deprecato)

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Include the <systemitem role="package">python-support</systemitem> package in <literal>Build-Depends</literal>.
it: Include il pacchetto <systemitem role="package">python-support</systemitem> in <literal>Build-Depends</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with pysupport</literal>.
it: Utilizza <literal>dh $@ --with pysupport</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This handles Python modules using the <systemitem role="package">python-support</systemitem> framework.
it: Gestisce i moduli Python utilizzando l'infrastruttura <systemitem role="package">python-support</systemitem>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>dh_pycentral</command> command. (deprecated)
it: Aggiunge il supporto al comando <command>dh_pycentral</command>. (deprecato)

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Include the <systemitem role="package">python-central</systemitem> package in <literal>Build-Depends</literal>.
it: Include il pacchetto <systemitem role="package">python-central</systemitem> in <literal>Build-Depends</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with python-central</literal> instead.
it: Utilizza in alternativa <literal>dh $@ --with python-central</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This also deactivates the <command>dh_pysupport</command> command.
it: Disattiva anche il comando <command>dh_pysupport</command>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This handles Python modules using the <systemitem role="package">python-central</systemitem> framework.
it: Gestisce i moduli Python utilizzando l'infrastruttura <systemitem role="package">python-central</systemitem>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>dh_installtex</command> command.
it: Aggiunge il supporto per il comando <command>dh_installtex</command>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Include the <systemitem role="package">tex-common</systemitem> package in <literal>Build-Depends</literal>.
it: Include il pacchetto <systemitem role="package">tex-common</systemitem> in <literal>Build-Depends</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with tex</literal> instead.
it: Utilizza in alternativa <literal>dh $@ --with tex</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This registers Type 1 fonts, hyphenation patterns, and formats with TeX.
it: Registra i caratteri Type 1, le regole di sillabazione, ed i formati con TeX.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>dh_quilt_patch</command> and <command>dh_quilt_unpatch</command> commands.
it: Aggiunge il supporto per i comandi <command>dh_quilt_patch</command> e <command>dh_quilt_unpatch</command>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Include the <systemitem role="package">quilt</systemitem> package in <literal>Build-Depends</literal>.
it: Include il pacchetto <systemitem role="package">quilt</systemitem> in <literal>Build-Depends</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with quilt</literal> instead.
it: Utilizza in alternativa <literal>dh $@ --with quilt</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This applies and un-applies patches to the upstream source from files in the <filename>debian/patches</filename> directory for a source package in the <literal>1.0</literal> format.
it: Applica e rimuove le patch al sorgente originale dai file nella directory <filename>debian/patches</filename> per i sorgenti dei pacchetti con formato <literal>1.0</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This is not needed if you use the new <literal>3.0 (quilt)</literal> source package format.
it: Non è necessario se si utilizza il nuovo formato del sorgente del pacchetto <literal>3.0 (quilt)</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>dh_dkms</command> command.
it: Aggiunge il supporto per il comando <command>dh_dkms</command>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Include the <systemitem role="package">dkms</systemitem> package in <literal>Build-Depends</literal>.
it: Include il pacchetto <systemitem role="package">dkms</systemitem> in <literal>Build-Depends</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with dkms</literal> instead.
it: Utilizza in alternativa <literal>dh $@ --with dkms</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This correctly handles DKMS usage by kernel module packages.
it: Gestisce in maniera corretta DKMS, usato dal pacchetto del modulo del kernel.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>dh_autotools-dev_updateconfig</command> and <command>dh_autotools-dev_restoreconfig</command> commands.
it: Aggiunge il supporto per i comandi <command>dh_autotools-dev_updateconfig</command> e <command>dh_autotools-dev_restoreconfig</command>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Include the <systemitem role="package">autotools-dev</systemitem> package in <literal>Build-Depends</literal>.
it: Include il pacchetto <systemitem role="package">autotools-dev</systemitem> in <literal>Build-Depends</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with autotools-dev</literal> instead.
it: Include in alternativa <literal>dh $@ --with autotools-dev</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This updates and restores <filename>config.sub</filename> and <filename>config.guess</filename>.
it: Aggiorna e ripristina i file <filename>config.sub</filename> and <filename>config.guess</filename>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>dh_autoreconf</command> and <command>dh_autoreconf_clean</command> commands.
it: Aggiunge il supporto per i comandi <command>dh_autoreconf</command> e <command>dh_autoreconf_clean</command>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Include the <systemitem role="package">dh-autoreconf</systemitem> package in <literal>Build-Depends</literal>.
it: Include il pacchetto <systemitem role="package">dh-autoreconf</systemitem> in <literal>Build-Depends</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with autoreconf</literal> instead.
it: Utilizza in alternativa <literal>dh $@ --with autoreconf</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This updates the GNU Build System files and restores them after the build.
it: Aggiorna i file del sistema di compilazione GNU e ripristina i file dopo la sua compilazione.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>dh_girepository</command> command.
it: Aggiunge il supporto per il comando <command>dh_girepository</command>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Includes the <systemitem role="package">gobject-introspection</systemitem> package in <literal>Build-Depends</literal>.
it: Include il pacchetto <systemitem role="package">gobject-introspection</systemitem> in <literal>Build-Depends</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with gir</literal> instead.
it: Utilizza in alternativa <literal>dh $@ --with gir</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This computes dependencies for packages shipping GObject introspection data and generates the <literal>${gir:Depends}</literal> substitution variable for the package dependency.
it: Questa operazione calcola le dipendenze per i pacchetti che spediscono dei dati d'auto-analisi di GObject e genera la variabile di sostituzione <literal>${gir:Depends}</literal> per la dipendenza del pacchetto.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>bash</command> completion feature.
it: Aggiunge il supporto alla funzionalità di completamento di <command>bash</command>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Includes the <systemitem role="package">bash-completion</systemitem> package in <literal>Build-Depends</literal>.
it: Include il pacchetto <systemitem role="package">bash-completion</systemitem> in <literal>Build-Depends</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with bash-completion</literal> instead.
it: Utilizza in alternativa <literal>dh $@ --with bash-completion</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This installs <command>bash</command> completions using a configuration file at <filename>debian/<replaceable>package</replaceable>.bash-completion</filename>.
it: Installa il completamento per <command>bash</command> utilizzando il file di configurazione <filename>debian/<replaceable>package</replaceable>.bash-completion</filename>.

note: type: Content of: <book><chapter><section><section><para>
en: Many <command>dh_*</command> commands invoked by the new <command>dh</command> command can be customized by the corresponding configuration files in the <filename>debian</filename> directory.  See <xref linkend="dother"/> and the manpage of each command for the customization of such features.
it: Molti comandi del tipo <command>dh_*</command>, invocati da <command>dh</command>, possono essere personalizzati modificando i rispettivi file di configurazione nella directory <filename>debian</filename>.  Si veda <xref linkend="dother"/> per la personalizzazione di tali caratteristiche.

note: type: Content of: <book><chapter><section><section><para><footnote><para>
en: Under <literal>lenny</literal>, if you wanted to change the behavior of a <command>dh_*</command> script you found the relevant line in the <filename>rules</filename> file and adjusted it.
it: Sotto <literal>lenny</literal>, se si vuole cambiare il comportamento di uno script <command>dh_*</command> basta cercare la riga relativa nel file <filename>rules</filename> e modificarla.

note: type: Content of: <book><chapter><section><section><para>
en: You may need to run <command>dh_*</command> commands invoked via the new <command>dh</command> with added arguments, or to run additional commands with them, or to skip them.  For such cases, you create an <literal>override_dh_<replaceable>foo</replaceable></literal> target with its rule in the <filename>rules</filename> file defining an <literal>override_dh_<replaceable>foo</replaceable></literal> target for the <command>dh_<replaceable>foo</replaceable></command> command you want to change.  It basically says <emphasis>run me instead</emphasis>.  <placeholder type="footnote" id="0"/>
it: Alcuni comandi del tipo <command>dh_*</command>, invocati da <command>dh</command>, possono richiedere la propria esecuzione con alcuni parametri o in aggiunta ad altri comandi da eseguire contestualmente o al posto dei comandi originali.  In tali casi viene creato nel file <filename>rules</filename> il target <literal>override_dh_<replaceable>foo</replaceable></literal> aggiungendo una regola solo per il comando <command>dh_<replaceable>foo</replaceable></command> che si intende modificare.  Fondamentalmente tale regola dice <emphasis>esegui me al posto di</emphasis>.  <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><section><para>
en: Please note that the <command>dh_auto_*</command> commands tend to do more than what has been discussed in this (over)simplified explanation to take care of all the corner cases.  It is a bad idea to use <literal>override_dh_*</literal> targets to substitute simplified equivalent commands (except for the <literal>override_dh_auto_clean</literal> target) since it may bypass such smart <systemitem role="package">debhelper</systemitem> features.
it: Si noti che il comando <command>dh_auto_*</command> tende a fare più di ciò che è stato discusso in questa spiegazione (ultra)semplificata. È una cattiva idea utilizzare i target <literal>override_dh_*</literal> per sostituire i comandi equivalenti (ad eccezione del target <literal>override_dh_auto_clean</literal>) in quanto può bypassare delle caratteristiche "intelligenti" di <systemitem role="package">debhelper</systemitem>.

note: type: Content of: <book><chapter><section><section><para>
en: So, for instance, if you want to store system configuration data in the <filename>/etc/gentoo</filename> directory instead of the usual <filename>/etc</filename> directory for the recent <systemitem role="package">gentoo</systemitem> package using Autotools, you can override the default <literal>--sysconfig=/etc</literal> argument given by the <command>dh_auto_configure</command> command to the <command>./configure</command> command by the following:
it: Se si vogliono registrare i dati di configurazione di sistema nella directory <filename>/etc/gentoo</filename> invece che nella solita directory <filename>/etc</filename>, per il pacchetto <systemitem role="package">gentoo</systemitem>, che utilizza gli Autotools, si può sovrascrivere il parametro predefinito <literal>--sysconfig=/etc</literal> dato dal comando <command>dh_auto_configure</command> al comando <command>./configure</command> nel modo seguente:

note: type: Content of: <book><chapter><section><section><para>
en: The arguments given after <literal>--</literal> are appended to the default arguments of the auto-executed program to override them.  Using the <command>dh_auto_configure</command> command is better than directly invoking the <command>./configure</command> command here since it will only override the <literal>--sysconfig</literal> argument and retain any other, benign arguments to the <command>./configure</command> command.
it: I parametri immessi dopo <literal>--</literal> vengono aggiunti dopo i parametri predefiniti dei programmi eseguiti per sovrascriverli.  Utilizzare il comando <command>dh_auto_configure</command> è preferibile rispetto al comando <command>./configure</command> dal momento che sovrascriverà esclusivamente il parametro <literal>--sysconfig</literal> e manterrà gli altri parametri del comando <command>./configure</command>.

note: type: Content of: <book><chapter><section><section><para><footnote><para>
en: <command>dh_auto_build</command> without any arguments will execute the first target in the <filename>Makefile</filename>.
it: <command>dh_auto_build</command> senza alcun argomento eseguirà il primo target del file <filename>Makefile</filename>.

note: type: Content of: <book><chapter><section><section><para>
en: If the <filename>Makefile</filename> in the source for <systemitem role="package">gentoo</systemitem> requires you to specify <literal>build</literal> as its target to build it <placeholder type="footnote" id="0"/>, you create an <literal>override_dh_auto_build</literal> target to enable this.
it: Se il <filename>Makefile</filename> del sorgente per il pacchetto <systemitem role="package">gentoo</systemitem> necessita che venga specificato il target per costruirlo <placeholder type="footnote" id="0"/>, basterà creare il target <literal>override_dh_auto_build</literal> per abilitarlo.

note: type: Content of: <book><chapter><section><section><para>
en: This ensures <literal>$(MAKE)</literal> is run with all the default arguments given by the <command>dh_auto_build</command> command plus the <literal>build</literal> argument.
it: Questo assicura che <literal>$(MAKE)</literal> verrà eseguito con tutti i parametri predefiniti del comando <command>dh_auto_build</command> ed il parametro <literal>build</literal>.

note: type: Content of: <book><chapter><section><section><para>
en: If the <filename>Makefile</filename> in the source for <systemitem role="package">gentoo</systemitem> requires you to specify the <literal>packageclean</literal> target to clean it for the Debian package instead of using <literal>distclean</literal> or <literal>clean</literal> targets, you can create an <literal>override_dh_auto_clean</literal> target to enable it.
it: Se il <filename>Makefile</filename> del sorgente per il pacchetto <systemitem role="package">gentoo</systemitem> necessita che venga specificato il target <literal>packageclean</literal> per pulirlo per il pacchetto Debian, al posto dell'utilizzo dei target <literal>distclean</literal> o <literal>clean</literal>, si può creare il target <literal>override_dh_auto_build</literal> pe abilitarlo.

note: type: Content of: <book><chapter><section><section><para>
en: If the <filename>Makefile</filename> in the source for <systemitem role="package">gentoo</systemitem> contains a <literal>test</literal> target which you do not want to run for the Debian package building process, you can use an empty <literal>override_dh_auto_test</literal> target to skip it.
it: Se il <filename>Makefile</filename> di un sorgente per il pacchetto <systemitem role="package">gentoo</systemitem> contiene il target <literal>test</literal> che non vuole essere eseguito nel processo di costruzione del pacchetto Debian, si può utilizzare l'obiettivo <literal>override_dh_auto_test</literal> per saltarlo.

note: type: Content of: <book><chapter><section><section><para><footnote><para>
en: The <filename>debian/changelog</filename> and <filename>debian/NEWS</filename> files are always automatically installed.  The upstream changelog is found by converting filenames to lower case and matching them against <filename>changelog</filename>, <filename>changes</filename>, <filename>changelog.txt</filename>, and <filename>changes.txt</filename>.
it: I file <filename>debian/changelog</filename> e <filename>debian/NEWS</filename> vengono sempre installati automaticamente.  Il changelog originale viene trovato convertendo i nomi dei file in minuscolo e cercando la corrispondenza con <filename>changelog</filename>, <filename>changes</filename>, <filename>changelog.txt</filename>, e <filename>changes.txt</filename>.

note: type: Content of: <book><chapter><section><section><para>
en: If <systemitem role="package">gentoo</systemitem> has an unusual upstream changelog file called <filename>FIXES</filename>, <command>dh_installchangelogs</command> will not install that file by default.  The <command>dh_installchangelogs</command> command requires <filename>FIXES</filename> as its argument to install it.  <placeholder type="footnote" id="0"/>
it: Se il programma originale <systemitem role="package">gentoo</systemitem> contiene un inusuale file di changelog chiamato <filename>FIXES</filename>, <command>dh_installchangelogs</command> non installerà questo file in modo predefinito.  Il comando <command>dh_installchangelogs</command> richiede che venga fornito il parametro <filename>FIXES</filename> per installarlo.<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><section><para>
en: When you use the new <command>dh</command> command, use of explicit targets such as the ones listed in <xref linkend="targets"/>, other than the <literal>get-orig-source</literal> target, may make it difficult to understand their exact effects.  Please limit explicit targets to <literal>override_dh_*</literal> targets and completely independent ones, if possible.
it: Quando si usa il nuovo comando <command>dh</command>, l'utilizzo di target espliciti come quelli elencanti in <xref linkend="targets"/>, possono rendere difficile capire i loro effetti.  Si prega di limitare i target espliciti in favore dei target <literal>override_dh_*</literal> e, se possibile, quelli completamente indipendenti.

note: type: Content of: <book><chapter><title>
en: Other files under the <filename>debian</filename> directory
it: Altri file nella directory <filename>debian</filename>

note: type: Content of: <book><chapter><para>
en: To control most of what <systemitem role="package">debhelper</systemitem> does while building the package, you put optional configuration files under the <filename>debian</filename> directory.  This chapter will provide an overview of what each of these does and its format.  Please read the <ulink url="&debian-policy;">Debian Policy Manual</ulink> and <ulink url="&developers-reference;">Debian Developer's Reference</ulink> for guidelines for packaging.
it: Per controllare la maggior parte delle operazioni che <systemitem role="package">debhelper</systemitem> effettua durante la creazione del pacchetto, si possono inserire dei file di configurazione all'interno della directory <filename>debian</filename>.  Questo capitolo fornirà una panoramica sull'utilizzo di ciascuno di essi ed il loro formato.  Si legga il <ulink url="&debian-policy;">Manuale delle policy di Debian</ulink> e la <ulink url="&developers-reference;">Guida di riferimento per lo sviluppatore Debian</ulink> per le linee guida sulla creazione dei pacchetti.

note: type: Content of: <book><chapter><para>
en: Some template configuration files for <systemitem role="package">debhelper</systemitem> may not be created by the <command>dh_make</command> command.  In such cases, you need to create them with an editor.
it: Alcuni modelli di file di configurazione per <systemitem role="package">debhelper</systemitem> non  possono essere creati dal comando <command>dh_make</command>.  In questo caso, è necessario crearlo con un editor.

note: type: Content of: <book><chapter><para>
en: If you wish or need to activate any of these, please do the following:
it: Se si vuole o si ha bisogno di attivare uno di questi file, si effettuino le seguenti operazioni:

note: type: Content of: <book><chapter><itemizedlist><listitem><para>
en: rename the configuration files to use the actual binary package name in place of <literal><replaceable>package</replaceable></literal>;
it: si rinominino i file di configurazione con il nome usato dall'attuale pacchetto binario al posto di <literal><replaceable>pacchetto</replaceable></literal>;

note: type: Content of: <book><chapter><itemizedlist><listitem><para>
en: modify template file contents to suit your needs;
it: si modifichi il contenuto del file in base alle proprie esigenze;

note: type: Content of: <book><chapter><itemizedlist><listitem><para>
en: remove template files which you do not need;
it: si elimini il file modello di cui non si ha più bisogno;

note: type: Content of: <book><chapter><itemizedlist><listitem><para>
en: modify the <filename>control</filename> file (see <xref linkend="control"/>), if necessary;
it: si modifichi il file <filename>control</filename> (si veda <xref linkend="control"/>), se necessario;

note: type: Content of: <book><chapter><itemizedlist><listitem><para>
en: modify the <filename>rules</filename> file (see <xref linkend="rules"/>), if necessary.
it: si modifichi il file delle <filename>regole</filename> (si veda <xref linkend="rules"/>), se necessario.

note: type: Content of: <book><chapter><para>
en: Any <systemitem role="package">debhelper</systemitem> configuration files without a <filename><replaceable>package</replaceable></filename> prefix, such as <filename>install</filename>, apply to the first binary package.  When there are many binary packages, their configurations can be specified by prefixing their name to their configuration filenames such as <filename><replaceable>package-1</replaceable>.install</filename>, <filename><replaceable>package-2</replaceable>.install</filename>, etc.
it: Qualsiasi file di configurazione di <systemitem role="package">debhelper</systemitem> senza prefisso del <filename><replaceable>pacchetto</replaceable></filename>, come nel file <filename>install</filename> vengono applicati al primo pacchetto binario.  Quando ci sono molti pacchetti binari le loro configurazioni possono essere specificate aggiungendo il loro prefisso al nome del file di configurazione come <filename><replaceable>pacchetto-1</replaceable>.install</filename>, <filename><replaceable>pacchetto-2</replaceable>.install</filename>, ecc.

note: type: Content of: <book><chapter><section><para>
en: Any extra details or discrepancies between the original package and your Debian version should be documented here.
it: Ogni ulteriore dettaglio o discrepanza tra il pacchetto originale e la versione Debian dovrebbe essere documentato qui.

note: type: Content of: <book><chapter><section><para>
en: <command>dh_make</command> created a default one; this is what it looks like:
it: <command>dh_make</command> ne crea uno predefinito; ecco come appare:

note: type: Content of: <book><chapter><section><para>
en: If you have nothing to be documented, remove this file.  See <citerefentry> <refentrytitle>dh_installdocs</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.
it: Qui dovrebbero inserire delle brevi informazioni specifiche di Debian.  Si veda <citerefentry> <refentrytitle>dh_installdocs</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.

note: type: Content of: <book><chapter><section><para>
en: The <filename>compat</filename> file defines the <systemitem role="package">debhelper</systemitem> compatibility level.  Currently, you should set it to the <systemitem role="package">debhelper</systemitem> v10 as follows:
it: Il file <filename>compat</filename> definisce il livello di compatibilità di <systemitem role="package">debhelper</systemitem>.  Al momento dovrebbe essere impostato a <systemitem role="package">debhelper</systemitem> v10 nel modo seguente:

note: type: Content of: <book><chapter><section><para>
en: You may use compat level v9 in certain circumstances for compatibility with older systems. However, using any level below v9 is not recommended and should be avoided for new packages.
it: È possibile utilizzare il livello di compatibilità v9 in determinate circostanze per la compatibilità con i sistemi meno recenti. Tuttavia, l'utilizzo di qualsiasi livello inferiore al v9 non è raccomandato e dovrebbe essere evitato per i nuovi pacchetti.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <citerefentry> <refentrytitle>dpkg</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> and <ulink url="&policy-conffiles;">Debian Policy Manual, "D.2.5 Conffiles"</ulink>.
it: Vedere <citerefentry> <refentrytitle>dpkg</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> e <ulink url="&policy-conffiles;">il manuale delle policy Debian, "D.2.5 Conffiles"</ulink>.

note: type: Content of: <book><chapter><section><para>
en: One of the most annoying things about software is when you spend a great deal of time and effort customizing a program, only to have an upgrade stomp all over your changes.  Debian solves this problem by marking such configuration files as conffiles.  <placeholder type="footnote" id="0"/> When you upgrade a package, you'll be asked whether you want to keep your old configuration files or not.
it: Una delle cose più fastidiose riguardanti il software accade quando si spende una grande quantità di tempo e di sforzi per personalizzare un programma solo per vedere un aggiornamento spazzare via tutte le modifiche fatte.  Debian risolve questo problema marcando i file di configurazione come conffiles.  <placeholder type="footnote" id="0"/> Quando si aggiorna un pacchetto, verrà richiesto se si vogliono mantenere o meno i vecchi file di configurazione.

note: type: Content of: <book><chapter><section><para>
en: <citerefentry><refentrytitle>dh_installdeb</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> <emphasis>automatically</emphasis> flags any files under the <filename>/etc</filename> directory as conffiles, so if your program only has conffiles there you do not need to specify them in this file.  For most package types, the only place conffiles should ever be is under <filename>/etc</filename>, and so this file doesn't need to exist.
it: <citerefentry> <refentrytitle>dh_installdeb</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> marcherà <emphasis>automaticamente</emphasis> ogni file che si trova nella directory <filename>/etc</filename> come conffiles, così che se il programma ha soli file di configurazione in quella directory, non ci sarà bisogno di specificarli in questo file.  Per la maggior parte dei tipi di pacchetto, l'unico posto in cui si dovrebbero trovare i conffile è all'interno di <filename>/etc</filename> e quindi non c'è bisogno che questo file esista.

note: type: Content of: <book><chapter><section><para>
en: If your program uses configuration files but also rewrites them on its own, it's best not to make them conffiles because <command>dpkg</command> will then prompt users to verify the changes all the time.
it: Se il programma creato utilizza file di configurazione e li sovrascrive in automatico, è meglio non rendere questi ultimi dei file di configurazione perché <command>dpkg</command> chiederà ogni volta agli utenti di verificare i cambiamenti.

note: type: Content of: <book><chapter><section><para>
en: If the program you're packaging requires every user to modify the configuration files in the <filename>/etc</filename> directory, there are two popular ways to arrange for them to not be conffiles, keeping <command>dpkg</command> quiet:
it: Se il programma di cui si sta creando il pacchetto richiede ad ogni utente di modificare i file di configurazione nella directory <filename>/etc</filename>, ci sono principalmente due modi per non renderli conffiles e quindi di mantenere <command>dpkg</command> tranquillo:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Create a symlink under the <filename>/etc</filename> directory pointing to a file under the <filename>/var</filename> directory generated by the maintainer scripts.
it: Si può creare un link simbolico nella directory <filename>/etc</filename> che punti ad un file nella directory <filename>/var</filename> generato dagli script del manutentore.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Create a file generated by the maintainer scripts under the <filename>/etc</filename> directory.
it: Si crei un file generato dagli script del manutentore nella directory <filename>/etc</filename>.

note: type: Content of: <book><chapter><section><para>
en: For information on maintainer scripts, see <xref linkend="maintscripts"/>.
it: Per maggiori informazioni sugli script del manutentore, si veda <xref linkend="maintscripts"/>.

note: type: Content of: <book><chapter><section><title>
en: <filename><replaceable>package</replaceable>.cron.*</filename>
it: <filename><replaceable>pacchetto</replaceable>.cron.*</filename>

note: type: Content of: <book><chapter><section><para>
en: If your package requires regularly scheduled tasks to operate properly, you can use these files to set that up.  You can set up regular tasks that either happen hourly, daily, weekly, or monthly, or alternatively happen at any other time that you wish.  The filenames are:
it: Se il pacchetto creato richiede che vengano programmate delle operazioni per funzionare correttamente, si può utilizzare questo file per lo scopo.  Si possono programmare delle operazioni in modo tale che vengano eseguite su base oraria, giornaliera, settimanale, mensile o che vengano eseguite alternativamente in qualsiasi momento si voglia.  I file saranno:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <filename><replaceable>package</replaceable>.cron.hourly</filename> - Installed as <filename>/etc/cron.hourly/<replaceable>package</replaceable></filename>; run once an hour.
it: <filename><replaceable>pacchetto</replaceable>cron.hourly</filename> - Installato come <filename>/etc/cron.hourly/<replaceable>pacchetto</replaceable></filename>: viene eseguito una volta ogni ora.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <filename><replaceable>package</replaceable>.cron.daily</filename> - Installed as <filename>/etc/cron.daily/<replaceable>package</replaceable></filename>; run once a day.
it: <filename><replaceable>pacchetto</replaceable>cron.daily</filename> - Installato as <filename>/etc/cron.daily/<replaceable>pacchetto</replaceable></filename>: viene eseguito una volta al giorno.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <filename><replaceable>package</replaceable>.cron.weekly</filename> - Installed as <filename>/etc/cron.weekly/<replaceable>package</replaceable></filename>; run once a week.
it: <filename><replaceable>pacchetto</replaceable>cron.weekly</filename> - Installato come <filename>/etc/cron.weekly/<replaceable>pacchetto</replaceable></filename>: viene eseguito una volta a settimana.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <filename><replaceable>package</replaceable>.cron.monthly</filename> - Installed as <filename>/etc/cron.monthly/<replaceable>package</replaceable></filename>: run once a month.
it: <filename><replaceable>pacchetto</replaceable>cron.monthly</filename> - Installato come <filename>/etc/cron.monthly/<replaceable>pacchetto</replaceable></filename>: viene eseguito una volta al mese.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <filename><replaceable>package</replaceable>.cron.d</filename> - Installed as <filename>/etc/cron.d/<replaceable>package</replaceable></filename>: for any other time.
it: <filename><replaceable>pacchetto</replaceable>cron.d</filename> - Installato come <filename>/etc/cron.d/<replaceable>pacchetto</replaceable></filename>: per qualsiasi altro periodo.

note: type: Content of: <book><chapter><section><para>
en: Most of these files are shell scripts, with the exception of <filename><replaceable>package</replaceable>.cron.d</filename> which follows the format of <citerefentry> <refentrytitle>crontab</refentrytitle> <manvolnum>5</manvolnum> </citerefentry>.
it: Molti di questi file sono script di shell, fatta eccezione di <filename><replaceable>pacchetto</replaceable>.cron.d</filename> che segue il formato di <citerefentry> <refentrytitle>crontab</refentrytitle> <manvolnum>5</manvolnum> </citerefentry>.

note: type: Content of: <book><chapter><section><para>
en: No explicit <filename>cron.*</filename> file is needed to set up log rotation; for that, see <citerefentry><refentrytitle>dh_installlogrotate</refentrytitle> <manvolnum>1</manvolnum></citerefentry> and <citerefentry><refentrytitle>logrotate</refentrytitle><manvolnum>8</manvolnum></citerefentry>.
it: Nessun esplicito file <filename>cron.*</filename> è necessario per impostare la rotazione dei log; a questo proposito si veda <citerefentry> <refentrytitle>dh_installlogrotate</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> e <citerefentry> <refentrytitle>logrotate</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>.

note: type: Content of: <book><chapter><section><para>
en: This file specifies any directories which we need but which are not created by the normal installation procedure (<literal>make install DESTDIR=...</literal> invoked by <literal>dh_auto_install</literal>).  This generally means there is a problem with the <filename>Makefile</filename>.
it: Questo file specifica le directory di cui si ha bisogno ma che non vengono create nella normale procedura di installazione (<literal>make install DESTDIR=...</literal> chiamata da <literal>dh_auto_install</literal>).  Questo generalmente indica la presenza di un problema nel <filename>Makefile</filename>.

note: type: Content of: <book><chapter><section><para>
en: Files listed in an <filename>install</filename> file don't need their directories created first.  See <xref linkend="install"/>.
it: I file elencati nel file <filename>install</filename> non hanno bisogno che le directory vengano create prima.  Si veda <xref linkend="install"/>.

note: type: Content of: <book><chapter><section><para>
en: It is best to try to run the installation first and only use this if you run into trouble.  There is no preceding slash on the directory names listed in the <filename>dirs</filename> file.
it: Si raccomanda di provare prima ad eseguire l'installazione ed utilizzare questo file solo se si incorre in problemi.  Si noti che il carattere slash non precede il nome delle directory elencate nel file <filename>dirs</filename>.

note: type: Content of: <book><chapter><section><title>
en: <filename><replaceable>package</replaceable>.doc-base</filename>
it: <filename><replaceable>pacchetto</replaceable>.doc-base</filename>

note: type: Content of: <book><chapter><section><para>
en: If your package has documentation other than manual and info pages, you should use the <systemitem role="package">doc-base</systemitem> file to register it, so the user can find it with e.g.  <citerefentry> <refentrytitle>dhelp</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>dwww</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, or <citerefentry> <refentrytitle>doccentral</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.
it: Se il pacchetto generato ha altra documentazione oltre alle pagine di manuale e di info, dovrebbe essere utilizzato il file <systemitem role="package">doc-base</systemitem> per segnalarla in modo che l'utente possa trovarla con, ad esempio <citerefentry> <refentrytitle>dhelp</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>dwww</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> o <citerefentry> <refentrytitle>doccentral</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.

note: type: Content of: <book><chapter><section><para>
en: This usually includes HTML, PS and PDF files, shipped in <filename>/usr/share/doc/<replaceable>packagename</replaceable>/</filename>.
it: Questa documentazione è solitamente costituita da documenti HTML, file PS e PDF, disponibili in <filename>/usr/share/doc/<replaceable>nomepacchetto</replaceable>/</filename>.

note: type: Content of: <book><chapter><section><para>
en: This is what <systemitem role="package">gentoo</systemitem>'s doc-base file <filename>gentoo.doc-base</filename> looks like:
it: Questo è il modo in cui il file doc-base di <systemitem role="package">gentoo</systemitem>, <filename>gentoo.doc-base</filename>, appare:

note: type: Content of: <book><chapter><section><para>
en: For information on the file format, see <citerefentry> <refentrytitle>install-docs</refentrytitle> <manvolnum>8</manvolnum> </citerefentry> and the Debian <systemitem role="package">doc-base</systemitem> manual at the local copy <filename>&doc-base;</filename> provided by the <systemitem role="package">doc-base</systemitem> package.
it: Per informazioni sul formato del file si veda <citerefentry> <refentrytitle>install-docs</refentrytitle> <manvolnum>8</manvolnum> </citerefentry> ed la copia locale del manuale Debian <systemitem role="package">doc-base</systemitem>, reperibile con il pacchetto <systemitem role="package">doc-base</systemitem>.

note: type: Content of: <book><chapter><section><para>
en: For more details on installing additional documentation, look in <xref linkend="destdir"/>.
it: Per ulteriori dettagli su come installare documentazione aggiuntiva, si veda in <xref linkend="destdir"/>.

note: type: Content of: <book><chapter><section><para>
en: This file specifies the file names of documentation files we can have <citerefentry> <refentrytitle>dh_installdocs</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> install into the temporary directory for us.
it: Questo file specifica il nome dei file di documentazione che si possono avere <citerefentry> <refentrytitle>dh_installdocs</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> li installa nella directory temporanea automaticamente.

note: type: Content of: <book><chapter><section><para>
en: By default, it will include all existing files in the top-level source directory that are called <filename>BUGS</filename>, <filename>README*</filename>, <filename>TODO</filename> etc.
it: Normalmente, questo file includerà tutti i file esistenti nella directory dei sorgenti di più alto livello che sono chiamati <filename>BUGS</filename>, <filename>README*</filename>, <filename>TODO</filename> ecc.

note: type: Content of: <book><chapter><section><para>
en: For <systemitem role="package">gentoo</systemitem>, some other files are also included:
it: Per il pacchetto <systemitem role="package">gentoo</systemitem>, sono stati inclusi anche altri files:

note: type: Content of: <book><chapter><section><para>
en: If your package supplies Emacs files that can be bytecompiled at package installation time, you can use these files to set it up.
it: Se il pacchetto generato contiene file Emacs che possono essere compilati al momento dell'installazione, possono essere usati per impostarli.

note: type: Content of: <book><chapter><section><para>
en: They are installed into the temporary directory by <citerefentry> <refentrytitle>dh_installemacsen</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.
it: Tali file sono installati nella directory temporanea con <citerefentry> <refentrytitle>dh_installemacsen</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.

note: type: Content of: <book><chapter><section><para>
en: If you don't need these, remove them.
it: Se non se ne ha bisogno, possono essere eliminati.

note: type: Content of: <book><chapter><section><title>
en: <filename><replaceable>package</replaceable>.examples</filename>
it: <filename><replaceable>pacchetto</replaceable>.examples</filename>

note: type: Content of: <book><chapter><section><para>
en: The <citerefentry> <refentrytitle>dh_installexamples</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> command installs files and directories listed in this file as example files.
it: Il comando <citerefentry> <refentrytitle>dh_installexamples</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> installa i file e le directory elencati al suo interno come file di esempio.

note: type: Content of: <book><chapter><section><title>
en: <filename><replaceable>package</replaceable>.init</filename> and <filename><replaceable>package</replaceable>.default</filename>
it: <filename><replaceable>pacchetto</replaceable>.init</filename> e <filename><replaceable>pacchetto</replaceable>.default</filename>

note: type: Content of: <book><chapter><section><para>
en: If your package is a daemon that needs to be run at system start-up, you've obviously disregarded my initial recommendation, haven't you? :-)
it: Se il pacchetto generato è un demone che deve partire all'avvio del sistema, hai chiaramente ignorato le mie raccomandazioni iniziali, vero? :-)

note: type: Content of: <book><chapter><section><para>
en: If your upstream program provides a file for the init script, you can either use it or not.  If you don't use their init script then create a new one in <filename><replaceable>package</replaceable>.init</filename>.  However if the upstream init script looks fine and installs in the right place you still need to set up the <filename>rc*</filename> symlinks.  To do this you will need to override <command>dh_installinit</command> in the <filename>rules</filename> file with the following lines:
it: Se il programma originale ha un file di init si può decidere di utilizzarlo o meno.  Se non viene utilizzato quello script init.d allora ne dovrà essere creato uno nuovo in <filename>debian/<replaceable>pacchetto</replaceable>.init</filename>.  Comunque se lo script di init originale sembra funzionare bene ed installa tutto nella corretta destinazione, si devono comunque impostare i link simbolici <filename>rc*</filename>.  Per fare questo si deve sovrascrivere <command>dh_installinit</command> nel file <filename>rules</filename> con le seguenti righe:

note: type: Content of: <book><chapter><section><para>
en: If you don't need this, remove the files.
it: Se non si ha bisogno di tutto ciò, si possono rimuovere i file.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: This replaces the deprecated <citerefentry> <refentrytitle>dh_movefiles</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> command which is configured by the <filename>files</filename> file.
it: Questo comando rimpiazza il comando <citerefentry> <refentrytitle>dh_movefiles</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, ormai deprecato, che veniva configurato dal file <filename>files</filename>.

note: type: Content of: <book><chapter><section><para>
en: If there are files that need to be installed into your package but your standard <literal>make install</literal> won't do it, put the filenames and destinations into this <filename>install</filename> file.  They are installed by <citerefentry> <refentrytitle>dh_install</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.<placeholder type="footnote" id="0"/> You should first check that there is not a more specific tool to use.  For example, documents should be in the <filename>docs</filename> file and not in this one.
it: Se ci sono dei file che devono essere installati nel pacchetto ma con il normale comando <literal>make install</literal> non vengono elaborati, i nomi di quest'ultimi e le cartelle di destinazione vanno messe in questo file <filename>install</filename>.  Tali file vengono installati con il comando <citerefentry> <refentrytitle>dh_install</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.<placeholder type="footnote" id="0"/> Andrebbe innanzitutto controllato che non ci sia uno strumento più specifico da poter utilizzare.  Per esempio, i documenti dovrebbero essere elencati nel file <filename>docs</filename> e non in questo file.

note: type: Content of: <book><chapter><section><para>
en: This <filename>install</filename> file has one line per file installed, with the name of the file (relative to the top build directory) then a space then the installation directory (relative to the install directory).  One example of where this is used is if a binary <filename>src/<replaceable>bar</replaceable></filename> is left uninstalled; the <filename>install</filename> file might look like:
it: Nel file <filename>install</filename> compare una riga per ogni file installato, contenente il nome del file (relativo alla directory in cui avviene la costruzione del pacchetto), uno spazio e la directory di installazione (relativa alla posizione del file install).  Un esempio dell'utilizzo è quando un file binario <filename>src/<replaceable>bar</replaceable></filename> non è stato installato, in questo caso il file <filename>install</filename> dovrebbe essere:

note: type: Content of: <book><chapter><section><para>
en: This means when this package is installed, there will be an executable command <filename>/usr/bin/<replaceable>bar</replaceable></filename>.
it: Questo significa che quando il pacchetto verrà installato, ci sarà un file eseguibile <filename>/usr/bin/<replaceable>bar</replaceable></filename>.

note: type: Content of: <book><chapter><section><para>
en: Alternatively, this <filename>install</filename> can have the name of the file only without the installation directory when the relative directory path does not change.  This format is usually used for a large package that splits the output of its build into multiple binary packages using <filename><replaceable>package-1</replaceable>.install</filename>, <filename><replaceable>package-2</replaceable>.install</filename>, etc.
it: Alternativamente, questo file <filename>install</filename> può presentare il nome del file senza la directory di installazione solo quando il percorso relativo della directory non cambia.  Questo formato è solitamente utilizzato per grandi pacchetti che organizzano i risultati della costruzione in pacchetti multipli utilizzando <filename><replaceable>pacchetto-1</replaceable>.install</filename>, <filename><replaceable>pacchetto-2</replaceable>.install</filename>, ecc.

note: type: Content of: <book><chapter><section><para>
en: The <command>dh_install</command> command will fall back to looking in <filename>debian/tmp</filename> for files, if it doesn't find them in the current directory (or wherever you've told it to look using <literal>--sourcedir</literal>).
it: Il comando <command>dh_install</command> andrà a controllare nella cartella <filename>debian/tmp</filename> alla ricerca di file, se non ne trova nella directory corrente (or in qualsiasi altro posto si sia indicato di guardare utilizzando <literal>--sourcedir</literal>).

note: type: Content of: <book><chapter><section><title>
en: <filename><replaceable>package</replaceable>.info</filename>
it: <filename><replaceable>pacchetto</replaceable>.info</filename>

note: type: Content of: <book><chapter><section><para>
en: If your package has info pages, you should install them using <citerefentry> <refentrytitle>dh_installinfo</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> by listing them in a <filename><replaceable>package</replaceable>.info</filename> file.
it: Se il pacchetto generato ha delle pagine info, queste andrebbero installate utilizzando il comando <citerefentry> <refentrytitle>dh_installinfo</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> ed elencandole nei file <filename><replaceable>pacchetto</replaceable>.info</filename>.

note: type: Content of: <book><chapter><section><title>
en: <filename><replaceable>package</replaceable>.links</filename>
it: <filename><replaceable>pacchetto</replaceable>.links</filename>

note: type: Content of: <book><chapter><section><para>
en: If you need to create additional symlinks in package build directories as package maintainer, you should install them using <citerefentry> <refentrytitle>dh_link</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> by listing their full paths of source and destination files in a <filename><replaceable>package</replaceable>.links</filename> file.
it: Se è necessario creare dei collegamenti simbolici aggiuntivi nella directory utilizzata per la creazione del pacchetto, si dovrebbero installare, come maintainer del pacchetto, utilizzando  <citerefentry> <refentrytitle>dh_link</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> con il path per esteso della sorgente e della destinazione dei file nel file <filename><replaceable>package</replaceable>.links</filename>.

note: type: Content of: <book><chapter><section><title>
en: <filename>{<replaceable>package</replaceable>.,source/}lintian-overrides</filename>
it: <filename>{<replaceable>pacchetto</replaceable>.,source/}lintian-overrides</filename>

note: type: Content of: <book><chapter><section><para>
en: If <systemitem role="package">lintian</systemitem> reports an erroneous diagnostic for a case where Debian policy allows exceptions to some rule, you can use <filename><replaceable>package</replaceable>.lintian-overrides</filename> or <filename>source/lintian-overrides</filename> to quieten it.  Please read the Lintian User's Manual (<filename>&lintian-doc;</filename>) and refrain from abusing this.
it: Se il pacchetto <systemitem role="package">lintian</systemitem> segnala degli errori di diagnostica in un caso in cui esista una policy Debian che ammette delle eccezioni alle regole, si possono utilizzare i file <filename><replaceable>pacchetto</replaceable>.lintian-overrides</filename> o <filename>source/lintian-overrides</filename> per inibire le segnalazioni.  Si legga il manuale utente di Lintian (<filename>&lintian-doc;</filename>) e si eviti di farne un uso eccessivo.

note: type: Content of: <book><chapter><section><para>
en: <filename><replaceable>package</replaceable>.lintian-overrides</filename> is for the binary package named <systemitem role="package"><replaceable>package</replaceable></systemitem> and is installed into <filename>usr/share/lintian/overrides/<replaceable>package</replaceable></filename> by the <command>dh_lintian</command> command.
it: Il file <filename><replaceable>pacchetto</replaceable>.lintian-overrides</filename> è utilizzato per il pacchetto binario chiamato <systemitem role="package"><replaceable>pacchetto</replaceable></systemitem> ed è installato in <filename>usr/share/lintian/overrides/<replaceable>pacchetto</replaceable></filename> dal comando <command>dh_lintian</command>.

note: type: Content of: <book><chapter><section><para>
en: <filename>source/lintian-overrides</filename> is for the source package.  This is not installed.
it: Il file <filename>source/lintian-overrides</filename> è utilizzato per il pacchetto sorgente.  Questo non viene installato.

note: type: Content of: <book><chapter><section><para>
en: Your program(s) should have a manual page.  If they don't, you should create them.  The <command>dh_make</command> command creates some template files for manual pages.  These need to be copied and edited for each command missing its manual page.  Please make sure to remove unused templates.
it: I programmi creati dovrebbero avere una pagina di manuale.  In caso contrario bisogna crearla.  Il comando <command>dh_make</command> crea diversi file modello per la pagina di manuale.  Questi devono essere copiati e modificati per ogni comando senza pagina di manuale.  Si faccia attenzione a rimuovere i file modello non utilizzati.

note: type: Content of: <book><chapter><section><section><para>
en: Manual pages are normally written in <citerefentry> <refentrytitle>nroff</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.  The <filename>manpage.1.ex</filename> template is written in <command>nroff</command>, too.  See the <citerefentry> <refentrytitle>man</refentrytitle> <manvolnum>7</manvolnum> </citerefentry> manual page for a brief description of how to edit such a file.
it: Le pagine del manuale sono solitamente scritte per <citerefentry> <refentrytitle>nroff</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.  Anche il file modello <filename>manpage.1.ex</filename> è scritto per <command>nroff</command>.  Si veda la pagina di manuale <citerefentry> <refentrytitle>man</refentrytitle> <manvolnum>7</manvolnum> </citerefentry> per una breve descrizione su come modificare un file del genere.

note: type: Content of: <book><chapter><section><section><para>
en: The final manual page file name should give the name of the program it is documenting, so we will rename it from <literal>manpage</literal> to <literal>gentoo</literal>.  The file name also includes <literal>.1</literal> as the first suffix, which means it's a manual page for a user command.  Be sure to verify that this section is indeed the correct one.  Here's a short list of manual page sections:
it: L'ultimo file delle pagine del manuale dovrebbe includere il nome del programma che si sta documentando, quindi verrà rinominato da <literal>manpage</literal> a <literal>gentoo</literal>.  Il nome del file include anche <literal>.1</literal> come primo suffisso, il che sta ad indicare che la sezione della pagina del manuale è relativa ad un comando dell'utente.  Si verifichi che questa sezione sia quella corretta.  Qui di seguito viene presentata una breve lista delle sezioni delle pagine del manuale:

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><thead><row><entry>
en: Section
it: Sezione

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><thead><row><entry>
en: Description
it: Descrizione

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><thead><row><entry>
en: Notes
it: Note

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: User commands
it: Comandi utente

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Executable commands or scripts
it: Comandi eseguibili o script

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: System calls
it: Chiamate di sistema

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Functions provided by the kernel
it: Funzioni fornite dal kernel

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Library calls
it: Chiamate alla libreria

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Functions within system libraries
it: Funzioni delle librerie di sistema

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Special files
it: File speciali

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Usually found in <filename>/dev</filename>
it: Posizionati normalmente in <filename>/dev</filename>

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: File formats
it: Formati di file

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: E.g. <filename>/etc/passwd</filename>'s format
it: Ad esempio il formato del file <filename>/etc/passwd </filename>

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Games
it: Giochi

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Games or other frivolous programs
it: Giochi o altri programmi frivoli

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Macro packages
it: Pacchetti di macro

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Such as <command>man</command> macros
it: Come le macro di <command>man</command>

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: System administration
it: Amministrazione del sistema

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Programs typically only run by root
it: Programmi di norma eseguibili solo da root

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Kernel routines
it: Kernel routine

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Non-standard calls and internals
it: Chiamate non standard e interne

note: type: Content of: <book><chapter><section><section><para>
en: So <systemitem role="package">gentoo</systemitem>'s man page should be called <filename>gentoo.1</filename>.  If there was no <filename>gentoo.1</filename> man page in the original source, you should create it by renaming the <filename>manpage.1.ex</filename> template to <filename>gentoo.1</filename> and editing it using information from the example and from the upstream docs.
it: Così la pagina man del pacchetto <systemitem role="package">gentoo</systemitem> dovrebbe chiamarsi <filename>gentoo.1</filename>.  Se non ci fosse alcuna pagina man <filename>gentoo.1</filename> nei sorgenti originali, andrebbe creata rinominando il modello <filename>manpage.1.ex</filename> in <filename>gentoo.1</filename> e modificandolo utilizzando le informazioni contenute negli esempi e nei documenti originali.

note: type: Content of: <book><chapter><section><section><para><footnote><para>
en: Note that <command>help2man</command>'s placeholder man page will claim that more detailed documentation is available in the info system. If the command is missing an <command>info</command> page, you should manually edit the man page created by the <command>help2man</command> command.
it: Si noti che i segnaposto di <command>help2man</command> contengono la documentazione più dettagliata disponibile nel sistema info. Se al comando manca la pagina <command>info</command> si dovrebbe modificare manualmente la pagina man generata dal comando <command>help2man</command>.

note: type: Content of: <book><chapter><section><section><para>
en: You can use the <command>help2man</command> command to generate a man page out of the <literal>--help</literal> and <literal>--version</literal> output of each program, too.  <placeholder type="footnote" id="0"/>
it: Si può utilizzare il comando <command>help2man</command> per generare una pagina di manuale, priva del risultato di <literal>--help</literal> and <literal>--version</literal>, per ogni programma.  <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><section><para>
en: If on the other hand you prefer writing SGML instead of <command>nroff</command>, you can use the <filename>manpage.sgml.ex</filename> template.  If you do this, you have to:
it: Se d'altra parte si preferisce scrivere in SGML piuttosto che utilizzare <command>nroff</command>, si può utilizzare il modello <filename>manpage.sgml.ex</filename>.  Se si procede in questo modo andrà:

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: rename the file to something like <filename>gentoo.sgml</filename>.
it: rinominato il file in qualcosa del tipo <filename>gentoo.sgml</filename>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: install the <systemitem role="package">docbook-to-man</systemitem> package
it: installato il pacchetto <systemitem role="package">docbook-to-man</systemitem>

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: add <literal>docbook-to-man</literal> to the <literal>Build-Depends</literal> line in the <filename>control</filename> file
it: aggiunto <literal>docbook-to-man</literal> alla linea <literal>Build-Depends</literal> nel file <filename>control</filename>

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: add an <literal>override_dh_auto_build</literal> target to your <filename>rules</filename> file:
it: aggiungere un obiettivo <literal>override_dh_auto_build</literal> al file <filename>rules</filename> :

note: type: Content of: <book><chapter><section><section><para>
en: If you prefer XML over SGML, you can use the <literal>manpage.xml.ex</literal> template.  If you do this, you have to:
it: Se si preferisce l'XML all'SGML, si può utilizzare il modello <literal>manpage.xml.ex</literal>.  Se si decide questa modalità si avranno due scelte:

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: rename the source file to something like <literal>gentoo.1.xml</literal>
it: rinominare il file in qualcosa del tipo <literal>gentoo.1.xml</literal>

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: install the <systemitem role="package">docbook-xsl</systemitem> package and an XSLT processor like <systemitem role="package">xsltproc</systemitem> (recommended)
it: installare il pacchetto <systemitem role="package">docbook-xsl</systemitem> e l'elaboratore XSLT come <systemitem role="package">xsltproc</systemitem> (recommended)

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: add the <literal>docbook-xsl</literal>, <literal>docbook-xml</literal>, and <literal>xsltproc</literal> packages to the <literal>Build-Depends</literal> line in the <literal>control</literal> file
it: aggiungere i pacchetti <literal>docbook-xsl</literal>, <literal>docbook-xml</literal> e <literal>xsltproc</literal> alla linea <literal>Build-Depends</literal> nel file <literal>control</literal>

note: type: Content of: <book><chapter><section><title>
en: <filename><replaceable>package</replaceable>.manpages</filename>
it: <filename><replaceable>pacchetto</replaceable>.manpages</filename>

note: type: Content of: <book><chapter><section><para>
en: If your package has manual pages, you should install them using <citerefentry> <refentrytitle>dh_installman</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> by listing them in a <filename><replaceable>package</replaceable>.manpages</filename> file.
it: Se il pacchetto creato presenta delle pagine del manuale, queste andrebbero installate utilizzando il comando <citerefentry> <refentrytitle>dh_installman</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> ed elencandole nei file <filename><replaceable>pacchetto</replaceable>.manpages</filename>.

note: type: Content of: <book><chapter><section><para>
en: To install <filename>docs/gentoo.1</filename> as a manpage for the <systemitem role="package">gentoo</systemitem> package, create a <filename>gentoo.manpages</filename> file as follows:
it: Per installare il file <filename>doc/gentoo.1</filename> come pagine di manuale per il pacchetto <systemitem role="package">gentoo</systemitem>, si deve creare il file <filename>gentoo.manpages</filename> contenente:

note: type: Content of: <book><chapter><section><para>
en: The <citerefentry> <refentrytitle>dh_installchangelogs</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> command installs this.
it: Il comando <citerefentry> <refentrytitle>dh_installchangelogs</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> installa questo file.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Despite this use of the <command>bash</command> shorthand expression <filename>{pre,post}{inst,rm}</filename> to indicate these filenames, you should use pure POSIX syntax for these maintainer scripts for compatibility with <command>dash</command> as the system shell.
it: Nonostante l'utilizzo dell'espressione <command>bash</command> <filename>{pre,post}{inst,rm}</filename> per indicare questi file, è necessario utilizzare la sintassi POSIX per questi script di manutenzione per mantenere la compatibilità con la shell di sistema <command>dash</command>.

note: type: Content of: <book><chapter><section><para>
en: These <filename>postinst</filename>, <filename>preinst</filename>, <filename>postrm</filename>, and <filename>prerm</filename> files <placeholder type="footnote" id="0"/> are called <emphasis>maintainer scripts</emphasis>.  They are scripts which are put in the control area of the package and run by <command>dpkg</command> when your package is installed, upgraded, or removed.
it: I files <filename>postinst</filename>, <filename>preinst</filename>, <filename>postrm</filename> e <filename>prerm</filename> <placeholder type="footnote" id="0"/> vengono chiamati <emphasis>script del manutentore</emphasis>.  Questi sono script che vengono messi nell'area di controllo del pacchetto e vengono lanciati dal comando <command>dpkg</command> quando il pacchetto viene installato, aggiornato o rimosso.

note: type: Content of: <book><chapter><section><para>
en: As a novice maintainer, you should avoid any manual editing of maintainer scripts because they are problematic.  For more information refer to the <ulink url="&policy-mantainerscripts;">Debian Policy Manual, 6 "Package maintainer scripts and installation procedure"</ulink>, and take a look at the example files provided by <command>dh_make</command>.
it: Un nuovo manutentore dovrebbe, se possibile, evitare ogni modifica manuale degli script del manutentore perché potrebbero creare dei problemi.  Per maggiori informazioni si guardi nel <ulink url="&policy-mantainerscripts;">Manuale delle policy di Debian, 6 'Script di manutenzione del pacchetto e procedure di installazione'</ulink>, e si dia un'occhiata ai file di esempio forniti da <command>dh_make</command>.

note: type: Content of: <book><chapter><section><para>
en: If you did not listen to me and have created custom maintainer scripts for a package, you should make sure to test them not only for <emphasis role="strong">install</emphasis> and <emphasis role="strong">upgrade</emphasis> but also for <emphasis role="strong">remove</emphasis> and <emphasis role="strong">purge</emphasis>.
it: Se si sono, comunque, creati dei script del manutentore personalizzati per un pacchetto, bisogna essere sicuri di averli provati non solo per <emphasis role="strong">install</emphasis> e <emphasis role="strong">upgrade</emphasis>, ma anche per <emphasis role="strong">remove</emphasis> e <emphasis role="strong">purge</emphasis>.

note: type: Content of: <book><chapter><section><para>
en: Upgrades to the new version should be silent and non-intrusive (existing users should not notice the upgrade except by discovering that old bugs have been fixed and perhaps that there are new features).
it: Gli aggiornamenti alle nuove versioni dovrebbero essere indolore e non invadenti (gli utenti esistenti non dovrebbero notare gli aggiornamenti a meno di scoprire che vecchi bug sono stati corretti e che vi sono magari delle nuove funzionalità).

note: type: Content of: <book><chapter><section><para>
en: When the upgrade is necessarily intrusive (eg., config files scattered through various home directories with totally different structure), you may consider as the last resort switching the package to a safe fallback state (e.g., disabling a service) and providing the proper documentation required by policy (<filename>README.Debian</filename> and <filename>NEWS.Debian</filename>).  Don't bother the user with <command>debconf</command> notes invoked from these maintainer scripts for upgrades.
it: Quando l'aggiornamento deve per forza di cose essere invadente (per esempio, file di configurazione sparsi all'interno di diverse cartelle home con strutture totalmente differenti), si può impostare il pacchetto ai valori sicuri predefiniti (esempio, servizi disabilitati) e fornire una valida documentazione come richiesto dalla policy (<filename>README.Debian</filename> e <filename>NEWS.Debian</filename>) come ultima spiaggia.  Sarebbe meglio non disturbare l'utente con la nota <command>debconf</command> richiamata da questi script del manutentore per gli aggiornamenti.

note: type: Content of: <book><chapter><section><para>
en: The <systemitem role="package">ucf</systemitem> package provides a <emphasis>conffile-like</emphasis> handling infrastructure to preserve user changes for files that may not be labeled as <emphasis>conffiles</emphasis> such as those managed by the maintainer scripts.  This should minimize issues associated with them.
it: Il pacchetto <systemitem role="package">ucf</systemitem> fornisce una infrastruttura di gestione <emphasis>simil-conffile</emphasis> per preservare cambiamenti effettuati dall'utente in file che non possono essere etichettati come <emphasis>conffile</emphasis>, come ad esempio quelli gestiti dagli script del manutentore.  Questo dovrebbe ridurre al minimo i problemi ad esso associati.

note: type: Content of: <book><chapter><section><para>
en: These maintainer scripts are among the Debian enhancements that explain <emphasis role="strong">why people choose Debian</emphasis>.  You must be very careful not to turn them into a source of annoyance.
it: Questi script del manutentore sono delle migliorie di Debian che fanno capire <emphasis role="strong">come mai le persone scelgano Debian</emphasis>.  Bisogna stare molto attenti a non infastidirle a causa loro.

note: type: Content of: <book><chapter><section><para>
en: Packaging of a library is not easy for a novice maintainer and should be avoided.  Having said it, if your package has libraries, you should have <filename>debian/<replaceable>package</replaceable>.symbols</filename> files. See <xref linkend="librarysymbols"/>.
it: Creare il pacchetto di una libreria non è semplice per un maintainer con poca esperienza e dovrebbe essere evitato.  Detto questo, se il pacchetto in questione ha delle librerie, si dovrebbero avere dei file <filename>debian/<replaceable>package</replaceable>.symbols</filename> files. Si veda <xref linkend="librarysymbols"/>.

note: type: Content of: <book><chapter><section><para>
en: The <citerefentry> <refentrytitle>dh_installdocs</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> command installs this.
it: Il comando <citerefentry> <refentrytitle>dh_installdocs</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> installa questo file.

note: type: Content of: <book><chapter><section><para>
en: The <filename>watch</filename> file format is documented in the <citerefentry> <refentrytitle>uscan</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> manpage.  The <filename>watch</filename> file configures the <command>uscan</command> program (in the <systemitem role="package">devscripts</systemitem> package) to watch the site where you originally got the source.  This is also used by the <ulink url="&debtrack;">Debian Package Tracker</ulink> service.
it: Il formato del file <filename>watch</filename> è documentato nella pagina di manuale <citerefentry> <refentrytitle>uscan</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.  Il file <filename>watch</filename> configura il programma <command>uscan</command> (nel pacchetto <systemitem role="package">devscripts</systemitem>) per controllare il sito da cui è stato scaricato il sorgente originale.  Questo file viene utilizzato pure dal servizio <ulink url="&debtrack;">Debian Package Tracker</ulink>.

note: type: Content of: <book><chapter><section><para>
en: Here are its contents:
it: Ecco il suo contenuto:

note: type: Content of: <book><chapter><section><para>
en: Normally with a <filename>watch</filename> file, the URL at <literal>&sf-net;/gentoo</literal> is downloaded and searched for links of the form <literal>&lt;a href=...&gt;</literal>.  The basename (just the part after the final <literal>/</literal>) of each linked URL is compared against the Perl regular expression pattern (see <citerefentry> <refentrytitle>perlre</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>)  <literal>gentoo-(.+)\.tar\.gz</literal>.  Out of the files that match, the one with the greatest version number is downloaded and the <command>uupdate</command> program is run to create an updated source tree.
it: Normalmente con il file <filename>watch</filename>, l'URL <literal>&sf-net;/gentoo</literal> viene scaricato per cercare dei collegamenti del tipo <literal>&lt;a href=...&gt;</literal>.  Il nome base (la parte appena dopo l'ultimo <literal>/</literal>) di questi URL sono confrontati con l'espressione regolare Perl (si veda <citerefentry> <refentrytitle>perlre</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>)  <literal>gentoo-(.+)\.tar\.gz</literal>.  Tra i file che combaciano viene scaricato quello avente il numero di versione più grande e viene avviato il programma <command>uupdate</command> per creare un albero dei sorgenti aggiornato.

note: type: Content of: <book><chapter><section><para>
en: Although this is true for other sites, the SourceForge download service at <ulink url="&sf-net;"/> is an exception.  When the <filename>watch</filename> file has a URL matching the Perl regexp <literal>^http://sf\.net/</literal>, the <command>uscan</command> program replaces it with <literal>&qa-do;watch/sf.php/</literal> and then applies this rule.  The URL redirector service at <ulink url="&qa-do;"/> is designed to offer a stable redirect service to the desired file for any <filename>watch</filename> pattern of the form <literal>&sf-net;/<replaceable>project</replaceable>/<replaceable>tar-name</replaceable>-(.+)\.tar\.gz</literal>.  This solves issues related to periodically changing SourceForge URLs.
it: Sebbene questo sia vero per la maggior parte dei siti, il servizio di scaricamento di SourceForge su <ulink url="&sf-net;"/> è un'eccezione.  Quando il file <filename>watch</filename> ha un URL che corrisponde all'espressione regolare perl <literal>^http://sf\.net/</literal>, il programma <command>uscan</command> lo sostituisce con <literal>&qa-do;watch/sf.php/</literal>.  Il servizio di reindirizzamento degli URL <ulink url="&qa-do;"/> è progettato per mettere a disposizione un sistema stabile per reindirizzare gli URL tipo <literal>&sf-net;/<replaceable>project</replaceable>/<replaceable>tar-name</replaceable>-(.+)\.tar\.gz</literal> presenti i nel file <filename>watch</filename>.  Questo risolve il problema relativo al cambiamento periodico degli URL di SourceForge.

note: type: Content of: <book><chapter><section><para>
en: If the upstream offers the cryptographic signature of the tarball, it is recommended to verify its authenticity using the <literal>pgpsigurlmangle</literal> option as described in <citerefentry> <refentrytitle>uscan</refentrytitle><manvolnum>1</manvolnum> </citerefentry>.
it: Se il pacchetto originale dispone di una firma crittografica dell'archivio, si consiglia di verificarne l'autenticità utilizzando l'opzione <literal>pgpsigurlmangle</literal> come descritto in <citerefentry> <refentrytitle>uscan</refentrytitle><manvolnum>1</manvolnum> </citerefentry>.

note: type: Content of: <book><chapter><section><para>
en: In the <filename>debian/source/format</filename> file, there should be a single line indicating the desired format for the source package (check <citerefentry> <refentrytitle>dpkg-source</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> for an exhaustive list).  After <literal>squeeze</literal>, it should say either:
it: Nel file <filename>debian/source/format</filename>, ci dovrebbe essere una unica riga che indichi il formato desiderato per il pacchetto sorgente (controllare <citerefentry> <refentrytitle>dpkg-source</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> per una lista completa).  Dopo <literal>squeeze</literal>, dovrebbe scrivere:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>3.0 (native)</literal> for native Debian packages or
it: <literal>3.0 (native)</literal> per i pacchetti nativi Debian o

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>3.0 (quilt)</literal> for everything else.
it: <literal>3.0 (quilt)</literal>per tutti gli altri.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&debsrc3;">DebSrc3.0</ulink> for a summary on the switch to the new <literal>3.0 (quilt)</literal> and <literal>3.0 (native)</literal> source formats.
it: Si veda <ulink url="&debsrc3;">DebSrc3.0</ulink> per una serie di informazioni generali riguardanti il passaggio al nuovo formato <literal>3.0 (quilt)</literal> ed ai formati sorgente <literal>3.0 (native)</literal>.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Actually, this new format also supports multiple upstream tarballs and more compression methods.  These are beyond the scope of this document.
it: Al momento questo nuovo formato supporta anche molteplici archivi e più metodi di compressione.  Questi però esulano dall'obiettivo di questo documento.

note: type: Content of: <book><chapter><section><para>
en: The newer <literal>3.0 (quilt)</literal> source format records modifications in a <command>quilt</command> patch series within <filename>debian/patches</filename>.  Those changes are then automatically applied during extraction of the source package.  <placeholder type="footnote" id="0"/> The Debian modifications are simply stored in a <filename>debian.tar.gz</filename> archive containing all files under the <filename>debian</filename> directory.  This new format supports inclusion of binary files such as PNG icons by the package maintainer without requiring tricks.  <placeholder type="footnote" id="1"/>
it: Il nuovo formato sorgente <literal>3.0 (quilt)</literal> registra le modifiche in una serie di patch <command>quilt</command> all'interno di <filename>debian/patches</filename>.  Questi cambiamenti vengono poi automaticamente applicati durante l'estrazione del pacchetto sorgente.  <placeholder type="footnote" id="0"/> Le modifiche di Debian sono semplicemente mantenute in un archivio <filename>debian.tar.gz</filename> contenente tutti i file sotto la directory <filename>debian</filename>.  Questo nuovo formato supporta l'inclusione di file binari come per esempio le icone PNG del manutentore del pacchetto senza richiedere trucchi.<placeholder type="footnote" id="1"/>

note: type: Content of: <book><chapter><section><para>
en: When <command>dpkg-source</command> extracts a source package in <literal>3.0 (quilt)</literal> source format, it automatically applies all patches listed in <filename>debian/patches/series</filename>.  You can avoid applying patches at the end of the extraction with the <literal>--skip-patches</literal> option.
it: Quando <command>dpkg-source</command> estrae un pacchetto sorgente nel formato <literal>3.0 (quilt)</literal>, applica automaticamente tutte le patch elencate nel file <filename>debian/patches/series</filename>.  Si può evitare di applicare le patch alla fine dell'estrazione con l'opzione <literal>--skip-patches</literal>.

note: type: Content of: <book><chapter><section><para>
en: When you want to manage Debian packaging activities under a VCS, you typically create one branch (e.g., <literal>upstream</literal>) tracking the upstream source and another branch (e.g., typically <literal>master</literal> for Git)  tracking the Debian package.  For the latter, you usually want to have unpatched upstream source with your <filename>debian/*</filename> files for the Debian packaging to ease merging of the new upstream source.
it: Quando si vogliono gestire le attività di pacchettizzazione utilizzando un VCS, di norma si crea un ramo (es.  <literal>upstream</literal>) in cui si tiene traccia dei cambiamenti apportanti al sorgente originale, e un altro ramo (es.  di solito <literal>master</literal> per Git) in cui si tiene traccia delle modifiche apportate al pacchetto.  In fine, è consigliato avere i sorgenti originali senza pach con i file in <filename>debian/*</filename> per il pacchetto Debian, per fare facilitare le operazioni di fusione con il nuovo sorgente originale.

note: type: Content of: <book><chapter><section><para>
en: After you build a package, the source is normally left patched.  You need to unpatch it manually by running <literal>dquilt pop -a</literal> before committing to the <literal>master</literal> branch.  You can automate this by adding the optional <filename>debian/source/local-options</filename> file containing <literal>unapply-patches</literal>.  This file is not included in the generated source package and changes the local build behavior only.  This file may contain <literal>abort-on-upstream-changes</literal>, too (see <citerefentry> <refentrytitle>dpkg-source</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>).
it: Dopo aver costruito il pacchetto, il sorgente è di norma pachato.  È necessario togliere la patch manualmente, eseguendo <literal>dquilt pop -a</literal>, prima di caricarlo nel ramo <literal>master</literal>.  Si può automatizzare l'operazione, aggiungendo il file <filename>debian/source/local-options</filename> con contenuto <literal>unapply-patches</literal>.  Questo file non è incluso nel sorgente del pacchetto generato, e cambia solamente la modalità di costruzione in locale.  Questo file può contenere anche <literal>abort-on-upstream-changes</literal>, (si veda <citerefentry> <refentrytitle>dpkg-source</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>).

note: type: Content of: <book><chapter><section><para>
en: The autogenerated files in the source tree can be quite annoying for packaging since they generate meaningless large patch files.  There are custom modules such as <command>dh_autoreconf</command> to ease this problem as described in <xref linkend="customrules"/>.
it: I file generati automaticamente nell'albero dei sorgenti possono essere molto fastidiosi per la pacchettizzazione, in quanto generano file di patch senza senso e di grandi dimensioni. Ci sono moduli personalizzati come <command>dh_autoreconf</command> per facilitare questo problema, come descritto nella <xref linkend="customrules"/> .

note: type: Content of: <book><chapter><section><para>
en: You can provide a Perl regular expression to the <literal>--extend-diff-ignore</literal> option argument of <citerefentry> <refentrytitle>dpkg-source</refentrytitle><manvolnum>1</manvolnum> </citerefentry> to ignore changes made to the autogenerated files while creating the source package.
it: È possibile fornire un'espressione regolare Perl al parametro <literal>--extend-diff-ignore</literal> di <citerefentry> <refentrytitle>dpkg-source</refentrytitle><manvolnum>1</manvolnum> </citerefentry> per ignorare le modifiche apportate ai file generati automaticamente durante la creazione del pacchetto sorgente.

note: type: Content of: <book><chapter><section><para>
en: As a general solution to address this problem of the autogenerated files, you can store such a <command>dpkg-source</command> option argument in the <filename>source/options</filename> file of the source package.  The following will skip creating patch files for <filename>config.sub</filename>, <filename>config.guess</filename>, and <filename>Makefile</filename>.
it: Come soluzione generale per affrontare il problema dei file generati automaticamente, è possibile memorizzare un parametro <command>dpkg-source</command> nel file <filename>source/options</filename> del pacchetto sorgente. Il comando di seguito salterà la creazione dei file di patch per <filename>config.sub</filename>, <filename>config.guess</filename> e <filename>Makefile</filename>.

note: type: Content of: <book><chapter><section><para>
en: The old <literal>1.0</literal> source format created a single large <filename>diff.gz</filename> file containing package maintenance files in <filename>debian</filename> and patch files for the source.  Such a package is a bit cumbersome to inspect and understand for each source tree modification later.  This is not so nice.
it: Il vecchio formato sorgente <literal>1.0</literal> creava un singolo, grosso file <filename>diff.gz</filename> file che conteneva i file di manutenzione del pacchetto che stavano in <filename>debian</filename> ed i file di patch del sorgente.  Un pacchetto così è un po' difficoltoso da ispezionare per capire successivamente la sequenza delle modifiche.  Per questo tale formato non è considerato soddisfacente.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Several methods of patch set maintenance have been proposed and are in use for Debian packages.  The <command>quilt</command> system is the preferred maintenance system in use.  Others include <command>dpatch</command>, <command>dbs</command>, and <command>cdbs</command>.  Many of these keep such patches as <filename>debian/patches/*</filename> files.
it: Diversi metodi di mantenimento delle patch set sono stati proposti e sono utilizzati per i pacchetti Debian. Il sistema <command>quilt</command>  è il sistema di manutenzione consigliato ed utilizzato. Altri includono <command>dpatch</command>, <command>dbs</command> e <command>cdbs</command>. Molte di questi tengono le patch come file <filename>debian/patches/*</filename>.

note: type: Content of: <book><chapter><section><para>
en: The newer <literal>3.0 (quilt)</literal> source format stores patches in <filename>debian/patches/*</filename> files using the <command>quilt</command> command.  These patches and other package data which are all contained under the <filename>debian</filename> directory are packaged as the <filename>debian.tar.gz</filename> file.  Since the <command>dpkg-source</command> command can handle <command>quilt</command> formatted patch data in the <literal>3.0 (quilt)</literal> source without the <systemitem role="package">quilt</systemitem> package, it does not need a <literal>Build-Depends</literal> on <systemitem role="package">quilt</systemitem>.  <placeholder type="footnote" id="0"/>
it: Il nuovo formato dei sorgenti <literal>3.0 (quilt)</literal> salva le patch in file <filename>debian/patches/*</filename> utilizzando il comando <command>quilt</command>.  Queste patch e gli altri dati del pacchetto che sono contenuti nella directory <filename>debian</filename> è pacchettizzato come file <filename>debian.tar.gz</filename>.  Poiché il comando <command>dpkg-source</command> è in grado di gestire patch formattate con <command>quilt</command> nel formato sorgente <literal>3.0 (quilt)</literal> senza il pacchetto <systemitem role="package">quilt</systemitem>, non è necessario il avere <systemitem role="package">quilt</systemitem> nel campo <literal>Build-Depends</literal>.  <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para><footnote><para>
en: If you are asking a sponsor to upload your package, this kind of clear separation and documentation of your changes is very important to expedite the package review by your sponsor.
it: Se si sta chiedendo ad uno sponsor di caricare il proprio pacchetto, questo tipo di chiara separazione e documentazione dei cambiamenti è molto importante per accelerare la revisione del pacchetto da parte dello sponsor.

note: type: Content of: <book><chapter><section><para>
en: The <command>quilt</command> command is explained in <citerefentry> <refentrytitle>quilt</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.  It records modifications to the source as a stack of <literal>-p1</literal> patch files in the <filename>debian/patches</filename> directory and the source tree is untouched outside of the <filename>debian</filename> directory.  The order of these patches is recorded in the <filename>debian/patches/series</filename> file.  You can apply (=push), un-apply (=pop), and refresh patches easily.  <placeholder type="footnote" id="0"/>
it: Il comando <command>quilt</command> è documentato in <citerefentry> <refentrytitle>quilt</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.  Esso registra le modifiche ai sorgenti come una coda di file di patch <literal>-p1</literal> nella directory <filename>debian/patches</filename> e l'albero dei sorgenti non varia al di fuori della directory <filename>debian</filename>.  L'ordine delle patch è registrato nel file <filename>debian/patches/series</filename>.  Si può applicare (=push), rimuovere(=pop), ed aggiornare le patch con facilità.  <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: For <xref linkend="modify"/>, we created three patches in <filename>debian/patches</filename>.
it: Per <xref linkend="modify"/>, sono state create tre patch in <filename>debian/patches</filename>.

note: type: Content of: <book><chapter><section><para>
en: Since Debian patches are located in <filename>debian/patches</filename>, please make sure to set up the <command>dquilt</command> command properly as described in <xref linkend="quiltrc"/>.
it: Dal momento che le patch di Debian si trovano in <filename>debian/patches</filename>, ci si assicuri di impostare correttamente il comando <command>dquilt</command>, come descritto nella <xref linkend="quiltrc"/>.

note: type: Content of: <book><chapter><section><para>
en: When anyone (including yourself) provides a patch <filename><replaceable>foo</replaceable>.patch</filename> to the source later, modifying a <literal>3.0 (quilt)</literal> source package is quite simple:
it: Quando qualcuno (me compreso) fornisce una patch <filename><replaceable>foo</replaceable>.patch</filename> per i sorgenti, allora la modifica del pacchetto sorgente di tipo <literal>3.0 (quilt)</literal>è abbastanza semplice:

note: type: Content of: <book><chapter><section><para>
en: The patches stored in the newer <literal>3.0 (quilt)</literal> source format must be <emphasis>fuzz</emphasis> free.  You can ensure this with <literal>dquilt pop -a; while dquilt push; do dquilt refresh; done</literal>.
it: Le patch salvate nel nuovo formato sorgente <literal>3.0 (quilt)</literal> devono essere prive di <emphasis>fuffa</emphasis>.  Bisogna quindi assicurarsi di ciò eseguendo <literal>dquilt pop -a; while dquilt push; do dquilt refresh; done</literal>.

note: type: Content of: <book><chapter><title>
en: Building the package
it: Costruzione del pacchetto

note: type: Content of: <book><chapter><para>
en: We should now be ready to build the package.
it: A questo punto, si dovrebbe essere pronti a creare il pacchetto.

note: type: Content of: <book><chapter><section><title>
en: Complete (re)build
it: (ri)Creazione completa

note: type: Content of: <book><chapter><section><para>
en: In order to perform a complete (re)build of a package properly, you need to make sure you have installed
it: Al fine di (ri)creare un pacchetto in modo appropriato, è necessario assicurarsi di installare

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: the <systemitem role="package">build-essential</systemitem> package,
it: il pacchetto <systemitem role="package">build-essential</systemitem>,

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: packages listed in the <literal>Build-Depends</literal> field (see <xref linkend="control"/>), and
it: i pacchetti elencati nel campo <literal>Build-Depends</literal> (vedere <xref linkend="control"/>), e

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: packages listed in the <literal>Build-Depends-indep</literal> field (see <xref linkend="control"/>).
it: i pacchetti elencati nel campo <literal>Build-Depends-indep</literal> (vedere <xref linkend="control"/>).

note: type: Content of: <book><chapter><section><para>
en: Then you issue the following command in the source directory:
it: Adesso ci si sposti nella directory dei sorgenti del programma e si lanci il comando:

note: type: Content of: <book><chapter><section><para>
en: This will do everything to make full binary and source packages for you.  It will:
it: Questo comando creerà i pacchetti binari e sorgenti al posto vostro.  Eseguirà le seguenti operazioni:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: clean the source tree (<literal>debian/rules clean</literal>)
it: pulirà l'albero dei sorgenti (<literal>debian/rules clean</literal>)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: build the source package (<literal>dpkg-source -b</literal>)
it: costruirà il pacchetto sorgente (<literal>dpkg-source -b</literal>)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: build the program (<literal>debian/rules build</literal>)
it: costruirà il programma (<literal>debian/rules build</literal>)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: build binary packages (<literal>fakeroot debian/rules binary</literal>)
it: costruirà il pacchetto binario (<literal>fakeroot debian/rules binary</literal>)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: make the <filename>.dsc</filename> file
it: crea il file <filename>.dsc</filename>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: make the <filename>.changes</filename> file, using <command>dpkg-genchanges</command>
it: crea il file <filename>.changes</filename>, utilizzando <command>dpkg-genchanges</command>

note: type: Content of: <book><chapter><section><para><footnote><para>
en: This GPG key must be signed by a Debian developer to get connected to the web of trust and must be registered to <ulink url="&keyring;">the Debian keyring</ulink>.  This enables your uploaded packages to be accepted to the Debian archives.  See <ulink url="&keycreate;">Creating a new GPG key</ulink> and <ulink url="&keysigning; ">Debian Wiki on Keysigning</ulink>.
it: Questa chiave GPG deve essere firmata da uno sviluppatore Debian per collegarsi alla rete di fiducia e bisogna essere registrati al <ulink url="&keyring;">portachiavi Debian</ulink>. In questo modo i pacchetti caricati potranno essere accettati ed inseriti negli archivi Debian. Vedere <ulink url="&keycreate;">Creare una nuova chiave GPG</ulink> e <ulink url="&keysigning;">Debian Wiki on Keysigning</ulink>.

note: type: Content of: <book><chapter><section><para>
en: If the build result is satisfactory, sign the <filename>.dsc</filename> and <filename>.changes</filename> files with your private GPG key using the <command>debsign</command> command.  You need to enter your secret pass phrase, twice.  <placeholder type="footnote" id="0"/>
it: Se si è soddisfatti del pacchetto generato, si firmino i file <filename>.dsc</filename> e <filename>.changes</filename> con la chiave GPG privata utilizzando il comando <command>debsign</command>.  È necessario inserire la propria passphrase segreta due volte.  <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: For a non-native Debian package, e.g., <systemitem role="package">gentoo</systemitem>, you will see the following files in the parent directory (<filename>~/gentoo</filename>) after building packages:
it: Per un pacchetto Debian non-nativo, per esempio, <systemitem role="package">gentoo</systemitem>, si vedano i seguenti file nella directory superiore (<filename>~/gentoo</filename>) dopo la creazione dei pacchetti:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: This is the original upstream source code tarball, merely renamed to the above so that it adheres to the Debian standard.  Note that this was created initially by the command <literal>dh_make -f ../gentoo-0.9.12.tar.gz</literal>.
it: Questo è il codice sorgente originale, semplicemente rinominato in modo da aderire allo standard Debian.  Da notare che questo è stato creato inizialmente con il comando <literal>dh_make -f ../gentoo-0.9.12.tar.gz</literal>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: This is a summary of the contents of the source code.  The file is generated from your <filename>control</filename> file, and is used when unpacking the source with <citerefentry> <refentrytitle>dpkg-source</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.
it: Questo è un sommario del contenuto del codice sorgente.  Questo file è generato dal file <filename>control</filename>, ed è usato quando si decomprime il sorgente con <citerefentry> <refentrytitle>dpkg-source</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: This compressed tarball contains your <filename>debian</filename> directory contents.  Each and every addition you made to the original source code is stored as a <command>quilt</command> patch in <filename>debian/patches</filename>.
it: Questo file compresso contiene il contenuto della directory <filename>debian</filename>.  Ogni modifica effettuata al codice sorgente originale, verrà memorizzata come patch di <command>quilt</command> in <filename>debian/patches</filename>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para><footnote><para>
en: You can avoid applying <command>quilt</command> patches in the <literal>3.0 (quilt)</literal> source format at the end of the extraction with the <literal>--skip-patches</literal> option.  Alternatively, you can run <literal>dquilt pop -a</literal> after normal operation.
it: È possibile evitare di applicare la patch <command>quilt</command>, nel formato sorgente <literal>3.0 (quilt)</literal>, aggiungendo il parametro <literal>--skip-patches</literal> al comando di estrazione.  In alternativa, è possibile eseguire <literal>dquilt pop -a</literal> dopo le normali operazioni.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If someone else wants to re-create your package from scratch, they can easily do so using the above three files.  The extraction procedure is trivial: just copy the three files somewhere else and run <literal>dpkg-source -x gentoo_0.9.12-1.dsc</literal>.  <placeholder type="footnote" id="0"/>
it: Se qualcun altro volesse ri-creare il pacchetto da zero, potrebbe farlo facilmente usando i suddetti tre file.  La procedura di estrazione è banale: basta copiare i tre file da qualche parte ed eseguire <literal>dpkg-source -x gentoo_0.9.12-1.dsc</literal>.  <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: This is your completed binary package.  You can use <command>dpkg</command> to install and remove this just like any other package.
it: Questo è il pacchetto binario completo.  Si può usare <command>dpkg</command> per installarlo e rimuoverlo, come per ogni altro pacchetto.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: This file describes all the changes made in the current package revision; it is used by the Debian FTP archive maintenance programs to install the binary and source packages.  It is partly generated from the <filename>changelog</filename> file and the <filename>.dsc</filename> file.
it: Questo file descrive tutte le modifiche effettuate nella revisione corrente del pacchetto; è usata dai programmi di manutenzione dell'archivio FTP di Debian, per installare i pacchetti binari e sorgenti.  È generato parzialmente dal contenuto del file <filename>changelog</filename> e dal file <filename>.dsc</filename>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: As you keep working on the package, its behavior will change and new features will be added.  People downloading your package can look at this file and quickly see what has changed.  Debian archive maintenance programs will also post the contents of this file to the <ulink url="&debian-devel-changes-ldo;">debian-devel-changes@lists.debian.org</ulink> mailing list.
it: Quando si lavora sul pacchetto, potrebbero cambiare il funzionamento del programma, o potrebbero venire introdotte nuove funzionalità.  Chi scaricherà il pacchetto, potrà controllare questo file per vedere velocemente quali sono i cambiamenti.  I programmi di manutenzione dell'archivio Debian invieranno anche i contenuti di questo file alla mailing list <ulink url="&debian-devel-changes-ldo;">debian-devel-changes-@lists.debian.org</ulink>.

note: type: Content of: <book><chapter><section><para>
en: The <filename>gentoo_0.9.12-1.dsc</filename> and <filename>gentoo_0.9.12-1_i386.changes</filename> files must be signed using the <command>debsign</command> command with your private GPG key in the <filename>~/.gnupg/</filename> directory, before uploading them to the Debian FTP archive. The GPG signature provides the proof that these files are really yours, using your public GPG key.
it: I file <filename>gentoo_0.9.12-1.dsc</filename> e <filename>gentoo_0.9.12-1_i386.changes</filename> devono essere firmati usando il comando <command>debsign</command> con la propria chiave privata GPG presente nella directory <filename>~/.gnupg/</filename>, prima di caricarli nell'archivio FTP Debian. La firma GPG è la prova che questi file sono veramente stati generati da te, utilizzando la chiave GPG pubblica.

note: type: Content of: <book><chapter><section><para>
en: The <command>debsign</command> command can be made to sign with your specified secret GPG key ID (good for sponsoring packages) with the following in the <filename>~/.devscripts</filename> file:
it: Il comando <command>debsign</command> può essere eseguito per firmare con l'ID della chiave GPG specificata, nel file <filename>~/.devscripts</filename>, come seguie (utile in caso di sponsoring di pacchetti):

note: type: Content of: <book><chapter><section><para>
en: The long strings of numbers in the <filename>.dsc</filename> and <filename>.changes</filename> files are SHA1/SHA256 checksums for the files mentioned.  Anyone downloading your files can test them with <citerefentry> <refentrytitle>sha1sum</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> or <citerefentry> <refentrytitle>sha256sum</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> and if the numbers don't match, they'll know the file is corrupt or has been tampered with.
it: Le lunghe stringhe di numeri nei file <filename>.dsc</filename> e <filename>.changes</filename> sono codici di controllo SHA1/SHA256 per i file menzionati.  Chi scarica questi file, può controllarli con <citerefentry> <refentrytitle>sha1sum</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, o <citerefentry> <refentrytitle>sha256sum</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> e se i numeri non corrispondessero saprebbe che il file relativo è corrotto, o è stato alterato.

note: type: Content of: <book><chapter><section><title>
en: Autobuilder
it: Auto-costruzione

note: type: Content of: <book><chapter><section><para><footnote><para>
en: The actual autobuilder system involves much more complicated schemes than the one documented here.  Such details are beyond the scope of this document.
it: L'attuale sistema di auto-costruzione è molto più complicato di come è qui documentato.  Tali dettagli esulano dallo scopo del documento.

note: type: Content of: <book><chapter><section><para>
en: Debian supports many <ulink url="&ports;">ports</ulink> with the <ulink url="&buildd;">autobuilder network</ulink> running <command>buildd</command> daemons on computers of many different architectures.  Although you do not need to do this yourself, you should be aware of what will happen to your packages.  Let's look into roughly how they rebuild your packages for multiple architectures.  <placeholder type="footnote" id="0"/>
it: Debian supporta molti <ulink url="&ports;">port</ulink> tramite la <ulink url="&buildd;">autobuilder network</ulink>, su cui sono in esecuzione i demoni di <command>buildd</command> su molti computer con architetture differenti.  Anche se non sarà necessario fare questo da soli, si dovrebbe essere consapevoli di quello che succederà ai pacchetti.  Si vedrà, in maniera non approfondita, come i pacchetti vengono ricostruiti per architetture differenti.  <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: For <literal>Architecture: any</literal> packages, the autobuilder system performs a rebuild.  It ensures the installation of
it: I pacchetti con <literal>Architecture: any</literal>, verranno ricostruiti dal sistema di auto-costruzione.  Ci si assicuri di avere installato

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: the <systemitem role="package">build-essential</systemitem> package, and
it: il pacchetto <systemitem role="package">build-essential</systemitem>, e

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: packages listed in the <literal>Build-Depends</literal> field (see <xref linkend="control"/>).
it: i pacchetti elencati nel campo <literal>Build-Depends</literal> (vedere <xref linkend="control"/>).

note: type: Content of: <book><chapter><section><para>
en: Then it issues the following command in the source directory:
it: Dopo si può eseguire il comando seguente nella directory dei sorgenti:

note: type: Content of: <book><chapter><section><para>
en: This will do everything to make architecture dependent binary packages on another architecture.  It will:
it: Questo comando creerà i pacchetti binari e sorgenti al posto vostro.  Eseguirà le seguenti operazioni:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: build architecture dependent binary packages (<literal>fakeroot debian/rules binary-arch</literal>)
it: costruirà il pacchetto binario per una specifica architettura (<literal>fakeroot debian/rules binary-arch</literal>)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: sign the source <filename>.dsc</filename> file, using <command>gpg</command>
it: firmerà il file sorgente <filename>.dsc</filename> file, usando <command>gpg</command>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: create and sign the upload <filename>.changes</filename> file, using <command>dpkg-genchanges</command> and <command>gpg</command>
it: creerà e firmerà il file di upload <filename>.changes</filename> file, usando <command>dpkg-genchanges</command> e <command>gpg</command>

note: type: Content of: <book><chapter><section><para>
en: This is why you see your package for other architectures.
it: È questo il motivo per il quale si vede il proprio pacchetto per altre architetture.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Unlike under the <systemitem role="package">pbuilder</systemitem> package, the <command>chroot</command> environment under the <systemitem role="package">sbuild</systemitem> package used by the autobuilder system does not enforce the use of a minimal system and may have many leftover packages installed.
it: Diversamente dal pacchetto <systemitem role="package">pbuilder</systemitem>, l'ambiente <command>chroot</command> sotto il pacchetto <systemitem role="package">sbuild</systemitem>, usato dal sistema di auto-costruzione, non forza la creazione di un sistema minimale, e potrebbe lasciare installati molti pacchetti.

note: type: Content of: <book><chapter><section><para>
en: Although packages listed in the <literal>Build-Depends-Indep</literal> field are required to be installed for our normal packaging work (see <xref linkend="completebuild"/>), they are not required to be installed for the autobuilder system since it builds only architecture dependent binary packages.  <placeholder type="footnote" id="0"/> This distinction between normal packaging and autobuilding procedures is what dictates whether you should record such required packages in the <literal>Build-Depends</literal> or <literal>Build-Depends-Indep</literal> fields of the <filename>debian/control</filename> file (see <xref linkend="control"/>).
it: Anche se i pacchetti sono elencati nel campo <literal>Build-Depends-Indep</literal>, per la normale creazione del pacchetto, devono comunque essere installati (vedere <xref linkend="completebuild"/>), invece per il sistema di auto-costruzione non è necessario installarli dato che costruisce solamente pacchetti binari per una specifica architettura.  <placeholder type="footnote" id="0"/> Questa distinzione tra la normale pacchettizzazione e il sistema di auto-costruzione determina se i pacchetti richiesti devono essere registrati nei campi <literal>Build-Depends</literal> o <literal>Build-Depends-Indep</literal> nel file <filename>debian/control</filename> (vedere <xref linkend="control"/>).

note: type: Content of: <book><chapter><section><title>
en: <command>debuild</command> command
it: Il comando <command>debuild</command>

note: type: Content of: <book><chapter><section><para>
en: You can automate the build activity around executing the <command>dpkg-buildpackage</command> command package further with the <command>debuild</command> command.  See <citerefentry> <refentrytitle>debuild</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.
it: È possibile automatizzare ulteriormente il processo di creazione del pacchetto, eseguito con il comando <command>dpkg-buildpackage</command>, utilizzando il comando <command>debuild</command>.  Vedere <citerefentry> <refentrytitle>debuild</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.

note: type: Content of: <book><chapter><section><para>
en: The <command>debuild</command> command executes the <command>lintian</command> command to make a static check after building the Debian package.  The <command>lintian</command> command can be customized with the following in the <filename>~/.devscripts</filename> file:
it: Il comando <command>debuild</command> esegue il comando <command>lintian</command> per effettuare un controllo statico dopo la creazione del pacchetto Debian.  Il comando <command>lintian</command> può essere personalizzato come segue, nel file <filename>~/.devscripts</filename>:

note: type: Content of: <book><chapter><section><para>
en: Cleaning the source and rebuilding the package from your user account is as simple as:
it: Si possono ripulire i sorgenti e ricreare il pacchetto da un account utente, semplicemente con:

note: type: Content of: <book><chapter><section><para>
en: You can clean the source tree as simply as:
it: È possibile ripulire l'albero dei sorgenti semplicemente con:

note: type: Content of: <book><chapter><section><title>
en: <systemitem role="package">pbuilder</systemitem> package
it: Il pacchetto <systemitem role="package">pbuilder</systemitem>

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Since the <systemitem role="package">pbuilder</systemitem> package is still evolving, you should check the actual configuration situation by consulting the latest official documentation.
it: <systemitem role="package">pbuilder</systemitem> è ancora in evoluzione, si dovrebbe controllare l'attuale configurazione consultando la documentazione ufficiale più recente.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&buildd-do;"/> for more on Debian package auto-building.
it: Vedere <ulink url="&buildd-do;"/> per maggiori informazioni sull'auto-costruzione dei pacchetti Debian.

note: type: Content of: <book><chapter><section><para>
en: For a clean room (<command>chroot</command>) build environment to verify the build dependencies, the <systemitem role="package">pbuilder</systemitem> package is very useful.  <placeholder type="footnote" id="0"/> This ensures a clean build from the source under the <literal>sid</literal> auto-builder for different architectures and avoids a severity serious FTBFS (Fails To Build From Source) bug which is always in the RC (release critical) category.  <placeholder type="footnote" id="1"/>
it: Il pacchetto <systemitem role="package">pbuilder</systemitem> è molto utile per verificare le dipendenze di creazione del pacchetto da un ambiente (<command>chroot</command>) di compilazione sano e minimale.  <placeholder type="footnote" id="0"/> Questo assicura di compilare i sorgenti in maniera pulita, usando la distribuzione <literal>sid</literal> un compilatore automatico (auto-builder) per differenti architetture ed evita i bug FTBFS (Fails To Build From Source) di severità seria, che sono sempre di categoria RC (Critici per il Rilascio).  <placeholder type="footnote" id="1"/>

note: type: Content of: <book><chapter><section><para>
en: Let's customize the <systemitem role="package">pbuilder</systemitem> package as follows:
it: Si configuri il pacchetto <systemitem role="package">pbuilder</systemitem> come segue:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: setting the <filename>/var/cache/pbuilder/result</filename> directory writable by your user account.
it: impostare il permesso di scrittura per l'utente alla directory <filename>/var/cache/pbuilder/result</filename>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: creating a directory, e.g.  <filename><replaceable>/var/cache/pbuilder/hooks</replaceable></filename>, writable by the user, to place hook scripts in.
it: creare una directory, ad es.  <filename><replaceable>/var/cache/pbuilder/hooks</replaceable></filename>, con i permessi di scrittura per l'utente per potergli inserire degli script di hook.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: configuring <filename>~/.pbuilderrc</filename> or <filename>/etc/pbuilderrc</filename> to include the following.
it: configurare il file <filename>~/.pbuilderrc</filename> o <filename>/etc/pbuilderrc</filename> in modo che includa le seguenti righe.

note: type: Content of: <book><chapter><section><para>
en: First let's initialize the local <systemitem role="package">pbuilder</systemitem> <command>chroot</command> system as follows:
it: Si avvii <systemitem role="package">pbuilder</systemitem> per costruire l'ambiente <command>chroot</command> locale, come segue:

note: type: Content of: <book><chapter><section><para>
en: If you already have a completed source package, issue the following commands in the directory where the <filename><replaceable>foo</replaceable>.orig.tar.gz</filename>, <filename><replaceable>foo</replaceable>.debian.tar.gz</filename>, and <filename><replaceable>foo</replaceable>.dsc</filename> files exist to update the local <systemitem role="package">pbuilder</systemitem> <command>chroot</command> system and to build binary packages in it:
it: Se si hanno già i pacchetti sorgenti, eseguire i seguenti comandi nella directory in cui si trovano i file <filename><replaceable>foo</replaceable>.orig.tar.gz</filename>, <filename><replaceable>foo</replaceable>.debian.tar.gz</filename>, e <filename><replaceable>foo</replaceable>.dsc</filename> per aggiornare l'ambiente <command>chroot</command> di <systemitem role="package">pbuilder</systemitem> e per costruirci dentro il pacchetto binario:

note: type: Content of: <book><chapter><section><para>
en: The newly built packages without the GPG signatures will be located in <filename>/var/cache/pbuilder/result/</filename> with non-root ownership.
it: Il nuovo pacchetto, senza firme GPG, sarà creato nella directory <filename>/var/cache/pbuilder/result/</filename>  e non sarà assegnato all'utente root.

note: type: Content of: <book><chapter><section><para>
en: The GPG signatures on the <filename>.dsc</filename> file and the <filename>.changes</filename> file can be generated as:
it: Le firme GPG sui file <filename>.dsc</filename> <filename>.changes</filename> possono essere generate come segue:

note: type: Content of: <book><chapter><section><para>
en: If you have an updated source tree but have not generated the matching source package, issue the following commands in the source directory where the <filename>debian</filename> directory exists, instead:
it: Se si ha l'albero dei sorgenti aggiornato, ma non si sono generati i rispettivi pacchetti sorgenti, eseguire i seguenti comandi nella directory dei sorgenti in cui si trova il file <filename>debian</filename>:

note: type: Content of: <book><chapter><section><para>
en: You can log into its <command>chroot</command> environment with the <literal>pbuilder --login --save-after-login</literal> command and configure it as you wish.  This environment can be saved by leaving its shell prompt with <literal>^D</literal> (Control-D).
it: È possibile accedere all'ambiente <command>chroot</command> con il comando <literal>pbuilder --login --save-after-login</literal> e configurarlo come si vuole.  Questo ambiente può essere salvato, semplicemente uscendo dalla shell con <literal>^D</literal> (Control-D).

note: type: Content of: <book><chapter><section><para><footnote><para>
en: This assumes <literal>HOOKDIR=/var/cache/pbuilder/hooks</literal>.  You can find many examples of hook scripts in the <filename>/usr/share/doc/pbuilder/examples</filename> directory.
it: Ciò presuppone il settaggio <literal>HOOKDIR=/var/cache/pbuilder/hooks</literal>.  È possibile trovare numerosi esempi di script di hook, nella directory <filename>/usr/share/doc/pbuilder/examples</filename>.

note: type: Content of: <book><chapter><section><para>
en: The latest version of the <command>lintian</command> command can be executed in the <literal>chroot</literal> environment using the hook script <filename><replaceable>/var/cache/pbuilder/hooks</replaceable>/B90lintian</filename> configured as follows: <placeholder type="footnote" id="0"/>
it: L'ultima versione del programma <command>lintian</command> può essere eseguita nell'ambiente <literal>chroot</literal>, usando gli script di hook <filename><replaceable>/var/cache/pbuilder/hooks</replaceable>/B90lintian</filename>, configurati come segue:  <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: You need to have access to the latest <literal>sid</literal> environment to build packages properly for <literal>sid</literal>.  In practice, <literal>sid</literal> may be experiencing issues which makes it undesirable for you to migrate your whole system.  The <systemitem role="package">pbuilder</systemitem> package can help you to cope with this kind of situation.
it: È necessario avere accesso all'ultima versione di <literal>sid</literal> per poter costruire correttamente i pacchetti per <literal>sid</literal>.  In pratica <literal>sid</literal> potrebbe avere dei problemi che rendono poco consigliabile migrare l'intero sistema.  In questo caso il pacchetto <systemitem role="package">pbuilder</systemitem> può essere molto di aiuto.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: There are some restrictions for such updates of your <literal>stable</literal> package.
it: Ci sono alcune restrizioni per tali aggiornamenti del pacchetto <literal>stable</literal>.

note: type: Content of: <book><chapter><section><para>
en: You may need to update your <literal>stable</literal> packages after their release for <literal>stable-proposed-updates</literal>, <literal>stable/updates</literal>, etc.  <placeholder type="footnote" id="0"/> For such occasions, the fact that you may be running a <literal>sid</literal> system is not a good enough excuse for failing to update them promptly.  The <systemitem role="package">pbuilder</systemitem> package can help you to access environments of almost any Debian derivative distribution of the same architecture.
it: Potrebbe essere necessario aggiornare i pacchetti <literal>stable</literal> dopo il loro rilascio per <literal>stable-proposed-updates</literal>, <literal>stable/updates</literal>, ecc.  <placeholder type="footnote" id="0"/> Per questa ragione se si sta utilizzando un sistema <literal>sid</literal> non è una buona scusa per non aggiornarli tempestivamente.  Il pacchetto <systemitem role="package">pbuilder</systemitem> aiuta ad accedere agli ambienti di quasi tutte le distribuzioni derivate da Debian con la stessa architettura di CPU.

note: type: Content of: <book><chapter><section><para>
en: See <ulink url="&pbuilder;"/>, <citerefentry> <refentrytitle>pdebuild</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>pbuilderrc</refentrytitle> <manvolnum>5</manvolnum> </citerefentry>, and <citerefentry> <refentrytitle>pbuilder</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>.
it: Vedere <ulink url="&pbuilder;"/>, <citerefentry> <refentrytitle>pdebuild</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>pbuilderrc</refentrytitle> <manvolnum>5</manvolnum> </citerefentry>, e <citerefentry> <refentrytitle>pbuilder</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>.

note: type: Content of: <book><chapter><section><title>
en: <command>git-buildpackage</command> command and similar
it: Il comando <command>git-buildpackage</command> ed altri simili

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&debref-vcs;">Version control systems</ulink> for more.
it: Vedere <ulink url="&debref-vcs;">Version control systems</ulink> per più informazioni.

note: type: Content of: <book><chapter><section><para>
en: If your upstream uses a source code management system (VCS)  <placeholder type="footnote" id="0"/> to maintain their code, you should consider using it as well.  This makes merging and cherry-picking upstream patches much easier.  There are several specialized wrapper script packages for Debian package building for each VCS.
it: Se l'autore originale utilizza un sistema di controllo di versione (VCS)  <placeholder type="footnote" id="0"/> per gestire il proprio codice, si dovrebbe prendere in considerazione di usarlo.  Questo rende molto più semplice la fusione e la raccolta di patch dai sorgenti originali.  Ci sono diversi pacchetti di script adatti alla costruzione di pacchetti Debian per ogni sistema VCS.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">git-buildpackage</systemitem>: a suite to help with Debian packages in Git repositories.
it: <systemitem role="package">git-buildpackage</systemitem>: una suite per aiutare con i pacchetti Debian nei repository Git.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">svn-buildpackage</systemitem>: helper programs to maintain Debian packages with Subversion.
it: <systemitem role="package">svn-buildpackage</systemitem>: programmi di supporto per mantenere i pacchetti Debian con Subversion.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">cvs-buildpackage</systemitem>: a set of Debian package scripts for CVS source trees.
it: <systemitem role="package">cvs-buildpackage</systemitem>: una serie di script per i pacchetti Debian per gli alberi di sorgenti sotto CVS.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: <ulink url="&debian-alioth-wiki;">Debian wiki Alioth</ulink> documents how to use the <ulink url="&debian-alioth;">alioth.debian.org</ulink> service.
it: <ulink url="&debian-alioth-wiki;">Debian wiki Alioth</ulink> spiega come usare il servizio <ulink url="&debian-alioth;">alioth.debian.org</ulink>.

note: type: Content of: <book><chapter><section><para>
en: Use of <systemitem role="package">git-buildpackage</systemitem> is becoming quite popular for Debian Developers to manage Debian packages with the Git server on <ulink url="&debian-alioth;">alioth.debian.org</ulink>. <placeholder type="footnote" id="0"/> This package offers many commands to <emphasis>automate</emphasis> packaging activities:
it: L'utilizzo di <systemitem role="package">git-buildpackage</systemitem> sta diventando molto popolare per gli sviluppatori Debian,questo permette di gestire i pacchetti Debian con il server Git su <ulink url="&debian-alioth;">alioth.debian.org</ulink>. <placeholder type="footnote" id="0"/> Questo pacchetto offre molti comandi che <emphasis>automatizzano</emphasis> le procedure di pacchettizzazione:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <citerefentry> <refentrytitle>git-buildpackage</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>: build Debian packages from a Git repository.
it: <citerefentry> <refentrytitle>git-buildpackage</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>: costruisce i pacchetti Debian da un repository Git.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <citerefentry> <refentrytitle>git-pbuilder</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>: build Debian packages from a Git repository using <command>pbuilder</command>/<command>cowbuilder</command>.
it: <citerefentry> <refentrytitle>git-pbuilder</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>: costruisce i pacchetti Debian da un repository Git, utilizzando <command>pbuilder</command>/<command>cowbuilder</command>.

note: type: Content of: <book><chapter><section><para>
en: These commands use 3 branches to track packaging activity:
it: Questi comandi utilizzano 3 "branch" per tenere traccia dell'attività sulla pacchettizzazione:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>main</literal> for Debian package source tree.
it: <literal>main</literal> per l'albero dei sorgenti dei pacchetti Debian.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>upstream</literal> for upstream source tree.
it: <literal>upstream</literal> per l'albero dei sorgenti originali.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para><footnote><para>
en: The <literal>--pristine-tar</literal> option invokes the <command>pristine-tar</command> command, which can regenerate an exact copy of a pristine upstream tarball using only a small binary delta file and the contents of the tarball that are typically kept in an <literal>upstream</literal> branch in the VCS.
it: L'opzione <literal>--pristine-tar</literal> esegue il comando <command>pristine-tar</command> che può rigenerare un copia esatta del tarball dei sorgenti originali, utilizzando solo un piccolo file binario delta e i contenuti del tarball, che normalmente sono conservati nel branch <literal>upstream</literal> del VCS.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>pristine-tar</literal> for upstream tarball generated by the <literal>--pristine-tar</literal> option.<placeholder type="footnote" id="0"/>
it: <literal>pristine-tar</literal> per i tarball dei sorgenti originali generati dall'opzione <literal>--pristine-tar</literal>.<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Here are some web resources available for advanced audiences.
it: Ecco alcune risorse web, per gli utenti esperti.

note: type: Content of: <book><chapter><section><para><footnote><itemizedlist><listitem><para>
en: Building Debian Packages with git-buildpackage (<filename>&git-buildpackage-doc;</filename>)
it: Creare pacchetti Debian Packages con git-buildpackage (<filename>&git-buildpackage-doc;</filename>)

note: type: Content of: <book><chapter><section><para>
en: You can configure <systemitem role="package">git-buildpackage</systemitem> with <filename>~/.gbp.conf</filename>. See <citerefentry> <refentrytitle>gbp.conf</refentrytitle> <manvolnum>5</manvolnum> </citerefentry>.  <placeholder type="footnote" id="0"/>
it: È possibile configurare <systemitem role="package">git-buildpackage</systemitem> utilizzando il file <filename>~/.gbp.conf</filename>. Vedere <citerefentry> <refentrytitle>gbp.conf</refentrytitle> <manvolnum>5</manvolnum> </citerefentry>.  <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><title>
en: Quick rebuild
it: Ricostruzione veloce

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Environment variables that are normally configured to proper values are not set by this method.  Never create real packages to be uploaded using this <emphasis role="strong">quick</emphasis> method.
it: Le variabili d'ambiente, che sono normalmente impostate con dei valori corretti, non sono utilizzati in questa modalità.  Mai creare dei pacchetti, che poi andranno caricati, utilizzando il metodo <emphasis role="strong">veloce</emphasis>.

note: type: Content of: <book><chapter><section><para>
en: With a large package, you may not want to rebuild from scratch every time while you're tuning details in <filename>debian/rules</filename>.  For testing purposes, you can make a <filename>.deb</filename> file without rebuilding the upstream sources like this<placeholder type="footnote" id="0"/>:
it: Con un pacchetto di grandi dimensioni, si potrebbe non voler ricostruire tutto da zero, ogni volta che si modifica un dettaglio in <filename>debian/rules</filename>.  Per effettuare delle prove, si può creare un file <filename>.deb</filename>, senza ricompilare i sorgenti originali, come segue: <placeholder type="footnote" id="0"/>:

note: type: Content of: <book><chapter><section><para>
en: Or simply do the following to see if it builds or not:
it: Oppure, semplicemente controllando se si costruisce o no:

note: type: Content of: <book><chapter><section><para>
en: Once you are finished with your tuning, remember to rebuild following the proper procedure.  You may not be able to upload correctly if you try to upload <filename>.deb</filename> files built this way.
it: Una volta completati i vari aggiustamenti, bisogna ricordarsi di ricostruire il pacchetto usando la giusta procedura.  Si potrebbe non essere in grado di caricare il pacchetto correttamente se si prova con dei file <filename>.deb</filename> creati in questo modo.

note: type: Content of: <book><chapter><section><title>
en: Command hierarchy
it: Struttura gerarchica del comando

note: type: Content of: <book><chapter><section><para>
en: Here is a quick summary of how many commands to build packages fit together in the command hierarchy. There are many ways to do the same thing.
it: Ecco un breve riassunto di come molti comandi per creare i pacchetti si incastrano nella gerarchia di comando. Ci sono molti modi per fare la stessa cosa.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <filename>debian/rules</filename> = maintainer script for the package building
it: <filename>debian/rules</filename> = script responsabile della costruzione del pacchetto

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <command>dpkg-buildpackage</command> = core of the package building tool
it: <command>dpkg-buildpackage</command> = il cuore dello strumento di costruzione del pacchetto

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <command>debuild</command> = <command>dpkg-buildpackage</command> + <command>lintian</command> (build under the sanitized environment variables)
it: <command>debuild</command> = <command>dpkg-buildpackage</command> + <command>lintian</command> (creare il pacchetto utilizzando un ambiente con le variabili controllate)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <command>pbuilder</command> = core of the Debian chroot environment tool
it: <command>pbuilder</command> = il cuore dello strumento  chroot dell'ambiente Debian

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <command>pdebuild</command> = <command>pbuilder</command> + <command>dpkg-buildpackage</command> (build in the chroot)
it: <command>pdebuild</command> = <command>pbuilder</command> + <command>dpkg-buildpackage</command> (costruito in chroot)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <command>cowbuilder</command> = speed up the <command>pbuilder</command> execution
it: <command>cowbuilder</command> = velocizza l'esecuzione di <command>pbuilder</command>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <command>git-pbuilder</command> = the easy-to-use commandline syntax for <command>pdebuild</command> (used by <command>gbp buildpackage</command>)
it: <command>git-pbuilder</command> = una sintassi a linea di comando facilitata per <command>pdebuild</command> (usato da <command>gbp buildpackage</command>)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <command>gbp</command> = manage the Debian source under the git repo
it: <command>gbp</command> = gestisce il sorgente Debian utilizzando un repository git

note: type: Content of: <book><chapter><section><para>
en: Although use of higher level commands such as <command>gbp buildpackage</command> and <command>pbuilder</command> ensures the perfect package building environment, it is essential to understand how lower level commands such as <filename>debian/rules</filename> and <command>dpkg-buildpackage</command> are executed under them.
it: Sebbene l'uso di comandi di alto livello come <command>gbp buildpackage</command> e <command>pbuilder</command> assicura l'ambiente ideale per la costruzione del pacchetto, è essenziale comprendere come i comandi di basso livello <filename>debian/rules</filename> e <command>dpkg-buildpackage</command> vengono richiamati da loro.

note: type: Content of: <book><chapter><title>
en: Checking the package for errors
it: Controllare il pacchetto per errori

note: type: Content of: <book><chapter><para>
en: There are some techniques you should know for checking a package for errors before uploading it to the public archives.
it: Ci sono alcune tecniche da sapere per controllare se un pacchetto ha degli errori prima di caricarlo negli archivi pubblici.

note: type: Content of: <book><chapter><para>
en: It's also a good idea to carry out testing on a machine other than your own.  You must watch closely for any warnings or errors for all the tests described here.
it: Effettuare dei test su altre macchine oltre a quella con cui si è sviluppato è una buona idea.  Si deve inoltre fare attenzione agli avvisi ed agli errori per tutti i test che verranno qui descritti.

note: type: Content of: <book><chapter><section><title>
en: Suspicious changes
it: Modifiche sospette

note: type: Content of: <book><chapter><section><para>
en: If you find a new autogenerated patch file such as <filename>debian-changes-*</filename> in the <filename>debian/patches</filename> directory after building your non-native Debian package in <literal>3.0 (quilt)</literal> format, chances are you changed some files by accident or the build script modified the upstream source.  If it is your mistake, fix it.  If it is caused by the build script, fix the root cause with <command>dh-autoreconf</command> as in <xref linkend="customrules"/> or work around it with <filename>source/options</filename> as in <xref linkend="sourceopt"/>.
it: Se si trova un nuovo file di patch generato automaticamente, come <filename>debian-changes-*</filename> nella directory <filename>debian/patches</filename> dopo aver costruito un pacchetto Debian non-nativo nel formato <literal>3.0 (quilt)</literal>, è probabile che è stato cambiato qualche file per caso o che gli script di build hanno modificato il sorgente originale. Se è si tratta di un errore del genere, lo si risolva. Se è causato dallo script di build, si cerchi la causa principale del problema con <command>dh-autoreconf</command> come mostrato in <xref linkend="customrules"/> o si cerchi di aggirare il problema con <filename>source/options</filename> come mostrato in <xref linkend="sourceopt"/>.

note: type: Content of: <book><chapter><section><title>
en: Verifying a package's installation
it: Verifica dell'installazione di un pacchetto

note: type: Content of: <book><chapter><section><para>
en: You must test your package for whether it installs without problems.  The <citerefentry> <refentrytitle>debi</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> command helps you to test installing all the generated binary packages.
it: Bisogna verificare che il pacchetto si installi senza problemi.  Il comando <citerefentry> <refentrytitle>debi</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> aiuta a testare l'installazione di tutti i pacchetti binari generati.

note: type: Content of: <book><chapter><section><para>
en: To prevent installation problems on different systems, you must make sure that there are no filenames conflicting with other existing packages, using the <filename>Contents-<replaceable>i386</replaceable></filename> file downloaded from the Debian archive.  The <command>apt-file</command> command may be handy for this task.  If there are collisions, please take action to avoid this real problem, whether by renaming the file, moving a common file to a separate package that multiple packages can depend on, using the alternatives mechanism (see <citerefentry><refentrytitle>update-alternatives</refentrytitle> <manvolnum>1</manvolnum></citerefentry>) in coordination with the maintainers of other affected packages, or declaring a <literal>Conflicts</literal> relationship in the <filename>debian/control</filename> file.
it: Per prevenire eventuali problemi di installazione su sistemi diversi, bisogna assicurarsi che non ci siano file in conflitto con altri pacchetti esistenti utilizzando il file <filename>Contents-<replaceable>i386</replaceable></filename> scaricato dall'archivio Debian.  Il comando <command>apt-file</command> può tornare utile a questo scopo.  Se ci sono file che si sovrappongono, si prega di prendere delle misure per evitare l'insorgere del problema, rinominando il file, spostando il file in un pacchetto separato e configurarlo come dipendenza sui vari pacchetti che lo richiedono, utilizzando meccanismi alternativi (si veda <citerefentry> <refentrytitle>update-alternatives</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>) che permettendo di coordinarsi con i manutentori degli altri pacchetti interessati o settano la voce <literal>Conflicts</literal> nel file <filename>debian/control</filename>.

note: type: Content of: <book><chapter><section><title>
en: Verifying a package's maintainer scripts
it: Verifica degli script del manutentore di un pacchetto

note: type: Content of: <book><chapter><section><para>
en: All maintainer scripts (that is, <filename>preinst</filename>, <filename>prerm</filename>, <filename>postinst</filename>, and <filename>postrm</filename> files) are hard to write correctly unless they are auto-generated by the <systemitem role="package">debhelper</systemitem> programs.  So do not use them if you are a novice maintainer (see <xref linkend="maintscripts"/>).
it: Tutti gli script del manutentore (ad esempio i file, <filename>preinst</filename>, <filename>prerm</filename>, <filename>postinst</filename>, e <filename>postrm</filename>) sono difficili da scrivere correttamente a meno che non siano stati generati automaticamente dai programmi di <systemitem role="package">debhelper</systemitem>.  Si consiglia pertanto di non utilizzarli se non si ha sufficiente esperienza come manutentore (si veda <xref linkend="maintscripts"/>).

note: type: Content of: <book><chapter><section><para>
en: If the package makes use of these non-trivial maintainer scripts, be sure to test not only for install but also for remove, purge, and upgrade processes.  Many maintainer script bugs show up when packages are removed or purged.  Use the <command>dpkg</command> command as follows to test them:
it: Se il pacchetto utilizza questi particolari script del manutentore, ci si assicuri di effettuare delle prove non solo per l'operazione di install, ma anche per il remove, purge, e l'upgrade.  Molti bug degli script del manutentore vengono fuori quando i pacchetti sono rimossi o viene applicato il purge.  Si utilizzi il comando <command>dpkg</command> nel seguente modo per testarli:

note: type: Content of: <book><chapter><section><para>
en: This should be done with sequences such as the following:
it: Questa operazione si dovrebbe effettuare con delle sequenze di questo tipo:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: install the previous version (if needed).
it: installazione della versione precedente (se necessaria).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: upgrade it from the previous version.
it: aggiornamento dalla versione precedente.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: downgrade it back to the previous version (optional).
it: ritorno alla versione precedente (opzionale).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: purge it.
it: applicazione del purge.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: install the new package.
it: installazione del nuovo pacchetto.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: remove it.
it: rimozione del pacchetto.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: install it again.
it: reinstallazione del pacchetto.

note: type: Content of: <book><chapter><section><para>
en: If this is your first package, you should create dummy packages with different versions to test your package in advance to prevent future problems.
it: Se si sta creando il primo pacchetto, andrebbero creati dei pacchetti fittizi con diversi numeri di versione per testare il pacchetto originale in anticipo e prevenire problemi futuri.

note: type: Content of: <book><chapter><section><para>
en: Bear in mind that if your package has previously been released in Debian, people will often be upgrading to your package from the version that was in the last Debian release.  Remember to test upgrades from that version too.
it: Si tenga in mente che se il pacchetto è stato già rilasciato in Debian, le persone spesso effettueranno un aggiornamento a quest'ultimo a partire dall'ultima versione disponibile su Debian.  Si ricordi di testare gli aggiornamenti anche a partire da questa versione.

note: type: Content of: <book><chapter><section><para>
en: Although downgrading is not officially supported, supporting it is a friendly gesture.
it: Anche se il ritorno ad una versione precedente non è ufficialmente supportato, sarebbe buona abitudine supportarlo.

note: type: Content of: <book><chapter><section><title>
en: Using <systemitem role="package">lintian</systemitem>
it: Utilizzare <systemitem role="package">lintian</systemitem>

note: type: Content of: <book><chapter><section><para><footnote><para>
en: You do not need to provide the <command>lintian</command> option <literal>-i -I --show-overrides</literal> if you customized <filename>/etc/devscripts.conf</filename> or <filename>~/.devscripts</filename> as described in <xref linkend="debuild"/>.
it: Non c'è bisogno di fornire l'opzione <command>lintian</command> <literal>-i -I --show-overrides</literal> se si è personalizzato il file <filename>/etc/devscripts.conf</filename> o il file <filename>~/.devscripts</filename> come descritto in <xref linkend="debuild"/>.

note: type: Content of: <book><chapter><section><para>
en: Run <citerefentry> <refentrytitle>lintian</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> on your <filename>.changes</filename> file.  The <command>lintian</command> command runs many test scripts to check for many common packaging errors.  <placeholder type="footnote" id="0"/>
it: Si esegua <citerefentry> <refentrytitle>lintian</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> sul file <filename>.changes</filename>.  Il comando <command>lintian</command> esegue molti script di test alla ricerca dei più comuni errori di pacchettizzazione.  <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: Of course, replace the filename with the name of the <filename>.changes</filename> file generated for your package.  The output of the <command>lintian</command> command uses the following flags:
it: Ovviamente va rimpiazzato il nome con quello del file <filename>.changes</filename> generato per il pacchetto.  I risultati del comando <command>lintian</command> vengono qui elencati di seguito:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>E:</literal> for error; a sure policy violation or packaging error.
it: <literal>E:</literal> errore; una violazione certa di una policy o un errore di pacchettizzazione.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>W:</literal> for warning; a possible policy violation or packaging error.
it: <literal>W:</literal> attenzione; una possibile violazione di policy o un errore della pacchettizzazione.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>I:</literal> for info; information on certain aspects of packaging.
it: <literal>I:</literal> informazione; un'informazione su alcuni aspetti della pacchettizzazione.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>N:</literal> for note; a detailed message to help your debugging.
it: <literal>N:</literal> nota; un messaggio dettagliato per aiutare nell'analisi degli errori.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>O:</literal> for overridden; a message overridden by the <filename>lintian-overrides</filename> files but displayed by the <literal>--show-overrides</literal> option.
it: <literal>O:</literal> per sovrascrivere: il messaggio verrà sovrascritto dal file <filename>lintian-overrides</filename>, ma potrà essere visualizzato con l'opzione <literal>--show-overrides</literal>.

note: type: Content of: <book><chapter><section><para>
en: When you see warnings, tune the package to avoid them or verify that the warnings are spurious.  If spurious, set up <filename>lintian-overrides</filename> files as described in <xref linkend="lintian"/>.
it: Quando vengono generati degli avvertimenti, si imposti il pacchetto in modo tale da evitarli o si verifichi che tali avvertimenti non siano indicativi di un errore.  In quest'ultimo caso, si impostino i file <filename>lintian-overrides</filename> come descritto in <xref linkend="lintian"/>.

note: type: Content of: <book><chapter><section><para>
en: Note that you can build the package with <command>dpkg-buildpackage</command> and run <command>lintian</command> on it in one command, if you use <citerefentry> <refentrytitle>debuild</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> or <citerefentry> <refentrytitle>pdebuild</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.
it: Si noti che si può costruire il pacchetto con <command>dpkg-buildpackage</command> ed eseguire <command>lintian</command> su di esso in una sola volta con <citerefentry> <refentrytitle>debuild</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> o con <citerefentry> <refentrytitle>pdebuild</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.

note: type: Content of: <book><chapter><section><title>
en: The <command>debc</command> command
it: Il comando <command>debc</command>

note: type: Content of: <book><chapter><section><para>
en: You can list files in the binary Debian package with the <citerefentry> <refentrytitle>debc</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> command.
it: Si possono elencare i file nel pacchetto binario Debian con il comando <citerefentry> <refentrytitle>debc</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.

note: type: Content of: <book><chapter><section><title>
en: The <command>debdiff</command> command
it: Il comando <command>debdiff</command>

note: type: Content of: <book><chapter><section><para>
en: You can compare file contents in two source Debian packages with the <citerefentry> <refentrytitle>debdiff</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> command.
it: Si può confrontare il contenuto dei file in due pacchetti sorgente Debian con il comando <citerefentry> <refentrytitle>debdiff</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.

note: type: Content of: <book><chapter><section><para>
en: You can also compare file lists in two sets of binary Debian packages with the <citerefentry> <refentrytitle>debdiff</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> command.
it: Si possono anche confrontare le liste di file in due set di pacchetti binari Debian con il comando <citerefentry> <refentrytitle>debdiff</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.

note: type: Content of: <book><chapter><section><para>
en: These are useful to identify what has been changed in the source packages and to check for inadvertent changes made when updating binary packages, such as unintentionally misplacing or removing files.
it: Questi comandi sono utili per vedere cosa sia cambiato nei pacchetti sorgente, se un file sia stato spostato inavvertitamente o rimosso dai pacchetti, e se altri cambiamenti non intenzionali siano stati fatti durante l'aggiornamento dei pacchetti binari.

note: type: Content of: <book><chapter><section><title>
en: The <command>interdiff</command> command
it: Il comando <command>interdiff</command>

note: type: Content of: <book><chapter><section><para>
en: You can compare two <filename>diff.gz</filename> files with the <citerefentry> <refentrytitle>interdiff</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> command.  This is useful for verifying that no inadvertent changes were made to the source by the maintainer when updating packages in the old <literal>1.0</literal> source format.
it: Si possono confrontare due file <filename>diff.gz</filename> con il comando <citerefentry> <refentrytitle>interdiff</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.  Questo è utile per verificare che il manutentore non abbia inavvertitamente fatto dei cambiamenti ai sorgenti durante il processo di aggiornamento dei pacchetti nel vecchio formato sorgente <literal>1.0</literal>.

note: type: Content of: <book><chapter><section><para>
en: The new <literal>3.0</literal> source format stores changes in multiple patch files as described in <xref linkend="patches"/>.  You can trace changes of each <filename>debian/patches/*</filename> file using <command>interdiff</command>, too.
it: Il nuovo formato sorgente <literal>3.0</literal> salva i cambiamenti in file di patch multipli come descritto in <xref linkend="patches"/>.  È possibile tracciare i cambiamenti di ogni file <filename>debian/patches/*</filename> usando anche <command>interdiff</command>.

note: type: Content of: <book><chapter><section><title>
en: The <command>mc</command> command
it: Il comando <command>mc</command>

note: type: Content of: <book><chapter><section><para>
en: Many of these file inspection operations can be made into an intuitive process by using a file manager like <citerefentry> <refentrytitle>mc</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> which will let you browse not only the contents of <filename>*.deb</filename> package files but also <filename>*.udeb</filename>, <filename>*.debian.tar.gz</filename>, <filename>*.diff.gz</filename>, and <filename>*.orig.tar.gz</filename> files.
it: Molte delle operazioni di ispezione dei file possono essere rese più semplici utilizzando un gestore dei file come <citerefentry> <refentrytitle>mc</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, che permette di navigare non solo il contenuto dei pacchetti in formato <filename>*.deb</filename> ma anche degli <filename>*.udeb</filename>, <filename>*.debian.tar.gz</filename>, <filename>*.diff.gz</filename>, e dei file <filename>*.orig.tar.gz</filename>.

note: type: Content of: <book><chapter><section><para>
en: Be on the lookout for extra unneeded files or zero length files, both in the binary and source package.  Often cruft doesn't get cleaned up properly; adjust your <filename>rules</filename> file to compensate for this.
it: Si faccia attenzione ad ulteriori file non necessari o vuoti, sia nel pacchetto binario che in quello sorgente.  Spesso non vengono ripuliti correttamente; si aggiusti il file <filename>rules</filename> per riparare a questo problema.

note: type: Content of: <book><chapter><title>
en: Updating the package
it: Aggiornamento del pacchetto

note: type: Content of: <book><chapter><para>
en: After you release a package, you will soon need to update it.
it: Una volta rilasciato un pacchetto, ci sarà presto bisogno di aggiornarlo.

note: type: Content of: <book><chapter><section><title>
en: New Debian revision
it: Nuova revisione Debian

note: type: Content of: <book><chapter><section><para>
en: Let's say that a bug report was filed against your package as <literal>#654321</literal>, and it describes a problem that you can solve.  Here's what you need to do to create a new Debian revision of the package:
it: Si supponga che sia stato compilato il bug report <literal>#654321</literal> per il pacchetto creato, e che questo descriva un problema che si può risolvere. Qui è descritto come creare una nuova revisione del pacchetto Debian:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If this is to be recorded as a new patch, do the following:
it: Se la modifica deve essere registrata come una nuova patch, si seguano queste istruzioni:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt new <replaceable>bugname.patch</replaceable></literal> to set the patch name;
it: <literal>dquilt new <replaceable>bugname.patch</replaceable></literal> per impostare il nome della patch;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt add <replaceable>buggy-file</replaceable></literal> to declare the file to be modified;
it: <literal>dquilt add <replaceable>buggy-file</replaceable></literal> per indicare i file modificati;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Correct the problem in the package source for the upstream bug;
it: Correggere il problema evidenziato dal bug report nel pacchetto sorgente;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt refresh</literal> to record it to <filename><replaceable>bugname.patch</replaceable></filename>;
it: <literal>dquilt refresh</literal> per registrare le modifiche in <filename><replaceable>bugname.patch</replaceable></filename>;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt header -e</literal> to add its description;
it: <literal>dquilt header -e</literal> per aggiungere una descrizione;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If this is to update an existing patch, do the following:
it: Se la modifica è un aggiornamento ad una patch esistente, si seguano queste istruzioni:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt pop <replaceable>foo.patch</replaceable></literal> to recall the existing <filename><replaceable>foo.patch</replaceable></filename>;
it: <literal>dquilt pop <replaceable>foo.patch</replaceable></literal> per richiamare la patch <filename><replaceable>foo.patch</replaceable></filename> esistente;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Correct the problem in the old <filename><replaceable>foo.patch</replaceable></filename>;
it: Correggere il problema nella vecchia patch <filename><replaceable>foo.patch</replaceable></filename>;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt refresh</literal> to update <filename><replaceable>foo.patch</replaceable></filename>;
it: <literal>dquilt refresh</literal> per aggiornare <filename><replaceable>foo.patch</replaceable></filename>;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt header -e</literal> to update its description;
it: <literal>dquilt header -e</literal> per aggiornarne la descrizione;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>while dquilt push; do dquilt refresh; done</literal> to apply all patches while removing <emphasis>fuzz</emphasis>;
it: <literal>while dquilt push; do dquilt refresh; done</literal> per applicare tutte le patch mentre si sta rimuovendo il <emphasis>fuzz</emphasis>;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para><footnote><para>
en: To get the date in the required format, use <literal>LANG=C date -R</literal>.
it: Per impostare la data nel formato corretto, si usi <literal>LANG=C date -R</literal>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Add a new revision at the top of the Debian <filename>changelog</filename> file, for example with <literal>dch -i</literal>, or explicitly with <literal>dch -v <replaceable>version</replaceable>-<replaceable>revision</replaceable></literal> and then insert the comments using your preferred editor.  <placeholder type="footnote" id="0"/>
it: Aggiungere una nuova revisione in cima al file di <filename>changelog</filename> Debian, per esempio con <literal>dch -i</literal>, o esplicitamente con <literal>dch -v <replaceable>version</replaceable>-<replaceable>revision</replaceable></literal> e poi inserire i commenti utilizzando l'editor preferito.  <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Include a short description of the bug and the solution in the changelog entry, followed by <literal>Closes: #654321</literal>.  That way, the bug report will be <emphasis>automagically</emphasis> closed by the archive maintenance software the moment your package gets accepted into the Debian archive.
it: Includere nella nuova voce del changelog una breve descrizione del problema e della relativa soluzione, seguita da <literal>Closes: #654321</literal>.  In questo modo, il report del problema verrà <emphasis>automaticamente</emphasis> chiuso dal programma di manutenzione dell'archivio Debian nel momento stesso in cui il pacchetto viene accettato.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Repeat what you did in the above to fix more bugs while updating the Debian <filename>changelog</filename> file with <literal>dch</literal> as needed.
it: Si ripetano questi passaggi per risolvere ulteriori problemi e si ricordi nel frattempo di aggiornare il file Debian di <filename>changelog</filename> con <literal>dch</literal> a seconda della necessità.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Repeat what you did in <xref linkend="completebuild"/> and <xref linkend="checkit"/>.
it: Si ripetano i passi fatti in <xref linkend="completebuild"/>, <xref linkend="checkit"/>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Once you are satisfied, you should change the distribution value in <filename>changelog</filename> from <literal>UNRELEASED</literal> to the target distribution value <literal>unstable</literal> (or even <literal>experimental</literal>).<placeholder type="footnote" id="0"/>
it: Quando si è soddisfatti, si può cambiare il valore del campo distribuzione nel file <filename>changelog</filename> da <literal>UNRELEASED</literal> a <literal>unstable</literal> (o anche <literal>experimental</literal>).<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Upload the package as in <xref linkend="upload"/>.  The difference is that this time, the original source archive won't be included, as it hasn't been changed and it already exists in the Debian archive.
it: Caricare i pacchetti come <xref linkend="upload"/>.  La differenza è che questa volta, l'archivio del sorgente originale non sarà incluso, dal momento che non è stato modificato e già esiste nell'archivio Debian.

note: type: Content of: <book><chapter><section><para>
en: One tricky case can occur when you make a local package, to experiment with the packaging before uploading the normal version to the official archive, e.g., <literal><replaceable>1.0.1</replaceable>-<replaceable>1</replaceable></literal>.  For smoother upgrades, it is a good idea to create a <filename>changelog</filename> entry with a version string such as <literal><replaceable>1.0.1</replaceable>-<replaceable>1~rc1</replaceable></literal>.  You may unclutter <filename>changelog</filename> by consolidating such local change entries into a single entry for the official package.  See <xref linkend="namever"/> for the order of version strings.
it: Un caso complicato può verificarsi quando si crea un pacchetto locale per sperimentare la pacchettizzazione prima di caricare la versione normale nell'archivio ufficiale, ad esempio <literal><replaceable>1.0.1</replaceable>-<replaceable>1</replaceable></literal>. Per facilitare gli aggiornamenti è consigliabile creare una voce con la stringa della versione come <literal><replaceable>1.0.1</replaceable>-<replaceable>1~rc1</replaceable></literal> nel file <filename>changelog</filename>. Per il pacchetto ufficiale si può riordinare il file <filename>changelog</filename> consolidando la modifiche locali in una singola voce. Si veda <xref linkend="namever"/> per l'ordine delle stringhe di versione.

note: type: Content of: <book><chapter><section><title>
en: Inspection of the new upstream release
it: Controllo della nuova distribuzione

note: type: Content of: <book><chapter><section><para>
en: When preparing packages of a new upstream release for the Debian archive, you must check the new upstream release first.
it: Quando si stanno preparando i pacchetti della nuova release per l'archivio Debian, bisogna controllare prima la nuova release del pacchetto originale.

note: type: Content of: <book><chapter><section><para>
en: Start by reading the upstream <filename>changelog</filename>, <filename>NEWS</filename>, and whatever other documentation they may have released with the new version.
it: Si comincia leggendo i file originali <filename>changelog</filename>, <filename>NEWS</filename>, e qualsiasi altra documentazione che possa essere stata rilasciata con la nuova versione.

note: type: Content of: <book><chapter><section><para>
en: You can then inspect changes between the old and new upstream sources as follows, watching out for anything suspicious:
it: Successivamente si controllano i cambiamenti tra i vecchi sorgenti originali e quelli nuovi, come mostrato in seguito, alla ricerca di qualsiasi modifica sospetta:

note: type: Content of: <book><chapter><section><para>
en: Changes to some auto-generated files by Autotools such as <filename>missing</filename>, <filename>aclocal.m4</filename>, <filename>config.guess</filename>, <filename>config.h.in</filename>, <filename>config.sub</filename>, <filename>configure</filename>, <filename>depcomp</filename>, <filename>install-sh</filename>, <filename>ltmain.sh</filename>, and <filename>Makefile.in</filename> may be ignored.  You may delete them before running <command>diff</command> on the source for inspection.
it: I cambiamenti effettuati ad alcuni file generati automaticamente dagli Autotools come <filename>missing</filename>, <filename>aclocal.m4</filename>, <filename>config.guess</filename>, <filename>config.h.in</filename>, <filename>config.sub</filename>, <filename>configure</filename>, <filename>depcomp</filename>, <filename>install-sh</filename>, <filename>ltmain.sh</filename>, e <filename>Makefile.in</filename> possono essere ignorati.  Possono anzi venire cancellati prima di eseguire <command>diff</command> per controllare i sorgenti.

note: type: Content of: <book><chapter><section><title>
en: New upstream release
it: Nuova distribuzione

note: type: Content of: <book><chapter><section><para><footnote><para>
en: If a package <systemitem role="package"><replaceable>foo</replaceable></systemitem> is packaged in the old <literal>1.0</literal> format, this can be done by running <literal>zcat /<replaceable>path</replaceable>/<replaceable>to</replaceable>/<replaceable>foo</replaceable>_<replaceable>oldversion</replaceable>.diff.gz|patch -p1</literal> in the new extracted source, instead.
it: Se un pacchetto <systemitem role="package"><replaceable>foo</replaceable></systemitem> è stato pacchettizzato nel vecchio formato <literal>1.0</literal>, si deve invece eseguire <literal>zcat /<replaceable>path</replaceable>/<replaceable>to</replaceable>/<replaceable>foo</replaceable>_<replaceable>oldversion</replaceable>.diff.gz|patch -p1</literal> nella nuova directory sorgente scompattata.

note: type: Content of: <book><chapter><section><para>
en: If a package <systemitem role="package"><replaceable>foo</replaceable></systemitem> is properly packaged in the newer <literal>3.0 (native)</literal> or <literal>3.0 (quilt)</literal> formats, packaging a new upstream version is essentially moving the old <filename>debian</filename> directory to the new source.  This can be done by running <literal>tar xvzf /<replaceable>path</replaceable>/<replaceable>to</replaceable>/<replaceable>foo</replaceable>_<replaceable>oldversion</replaceable>.debian.tar.gz</literal> in the new extracted source.  <placeholder type="footnote" id="0"/> Of course, you need to do some obvious chores:
it: Se un pacchetto <systemitem role="package"><replaceable>foo</replaceable></systemitem> è stato impacchettato correttamente nei nuovi formati <literal>3.0 (native)</literal> o <literal>3.0 (quilt)</literal>, si rende necessario impacchettare anche la versione originale muovendo la directory <filename>debian</filename> nella nuova sorgente.  Questo può essere fatto eseguendo <literal>tar xvzf /<replaceable>path</replaceable>/<replaceable>to</replaceable>/<replaceable>foo</replaceable>_<replaceable>oldversion</replaceable>.debian.tar.gz</literal> nella nuova directory sorgente scompattata.  <placeholder type="footnote" id="0"/> Ovviamente bisognerà effettuare alcuni passaggi:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Create a copy of the upstream source as the <filename>foo_<replaceable>newversion</replaceable>.orig.tar.gz</filename> file.
it: Creare una copia dei sorgenti originali nel file <filename>foo_<replaceable>newversion</replaceable>.orig.tar.gz</filename>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Update the Debian <filename>changelog</filename> file with <literal>dch -v <replaceable>newversion</replaceable>-<replaceable>1</replaceable></literal>.
it: Aggiornare il file di <filename>changelog</filename> Debian con <literal>dch -v <replaceable>newversion</replaceable>-<replaceable>1</replaceable></literal>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Add an entry with <literal>New upstream release</literal>.
it: Aggiungere una voce che dica <literal>New upstream release</literal>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Describe concisely the changes <emphasis>in the new upstream release</emphasis> that fix reported bugs and close those bugs by adding <literal>Closes: #<replaceable>bug_number</replaceable></literal>.
it: Descrivere brevemente i cambiamenti <emphasis>nella nuova distribuzione</emphasis> che correggono i bug riportati e ne chiudono altri aggiungendo <literal>Closes: #<replaceable>numero_bug</replaceable></literal>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Describe concisely the changes <emphasis>to the new upstream release</emphasis> by the maintainer that fix reported bugs and close those bugs by adding <literal>Closes: #<replaceable>bug_number</replaceable></literal>.
it: Descrivere brevemente i cambiamenti <emphasis>nella nuova distribuzione</emphasis>, effettuati dal manutentore, che correggono i bug riportati e li chiudono aggiungendo <literal>Closes: #<replaceable>numero_bug</replaceable></literal>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>while dquilt push; do dquilt refresh; done</literal> to apply all patches while removing <emphasis>fuzz</emphasis>.
it: <literal>while dquilt push; do dquilt refresh; done</literal> per applicare tutte le patch mentre si sta rimuovendo il <emphasis>fuzz</emphasis>.

note: type: Content of: <book><chapter><section><para>
en: If the patch/merge did not apply cleanly, inspect the situation (clues are left in <filename>.rej</filename> files).
it: Se la patch/merge non è stata applicata in maniera corretta, si controlli la situazione (gli indizi vengono lasciati nei file <filename>.rej</filename>).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If a patch you applied to the source was integrated into the upstream source,
it: Se una patch applicata ai sorgenti è stata integrata nei sorgenti originali,

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt delete</literal> to remove it.
it: si rimuova con <literal>dquilt delete</literal>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If a patch you applied to the source conflicted with new changes in the upstream source,
it: Se una patch applicata alla sorgente è andata in conflitto con i nuovi cambiamenti nei sorgenti originali,

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt push -f</literal> to apply old patches while forcing rejects as <filename><replaceable>baz</replaceable>.rej</filename>.
it: si esegua <literal>dquilt push -f</literal> per applicare le vecchie patch forzando gli scarti nel file <filename><replaceable>baz</replaceable>.rej</filename>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Edit the <filename><replaceable>baz</replaceable></filename> file manually to bring about the intended effect of <filename><replaceable>baz</replaceable>.rej</filename>.
it: Modificare manualmente il file <filename><replaceable>baz</replaceable></filename> per applicare gli effetti desiderati presenti nel file <filename><replaceable>baz</replaceable>.rej</filename>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt refresh</literal> to update the patch.
it: <literal>dquilt refresh</literal> per aggiornare la patch.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Continue as usual with <literal>while dquilt push; do dquilt refresh; done</literal>.
it: Ritornare alla procedura <literal>while dquilt push; do dquilt refresh; done</literal>.

note: type: Content of: <book><chapter><section><para>
en: This process can be automated using the <citerefentry> <refentrytitle>uupdate</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> command as follows:
it: Questo processo può essere automatizzato utilizzando il comando <citerefentry> <refentrytitle>uupdate</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> come segue:

note: type: Content of: <book><chapter><section><para><footnote><para>
en: If the <command>uscan</command> command downloads the updated source but it does not run the <command>uupdate</command> command, you should correct the <filename>debian/watch</filename> file to have <literal>debian uupdate</literal> at the end of the URL.
it: Se il comando <command>uscan</command> scarica il sorgente aggiornato ma non esegue il comando <command>uupdate</command>, si può modificare il file <filename>debian/watch</filename> inserendo <literal>debian uupdate</literal> alla fine dell'URL.

note: type: Content of: <book><chapter><section><para>
en: If you set up a <filename>debian/watch</filename> file as described in <xref linkend="watch"/>, you can skip the <command>wget</command> command.  You simply run <citerefentry> <refentrytitle>uscan</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> in the <filename><replaceable>foo</replaceable>-<replaceable>oldversion</replaceable></filename> directory instead of the <command>uupdate</command> command.  This will <emphasis>automagically</emphasis> look for the updated source, download it, and run the <command>uupdate</command> command.  <placeholder type="footnote" id="0"/>
it: Se si imposta il file <filename>debian/watch</filename> come descritto in <xref linkend="watch"/>, si può saltare il comando <command>wget</command>.  Basterà eseguire <citerefentry> <refentrytitle>uscan</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> nella directory <filename><replaceable>foo</replaceable>-<replaceable>oldversion</replaceable></filename> al posto del comando <command>uupdate</command>.  Questo cercherà <emphasis>auto-magicamente</emphasis> i sorgenti corretti, li scaricherà ed eseguirà il comando <command>uupdate</command>.  <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: You can release this updated source by repeating what you did in <xref linkend="completebuild"/>, <xref linkend="checkit"/>, and <xref linkend="upload"/>.
it: Si possono rilasciare questi sorgenti aggiornati ripetendo ciò che si è fatto in <xref linkend="completebuild"/>, <xref linkend="checkit"/>, ed <xref linkend="upload"/>.

note: type: Content of: <book><chapter><section><title>
en: Updating the packaging style
it: Aggiornare lo stile di pacchettizzazione

note: type: Content of: <book><chapter><section><para><footnote><para>
en: If your sponsor or other maintainers object to updating the existing packaging style, don't bother arguing.  There are more important things to do.
it: Se il proprio sponsor o altri manutentori non ritengono sia necessario aggiornare lo stile del pacchetto, allora non vale la pena perderci molto tempo.  Ci sono cose più importanti da fare.

note: type: Content of: <book><chapter><section><para>
en: Updating the package style is not a required activity for the update of a package.  However, doing so lets you use the full capabilities of the modern <systemitem role="package">debhelper</systemitem> system and the <literal>3.0</literal> source format.  <placeholder type="footnote" id="0"/>
it: L'aggiornamento dello stile del pacchetto non è una attività obbligatoria nel processo di aggiornamento di quest'ultimo.  Tuttavia facendo ciò si può sfruttare appieno la capacità del moderno sistema <systemitem role="package">debhelper</systemitem> ed il formato sorgente <literal>3.0</literal>.  <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If you need to recreate deleted template files for any reason, you can run <command>dh_make</command> again in the same Debian package source tree with the <literal>--addmissing</literal> option.  Then edit them appropriately.
it: Se per qualsiasi motivo c'è la necessità di aggiungere file di template cancellati, si può eseguire nuovamente il comando <command>dh_make</command> nella stessa directory del sorgente del pacchetto Debian con l'opzione <literal>--addmissing</literal>.  Fatto questo si potrà modificarlo di conseguenza.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If the package has not been updated to use the <systemitem role="package">debhelper</systemitem> v7+ <command>dh</command> syntax for the <filename>debian/rules</filename> file, update it to use <command>dh</command>.  Update the <filename>debian/control</filename> file accordingly.
it: Se il pacchetto non è stato aggiornato per utilizzare la sintassi v7+ di <command>dh</command> del pacchetto <systemitem role="package">debhelper</systemitem> per il file <filename>debian/rules</filename>, si deve effettuare un aggiornamento per poter usare <command>dh</command>.  Si aggiorni di conseguenza anche il file <filename>debian/control</filename>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If you want to update the <filename>rules</filename> file created with the <filename>Makefile</filename> inclusion mechanism of the Common Debian Build System (<systemitem role="package">cdbs</systemitem>) to the <command>dh</command> syntax, see the following to understand its <literal>DEB_*</literal> configuration variables.
it: Se si desidera aggiornare il file <filename>rules</filename> creato con il meccanismo di inclusione "Common Debian Build System" (<systemitem role="package">cdbs</systemitem>) del <filename>Makefile</filename> con la sintassi <command>dh</command>, si veda più avanti per capire le variabili di configurazione <literal>DEB_*</literal>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: local copy of <filename>&cdbs-doc;</filename>
it: copia locale di <filename>&cdbs-doc;</filename>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If you have a <literal>1.0</literal> source package without the <filename><replaceable>foo</replaceable>.diff.gz</filename> file, you can update it to the newer <literal>3.0 (native)</literal> source format by creating <filename>debian/source/format</filename> with <literal>3.0 (native)</literal>.  The rest of the <filename>debian/*</filename> files can just be copied.
it: Se si ha un pacchetto sorgente nella versione <literal>1.0</literal> senza il file <filename><replaceable>foo</replaceable>.diff.gz</filename>, si può aggiornare al nuovo formato sorgente <literal>3.0 (native)</literal> creando il file <filename>debian/source/format</filename> contenente <literal>3.0 (native)</literal>.  Gli altri file <filename>debian/*</filename> possono essere semplicemente copiati.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para><footnote><para>
en: You can split <filename>big.diff</filename> into many small incremental patches using the <command>splitdiff</command> command.
it: È possibile dividere il file <filename>big.diff</filename> in tante piccole patch incrementali utilizzando il comando <command>splitdiff</command>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If you have a <literal>1.0</literal> source package with the <filename><replaceable>foo</replaceable>.diff.gz</filename> file, you can update it to the newer <literal>3.0 (quilt)</literal> source format by creating <filename>debian/source/format</filename> with <literal>3.0 (quilt)</literal>.  The rest of the <filename>debian/*</filename> files can just be copied.  Import the <filename>big.diff</filename> file generated by the command <literal>filterdiff -z -x '*/debian/*' <replaceable>foo</replaceable>.diff.gz &gt; big.diff</literal> to your <command>quilt</command> system, if needed.  <placeholder type="footnote" id="0"/>
it: Se si ha un pacchetto sorgente nella versione <literal>1.0</literal> con il file <filename><replaceable>foo</replaceable>.diff.gz</filename>, si può aggiornare al nuovo formato sorgente <literal>3.0 (quilt)</literal> creando il file <filename>debian/source/format</filename> contenente <literal>3.0 (quilt)</literal>.  Gli altri file <filename>debian/*</filename> possono essere semplicemente copiati.  Se necessario, si importi il file <filename>big.diff</filename> generato dal comando <literal>filterdiff -z -x '*/debian/*' <replaceable>foo</replaceable>.diff.gz &gt; big.diff</literal> nel sistema <command>quilt</command>.<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If it was packaged using another patch system such as <systemitem role="package">dpatch</systemitem>, <systemitem role="package">dbs</systemitem>, or <systemitem role="package">cdbs</systemitem> with <literal>-p0</literal>, <literal>-p1</literal>, or <literal>-p2</literal>, convert it to <systemitem role="package">quilt</systemitem> using <filename>deb3</filename> at <ulink url="&deb3;"/>.
it: Si nel pacchetto è stato utilizzato un altro sistema di patch come <systemitem role="package">dpatch</systemitem>, <systemitem role="package">dbs</systemitem>, o <systemitem role="package">cdbs</systemitem> con <literal>-p0</literal>, <literal>-p1</literal>, o <literal>-p2</literal>, lo si può convertire con il comando <systemitem role="package">quilt</systemitem> utilizzando <filename>deb3</filename> presente su <ulink url="&deb3;"/>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If it was packaged with the <command>dh</command> command with the <literal>--with quilt</literal> option or with the <command>dh_quilt_patch</command> and <command>dh_quilt_unpatch</command> commands, remove these and make it use the newer <literal>3.0 (quilt)</literal> source format.
it: Se il pacchetto è stato creato con il comando <command>dh</command> con l'opzione <literal>--with quilt</literal> o con i comandi <command>dh_quilt_patch</command> e <command>dh_quilt_unpatch</command>, si rimuovano i file prodotti e li si sostituisca usando il nuovo formato dei sorgenti <literal>3.0 (quilt)</literal>.

note: type: Content of: <book><chapter><section><para>
en: You should check <ulink url="&dep;">DEP - Debian Enhancement Proposals</ulink> and adopt ACCEPTED proposals.
it: Bisogna controllare <ulink url="&dep;">DEP - Debian Enhancement Proposals</ulink> e adottare le proposte ACCEPTED.

note: type: Content of: <book><chapter><section><para>
en: You need to do the other tasks described in <xref linkend="newupstream"/>, too.
it: Ci sarà anche bisogno di eseguire ulteriori operazioni descritte in <xref linkend="newupstream"/>.

note: type: Content of: <book><chapter><section><title>
en: UTF-8 conversion
it: Conversione UTF-8

note: type: Content of: <book><chapter><section><para>
en: If upstream documents are encoded in old encoding schemes, converting them to <ulink url="&utf8;">UTF-8</ulink> is a good idea.
it: Se i documenti originali sono codificato con vecchi schemi di codifica, è buona norma convertirli in <ulink url="&utf8;">UTF-8</ulink>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Use <citerefentry> <refentrytitle>iconv</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> to convert encodings of plain text files.
it: Utilizzare <citerefentry> <refentrytitle>iconv</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> per convertire le codifiche dei file di testo.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Use <citerefentry> <refentrytitle>w3m</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> to convert from HTML files to UTF-8 plain text files.  When you do this, make sure to execute it under UTF-8 locale.
it: Utilizzare <citerefentry> <refentrytitle>w3m</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> per convertire da file HTML a file di testo UTF-8.  Ci si assicuri di utilizzarlo in un ambiente con localizzazione UTF-8.

note: type: Content of: <book><chapter><section><title>
en: Reminders for updating packages
it: Note per l'aggiornamento dei pacchetti

note: type: Content of: <book><chapter><section><para>
en: Here are a few reminders for updating packages:
it: Vengono qui presentate alcune note per l'aggiornamento dei pacchetti:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Preserve old <filename>changelog</filename> entries (sounds obvious, but there have been cases of people typing <literal>dch</literal> when they should have typed <literal>dch -i</literal>.)
it: Si preservino le vecchie voci del <filename>changelog</filename> (sembra ovvio, ma a volte si sono verificati problemi per aver scritto <literal>dch</literal> mentre si sarebbe dovuto scrivere <literal>dch -i</literal>.)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Existing Debian changes need to be reevaluated; throw away stuff that upstream has incorporated (in one form or another) and remember to keep stuff that hasn't been incorporated by upstream, unless there is a compelling reason not to.
it: Cambiamenti preesistenti devono essere ricontrollati; si scarti tutto ciò che è stato incorporato in upstream (in una forma o nell'altra) e ci si ricordi di mantenere tutto quello che non è stato incorporato dall'upstream, a meno che non ci sia una buona ragione per non farlo.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If any changes were made to the build system (hopefully you'd know from inspecting upstream changes) then update the <filename>debian/rules</filename> and <filename>debian/control</filename> build dependencies if necessary.
it: Se è stato fatto qualsiasi cambiamento nel sistema di costruzione del pacchetto (sperabilmente ce se ne renderà conto controllando i cambiamenti dall'originale) allora si aggiorni il file <filename>debian/rules</filename> e le dipendenze di <filename>debian/control</filename> se necessario.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Check the <ulink url="&bts;">Debian Bug Tracking System (BTS)</ulink> to see if someone has provided patches to bugs that are currently open.
it: Si controlli nel <ulink url="&bts;">Debian Bug Tracking System (BTS)</ulink> se qualcuno ha reso disponibili delle patch ai bug che sono attualmente aperti.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Check the contents of the <filename>.changes</filename> file to make sure you are uploading to the correct distribution, the proper bug closures are listed in the <literal>Closes</literal> field, the <literal>Maintainer</literal> and <literal>Changed-By</literal> fields match, the file is GPG-signed, etc.
it: Si controlli il contenuto del file <filename>.changes</filename> per essere sicuri che si stia caricando per la distribuzione corretta, le risoluzioni ai bug vengono listate nel campo <literal>Closes</literal>, i campi <literal>Maintainer</literal> e <literal>Changed-By</literal> corrispondono, il file è firmato con GPG, ecc.

note: type: Content of: <book><chapter><title>
en: Uploading the package
it: Caricamento del pacchetto

note: type: Content of: <book><chapter><para>
en: Now that you have tested your new package thoroughly, you want to release it to a public archive to share it.
it: Una volta testato il nuovo pacchetto approfonditamente, si potrà rilasciarlo in un archivio pubblico per condividerlo.

note: type: Content of: <book><chapter><section><title>
en: Uploading to the Debian archive
it: Caricamento nell'archivio Debian

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <xref linkend="socialdynamics"/>.
it: Si veda <xref linkend="socialdynamics"/>.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: There are publicly accessible archives such as <ulink url="&mentors-dn;"/> which work almost the same way as the Debian archive and provide an upload area for non-DDs.  You can set up an equivalent archive by yourself using the tools listed at <ulink url="&deb-archive;"/>.  So this section is useful for non-DDs, too.
it: Ci sono archivi accessibili al pubblico, come <ulink url="&mentors-dn;"/> che lavorano quasi allo stesso modo dell'archivio Debian e forniscono una zona di caricamento per i non-DD. È possibile impostare, autonomamente, un archivio equivalente utilizzando gli strumenti elencati in <ulink url="&deb-archive;"/> . Quindi questa sezione è utile per anche per i non-DD.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: The <systemitem role="package">dput</systemitem> package seems to come with more features and to be becoming more popular than the <systemitem role="package">dupload</systemitem> package.  It uses the file <filename>/etc/dput</filename> for its global configuration and the file <filename>~/.dput.cf</filename> for per-user configuration.  It supports Ubuntu-related services out-of-the-box, too.
it: Il pacchetto <systemitem role="package">dput</systemitem> sembra avere più funzionalità e sta divenendo più popolare del pacchetto <systemitem role="package">dupload</systemitem>.  Questo utilizza il file <filename>/etc/dput</filename> per la sua configurazione globale ed il file <filename>~/.dput.cf</filename> per quella dei singoli utenti.  Inoltre supporta nativamente anche i servizi relativi ad Ubuntu.

note: type: Content of: <book><chapter><section><para>
en: Once you become an official developer, <placeholder type="footnote" id="0"/> you can upload the package to the Debian archive.  <placeholder type="footnote" id="1"/> You can do this manually, but it's easier to use the existing automated tools, like <citerefentry> <refentrytitle>dupload</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> or <citerefentry> <refentrytitle>dput</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.  We'll describe how it's done with <command>dupload</command>.  <placeholder type="footnote" id="2"/>
it: Una volta diventati sviluppatori ufficiali, <placeholder type="footnote" id="0"/> si dovrà caricare il pacchetto nell'archivio Debian.  <placeholder type="footnote" id="1"/> Si potrebbe fare manualmente, ma è più semplice usare i tool automatici che vengono forniti, come <citerefentry> <refentrytitle>dupload</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> o <citerefentry> <refentrytitle>dput</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.  Verrà qui descritto come tutto ciò può essere fatto utilizzando <command>dupload</command>.  <placeholder type="footnote" id="2"/>

note: type: Content of: <book><chapter><section><para>
en: First you have to set up <command>dupload</command>'s config file.  You can either edit the system-wide <filename>/etc/dupload.conf</filename> file, or have your own <filename>~/.dupload.conf</filename> file override the few things you want to change.
it: Innanzitutto andrà impostato il file di configurazione di <command>dupload</command>.  Si può modificare il file <filename>/etc/dupload.conf</filename> per l'intero sistema, oppure far si che il file <filename>~/.dupload.conf</filename> sovrascriva le poche cose che si vogliono cambiare.

note: type: Content of: <book><chapter><section><para>
en: You can read the <citerefentry> <refentrytitle>dupload.conf</refentrytitle> <manvolnum>5</manvolnum> </citerefentry> manual page to understand what each of these options means.
it: Si legga la pagina del manuale <citerefentry> <refentrytitle>dupload.conf</refentrytitle> <manvolnum>5</manvolnum> </citerefentry> per capire cosa significhino tutte le opzioni.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&devref-upload;">Debian Developer's Reference 5.6, "Uploading a package"</ulink>.
it: Per maggiori informazioni, si consulti la <ulink url="&developers-reference;">Guida di riferimento per lo sviluppatore 5.6. "Uploading a package"</ulink>.

note: type: Content of: <book><chapter><section><para>
en: The <literal>$default_host</literal> option determines which of the upload queues will be used by default.  <literal>anonymous-ftp-master</literal> is the primary one, but it's possible that you will want to use another one.  <placeholder type="footnote" id="0"/>
it: L'opzione <literal>$default_host</literal> determina quali tra le code di caricamento vengano utilizzate in modo predefinito.  <literal>anonymous-ftp-master</literal> è quella primaria, ma è possibile utilizzarne anche altre. <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: While connected to the Internet, you can upload your package as follows:
it: Quando si è connessi ad Internet, si può caricare il proprio pacchetto con il comando:

note: type: Content of: <book><chapter><section><para>
en: <command>dupload</command> checks that the SHA1/SHA256 file checksums match those listed in the <filename>.changes</filename> file.  If they do not match, it will warn you to rebuild it as described in <xref linkend="completebuild"/> so it can be properly uploaded.
it: <command>dupload</command> controlla che i checksum SHA1/SHA256 dei file corrispondano con quelli del file <filename>.changes</filename>.  Se non dovessero corrispondere si verrà avvertiti di ricostruire il pacchetto come descritto in <xref linkend="completebuild"/> per poi poterlo ricaricare.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&uploadqueue-readme;"/>.  Alternatively, you can use the <command>dcut</command> command from the <systemitem role="package">dput</systemitem> package.
it: Si veda <ulink url="&uploadqueue-readme;"/>. Alternativamente, si può utilizzare il comando <command>dcut</command> del pacchetto <systemitem role="package">dput</systemitem>.

note: type: Content of: <book><chapter><section><para>
en: If you encounter an upload problem at <ulink url="&uploadqueue;"/>, you can fix this by manually uploading a GPG-signed <filename>*.commands</filename> file to there with <command>ftp</command>.  <placeholder type="footnote" id="0"/> For example, using <filename>hello.commands</filename>:
it: Se si incontrano problemi nel caricamento su <ulink url="&uploadqueue;"/>, si può porre rimedio caricando automaticamente il file <filename>*.commands</filename> firmato con GPG via <command>ftp</command>.  <placeholder type="footnote" id="0"/> Per esempio, si prenda il file <filename>hello.commands</filename>:

note: type: Content of: <book><chapter><section><title>
en: Including <filename>orig.tar.gz</filename> for upload
it: Includere <filename>orig.tar.gz</filename> per il caricamento

note: type: Content of: <book><chapter><section><para>
en: When you first upload the package to the archive, you need to include the original <filename>orig.tar.gz</filename> source, too.  If the Debian revision number of this package is neither <literal>1</literal> nor <literal>0</literal>, you must provide the <command>dpkg-buildpackage</command> option <literal>-sa</literal>.
it: Quando si carica per la prima volta il pacchetto nell'archivio, si deve includere il file dei sorgenti originali <filename>orig.tar.gz</filename>. Se il numero di revisione Debian del pacchetto non è <literal>1</literal> o <literal>0</literal>, si deve eseguire il comando <command>dpkg-buildpackage</command> con l'opzione <literal>-sa</literal>.

note: type: Content of: <book><chapter><section><para>
en: For the <command>dpkg-buildpackage</command> command:
it: Per il comando <command>dpkg-buildpackage</command>:

note: type: Content of: <book><chapter><section><para>
en: For the <command>debuild</command> command:
it: Per il comando <command>debuild</command>:

note: type: Content of: <book><chapter><section><para>
en: For the <command>pdebuild</command> command:
it: Per il comando <command>pdebuild</command>:

note: type: Content of: <book><chapter><section><para>
en: On the other hand, the <literal>-sd</literal> option will force the exclusion of the original <filename>orig.tar.gz</filename> source.
it: D'altra parte, l'opzione <literal>-sd</literal> forzerà l'esclusione del sorgente originale <filename>orig.tar.gz</filename>.

note: type: Content of: <book><chapter><section><title>
en: Skipped uploads
it: Aggiornamenti scartati

note: type: Content of: <book><chapter><section><para>
en: If you created multiple entries in <filename>debian/changelog</filename> by skipping uploads, you must create a proper <filename>*_.changes</filename> file that includes all changes since the last upload.  This can be done by specifying the <command>dpkg-buildpackage</command> option <literal>-v</literal> with the version, e.g., <literal><replaceable>1.2</replaceable></literal>.
it: Se si creano più voci nel file <filename>debian/changelog</filename> tralasciando gli aggiornamenti, è necessario creare il file <filename>*_.changes</filename> che include tutte le modifiche dall'ultimo caricamento. Questo può essere fatto specificando, al comando <command>dpkg-buildpackage</command>, l'opzione <literal>-v</literal> con la versione, ad esempio <literal><replaceable>1.2</replaceable></literal>.

note: type: Content of: <book><appendix><title>
en: Advanced packaging
it: Pacchettizzazione avanzata

note: type: Content of: <book><appendix><para>
en: Here are some hints and pointers for advanced packaging topics that you are most likely to deal with.  You are strongly advised to read all the references suggested here.
it: Sono qui riportati alcuni suggerimenti e riferimenti sulle cose più comuni riguardanti la pacchettizzazione avanzata.  Si consiglia vivamente di leggere tutti i riferimenti qui riportati.

note: type: Content of: <book><appendix><para>
en: You may need to manually edit the packaging template files generated by the <command>dh_make</command> command to address topics covered in this chapter.  The newer <command>debmake</command> command should address these topics better.
it: Può essere necessario modificare manualmente il file del template del pacchetto generato dal comando <command>dh_make</command> per affrontare gli argomenti trattati in questo capitolo. Il nuovo comando <command>debmake</command> potrebbe trattare questi temi in modo migliore.

note: type: Content of: <book><appendix><section><title>
en: Shared libraries
it: Librerie condivise

note: type: Content of: <book><appendix><section><para>
en: Before packaging shared <ulink url="&library;">libraries</ulink>, you should read the following primary references in detail:
it: Prima di pacchettizzare una <ulink url="&library;">libreria</ulink> condivisa, si dovrebbero leggere attentamente i seguenti riferimenti principali:

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <ulink url="&policy-sharedlibraries;">Debian Policy Manual, 8 "Shared libraries"</ulink>
it: <ulink url="&policy-sharedlibraries;">Manuale delle policy di Debian, 8 "Shared libraries"</ulink>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <ulink url="&policy-fhs;">Debian Policy Manual, 9.1.1 "File System Structure"</ulink>
it: <ulink url="&policy-fhs;">Manuale delle policy di Debian, 9.1.1 "File System Structure"</ulink>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <ulink url="&policy-libraries;">Debian Policy Manual, 10.2 "Libraries"</ulink>
it: <ulink url="&policy-libraries;">Manuale delle policy di Debian, 10.2 "Libraries"</ulink>

note: type: Content of: <book><appendix><section><para>
en: Here are some oversimplified hints for you to get started:
it: Di seguito alcuni semplici suggerimenti per iniziare:

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Shared libraries are <ulink url="&elf;">ELF</ulink> object files containing compiled code.
it: Le librerie condivise sono file oggetto <ulink url="&elf;">ELF</ulink> che contengono del codice compilato.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Shared libraries are distributed as <filename>*.so</filename> files. (Neither <filename>*.a</filename> files nor <filename>*.la</filename> files)
it: Le librerie condivise sono distribuite come file <filename>*.so</filename>. (Né come file <filename>*.a</filename> né come file <filename>*.la</filename>)

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Shared libraries are mainly used to share common codes among multiple executables with the <command>ld</command> mechanism.
it: Le librerie condivise sono utilizzate principalmente per condividere codice tra più eseguibili, utilizzando il sistema <command>ld</command>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Shared libraries are sometimes used to provide multiple plugins to an executable with the <command>dlopen</command> mechanism.
it: Le librerie condivise sono a volte utilizzate per fornire plugin a più di un file eseguibile con il sistema <command>dlopen</command>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Shared libraries export <ulink url="&symbol;">symbols</ulink>, which represent compiled objects such as variables, functions, and classes; and enable access to them from the linked executables.
it: Le librerie condivise esportano i <ulink url="&symbol;">symbols</ulink> che rappresentano gli oggetti compilati, come le variabili, le funzioni e le classi; e consentono l'accesso ad essi dagli eseguibili collegati.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para><footnote><para>
en: Alternatively: <literal>readelf -d lib<replaceable>foo</replaceable>.so.<replaceable>1</replaceable> | grep SONAME</literal>
it: In alternativa: <literal>readelf -d lib<replaceable>foo</replaceable>.so.<replaceable>1</replaceable> | grep SONAME</literal>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: The <ulink url="&soname;">SONAME</ulink> of a shared library <filename>lib<replaceable>foo</replaceable>.so</filename>.<replaceable>1</replaceable>: <literal>objdump -p lib<replaceable>foo</replaceable>.so.<replaceable>1</replaceable> | grep SONAME</literal> <placeholder type="footnote" id="0"/>
it: Il <ulink url="&soname;">SONAME</ulink> di una libreria condivisa <filename>lib<replaceable>foo</replaceable>.so</filename>.<replaceable>1</replaceable>: <literal>objdump -p lib<replaceable>foo</replaceable>.so.<replaceable>1</replaceable> | grep SONAME</literal> <placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: The SONAME of a shared library usually matches the library file name (but not always).
it: Il SONAME di una libreria condivisa di solito corrisponde al nome del file della libreria (ma non sempre).

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para><footnote><para>
en: Alternatively: <literal>readelf -d lib<replaceable>foo</replaceable>.so.<replaceable>1</replaceable> | grep NEEDED</literal>
it: In alternativa: <literal>readelf -d lib<replaceable>foo</replaceable>.so.<replaceable>1</replaceable> | grep NEEDED</literal>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: The SONAME of shared libraries linked to <filename><replaceable>/usr/bin/foo</replaceable></filename>: <literal>objdump -p <replaceable>/usr/bin/foo</replaceable> | grep NEEDED</literal> <placeholder type="footnote" id="0"/>
it: Il SONAME delle librerie condivise collegate a <filename><replaceable>/usr/bin/foo</replaceable></filename>: <literal>objdump -p <replaceable>/usr/bin/foo</replaceable> | grep NEEDED</literal> <placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para><footnote><para>
en: See <ulink url="&policy-runtime;">Debian Policy Manual, 8.1 "Run-time shared libraries"</ulink>.
it: See <ulink url="&policy-runtime;">Manuale delle policy di Debian, 8.1 "Run-time shared libraries"</ulink>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <systemitem role="package">lib<replaceable>foo</replaceable><replaceable>1</replaceable></systemitem>: the library package for the shared library <filename>lib<replaceable>foo</replaceable>.so.<replaceable>1</replaceable></filename> with the SONAME ABI version <replaceable>1</replaceable>.<placeholder type="footnote" id="0"/>
it: <systemitem role="package">lib<replaceable>foo</replaceable><replaceable>1</replaceable></systemitem>: il pacchetto libreria per la libreria condivisa <filename>lib<replaceable>foo</replaceable>.so.<replaceable>1</replaceable></filename> con la versione SONAME ABI <replaceable>1</replaceable>.<placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para><footnote><para>
en: See <ulink url="&policy-ldconfig;">Debian Policy Manual, 8.1.1 "ldconfig"</ulink>.
it: See <ulink url="&policy-ldconfig;">Manuale delle policy di Debian, 8.1.1 "ldconfig"</ulink>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: The package maintainer scripts of the library package must call <command>ldconfig</command> under the specific circumstances to create the necessary symbolic links for the SONAME.<placeholder type="footnote" id="0"/>
it: Gli script dei maintainer riguardanti i pacchetti libreria devono richiamare <command>ldconfig</command> in circostanze specifiche per creare i necessari collegamenti simbolici per SONAME.<placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <systemitem role="package">lib<replaceable>foo</replaceable><replaceable>1</replaceable>-dbg</systemitem>: the debugging symbols package that contains the debugging symbols for the shared library package <systemitem role="package">lib<replaceable>foo</replaceable><replaceable>1</replaceable></systemitem>.
it: <systemitem role="package">lib<replaceable>foo</replaceable><replaceable>1</replaceable>-dbg</systemitem>: i pacchetti di simboli di debugging che contengono i simboli di debugging per il pacchetto della libreria condivisa <systemitem role="package">lib<replaceable>foo</replaceable><replaceable>1</replaceable></systemitem>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para><footnote><para>
en: See <ulink url="&policy-static;">Debian Policy Manual, 8.3 "Static libraries"</ulink> and <ulink url="&policy-dev;">Debian Policy Manual, 8.4 "Development files"</ulink>.
it: See <ulink url="&policy-static;">Manuale delle policy di Debian, 8.3 "Static libraries"</ulink> e <ulink url="&policy-dev;">Manuale delle policy di Debian, 8.4 "Development files"</ulink>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <systemitem role="package">lib<replaceable>foo</replaceable>-dev</systemitem>: the development package that contains the header files etc. for the shared library <filename>lib<replaceable>foo</replaceable>.so.<replaceable>1</replaceable></filename>.<placeholder type="footnote" id="0"/>
it: <systemitem role="package">lib<replaceable>foo</replaceable>-dev</systemitem>: il pacchetto di sviluppo che contiene i file header etc, per la libreria condivisa <filename>lib<replaceable>foo</replaceable>.so.<replaceable>1</replaceable></filename>.<placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para><footnote><para>
en: See <ulink url="&removela;">Debian wiki ReleaseGoals/LAFileRemoval</ulink>.
it: Si veda <ulink url="&removela;">Debian wiki ReleaseGoals/LAFileRemoval</ulink>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Debian packages should not contain <filename>*.la</filename> Libtool archive files in general.<placeholder type="footnote" id="0"/>
it: Un pacchetto Debian, di norma, non deve contenere file di archivi Libtool <filename>*.la</filename>.<placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para><footnote><para>
en: See <ulink url="&rpathissues;">Debian wiki RpathIssue</ulink>.
it: Si veda <ulink url="&rpathissues;">Debian wiki RpathIssue</ulink>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Debian packages should not use RPATH in general.<placeholder type="footnote" id="0"/>
it: Un pacchetto Debian, di norma, non deve usare RPATH.<placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Although it is somewhat outdated and is only a secondary reference, <ulink url="&debianlibrarypackagingguide;">Debian Library Packaging Guide</ulink> may still be useful.
it: Anche se un po' datato, ed è solo un riferimento secondario, <ulink url="&debianlibrarypackagingguide;">Debian Library Packaging Guide</ulink> può ancora essere utile.

note: type: Content of: <book><appendix><section><title>
en: Managing <filename>debian/<replaceable>package</replaceable>.symbols</filename>
it: Gestire <filename>debian/<replaceable>package</replaceable>.symbols</filename>

note: type: Content of: <book><appendix><section><para><footnote><para>
en: Backward-incompatible ABI changes normally require you to update the SONAME of the library and the shared library package name to new ones.
it: Le modifiche ABI incompatibili con le versioni precedenti, normalmente rendono necessario aggiornare il SONAME della libreria e il nome del pacchetto della libreria condivisa a quelli nuovi.

note: type: Content of: <book><appendix><section><para>
en: When you package a shared library, you should create a <filename>debian/<replaceable>package</replaceable>.symbols</filename> file to manage the minimal version associated with each symbol for backward-compatible ABI changes under the same SONAME of the library for the same shared library package name.<placeholder type="footnote" id="0"/> You should read the following primary references in detail:
it: Quando si pacchettizza una libreria condivisa, si deve creare il file <filename>debian/<replaceable>package</replaceable>.symbols</filename> per gestire la versione minima associata ad ogni simbolo per le modifiche ABI compatibili con le versioni precedenti, utilizzando lo stesso SONAME della libreria per lo stesso nome del pacchetto della libreria condivisa.<placeholder type="footnote" id="0"/> Si dovrebbero leggere, con attenzione, i seguenti riferimenti:

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para><footnote><para>
en: For C++ libraries and other cases where tracking individual symbols is too difficult, follow <ulink url="&policy-library-shlibs;">Debian Policy Manual, 8.6.4 "The shlibs system"</ulink>, instead.
it: Per le librerie C++ e per gli altri casi in cui il tracciamento dei singoli simboli è troppo difficile, si consulti invece <ulink url="&policy-library-shlibs;">Manuale delle policy di Debian, 8.6.4 "The shlibs system"</ulink>, instead.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <ulink url="&policy-library-symbols;">Debian Policy Manual, 8.6.3 "The symbols system"</ulink><placeholder type="footnote" id="0"/>
it: <ulink url="&policy-library-symbols;">Manuale delle policy di Debian, 8.6.3 "The symbols system"</ulink><placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><para>
en: Here is a rough example of how to create the <systemitem role="package">libfoo1</systemitem> package from the upstream version <literal>1.3</literal> with the proper <filename>debian/libfoo1.symbols</filename> file:
it: Di seguito un esempio di massima, per creare il pacchetto <systemitem role="package">libfoo1</systemitem> alla versione originale (upstream) <literal>1.3</literal> con il file <filename>debian/libfoo1.symbols</filename> corretto:

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Prepare the skeleton debianized source tree using the upstream <filename>libfoo-1.3.tar.gz</filename> file.
it: Preparare lo scheletro dell'albero del sorgente debianizzato utilizzando il file originale <filename>libfoo-1.3.tar.gz</filename>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: If this is the first packaging of the <systemitem role="package">libfoo1</systemitem> package, create the <filename>debian/libfoo1.symbols</filename> file with empty content.
it: Se è il primo pacchetto per <systemitem role="package">libfoo1</systemitem>, bisogna creare il file vuoto <filename>debian/libfoo1.symbols</filename>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: If the previous upstream version <literal>1.2</literal> was packaged as the <systemitem role="package">libfoo1</systemitem> package with the proper <filename>debian/libfoo1.symbols</filename> in its source package, use it again.
it: Se la versione originale (upstream) precedente <literal>1.2</literal> è stata pacchettizzata come <systemitem role="package">libfoo1</systemitem> con il file <filename>debian/libfoo1.symbols</filename> nei propri sorgenti del pacchetto, lo si utilizzi.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para><footnote><para>
en: All previous versions of Debian packages are available at <ulink url="&snapshot;">http://snapshot.debian.org/</ulink>.  The Debian revision is dropped from the version to make it easier to backport the package: <literal>1.1</literal> &lt;&lt; <literal>1.1-1~bpo70+1</literal> &lt;&lt; <literal>1.1-1</literal> and <literal>1.2</literal> &lt;&lt; <literal>1.2-1~bpo70+1</literal> &lt;&lt; <literal>1.2-1</literal>
it: Tutte la versioni precedenti del pacchetto Debian packages sono disponibili su <ulink url="&snapshot;">http://snapshot.debian.org/</ulink>.  La revisione Debian viene eliminata dalla versione per rendere più facile il backport del pacchetto: <literal>1.1</literal> &lt;&lt; <literal>1.1-1~bpo70+1</literal> &lt;&lt; <literal>1.1-1</literal> and <literal>1.2</literal> &lt;&lt; <literal>1.2-1~bpo70+1</literal> &lt;&lt; <literal>1.2-1</literal>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: If the previous upstream version <literal>1.2</literal> was not packaged with <filename>debian/libfoo1.symbols</filename>, create it as the <filename>symbols</filename> file from all available binary packages of the same shared library package name containing the same SONAME of the library, for example, versions <literal>1.1-1</literal> and <literal>1.2-1</literal>.  <placeholder type="footnote" id="0"/>
it: Se la versione originale (upstream) precedente <literal>1.2</literal> non è stata pacchettizzata con il file <filename>debian/libfoo1.symbols</filename>, è necessario creare il file <filename>symbols</filename> per tutti i pacchetti binari disponibili con lo stesso nome del pacchetto della libreria condivisa che contiene lo stesso SONAME della libreria, ad esempio, le versioni <literal>1.1-1</literal> e <literal>1.2-1</literal>.  <placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Make trial builds of the source tree with tools such as <command>debuild</command> and <command>pdebuild</command>.  (If this fails due to missing symbols etc., there were some backward-incompatible ABI changes that require you to bump the shared library package name to something like <systemitem role="package">libfoo1a</systemitem> and you should start over again.)
it: È possibile provare a costruire l'albero dei sorgenti utilizzando dei programmi come <command>debuild</command> e <command>pdebuild</command>.  (Se questo non riesce a causa della mancanza di simboli, ecc, ci sono stati dei cambiamenti ABI incompatibili con le versioni precedenti, che richiedono di cambiare il nome del pacchetto della libreria condivisa a qualcosa di simile <systemitem role="package">libfoo1a</systemitem> e si dovrebbe ricominciare di nuovo da capo.)

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para><footnote><para>
en: The Debian revision is dropped from the version to make it easier to backport the package: <literal>1.3</literal> &lt;&lt; <literal>1.3-1~bpo70+1</literal> &lt;&lt; <literal>1.3-1</literal>
it: La revisione Debian viene eliminata dalla versione per rendere più facile il backport del pacchetto: <literal>1.3</literal> &lt;&lt; <literal>1.3-1~bpo70+1</literal> &lt;&lt; <literal>1.3-1</literal>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: If you see the diff printed by the <command>dpkg-gensymbols</command> as above, extract the proper updated <filename>symbols</filename> file from the generated binary package of the shared library.  <placeholder type="footnote" id="0"/>
it: Se si vede il diff stampato da <command>dpkg-gensymbols</command> qui sopra, bisogna estrarre i file <filename>symbols</filename> aggiornati correttamente dal pacchetto binario generato dalla libreria condivisa.  <placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Build release packages with tools such as <command>debuild</command> and <command>pdebuild</command>.
it: Costruire la release dei pacchetti con programmi come <command>debuild</command> e <command>pdebuild</command>.

note: type: Content of: <book><appendix><section><para><footnote><para>
en: See <ulink url="&policy-library-abi;">Debian Policy Manual, 8.6.2 "Shared library ABI changes"</ulink>.
it: Si veda <ulink url="&policy-library-abi;">Manuale delle policy di Debian, 8.6.2 "Shared library ABI changes"</ulink>.

note: type: Content of: <book><appendix><section><para>
en: In addition to the above examples, we need to check the ABI compatibility further and bump versions for some symbols manually as needed.  <placeholder type="footnote" id="0"/>
it: In aggiunta agli esempi sopra riportati, è necessario controllare ulteriormente la compatibilità ABI e cambiare le versioni di qualche simbolo manualmente come richiesto.  <placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><para>
en: Although it is only a secondary reference, <ulink url="&usingsymbolsfiles;">Debian wiki UsingSymbolsFiles</ulink> and its linked web pages may be useful.
it: Anche se è solo un riferimento secondario,, <ulink url="&usingsymbolsfiles;">Debian wiki UsingSymbolsFiles</ulink> e i suoi collegamenti possono essere utili.

note: type: Content of: <book><appendix><section><para>
en: The multiarch feature introduced to Debian wheezy integrates support for cross-architecture installation of binary packages (particularly <literal>i386</literal>&lt;-&gt;<literal>amd64</literal>, but also other combinations) in <systemitem role="package">dpkg</systemitem> and <systemitem role="package">apt</systemitem>. You should read the following references in detail:
it: La funzionalità multiarch introdotta in Debian wheezy integra il supporto per l'installazione dei pacchetti binari cross-architettura (in particolare <literal>i386</literal>&lt;-&gt;<literal>amd64</literal>, ma anche altre combinazioni) in <systemitem role="package">dpkg</systemitem> e <systemitem role="package">apt</systemitem>. Si consiglia di leggere attentamente i seguenti riferimenti:

note: type: Content of: <book><appendix><section><para><footnote><para>
en: Old special purpose library paths such as <filename>/lib32/</filename> and <filename>/lib64/</filename> are not used anymore.
it: Vecchi percorsi di libreria, per scopi speciali, come <filename>/lib32/</filename> and <filename>/lib64/</filename> non sono più utilizzati.

note: type: Content of: <book><appendix><section><para>
en: It uses the triplet such as <literal>i386-linux-gnu</literal> and <literal>x86_64-linux-gnu</literal> for the install path of shared libraries. The actual triplet path is dynamically set into the <literal>$(DEB_HOST_MULTIARCH)</literal> variable using the <citerefentry> <refentrytitle>dpkg-architecture</refentrytitle><manvolnum>1</manvolnum></citerefentry> command for each binary package build. For example, the path to install multiarch libraries are changed as follows:<placeholder type="footnote" id="0"/>
it: Esso utilizza la tripletta come <literal>i386-linux-gnu</literal> e <literal>x86_64-linux-gnu</literal> per il percorso d'installazione delle librerie condivise. La tripletta del percorso reale è impostata con il valore dinamico <literal>$(DEB_HOST_MULTIARCH)</literal> da <citerefentry> <refentrytitle>dpkg-architecture</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> per ogni costruzione.  Ad esempio, il percorso per installare le librerie multiarch viene modificato come segue.<placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><informaltable><tgroup><thead><row><entry>
en: Old path
it: Vecchio percorso

note: type: Content of: <book><appendix><section><informaltable><tgroup><thead><row><entry>
en: i386 multiarch path
it: percorso i386 multiarch

note: type: Content of: <book><appendix><section><informaltable><tgroup><thead><row><entry>
en: amd64 multiarch path
it: percorso amd64 multiarch

note: type: Content of: <book><appendix><section><para>
en: Here are some typical multiarch package split scenario examples for the following:
it: Qui di seguito alcuni esempi tipici di pacchetti multiarch divisi per scenario:

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: a library source <filename>lib<replaceable>foo</replaceable>-1.tar.gz</filename>
it: sorgente di libreria <filename>lib<replaceable>foo</replaceable>-1.tar.gz</filename>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: a tool source <filename><replaceable>bar</replaceable>-1.tar.gz</filename> written in a compiled language
it: sorgente di programma <filename><replaceable>bar</replaceable>-1.tar.gz</filename> scritto con un linguaggio compilato

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: a tool source <filename><replaceable>baz</replaceable>-1.tar.gz</filename> written in an interpreted language
it: sorgente di programma <filename><replaceable>baz</replaceable>-1.tar.gz</filename> scritto con un linguaggio interpretato

note: type: Content of: <book><appendix><section><informaltable><tgroup><thead><row><entry>
en: Package
it: Pacchetto

note: type: Content of: <book><appendix><section><informaltable><tgroup><thead><row><entry>
en: Architecture:
it: Architettura:

note: type: Content of: <book><appendix><section><informaltable><tgroup><thead><row><entry>
en: Package content
it: Contenuto del pacchetto

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: any
it: qualsiasi

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: same
it: uguale

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the shared library, co-installable
it: la libreria condivisa, co-installabile

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the shared library debug symbols, co-installable
it: i simboli di debug della libreira condivisa, co-installabile

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the shared library header files etc., co-installable
it: i file di header, ecc, della libreira condivisa, co-installabile

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: foreign
it: straniero

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the run-time support programs, not co-installable
it: il programma di supporto run-time, non co-installabile

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: all
it: tutti

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the shared library documentation files
it: i file di documentazione della libreria condivisa

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the compiled program files, not co-installable
it: i file del programma compilato, non co-installabile

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the documentation files for the program
it: i file di documentazione del programma

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the interpreted program files
it: i file del programma interpretato

note: type: Content of: <book><appendix><section><para>
en: Please note that the development package should contain a symlink for the associated shared library <emphasis role="strong">without a version number</emphasis>.  E.g.: <filename>/usr/lib/x86_64-linux-gnu/libfoo.so</filename> -&gt; <filename>libfoo.so.1</filename>
it: Si prega di notare che il pacchetto di sviluppo dovrebbe contenere un link simbolico per la libreria condivisa associata <emphasis role="strong">senza un numero di versione</emphasis>.  Ad es.: <filename>/usr/lib/x86_64-linux-gnu/libfoo.so</filename> -&gt; <filename>libfoo.so.1</filename>

note: type: Content of: <book><appendix><section><title>
en: Building a shared library package
it: Costruzione del pacchetto della libreria condivisa

note: type: Content of: <book><appendix><section><para>
en: You can build a Debian library package enabling multiarch support using <citerefentry> <refentrytitle>dh</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> as follows:
it: Si può costruire il pacchetto Debian delle libreria, abilitando il supporto multiarch utilizzando <citerefentry> <refentrytitle>dh</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> come di seguito:

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Update <filename>debian/control</filename>.
it: Aggiornare <filename>debian/control</filename>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Add <literal>Build-Depends: debhelper (>=10)</literal> for the source package section.
it: Aggiungere <literal>Build-Depends: debhelper (>=10)</literal> per la sezione del sorgente del pacchetto.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Add <literal>Pre-Depends: ${misc:Pre-Depends}</literal> for each shared library binary package.
it: Aggiungere <literal>Pre-Depends: ${misc:Pre-Depends}</literal> per ogni pacchetto binario di una libreria condivisa.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Add <literal>Multi-Arch:</literal> stanza for each binary package section.
it: Aggiungere <literal>Multi-Arch:</literal> per ogni sezione del pacchetto binario.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Set <filename>debian/compat</filename> to "10".
it: Impostare <filename>debian/compat</filename> a "10".

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Adjust the path from the normal <literal>/usr/lib/</literal> to the multiarch <literal>/usr/lib/$(DEB_HOST_MULTIARCH)/</literal> for all packaging scripts.
it: Regolare il percorso dal normale <literal>/usr/lib/</literal> a quello multiarch <literal>/usr/lib/$(DEB_HOST_MULTIARCH)/</literal> per tutti gli script di pacchettizzazione.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Call <literal>DEB_HOST_MULTIARCH ?= $(shell dpkg-architecture -qDEB_HOST_MULTIARCH)</literal> in <filename>debian/rules</filename> to set the <literal>DEB_HOST_MULTIARCH</literal> variable first.
it: Invocare <literal>DEB_HOST_MULTIARCH ?= $(shell dpkg-architecture -qDEB_HOST_MULTIARCH)</literal> nel file <filename>debian/rules</filename> per impostare la variabile <literal>DEB_HOST_MULTIARCH</literal>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Replace <literal>/usr/lib/</literal> with <literal>/usr/lib/$(DEB_HOST_MULTIARCH)/</literal> in <filename>debian/rules</filename>.
it: Sostituire <literal>/usr/lib/</literal> con <literal>/usr/lib/$(DEB_HOST_MULTIARCH)/</literal> nel file <filename>debian/rules</filename>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para><footnote><para>
en: Alternatively, you can add <literal>--libdir=\$${prefix}/lib/$(DEB_HOST_MULTIARCH)</literal> and <literal>--libexecdir=\$${prefix}/lib/$(DEB_HOST_MULTIARCH)</literal> arguments to <literal>./configure</literal>.  Please note that <literal>--libexecdir</literal> specifies the default path to install executable programs run by other programs rather than by users.  Its Autotools default is <filename>/usr/libexec/</filename> but its Debian default is <filename>/usr/lib/</filename>.
it: In alternativa, si possono aggiungere gli argomenti <literal>--libdir=\$${prefix}/lib/$(DEB_HOST_MULTIARCH)</literal> e <literal>--libexecdir=\$${prefix}/lib/$(DEB_HOST_MULTIARCH)</literal> a <literal>./configure</literal>.  Si noti che <literal>--libexecdir</literal> indica il percorso predefinito d'installazione dei programmi eseguibili gestiti da altri programmi e non dagli utenti.  Il percorso predefinito di Autotools è <filename>/usr/libexec/</filename> mentre quello di Debian è <filename>/usr/lib/</filename>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: If <literal>./configure</literal> is used in part of the <literal>override_dh_auto_configure</literal> target in <filename>debian/rules</filename>, make sure to replace it with <literal>dh_auto_configure -- </literal>.  <placeholder type="footnote" id="0"/>
it: Se <literal>./configure</literal> viene utilizzato nella parte target di <literal>override_dh_auto_configure</literal> in <filename>debian/rules</filename>, ci si assicuri di sostituirlo con <literal>dh_auto_configure -- </literal>.  <placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Replace all occurrences of <literal>/usr/lib/</literal> with <literal>/usr/lib/*/</literal> in <filename>debian/<replaceable>foo</replaceable>.install</filename> files.
it: Sostituire tutte le occorrenze di <literal>/usr/lib/</literal> con <literal>/usr/lib/*/</literal> nei file <filename>debian/<replaceable>foo</replaceable>.install</filename>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Generate files like <filename>debian/<replaceable>foo</replaceable>.links</filename> from <filename>debian/<replaceable>foo</replaceable>.links.in</filename> dynamically by adding a script to the <literal>override_dh_auto_configure</literal> target in <filename>debian/rules</filename>.
it: Genera dinamicamente dei file come <filename>debian/<replaceable>foo</replaceable>.links</filename> da <filename>debian/<replaceable>foo</replaceable>.links.in</filename> aggiungendo un script al target di <literal>override_dh_auto_configure</literal> in <filename>debian/rules</filename>.

note: type: Content of: <book><appendix><section><para>
en: Please make sure to verify that the shared library package contains only the expected files, and that your -dev package still works.
it: Ci si assicuri di verificare che il pacchetto di libreria condivisa contenga solo i file attesi, e che il pacchetto -dev continui a funzionare.

note: type: Content of: <book><appendix><section><para>
en: All files installed simultaneously as the multiarch package to the same file path should have exactly the same file content.  You must be careful of differences generated by the data byte order and by the compression algorithm.
it: Tutti i file installati contemporaneamente come pacchetto multiarch con lo stesso percorso del file devono avere esattamente lo stesso contenuto. È necessario prestare attenzione alle differenze generate dall'ordine dei byte nei dati e dall'algoritmo di compressione.

note: type: Content of: <book><appendix><section><title>
en: Native Debian package
it: Pacchetto nativo Debian

note: type: Content of: <book><appendix><section><para>
en: If a package is maintained only for Debian or possibly only for local use, its source may contain all the <filename>debian/*</filename> files in it.  There are 2 ways to package it.
it: Se il pacchetto è mantenuto solo per Debian o per uso locale, il suo sorgente potrebbe contenere tutti i file in <filename>debian/*</filename>.  In questo caso, ci sono 2 modi per pacchettizzarlo.

note: type: Content of: <book><appendix><section><para>
en: You can make the upstream tarball by excluding the <filename>debian/*</filename> files and package it as a non-native Debian package as in <xref linkend="workflow"/>.  This is the normal way, which some people encourage using.
it: È possibile creare l'archivio originale escludendo i file in <filename>debian/*</filename> e pacchettizandolo come pacchetto Debian non nativo, come descritto in <xref linkend="workflow"/>.  Questo è il metodo normale che alcune persone incoraggiano ad utilizzare.

note: type: Content of: <book><appendix><section><para>
en: The alternative is the workflow of the native Debian package.
it: L'alternativa è utilizzare lo stesso metodo usato dai pacchetti Debian nativi.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Create a native Debian source package in the <literal>3.0 (native)</literal> format using a single compressed tar file in which all files are included.
it: Creare un pacchetto sorgente nativo di Debian nel formato <literal>3.0 (native)</literal> usando un singolo file tar compresso che include tutti i file.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><literal>
en: <replaceable>package</replaceable>_<replaceable>version</replaceable>.tar.gz
it: <replaceable>pacchetto</replaceable>_<replaceable>versione</replaceable>.tar.gz

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><literal>
en: <replaceable>package</replaceable>_<replaceable>version</replaceable>.dsc
it: <replaceable>pacchetto</replaceable>_<replaceable>versione</replaceable>.dsc

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Build Debian binary packages from the native Debian source package.
it: Costruire pacchetti binari Debian dal pacchetto sorgente nativo di Debian.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><literal>
en: <replaceable>package</replaceable>_<replaceable>version</replaceable>_<replaceable>arch</replaceable>.deb
it: <replaceable>pacchetto</replaceable>_<replaceable>versione</replaceable>_<replaceable>arch</replaceable>.deb

note: type: Content of: <book><appendix><section><para>
en: For example, if you have source files in <filename>~/mypackage-1.0</filename> without the <filename>debian/*</filename> files, you can create a native Debian package by issuing the <command>dh_make</command> command as follows:
it: Per esempio, se si hanno i file sorgenti in <filename>~/mypackage-1.0</filename> senza i file <filename>debian/*</filename>, si può creare un pacchetto nativo Debian, utilizzando il comando <command>dh_make</command> come segue:

note: type: Content of: <book><appendix><section><para>
en: Then the <filename>debian</filename> directory and its contents are created just like in <xref linkend="non-native-dh-make"/>.  This does not create a tarball, since this is a native Debian package.  But that is the only difference.  The rest of the packaging activities are practically the same.
it: La directory <filename>debian</filename> e il suo contenuto, sono creati proprio come <xref linkend="non-native-dh-make"/>.  Questo non crea un archivio poiché si tratta di un pacchetto Debian nativo.  Questa è l'unica differenza.  Il resto delle attività di pacchettizzazione sono praticamente le stesse.

note: type: Content of: <book><appendix><section><para>
en: After execution of the <command>dpkg-buildpackage</command> command, you will see the following files in the parent directory:
it: Dopo l'esecuzione del comando <command>dpkg-buildpackage</command>, si possono vedere i seguenti file nella directory principale:

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: This is the source code tarball created from the <filename>mypackage-1.0</filename> directory by the <command>dpkg-source</command> command.  (Its suffix is not <filename>orig.tar.gz</filename>.)
it: Questo è l'archivio del codice sorgente creato dalla directory <filename>mypackage-1.0</filename> dal comando <command>dpkg-source</command>. (Il suffisso non è <filename>orig.tar.gz</filename>.)

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: This is a summary of the contents of the source code, as in the non-native Debian package. (There is no Debian revision.)
it: Questo è un sommario del contenuto del codice sorgente, come per i pacchetti non-nativi Debian. (non c'è revisione Debian.)

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: This is your completed binary package, as in the non-native Debian package.  (There is no Debian revision.)
it: Questo è il pacchetto binario completo, come per i pacchetti non-nativi Debian. (non c'è revisione Debian.)

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: This file describes all the changes made in the current package version as in the non-native Debian package. (There is no Debian revision.)
it: Questo file descrive tutte le modifiche apportate nella versione attuale del pacchetto, come per i pacchetti Debian non-nativi. (non c'è revisione Debian.)
