developers-reference - en to it translation catalogue (204 entries)

en: Best Packaging Practices
it: Buone pratiche per la pacchettizzazione

en: This chapter provides some best practices for Debian developers. All recommendations are merely that, and are not requirements or policy. These are just some subjective hints, advice and pointers collected from Debian developers. Feel free to pick and choose whatever works best for you.
it: Questo capitolo fornisce alcune buone pratiche per gli sviluppatori Debian. Tutte le raccomandazioni sono solo tali, e non sono requisiti o policy. Questi sono solo alcuni spunti soggettivi, i consigli e i punti raccolti da sviluppatori Debian. Ci si senta liberi di scegliere quello che funziona meglio.

en: Best practices for ``debian/rules``
it: Buone pratiche per ``debian/rules``

en: Helper scripts
it: Script di supporto

en: The rationale for using helper scripts in ``debian/rules`` is that they let maintainers use and share common logic among many packages. Take for instance the question of installing menu entries: you need to put the file into ``/usr/share/menu`` (or ``/usr/lib/menu`` for executable binary menufiles, if this is needed), and add commands to the maintainer scripts to register and unregister the menu entries. Since this is a very common thing for packages to do, why should each maintainer rewrite all this on their own, sometimes with bugs? Also, supposing the menu directory changed, every package would have to be changed.
it: L'idea nell'utilizzo degli script di aiuto in ``debian/rules`` è che essi hanno consentito ai maintainer di usare e condividere la logica comune tra molti pacchetti. Si prenda per esempio la questione dell'installazione delle voci di menu: è necessario mettere il file in ``/usr/share/menu`` (o ``/usr/lib/menu`` per gli eseguibili binari dei menufile, se questo è necessario), e aggiungere i comandi agli script del maintainer per registrare ed annullare la registrazione delle voci di menu. Dal momento che questa è una cosa molto comune da fare con i pacchetti, perché ogni maintainer dovrebbe riscrivere tutto questo da solo, a volte con bug? Inoltre, supponendo che la cartella menu cambi, ogni pacchetto dovrebbe essere cambiato.

en: Helper scripts take care of these issues. Assuming you comply with the conventions expected by the helper script, the helper takes care of all the details. Changes in policy can be made in the helper script; then packages just need to be rebuilt with the new version of the helper and no other changes.
it: Gli script di supporto si occupano di questi problemi. Supponendo che ci si attenga alle convenzioni previste dallo script di supporto, quest'ultimo si prende cura di tutti i dettagli. Cambiamenti nella policy possono essere effettuati nello script helper; successivamente i pacchetti avranno solo bisogno di essere ricompilati con la nuova versione dell'helper e nessuna ulteriore modifica.

en: :ref:`tools` contains a couple of different helpers. The most common and best (in our opinion) helper system is ``debhelper``. Previous helper systems, such as ``debmake``, were monolithic: you couldn't pick and choose which part of the helper you found useful, but had to use the helper to do everything. ``debhelper``, however, is a number of separate little ``dh_*`` programs. For instance, ``dh_installman`` installs and compresses man pages, ``dh_installmenu`` installs menu files, and so on. Thus, it offers enough flexibility to be able to use the little helper scripts, where useful, in conjunction with hand-crafted commands in ``debian/rules``.
it: :ref:`tools` contiene un paio di diversi script di supporto. Il sistema di supporto più comune e migliore (a nostro parere) è ``debhelper``. I sistemi di supporto precedenti, come ``debmake``, erano monolitici: non si poteva scegliere quale parte dell'helper si riteneva utile, ma si doveva usare l'helper per fare tutto. ``debhelper``, invece, è una serie di programmi piccoli e separati ``dh_*``. Per esempio, ``dh_installman`` installa e comprime le pagine man, ``dh_installmenu`` installa i file di menu, e così via. Così, si offre sufficiente flessibilità per essere in grado di utilizzare i piccoli script di aiuto, dove utile, in abbinamento con i comandi manuali in ``debian/rules``.

en: Multiple binary packages
it: Pacchetti binari multipli

en: The second case can be easily managed in ``debian/rules``. You just need to move the appropriate files from the build directory into the package's temporary trees. You can do this using ``install`` or ``dh_install`` from ``debhelper``. Be sure to check the different permutations of the various packages, ensuring that you have the inter-package dependencies set right in ``debian/control``.
it: Il secondo caso può essere facilmente gestito in ``debian/rules``. Bisogna solo spostare i file appropriati dalla cartella di compilazione in alberi temporanei del pacchetto. È possibile farlo utilizzando ``install`` o ``dh_install`` da ``debhelper``. Ci si assicuri di controllare le diverse permutazioni dei vari pacchetti, assicurandosi di avere il corretto insieme di dipendenze tra pacchetti in ``debian/control``.

en: Best practices for ``debian/control``
it: Buone pratiche per ``debian/control``

en: The following practices are relevant to the ``debian/control`` file. They supplement the `Policy on package descriptions <https://www.debian.org/doc/debian-policy/ch-binary.html#s-descriptions>`__.
it: Le seguenti pratiche sono rilevanti per il file\ ``debian/control``. Esse integrano la `Policy sulla descrizione dei pacchetti <https://www.debian.org/doc/debian-policy/ch-binary.html#s-descriptions>`__.

en: The description of the package, as defined by the corresponding field in the ``control`` file, contains both the package synopsis and the long description for the package. :ref:`bpp-desc-basics` describes common guidelines for both parts of the package description. Following that, :ref:`bpp-pkg-synopsis` provides guidelines specific to the synopsis, and :ref:`bpp-pkg-desc` contains guidelines specific to the description.
it: La descrizione del pacchetto, come definito dal corrispondente campo nel file ``control``, contiene sia la sinossi del pacchetto sia la descrizione lunga del pacchetto. :ref:`bpp-desc-basics` descrive le linee guida comuni ad entrambe le parti della descrizione del pacchetto. In seguito, :ref:`bpp-pkg-synopsis` fornisce specifiche linee guida per la sinossi e :ref:`bpp-pkg-desc` contiene specifiche linee guida per la descrizione.

en: General guidelines for package descriptions
it: Linee guida generali per le descrizioni dei pacchetti

en: The package description should be written for the average likely user, the average person who will use and benefit from the package. For instance, development packages are for developers, and can be technical in their language. More general-purpose applications, such as editors, should be written for a less technical user.
it: La descrizione del pacchetto dovrebbe essere scritta probabilmente per l'utente medio, la persona media che utilizzerà ed avrà benefici dal pacchetto. Per esempio, pacchetti di sviluppo sono per gli sviluppatori e possono essere di natura tecnica nella loro linguaggio. Applicazioni più generiche, come gli editor, dovrebbero essere scritte per un utente meno tecnico.

en: Our review of package descriptions lead us to conclude that most package descriptions are technical, that is, are not written to make sense for non-technical users. Unless your package really is only for technical users, this is a problem.
it: La nostra analisi delle descrizioni dei pacchetti ci porta a concludere che la maggior parte delle descrizioni dei pacchetti sono di natura tecnica, cosi è, non sono scritte per avere senso per gli utenti non tecnici. A meno che il proprio pacchetto non sia realmente solo per utenti tecnici, questo costituisce un problema.

en: How do you write for non-technical users? Avoid jargon. Avoid referring to other applications or frameworks that the user might not be familiar with — GNOME or KDE is fine, since users are probably familiar with these terms, but GTK is probably not. Try not to assume any knowledge at all. If you must use technical terms, introduce them.
it: Come si scrive per gli utenti non tecnici? Si eviti il gergo. Evitare di riferirsi ad altre applicazioni o framework che l'utente potrebbe non conoscere - GNOME o KDE va bene, dal momento che gli utenti hanno probabilmente familiarità con questi termini, ma GTK probabilmente non lo è. Cercare di ipotizzare nessuna conoscenza a priori. Se è necessario utilizzare termini tecnici, spiegarli.

en: Be objective. Package descriptions are not the place for advocating your package, no matter how much you love it. Remember that the reader may not care about the same things you care about.
it: Si sia obiettivi. Le descrizioni dei pacchetti non sono il posto per promuovere il proprio pacchetto, non importa quanto lo si ami. Ricordare che il lettore potrebbe non essere interessato alle stesse cose che vi interessano.

en: References to the names of any other software packages, protocol names, standards, or specifications should use their canonical forms, if one exists. For example, use X Window System, X11, or X; not X Windows, X-Windows, or X Window. Use GTK, not GTK+ or gtk. Use GNOME, not Gnome. Use PostScript, not Postscript or postscript.
it: I riferimenti ai nomi di eventuali altri pacchetti software, nomi di protocollo, standard o specifiche dovrebbero utilizzare la forma canonica, se ne esiste una. Ad esempio, utilizzare X Window System, X11 o X, non X Windows, X-Windows o X Window. Utilizzare GTK, non GTK+ o gtk. Usare GNOME, non Gnome. Utilizzare PostScript, non Postscript o postscript.

en: If you are having problems writing your description, you may wish to send it along to ``debian-l10n-english@lists.debian.org`` and request feedback.
it: Se si hanno problemi di scrittura della descrizione, si potrebbe desiderare di inviarla all'indirizzo di posta elettronica ``debian-l10n-english@lists.debian.org`` richiedendo un parere.

en: The package synopsis, or short description
it: La sinossi del pacchetto, o una breve descrizione

en: Policy says the synopsis line (the short description) must be concise, not repeating the package name, but also informative.
it: La policy dice che la linea di sinossi (la breve descrizione) deve essere concisa ma anche informativa, non ripetendo il nome del pacchetto.

en: The synopsis functions as a phrase describing the package, not a complete sentence, so sentential punctuation is inappropriate: it does not need extra capital letters or a final period (full stop). It should also omit any initial indefinite or definite article — "a", "an", or "the". Thus for instance:
it: Le sinossi funziona come una frase che descrive il pacchetto, non una frase completa, perciò la punteggiatura è inappropriata: non ha bisogno di lettere maiuscole in più o un punto finale (punto). Dovrebbe anche omettere qualsiasi iniziale articolo indefinito o definito - «a», «un» o «il». Così, per esempio:

en: Technically this is a noun phrase minus articles, as opposed to a verb phrase. A good heuristic is that it should be possible to substitute the package *name* and *synopsis* into this formula:
it: Tecnicamente si tratta di un sintagma nominale senza articoli, al contrario di una frase verbale. Una buona euristica è che dovrebbe essere possibile sostituire il *nome* e la *sinossi* del pacchetto in questa formula:

en: The package *name* provides {a,an,the,some} *synopsis*.
it: Il pacchetto *name* fornisce {a, un, il, alcuni} *sinossi*.

en: Sets of related packages may use an alternative scheme that divides the synopsis into two parts, the first a description of the whole suite and the second a summary of the package's role within it:
it: Insiemi di pacchetti correlati possono utilizzare uno schema alternativo che divide la sinossi in due parti, la prima una descrizione di tutta la suite e la seconda una sintesi del ruolo del pacchetto all'interno di essa:

en: These synopses follow a modified formula. Where a package "*name*" has a synopsis "*suite* (*role*)" or "*suite* - *role*", the elements should be phrased so that they fit into the formula:
it: Queste sinossi seguono una formula modificata. Quando un pacchetto «\ *name*\ » ha una «\ *suite* di sinossi (*role*) » o «\ *suite* - *role*\ », gli elementi devono essere formulati in modo che si inseriscano nella formula:

en: The package *name* provides {a,an,the} *role* for the *suite*.
it: Il *name* del pacchetto fornisce {a, un, il} *role* per la *suite*.

en: The long description
it: La descrizione lunga

en: The long description is the primary information available to the user about a package before they install it. It should provide all the information needed to let the user decide whether to install the package. Assume that the user has already read the package synopsis.
it: La descrizione lunga è la principale informazione sul pacchetto disponibile agli utenti prima che lo si installi. Essa dovrebbe fornire tutte le informazioni necessarie per permettere all'utente di decidere se installare il pacchetto. Si supponga che l'utente abbia già letto la sinossi del pacchetto.

en: The long description should consist of full and complete sentences.
it: La descrizione lunga deve essere composta da frasi complete ed esaustive.

en: The first paragraph of the long description should answer the following questions: what does the package do? what task does it help the user accomplish? It is important to describe this in a non-technical way, unless of course the audience for the package is necessarily technical.
it: Il primo paragrafo della descrizione lunga deve rispondere alle seguenti domande: che cosa fa il pacchetto? in che modo aiuta l'utente ad assolvere ai suoi task? È importante descrivere ciò in maniera non tecnica, salvo ovviamente quando il pacchetto è destinato ad una utenza tecnica.

en: Be careful to avoid spelling and grammar mistakes. Ensure that you spell-check it. Both ``ispell`` and ``aspell`` have special modes for checking ``debian/control`` files:
it: Fare attenzione ad evitare errori di ortografia e di grammatica. Ci si assicuri di effettuare il controllo ortografico. Entrambi ``ispell`` e ``aspell`` hanno modalità speciali per il controllo del file ``debian/control``:

en: Users usually expect these questions to be answered in the package description:
it: Gli utenti di solito si aspettano che queste domande ricevano risposta nella descrizione del pacchetto:

en: What does the package do? If it is an add-on to another package, then the short description of the package we are an add-on to should be put in here.
it: Che cosa fa il pacchetto? Se si tratta di un componente aggiuntivo per un altro pacchetto, allora la breve descrizione del pacchetto per il quale è un componente aggiuntivo dovrebbe essere inserita qui.

en: Why should I want this package? This is related to the above, but not the same (this is a mail user agent; this is cool, fast, interfaces with PGP and LDAP and IMAP, has features X, Y, and Z).
it: Perché dovrei volere questo pacchetto? Questo è legato al precedente, ma non è lo stesso (questo è un client di posta elettronica; questo è eccezionale, veloce, si interfaccia con PGP e LDAP e IMAP, ha caratteristiche X, Y e Z).

en: If this package should not be installed directly, but is pulled in by another package, this should be mentioned.
it: Se il pacchetto non deve essere installato direttamente, ma è richiamato da un altro pacchetto, questo dovrebbe essere menzionato.

en: If the package is ``experimental``, or there are other reasons it should not be used, if there are other packages that should be used instead, it should be here as well.
it: Se il pacchetto è ``experimental``, o ci sono altri motivi per i quali non dovrebbe essere usato, se invece ci sono altri pacchetti che dovrebbero essere utilizzati, esso dovrebbe essere indicato.

en: Upstream home page
it: Home page originale del pacchetto

en: We recommend that you add the URL for the package's home page in the ``Homepage`` field of the ``Source`` section in ``debian/control``. Adding this information in the package description itself is considered deprecated.
it: Si consiglia di aggiungere l'URL per la home page del pacchetto nel campo ``Homepage`` della sezione ``Source`` in ``debian/control``. L'aggiunta di questa informazione nella descrizione del stesso pacchetto è considerata obsoleta.

en: Version Control System location
it: La posizione del Version Control System

en: There are additional fields for the location of the Version Control System in ``debian/control``.
it: Ci sono campi aggiuntivi per la posizione del Version Control System in ``debian/control``.

en: The information is meant to be useful for the final user, willing to browse the latest work done on the package (e.g. when looking for the patch fixing a bug tagged as ``pending`` in the bug tracking system).
it: L'informazione è destinata ad essere utile per l'utente finale, disposto a sfogliare l'ultimo lavoro svolto sul pacchetto (ad esempio quando si cerca la patch di un bug etichettato come ``pending`` nel sistema di bug tracking).

en: The information is meant to be useful for a user knowledgeable in the given Version Control System and willing to build the current version of a package from the VCS sources. Other uses of this information might include automatic building of the latest VCS version of the given package. To this end the location pointed to by the field should better be version agnostic and point to the main branch (for VCSs supporting such a concept). Also, the location pointed to should be accessible to the final user; fulfilling this requirement might imply pointing to an anonymous access of the repository instead of pointing to an SSH-accessible version of the same.
it: L'informazione è destinata ad essere utile per un utente esperto nel dato Version Control System e disposto a compilare la versione attuale del pacchetto dai sorgenti VCS. Altri usi di queste informazioni possono includere compilazioni automatiche della versione VCS più recente del dato pacchetto. A tal fine la posizione a cui punta il campo dovrebbe essere la versione migliore rispetto a quella agnostica e puntare al ramo principale (per i VCS che supportano tale concetto). Inoltre, la posizione indicata dovrebbe essere accessibile per l'utente finale; soddisfare questo requisito potrebbe implicare un accesso anonimo al repository invece di puntare a una versione SSH-accessibile dello stesso.

en: Best practices for ``debian/changelog``
it: Buone pratiche per il ``debian/changelog``

en: The following practices supplement the `Policy on changelog files <https://www.debian.org/doc/debian-policy/ch-docs.html#s-changelogs>`__.
it: Le seguenti pratiche integrano la `Policy sui file changelog <https://www.debian.org/doc/debian-policy/ch-docs.html#s-changelogs>`__.

en: Writing useful changelog entries
it: Scrivere informazioni utili nel file changelog

en: The changelog entry for a package revision documents changes in that revision, and only them. Concentrate on describing significant and user-visible changes that were made since the last version.
it: La voce del changelog inerente una revisione del pacchetto documenta i cambiamenti in quella specifica revisione e solo loro. Concentrarsi sulla descrizione di cambiamenti significativi e visibili all'utente che sono stati fatti dopo l'ultima versione.

en: Focus on *what* was changed — who, how and when are usually less important. Having said that, remember to politely attribute people who have provided notable help in making the package (e.g., those who have sent in patches).
it: Ci si concentri su *ciò* che è stato cambiato: chi, come e quando di solito sono meno importanti. Detto questo, ricordarsi di citare le persone che hanno fornito un notevole aiuto nel compilare il pacchetto (ad esempio, coloro che hanno inviato delle patch).

en: There's no need to elaborate the trivial and obvious changes. You can also aggregate several changes in one entry. On the other hand, don't be overly terse if you have undertaken a major change. Be especially clear if there are changes that affect the behaviour of the program. For further explanations, use the ``README.Debian`` file.
it: Non c'è bisogno di elaborare le modifiche banali e ovvie. È inoltre possibile aggregare diversi cambiamenti in un'unica voce. D'altra parte, non si sia troppo ermetici se si ha intrapreso un cambiamento importante. Si sia particolarmente chiari se ci sono cambiamenti che influenzano il comportamento del programma. Per ulteriori chiarimenti, utilizzare il ``README.Debian``.

en: Use common English so that the majority of readers can comprehend it. Avoid abbreviations, tech-speak and jargon when explaining changes that close bugs, especially for bugs filed by users that did not strike you as particularly technically savvy. Be polite, don't swear.
it: Si utilizzi l'inglese comune in modo che la maggior parte dei lettori possa comprenderlo. Si evitino abbreviazioni, termini tecnici e gergo quando si spiegano i cambiamenti che chiudono i bug, soprattutto per i bug segnalati dagli utenti che non sembrano particolarmente smaliziati dal punto di vista tecnico. Si sia gentili, non si imprechi.

en: It is sometimes desirable to prefix changelog entries with the names of the files that were changed. However, there's no need to explicitly list each and every last one of the changed files, especially if the change was small or repetitive. You may use wildcards.
it: A volte è desiderabile far precedere le voci del changelog con i nomi dei file che sono stati modificati. Tuttavia, non c'è bisogno di elencare esplicitamente uno per uno tutti i file modificati, soprattutto se il cambiamento è stato piccolo o ripetitivo. È possibile utilizzare i metacaratteri.

en: When referring to bugs, don't assume anything. Say what the problem was, how it was fixed, and append the closes: #nnnnn string. See :ref:`upload-bugfix` for more information.
it: Quando si parla di bug, non si dia per scontato nulla. Dire quale era il problema, come è stato risolto e aggiungere in fondo la stringa closes: #nnnnn. Per ulteriori informazioni, si consulti :ref:`upload-bugfix`.

en: Common misconceptions about changelog entries
it: Comuni incomprensioni sulle voci del changelog

en: The changelog entries should **not** document generic packaging issues (Hey, if you're looking for foo.conf, it's in /etc/blah/.), since administrators and users are supposed to be at least remotely acquainted with how such things are generally arranged on Debian systems. Do, however, mention if you change the location of a configuration file.
it: Le voci del changelog **non** dovrebbero documentare generici problemi di packaging (Ehi, se si è alla ricerca di foo.conf, è in /etc/blah/.), dal momento che si suppone che gli amministratori e gli utenti siano a conoscenza di come queste cose sono generalmente gestite sui sistemi Debian. Parlatene, tuttavia, se si modifica la posizione di un file di configurazione.

en: The only bugs closed with a changelog entry should be those that are actually fixed in the same package revision. Closing unrelated bugs in the changelog is bad practice. See :ref:`upload-bugfix`.
it: Gli unici bug chiusi con una voce nel changelog dovrebbero essere quelli che sono effettivamente chiusi nella stessa versione del pacchetto. Chiudere bug non correlati nel changelog è cattiva pratica. Si veda :ref:`upload-bugfix`.

en: The changelog entries should **not** be used for random discussion with bug reporters (I don't see segfaults when starting foo with option bar; send in more info), general statements on life, the universe and everything (sorry this upload took me so long, but I caught the flu), or pleas for help (the bug list on this package is huge, please lend me a hand). Such things usually won't be noticed by their target audience, but may annoy people who wish to read information about actual changes in the package. See :ref:`bug-answering` for more information on how to use the bug tracking system.
it: Le voci del changelog **non** dovrebbero essere utilizzate per discussioni casuali con chi ha segnalato il bug (non vedo segmentation fault quando avvio foo con l'opzione bar; invia più informazioni al riguardo), dichiarazioni generali sulla vita, l'universo e tutto il resto (scusate questo caricamento mi ha preso così tanto tempo, ma ho preso l'influenza), o richieste di aiuto (la lista di bug su questo pacchetto è enorme, vi prego di dare una mano). Queste cose di solito non vengono notate, ma possono infastidire le persone che desiderano leggere le informazioni sulle modifiche effettive nel pacchetto. Per ulteriori informazioni su come utilizzare il sistema di bug tracking vedere :ref:`bug-answering`.

en: It is an old tradition to acknowledge bugs fixed in non-maintainer uploads in the first changelog entry of the proper maintainer upload. As we have version tracking now, it is enough to keep the NMUed changelog entries and just mention this fact in your own changelog entry.
it: Si tratta di una vecchia tradizione per riconoscere bug corretti in un caricamento di un non-maintainer nella prima voce del changelog dell'appropriato maintainer. Siccome ora abbiamo il version tracking, è sufficiente mantenere le voci del changelog NMUed e citare questo fatto nella propria voce del changelog.

en: Common errors in changelog entries
it: Errori frequenti nelle voci del changelog

en: The following examples demonstrate some common errors or examples of bad style in changelog entries.
it: I seguenti esempi dimostrano alcuni errori comuni o di cattivo stile nelle voci del changelog.

en: This doesn't tell readers anything too useful, obviously.
it: Questo non dice ai lettori qualcosa di particolarmente utile, ovviamente.

en: What was the patch about?
it: Qual'era l'argomento della patch?

en: Overhaul which accomplished what? Is the mention of late night supposed to remind us that we shouldn't trust that code?
it: Revisione che ha completato cosa? L'ipotetica citazione notturna è lì a ricordarci che non dovremmo fidarci di quel codice?

en: First of all, there's absolutely no need to upload the package to convey this information; instead, use the bug tracking system. Secondly, there's no explanation as to why the report is not a bug.
it: Innanzitutto, non c'è assolutamente alcun bisogno di caricare il pacchetto per trasmettere queste informazioni; invece, utilizzare il sistema di bug tracking. In secondo luogo, non c'è alcuna spiegazione del perché il rapporto non è un bug.

en: Where's the description? If you can't think of a descriptive message, start by inserting the title of each different bug.
it: Dov'è la descrizione? Se non è possibile pensare ad un messaggio descrittivo, iniziare inserendo il titolo di ogni differente bug.

en: Supplementing changelogs with ``NEWS.Debian`` files
it: Integrare i changelog con i file ``NEWS.Debian``

en: Important news about changes in a package can also be put in ``NEWS.Debian`` files. The news will be displayed by tools like ``apt-listchanges``, before all the rest of the changelogs. This is the preferred means to let the user know about significant changes in a package. It is better than using ``debconf`` notes since it is less annoying and the user can go back and refer to the ``NEWS.Debian`` file after the install. And it's better than listing major changes in ``README.Debian``, since the user can easily miss such notes.
it: Importanti novità sui i cambiamenti in un pacchetto possono anche essere inserite nei file ``NEWS.Debian``. Le notizie saranno visualizzate da strumenti come ``apt-listchanges``, prima di tutto il resto dei changelog. Questo è il mezzo preferito per permettere all'utente di conoscere i cambiamenti significativi in ??un pacchetto. È meglio che usare le note di ``debconf`` in quanto è meno fastidioso e l'utente può tornare indietro e vedere il file ``NEWS.Debian`` dopo l'installazione. Ed è meglio rispetto all'elencare i principali cambiamenti presenti in ``README.Debian``, dal momento che l'utente può facilmente perderli.

en: The file format is the same as a debian changelog file, but leave off the asterisks and describe each news item with a full paragraph when necessary rather than the more concise summaries that would go in a changelog. It's a good idea to run your file through ``dpkg-parsechangelog`` to check its formatting as it will not be automatically checked during build as the changelog is. Here is an example of a real ``NEWS.Debian`` file:
it: Il formato del file è lo stesso di un file changelog Debian, ma lasciare fuori gli asterischi e descrivere ogni notizia con un paragrafo completo quando necessario, piuttosto che le più concise sintesi che andrebbero in un changelog. È una buona idea eseguire il file attraverso ``dpkg-parsechangelog`` per controllare la formattazione in quanto durante la fase di compilazione non sarà controllata automaticamente come è stato fatto per il changelog. Ecco un esempio di un vero e proprio file ``NEWS.Debian``:

en: The ``NEWS.Debian`` file is installed as ``/usr/share/doc/``\ *package*\ ``/NEWS.Debian.gz``. It is compressed, and always has that name even in Debian native packages. If you use ``debhelper``, ``dh_installchangelogs`` will install ``debian/NEWS`` files for you.
it: Il file ``NEWS.Debian`` è installato come ``/usr/share/doc/``\ *package*\ ``/NEWS.Debian.gz``. È compresso e ha sempre quel nome, anche in pacchetti nativi Debian. Se si utilizza ``debhelper``, ``dh_installchangelogs`` installerà il file ``debian/NEWS`` per voi.

en: Unlike changelog files, you need not update ``NEWS.Debian`` files with every release. Only update them if you have something particularly newsworthy that user should know about. If you have no news at all, there's no need to ship a ``NEWS.Debian`` file in your package. No news is good news!
it: A differenza dei file changelog, non è necessario aggiornare il file ``NEWS.Debian`` ad ogni rilascio. Aggiornarli solo se si ha qualcosa particolarmente degna di nota che l'utente dovrebbe conoscere. Se non si ha alcuna notizia, non c'è bisogno di fornire un file ``NEWS.Debian``. Nessuna notizia è una buona notizia!

en: Best practices for maintainer scripts
it: Buone pratiche per gli script del mantainer

en: Maintainer scripts must be idempotent. That means that you need to make sure nothing bad will happen if the script is called twice where it would usually be called once.
it: Gli script del maintainer devono essere idempotenti. Ciò significa che è necessario assicurarsi che nulla di male accadrà se lo script dovesse essere invocato due volte dove di solito viene lanciato una volta sola.

en: Standard input and output may be redirected (e.g. into pipes) for logging purposes, so don't rely on them being a tty.
it: Gli standard input e output possono essere reindirizzati (ad esempio nelle pipe) per finalità di logging, quindi non utilizzateli come una tty.

en: All prompting or interactive configuration should be kept to a minimum. When it is necessary, you should use the ``debconf`` package for the interface. Remember that prompting in any case can only be in the ``configure`` stage of the ``postinst`` script.
it: Tutte le configurazioni suggerite o interattive devono essere ridotte al minimo. Quando è necessario, si dovrebbe utilizzare il pacchetto ``debconf`` per l'interfaccia. Ricordare che il suggerimento in ogni caso può esserci solo nella fase ``configure`` dello script ``postinst``.

en: Keep the maintainer scripts as simple as possible. We suggest you use pure POSIX shell scripts. Remember, if you do need any bash features, the maintainer script must have a bash shebang line. POSIX shell or Bash are preferred to Perl, since they enable ``debhelper`` to easily add bits to the scripts.
it: Mantenere gli script del maintainer più semplici possibile. Si consiglia di utilizzare puri script POSIX. Ricordate, se si ha bisogno di tutte le funzioni di bash, lo script del maintainer deve avere una linea shebang per bash. La shell POSIX o Bash sono preferite a quella Perl, poiché permettono a ``debhelper`` di aggiungere facilmente bit agli script.

en: If you change your maintainer scripts, be sure to test package removal, double installation, and purging. Be sure that a purged package is completely gone, that is, it must remove any files created, directly or indirectly, in any maintainer script.
it: Se si modificano gli script del maintainer, assicurarsi di testare la rimozione del pacchetto, la doppia installazione e l'epurazione. Assicurarsi che un pacchetto epurato sia completamente sparito, ovvero, deve rimuovere tutti i file creati, direttamente o indirettamente, in tutti gli script del maintainer.

en: If you need to check for the existence of a command, you should use something like
it: Se è necessario verificare l'esistenza di un comando, si dovrebbe usare qualcosa simile a

en: Configuration management with ``debconf``
it: Gestione della configurazione con ``debconf``

en: These guidelines include some writing style and typography recommendations, general considerations about debconf usage as well as more specific recommendations for some parts of the distribution (the installation system for instance).
it: Queste linee guida comprendono un certo stile di scrittura e di raccomandazioni tipografiche, considerazioni generali sull'uso di debconf e raccomandazioni più specifiche per alcune parti della distribuzione (il sistema di installazione, per esempio).

en: Do not abuse debconf
it: Non abusare di debconf

en: Since debconf appeared in Debian, it has been widely abused and several criticisms received by the Debian distribution come from debconf abuse with the need of answering a wide bunch of questions before getting any little thing installed.
it: Da quando debconf è apparso in Debian, è stato ampiamente abusato e diverse critiche ricevute dalla distribuzione Debian provengono dall'abuso di debconf con la necessità di rispondere ad una vasta serie di domande prima di installare ogni piccola cosa.

en: General recommendations for authors and translators
it: Raccomandazioni generali per autori e traduttori

en: Write correct English
it: Scrivere inglese corretto

en: Most Debian package maintainers are not native English speakers. So, writing properly phrased templates may not be easy for them.
it: La maggior parte dei maintainer dei pacchetti Debian non sono di madrelingua inglese. Quindi, la scrittura di modelli correttamente formulati, può non essere facile per loro.

en: Please use (and abuse) ``debian-l10n-english@lists.debian.org`` mailing list. Have your templates proofread.
it: utilizzare (e abusare) della mailing list ``debian-l10n-english@lists.debian.org``. Avrete le vostre bozze di modelli corrette.

en: Badly written templates give a poor image of your package, of your work... or even of Debian itself.
it: I modelli scritti male danno una cattiva immagine del pacchetto, del proprio lavoro... o anche di Debian stesso.

en: Avoid technical jargon as much as possible. If some terms sound common to you, they may be impossible to understand for others. If you cannot avoid them, try to explain them (use the extended description). When doing so, try to balance between verbosity and simplicity.
it: Evitare il gergo tecnico il più possibile. Se alcuni termini suonano comuni a voi, possono essere impossibili da comprendere per gli altri. Se non si possono evitare, cercare di spiegarli (utilizzare la descrizione estesa). Nel fare ciò, cercare di bilanciarsi tra verbosità e semplicità.

en: Be kind to translators
it: Sii gentile con i traduttori

en: Please use gettext-based templates. Install ``po-debconf`` on your development system and read its documentation (``man po-debconf`` is a good start).
it: Utilizzare i modelli basati su gettext. Installare ``po-debconf`` sul proprio sistema di sviluppo e leggete la sua documentazione (``man po-debconf`` è un buon inizio).

en: If you plan to do changes to your original templates, please use the notification system provided with the ``po-debconf`` package, namely the ``podebconf-report-po``, to contact translators. Most active translators are very responsive and getting their work included along with your modified templates will save you additional uploads. If you use gettext-based templates, the translator's name and e-mail addresses are mentioned in the PO files headers and will be used by ``podebconf-report-po``.
it: Se si ha intenzione di modificare i modelli originali, utilizzare il sistema di notifica fornito con il pacchetto ``po-debconf``, vale a dire il ``podebconf-report-po``, per contattare i traduttori. I Traduttori più attivi sono molto reattivi e ottenere il loro lavoro incluso insieme con i vostri modelli modificati vi risparmierà caricamenti aggiuntivi. Se si utilizzano modelli basati su gettext, il nome del traduttore e gli indirizzi di posta elettronica sono menzionati negli header dei file PO e saranno utilizzati da ``podebconf-report-po``.

en: A recommended use of that utility is:
it: Un uso consigliato di ciò che questa utility è:

en: Giving a deadline to translators is always appreciated, so that they can organize their work. Please remember that some translation teams have a formalized translate/review process and a delay lower than 10 days is considered as unreasonable. A shorter delay puts too much pressure on translation teams and should be kept for very minor changes.
it: Dare una scadenza ai traduttori è sempre apprezzato, in modo tale che possano organizzare il loro lavoro. Ricordare che alcuni gruppi di traduzione hanno un processo formalizzato di traduzione/revisione e un ritardo inferiore a 10 giorni è considerato irragionevole. Un ritardo più breve mette troppa pressione sul team di traduzione e dovrebbe essere utilizzato per modifiche di minore entità.

en: If in doubt, you may also contact the translation team for a given language (debian-l10n-xxxxx@lists.debian.org), or the ``debian-i18n@lists.debian.org`` mailing list.
it: In caso di dubbio, si può anche contattare il team di traduzione per una determinata lingua (debian-l10n-xxxxx@lists.debian.org), o la mailing list ``debian-i18n@lists.debian.org``.

en: Unfuzzy complete translations when correcting typos and spelling
it: Ordinare intere traduzioni quando si correggono errori di battitura e di ortografia

en: When the text of a debconf template is corrected and you are **sure** that the change does **not** affect translations, please be kind to translators and *unfuzzy* their translations.
it: Quando il testo di un modello debconf è corretto e si è **sicuri** che la modifica **non** influenzi le traduzioni, si sia gentili con i traduttori e *sistemare* le loro traduzioni.

en: If you don't do so, the whole template will not be translated as long as a translator will send you an update.
it: Se non si fa così, l'intero modello non verrà tradotto fino a quando un traduttore invierà un aggiornamento.

en: To *unfuzzy* translations, you can use ``msguntypot`` (part of the ``po4a`` package).
it: Per *sistemare* le traduzioni, è possibile utilizzare ``msguntypot`` (parte del pacchetto ``po4a``).

en: Regenerate the POT and PO files.
it: Rigenerare i file POT e PO.

en: Make a copy of the POT file.
it: Creare una copia del file POT.

en: Make a copy of all the PO files.
it: Fare una copia di tutti i files PO.

en: Change the debconf template files to fix the typos.
it: Modificare i file dei modelli di debconf per correggere errori di battitura.

en: Regenerate the POT and PO files (again).
it: Rigenerare i file POT e PO (di nuovo).

en: At this point, the typo fix fuzzied all the translations, and this unfortunate change is the only one between the PO files of your main directory and the one from the fridge. Here is how to solve this.
it: A questo punto, la correzione dell'errore di battitura ha confuso tutte le traduzioni e questo spiacevole cambiamento è l'unico tra i file PO della vostra cartella principale e quella in frigo. Ecco come risolvere questa situazione.

en: Discard fuzzy translation, restore the ones from the fridge.
it: Scartare la traduzione disordinata, ripristinare quella proveniente dal frigo.

en: Manually merge the PO files with the new POT file, but taking the useless fuzzy into account.
it: Unire manualmente i files PO con il nuovo file POT, ma prendendo nell'account l'inutile disordine.

en: Clean up.
it: Pulizia.

en: Do not make assumptions about interfaces
it: Non fare ipotesi sulle interfacce

en: String templates should also avoid mentioning the default values in their description. First, because this is redundant with the values seen by the users. Also, because these default values may be different from the maintainer choices (for instance, when the debconf database was preseeded).
it: I modelli di frasi dovrebbero anche evitare di menzionare i valori predefiniti nella loro descrizione. Primo, perché questo è ridondante con i valori visualizzati dagli utenti. Inoltre, perché questi valori predefiniti possono essere diversi dalle scelte del maintainer (per esempio, quando il database debconf è stato preconfigurato).

en: More generally speaking, try to avoid referring to user actions. Just give facts.
it: Più in generale, cercare di evitare di riferirsi alle azioni dell'utente. Basta indicare i fatti.

en: Do not use first person
it: Non utilizzare la prima persona

en: Be gender neutral
it: Usare il genere neutro

en: Templates fields definition
it: Definizione dei campi dei modelli

en: Type
it: Tipo

en: string
it: stringa

en: Results in a free-form input field that the user can type any string into.
it: Risultati in un campo di input nel quale l'utente può digitare qualsiasi frase.

en: Prompts the user for a password. Use this with caution; be aware that the password the user enters will be written to debconf's database. You should probably clean that value out of the database as soon as is possible.
it: Richiede all'utente una password. La si usi con cautela; si sia consapevoli del fatto che la password che l'utente inserisce sarà scritta nel database di debconf. Si dovrebbe cancellare quel valore fuori dal database appena è possibile.

en: boolean
it: booleano

en: A true/false choice. Remember: true/false, **not yes/no**...
it: Una scelta vero/falso. Ricordare: vero/falso, **non si/no**...

en: select
it: seleziona

en: A choice between one of a number of values. The choices must be specified in a field named 'Choices'. Separate the possible values with commas and spaces, like this: ``Choices: yes, no, maybe``.
it: Una scelta tra una serie di valori. Le scelte devono essere specificate in un campo denominato «Choices». Separare i possibili valori con le virgole e gli spazi, in questo modo: ``Scelte: sì, no, forse``.

en: If choices are translatable strings, the 'Choices' field may be marked as translatable by using ``__Choices``. The double underscore will split out each choice in a separate string.
it: Se le scelte sono stringhe traducibili, il campo «Choices» può essere contrassegnato come traducibile utilizzando ``__Choices``. La doppia sottolineatura suddividerà ogni scelta in una stringa separata.

en: The ``po-debconf`` system also offers interesting possibilities to only mark **some** choices as translatable. Example:
it: Il sistema ``po-debconf`` offre anche interessanti possibilità di marcare solamente **alcune** scelte come traducibili. Esempio:

en: In that example, only the 'Other' string is translatable while others are acronyms that should not be translated. The above allows only 'Other' to be included in PO and POT files.
it: In questo esempio, solo la stringa «Other» è traducibile, mentre altri sono acronimi che non devono essere tradotti. Quanto sopra esposto consente solo ad «Other» di essere inserito nei file PO e POT.

en: Like the select data type, except the user can choose any number of items from the choices list (or chose none of them).
it: Come per la selezione del tipo di dato, ad eccezione di quando l'utente può scegliere un qualsiasi numero di elementi dall'elenco delle scelte (o scegliere nessuno di loro).

en: note
it: nota

en: Rather than being a question per se, this datatype indicates a note that can be displayed to the user. It should be used only for important notes that the user really should see, since debconf will go to great pains to make sure the user sees it; halting the install for them to press a key, and even mailing the note to them in some cases.
it: Piuttosto che essere una questione di per sé, questo tipo di dato indica una nota che può essere visualizzata all'utente. Dovrebbe essere usato solo per le note importanti che l'utente in realtà dovrebbe vedere, dato che debconf andrà incontro a grandi dolori per assicurarsi che l'utente la veda; arrestando l'installazione per consentire loro di premere un tasto persino inviandogli la nota tramite posta elettronica in alcuni casi.

en: text
it: testo

en: This type is now considered obsolete: don't use it.
it: Questo tipo è ora considerato obsoleto: non usarlo.

en: error
it: errore

en: It is recommended to use this type for any message that needs user attention for a correction of any kind.
it: Si consiglia di utilizzare questo tipo per ogni messaggio che necessita dell'attenzione dell'utente per una correzione di qualsiasi tipo.

en: Description: short and extended description
it: Descrizione: descrizione breve ed estesa

en: Template descriptions have two parts: short and extended. The short description is in the Description: line of the template.
it: Le descrizioni dei modelli constano di due parti: breve ed estesa. La descrizione breve è nella linea «Description:» del modello.

en: The short description should be kept short (50 characters or so) so that it may be accommodated by most debconf interfaces. Keeping it short also helps translators, as usually translations tend to end up being longer than the original.
it: La descrizione breve dovrebbe essere mantenuta breve (50 caratteri o giù di lì) in modo che possa essere accolta dalla maggior parte delle interfacce di debconf. Mantenerla breve aiuta anche i traduttori, considerato che normalmente le traduzioni tendono a finire per essere più lunghe rispetto all'originale.

en: The short description does not necessarily have to be a full sentence. This is part of the keep it short and efficient recommendation.
it: La descrizione breve non deve necessariamente essere un periodo completo. Questo fa parte della raccomandazione di mantenerla breve ed efficiente.

en: The extended description should not repeat the short description word for word. If you can't think up a long description, then first, think some more. Post to debian-devel. Ask for help. Take a writing class! That extended description is important. If after all that you still can't come up with anything, leave it blank.
it: La descrizione estesa non deve ripetere la descrizione breve parola per parola. Se non è possibile pensare ad una descrizione lunga, quindi primo, si pensi un po' di più. Si condivida in debian-devel. Si chieda aiuto. Ci si iscriva ad un corso di scrittura! La descrizione estesa è importante. Se dopo tutto questo non è ancora possibile trovare qualcosa, la si lasci vuota.

en: The extended description should use complete sentences. Paragraphs should be kept short for improved readability. Do not mix two ideas in the same paragraph but rather use another paragraph.
it: La descrizione estesa dovrebbe usare periodi completi. I paragrafi devono essere brevi per migliorare la leggibilità. Non mescolare due idee nello stesso punto, piuttosto si usi un altro paragrafo.

en: Don't be too verbose. User tend to ignore too long screens. 20 lines are by experience a border you shouldn't cross, because that means that in the classical dialog interface, people will need to scroll, and lot of people just don't do that.
it: Non si sia troppo prolissi. Gli utenti tendono a ignorare schermate troppo lunghe. 20 righe sono per esperienza un limite che non si dovrebbe oltrepassare, perché ciò significa che nella finestra di interfaccia classica, le persone avranno bisogno di scorrere e molte persone semplicemente non lo fanno.

en: The extended description should **never** include a question.
it: La descrizione estesa non dovrebbe **mai** includere una domanda.

en: For specific rules depending on templates type (string, boolean, etc.), please read below.
it: Per specifiche regole inerenti il tipo di template (string, boolean, etc), leggere qui di seguito.

en: Choices
it: Scelte

en: This field is optional. It contains the default answer for string, select and multiselect templates. For multiselect templates, it may contain a comma-separated list of choices.
it: Questo campo è facoltativo. Esso contiene la risposta predefinita per i modelli di periodi, di selezione singola e multipla. Per i modelli di selezione multipla, può contenere un elenco di scelte separate da virgole.

en: No specific indication except: use the appropriate type by referring to the previous section.
it: Nessuna indicazione specifica eccetto: utilizzare il tipo appropriato, facendo riferimento alla sezione precedente.

en: Description field
it: Il campo Description

en: Below are specific instructions for properly writing the Description (short and extended) depending on the template type.
it: Qui di seguito sono istruzioni specifiche per scrivere correttamente la descrizione (breve e lunga) a seconda del tipo di modello.

en: String/password templates
it: Modelli di string/password

en: The short description is a prompt and **not** a title. Avoid question style prompts (IP Address?) in favour of opened prompts (IP address:). The use of colons is recommended.
it: La descrizione breve è un suggerimento e **non** un titolo. Evitare domande in stile suggerimento (indirizzo IP?) a favore di suggerimenti aperti (indirizzo IP:). Si consiglia l'uso dei due punti.

en: The extended description is a complement to the short description. In the extended part, explain what is being asked, rather than ask the same question again using longer words. Use complete sentences. Terse writing style is strongly discouraged.
it: La descrizione estesa è un complemento della descrizione breve. Nella parte estesa, si spieghi ciò che viene chiesto, piuttosto che riproporre la stessa domanda con parole più lunghe. Utilizzare frasi complete. Una scrittura concisa è fortemente sconsigliata.

en: Boolean templates
it: Modelli booleani

en: Again, please avoid referring to specific interface widgets. A common mistake for such templates is if you answer Yes-type constructions.
it: Anche in questo caso, evitare il riferimento a specifici widget delle interfacce. Un errore comune per tali modelli è se si risponde con costrutti di tipo Yes.

en: Select/Multiselect
it: Selezione/Multiselezione

en: The extended description will complete the short description. It may refer to the available choices. It may also mention that the user may choose more than one of the available choices, if the template is a multiselect one (although the interface often makes this clear).
it: La descrizione estesa completerà la descrizione breve. Può far riferimento alle scelte disponibili. Può anche indicare che l'utente può scegliere più di una tra le scelte disponibili, se il modello è di tipo selezione multipla (l'interfaccia spesso rende chiaro tutto ciò).

en: The short description should be considered to be a **title**.
it: La descrizione breve dovrebbe essere considerata un **titolo**.

en: The extended description is what will be displayed as a more detailed explanation of the note. Phrases, no terse writing style.
it: La descrizione estesa è ciò che sarà visualizzato come una spiegazione più dettagliata della nota. Frasi, non scrittura sintetica.

en: Choices field
it: Campo Choises

en: If the Choices are likely to change often, please consider using the \__Choices trick. This will split each individual choice into a single string, which will considerably help translators for doing their work.
it: Se le «Choises» sono suscettibili di cambiare spesso, considerare l'uso del trucco «_\_ Choices». Questo dividerà ogni singola scelta in una singola stringa, che aiuterà notevolmente i traduttori nel compiere il loro lavoro.

en: Default field
it: Campo Default

en: Example, taken from the geneweb package templates:
it: Esempio, tratto dai modelli del pacchetto geneweb:

en: Internationalization
it: Internazionalizzazione

en: Handling debconf translations
it: Gestione delle traduzioni debconf

en: Like porters, translators have a difficult task. They work on many packages and must collaborate with many different maintainers. Moreover, most of the time, they are not native English speakers, so you may need to be particularly patient with them.
it: Come gli autori di port, i traduttori hanno un compito difficile. Lavorano su molti pacchetti e devono collaborare con molti maintainer diversi. Inoltre, la maggior parte delle volte, non sono di madrelingua inglese, quindi si potrebbe dover essere particolarmente pazienti con loro.

en: Internationalized documentation
it: Documentazione internazionalizzata

en: Internationalizing documentation is crucial for users, but a lot of labor. There's no way to eliminate all that work, but you can make things easier for translators.
it: Internazionalizzare la documentazione è fondamentale per gli utenti, ma richiede molto lavoro. Non c'è modo di eliminare tutto quel lavoro, ma si possono rendere le cose più facili per i traduttori.

en: Common packaging situations
it: Situazioni comuni durante la pacchettizzazione

en: Packages using ``autoconf``/``automake``
it: Pacchettizzazione utilizzando ``autoconf``/``automake``

en: Keeping ``autoconf``'s ``config.sub`` and ``config.guess`` files up to date is critical for porters, especially on more volatile architectures. Some very good packaging practices for any package using ``autoconf`` and/or ``automake`` have been synthesized in ``/usr/share/doc/autotools-dev/README.Debian.gz`` from the ``autotools-dev`` package. You're strongly encouraged to read this file and to follow the given recommendations.
it: Mantenere i file ``config.sub`` e ``config.guess`` di ``autoconf`` aggiornati è fondamentale per gli autori di port, soprattutto su architetture più volatili. Alcune ottime pratiche di packaging per ogni pacchetto che usa ``autoconf`` e/o ``automake`` sono state sintetizzate in ``/usr/share/doc/autotools-dev/README.Debian.gz`` dal pacchetto ``autotools-dev``. Si è vivamente incoraggiati a leggere questo file e di seguire le raccomandazioni in esso fornite.

en: Libraries
it: Le librerie

en: Libraries are always difficult to package for various reasons. The policy imposes many constraints to ease their maintenance and to make sure upgrades are as simple as possible when a new upstream version comes out. Breakage in a library can result in dozens of dependent packages breaking.
it: Le librerie sono sempre difficili da pacchettizzare per vari motivi. La policy impone molti vincoli per facilitare il loro mantenimento e per assicurarsi che gli aggiornamenti siano i più semplici possibili quando una nuova versione viene pubblicata. Una rottura in una libreria può causare una rottura in decine di pacchetti dipendenti.

en: Documentation
it: La documentazione

en: Be sure to follow the `Policy on documentation <https://www.debian.org/doc/debian-policy/ch-docs.html>`__.
it: Assicurarsi di seguire la policy `Policy sulla documentazione <https://www.debian.org/doc/debian-policy/ch-docs.html>`__.

en: If your package contains documentation built from XML or SGML, we recommend you not ship the XML or SGML source in the binary package(s). If users want the source of the documentation, they should retrieve the source package.
it: Se il pacchetto contiene la documentazione compilata a partire da XML o SGML, si consiglia di non includere il sorgente XML o SGML nel pacchetto binario. Se gli utenti vogliono il sorgente della documentazione, dovrebbero poter recuperare il pacchetto sorgente.

en: Policy specifies that documentation should be shipped in HTML format. We also recommend shipping documentation in PDF and plain text format if convenient and if output of reasonable quality is possible. However, it is generally not appropriate to ship plain text versions of documentation whose source format is HTML.
it: La policy specifica che la documentazione deve essere fornita in formato HTML. Si consiglia anche di inserire la documentazione in formato PDF e testo normale se conveniente e se è possibile output di discreta qualità. Tuttavia, non è in genere appropriato includere la versione in testo semplice della documentazione il cui formato sorgente è HTML.

en: Major shipped manuals should register themselves with ``doc-base`` on installation. See the ``doc-base`` package documentation for more information.
it: La maggior parte dei manuali dovrebbe registrarsi con ``doc-base`` durante l'installazione. Si consulti la documentazione del pacchetto ``doc-base`` per ulteriori informazioni.

en: Debian policy (section 12.1) directs that manual pages should accompany every program, utility, and function, and suggests them for other objects like configuration files. If the work you are packaging does not have such manual pages, consider writing them for inclusion in your package, and submitting them upstream.
it: La policy di Debian (sezione 12.1) indica che le pagine del manuale dovrebbero accompagnare ogni programma, utility e la funzione e suggerirli per altri oggetti come file di configurazione. Se il lavoro che si sta pacchettizzando non ha queste pagine di manuale, si consideri la loro scrittura per l'inclusione nel pacchetto e di sottoporla allo sviluppatore originale.

en: Specific types of packages
it: Specifici tipi di pacchetti

en: Several specific types of packages have special sub-policies and corresponding packaging rules and practices:
it: Vari tipi specifici di pacchetti hanno particolari sub-politiche e rispettive pratiche e regole per la pacchettizzazione:

en: Emacs related packages have the `emacs policy <https://www.debian.org/doc/packaging-manuals/debian-emacs-policy>`__.
it: I relativi pacchetti Emacs hanno la `emacs policy <https://www.debian.org/doc/packaging-manuals/debian-emacs-policy>`__.

en: Java related packages have their `java policy <https://www.debian.org/doc/packaging-manuals/java-policy/>`__.
it: I relativi pacchetti Java hanno la loro `java policy <https://www.debian.org/doc/packaging-manuals/java-policy/>`__.

en: Packages providing XML or SGML DTDs should conform to the recommendations found in the ``sgml-base-doc`` package.
it: I pacchetti che forniscono XML o SGML DTD devono essere conformi alle indicazioni fornite nel pacchetto ``sgml-base-doc``.

en: Lisp packages should register themselves with ``common-lisp-controller``, about which see ``/usr/share/doc/common-lisp-controller/README.packaging``.
it: I pacchetti Lisp si devono registrare con il ``common-lisp-controller``, a proposito del quale si veda ``/usr/share/doc/common-lisp-controller/README.packaging``.

en: Architecture-independent data
it: Dati indipendenti dall'architettura

en: It is not uncommon to have a large amount of architecture-independent data packaged with a program. For example, audio files, a collection of icons, wallpaper patterns, or other graphic files. If the size of this data is negligible compared to the size of the rest of the package, it's probably best to keep it all in a single package.
it: Non è raro avere una grande quantità di dati indipendenti dall'architettura pacchettizzati con un programma. Ad esempio, i file audio, una collezione di icone, modelli di wallpaper, o altri file grafici. Se la dimensione di questi dati è trascurabile rispetto alle dimensioni del resto del pacchetto, probabilmente è meglio tenere il tutto in un unico pacchetto.

en: Needing a certain locale during build
it: Aver bisogno di una particolare localizzazione durante la compilazione

en: If you need a certain locale during build, you can create a temporary file via this trick:
it: Se si ha bisogno di una certa localizzazione durante la compilazione, si può creare un file temporaneo con questo trucco:

en: If you set ``LOCPATH`` to the equivalent of ``/usr/lib/locale``, and ``LC_ALL`` to the name of the locale you generate, you should get what you want without being root. Something like this:
it: Se si imposta ``LOCPATH`` all'equivalente di ``/usr/lib/locale`` e ``LC_ALL`` al nome del locale che si genera, si dovrebbe ottenere ciò che si desidera senza essere root. Qualcosa di simile a questo:

en: Make transition packages deborphan compliant
it: Rendere i pacchetti di transizione conformi a deborphan

en: Deborphan is a program for helping users to detect which packages can safely be removed from the system, i.e. the ones that have no packages depending on them. The default operation is to search only within the libs and oldlibs sections, to hunt down unused libraries. But when passed the right argument, it tries to catch other useless packages.
it: Deborphan è un programma per aiutare gli utenti ad individuare quali pacchetti possono essere tranquillamente rimossi dal sistema, vale a dire quelli che non hanno pacchetti dipendenti da loro. Il funzionamento predefinito è di cercare solo all'interno delle sezioni libs e oldlibs, per dare la caccia a librerie inutilizzate. Ma quando viene passato l'argomento giusto, cerca di catturare altri pacchetti inutili.

en: Best practices for ``.orig.tar.{gz,bz2,xz}`` files
it: Buone pratiche per i file ``.orig.tar.{gz,bz2,xz}``

en: There are two kinds of original source tarballs: Pristine source and repackaged upstream source.
it: Ci sono due tipi di tarball dei sorgenti originali: sorgente puro e sorgente originale ripacchettizzato.

en: Pristine source
it: Sorgente puro

en: The defining characteristic of a pristine source tarball is that the ``.orig.tar.{gz,bz2,xz}`` file is byte-for-byte identical to a tarball officially distributed by the upstream author. [1]_ This makes it possible to use checksums to easily verify that all changes between Debian's version and upstream's are contained in the Debian diff. Also, if the original source is huge, upstream authors and others who already have the upstream tarball can save download time if they want to inspect your packaging in detail.
it: La caratteristica distintiva di un tarball sorgente incontaminato è che il ``.orig.tar.{gz,bz2,xz}`` è byte-per-byte identico a un tarball ufficialmente distribuito dall'autore originale.  [1]_ Questo rende possibile l'utilizzo di checksum per verificare facilmente che tutte le modifiche tra la versione di Debian e quella originale siano contenute nel Debian diff. Inoltre, se il sorgente originale è enorme, gli autori originali e chiunque possieda già l'archivio originale possono risparmiare tempo di download, se vogliono ispezionare il pacchetto in dettaglio.

en: It unpacks the tarball in an empty temporary directory by doing
it: Si scompatta l'archivio in una cartella temporanea vuota facendo

en: If, after this, the temporary directory contains nothing but one directory and no other files, ``dpkg-source`` renames that directory to *packagename*\ ``-``\ *upstream-version*\ ``(.orig)``. The name of the top-level directory in the tarball does not matter, and is forgotten.
it: Se, dopo questo, la cartella temporanea non contiene nulla, ma una sola cartella e nessun altro file, ``dpkg-source`` rinomina quella cartella in *packagename*\ ``-``\ *upstream-version*\ ``(.orig)``. Il nome della più alta cartella nella tarball non ha importanza, ed è tralasciata.

en: Otherwise, the upstream tarball must have been packaged without a common top-level directory (shame on the upstream author!). In this case, ``dpkg-source`` renames the temporary directory *itself* to *packagename*\ ``-``\ *upstream-version*\ ``(.orig)``.
it: In caso contrario, l'archivio originale deve essere stato confezionato senza una comune cartella di livello alto (vergogna sull'autore originale!). In questo caso, ``dpkg-source`` rinomina la cartella temporanea *stessa* in *packagename*\ ``-``\ *upstream-version*\ ``(.orig)``.

en: Repackaged upstream source
it: Sorgente originale ripacchettizzato

en: You **should** upload packages with a pristine source tarball if possible, but there are various reasons why it might not be possible. This is the case if upstream does not distribute the source as gzipped tar at all, or if upstream's tarball contains non-DFSG-free material that you must remove before uploading.
it: **Si dovrebbe** caricare i pacchetti con un tarball sorgente puro, se possibile, ma ci sono vari motivi per cui potrebbe non essere possibile. Questo è il caso in cui se l'autore originale non distribuisce il sorgente come non completamente compresso in formato tar, o se il tarball originale contiene materiale non DFSG-free che è necessario rimuovere prima di caricare.

en: In these cases the developer must construct a suitable ``.orig.tar.{gz,bz2,xz}`` file themselves. We refer to such a tarball as a repackaged upstream source. Note that a repackaged upstream source is different from a Debian-native package. A repackaged source still comes with Debian-specific changes in a separate ``.diff.gz`` or ``.debian.tar.{gz,bz2,xz}`` and still has a version number composed of *upstream-version* and *debian-version*.
it: In questi casi, lo sviluppatore deve costruirsi un ``.orig.tar.{gz,bz2,xz}`` adatto. Ci si riferisce a un tale tarball come sorgente originale ripacchettizato. Si noti che un sorgente originale ripacchettizato è diverso da un pacchetto Debian nativo. Un sorgente originale ripacchettizato con modifiche specifiche per Debian ancora viene distribuito in un separato ``.diff.gz`` o ``.debian.tar.{gz,bz2,xz}`` e ha ancora un numero di versione composto da *upstream-version* e *debian-version*.

en: There may be cases where it is desirable to repackage the source even though upstream distributes a ``.tar.{gz,bz2,xz}`` that could in principle be used in its pristine form. The most obvious is if *significant* space savings can be achieved by recompressing the tar archive or by removing genuinely useless cruft from the upstream archive. Use your own discretion here, but be prepared to defend your decision if you repackage source that could have been pristine.
it: Ci possono essere casi in cui è auspicabile pacchettizzare nuovamente il sorgente anche se l'autore originale distribuisce un ``.tar.{gz,bz2,xz}`` che potrebbe in linea di principio essere utilizzato nella sua forma originaria. Il più ovvio è se un *significativo* risparmio di spazio può essere ottenuto ricomprimendo l'archivio tar o rimuovendo genuinamente dell'inutile fuffa dall'archivio originale. Si usi la propria discrezione qui, ma si sia pronti a difendere la propria decisione se si pacchettizza nuovamente il sorgente che poteva esser puro.

en: A repackaged ``.orig.tar.{gz,bz2,xz}``
it: Un ``.orig.tar.{gz,bz2,xz}`` ripacchettizzato

en: **should not** contain any file that does not come from the upstream author(s), or whose contents has been changed by you. [2]_
it: **non dovrebbe** contenere qualsiasi tipo di file che non proviene dall'autore originale, o il cui contenuto è stato modificato.  [2]_

en: (*Rationale:* It is common for Debian users who need to build software for non-Debian platforms to fetch the source from a Debian mirror rather than trying to locate a canonical upstream distribution point).
it: (*Motivazione:* È comune per gli utenti Debian che hanno bisogno di compilare software per piattaforme non-Debian prendere il sorgente da uno dei mirror Debian piuttosto che cercare di individuare un punto canonico di distribuzione originale).

en: Changing binary files
it: Modifica dei file binari

en: Best practices for debug packages
it: Buone pratiche per i pacchetti di debug

en: Note that the debug package should depend on the package that it provides debugging symbols for, and this dependency should be versioned. For example:
it: Si noti che il pacchetto di debug dovrebbe dipendere dal pacchetto per il quale fornisce i simboli di debug e questa dipendenza dovrebbe essere versionata. Per esempio:

en: Best practices for meta-packages
it: Buone pratiche per i metapacchetti

en: A meta-package is a mostly empty package that makes it easy to install a coherent set of packages that can evolve over time. It achieves this by depending on all the packages of the set. Thanks to the power of APT, the meta-package maintainer can adjust the dependencies and the user's system will automatically get the supplementary packages. The dropped packages that were automatically installed will be also be marked as removal candidates (and are even automatically removed by ``aptitude``). ``gnome`` and ``linux-image-amd64`` are two examples of meta-packages (built by the source packages ``meta-gnome2`` and ``linux-latest``).
it: Un metapacchetto è un pacchetto per lo più vuoto che rende facile installare un insieme coerente di pacchetti che possono evolvere nel tempo. Realizza ciò creando una dipendenza per tutti i pacchetti dell'insieme. Grazie alla potenza di APT, il maintainer del metapacchetto può sistemare le dipendenze e il sistema dell'utente otterrà automaticamente i pacchetti supplementari. I pacchetti eliminati che sono stati installati automaticamente verranno contrassegnati come candidati alla rimozione (e saranno anche rimossi automaticamente da ``aptitude``). ``gnome`` e ``linux-image-amd64`` sono due esempi di metapacchetti (compilati dai pacchetti sorgente meta-gnome2 e ``linux-latest``).
