maint-guide - en to fr translation catalogue (1045 entries)

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

note: type: Content of: <book><title>
en: Debian New Maintainers' Guide
fr: Guide du nouveau responsable Debian

note: type: Content of: <book><bookinfo><authorgroup><author><contrib>
en: original contents
fr: version initiale

note: type: Content of: <book><bookinfo><authorgroup><author><contrib>
en: updated contents
fr: version mise à jour

note: type: Content of: <book><bookinfo><legalnotice><para>
en: This document may be used under the terms the GNU General Public License version 2 or higher.
fr: Ce document peut être utilisé selon les termes de la Licence publique générale de GNU version 2 ou suivante.

note: type: Content of: <book><bookinfo><legalnotice><para>
en: This document was made using these two documents as examples:
fr: Ce document a été créé en se basant sur les deux suivants :

note: type: Content of: <book><bookinfo><legalnotice><itemizedlist><listitem><para>
en: Making a Debian Package (AKA the Debmake Manual), copyright © 1997 Jaldhar Vyas.
fr: Making a Debian Package (le manuel de debmake), copyright © 1997 Jaldhar Vyas.

note: type: Content of: <book><chapter><title>
en: Getting started The Right Way
fr: Partir du bon pied

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).
fr: Ce document essaie de décrire aux utilisateurs Debian moyens, et aux développeurs en devenir, la construction d'un paquet Debian. Il utilise un langage pas trop technique et est complété par des exemples, selon le vieux proverbe latin : « <emphasis>Longum iter est per praecepta, breve et efficax per exempla</emphasis> » (c'est long par la règle, court et efficace par l'exemple).

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.
fr: Ce document suppose que vous utilisez un système <literal>&Base-release;</literal> ou plus récent. Si vous avez l'intention de suivre ce texte avec un système plus ancien (y compris un ancien système Ubuntu par exemple), vous devez au moins installer les paquets <systemitem role="package">dpkg</systemitem> et <systemitem role="package">debhelper</systemitem> rétroportés.

note: type: Content of: <book><chapter><para>
en: This document has been updated for the Debian <literal>&base-release;</literal> release.  <placeholder type="footnote" id="0"/>
fr: Ce document a été mis à jour pour la version <literal>&Base-release;</literal> de Debian. <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.
fr: Vous pouvez apprendre les bases du système Debian à partir de la <ulink url="&debref;">Référence Debian</ulink>. Elle contient aussi quelques liens pour apprendre la programmation 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"/>
fr: Une des choses qui font de Debian une distribution de si haut niveau est son système de paquets. Bien qu'il existe une grande quantité de logiciels au format Debian, vous devrez parfois installer un logiciel qui ne l'est pas. Vous pouvez vous demander comment faire vos propres paquets et peut-être pensez-vous que c'est une tâche très difficile. Eh bien, si vous êtes vraiment un débutant sous Linux, c'est dur, mais si vous étiez un débutant, vous ne seriez pas en train de lire ce document. :-) Vous devez en savoir un peu sur la programmation UNIX, mais vous n'avez certainement pas besoin d'être un magicien. <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.
fr: Une chose est sûre, cependant : créer et maintenir correctement des paquets Debian prend beaucoup de temps. Ne vous faites pas d'illusion, pour que votre système fonctionne, les responsables doivent à la fois être techniquement compétents et consciencieux.

note: type: Content of: <book><chapter><para>
en: If you need some help on packaging, please read <xref linkend="helpme"/>.
fr: Si vous avez besoin d'aide sur l'empaquetage, veuillez consulter <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.
fr: Les nouvelles versions de ce document devraient toujours être disponibles en ligne sur <ulink url="&maint-guide;"/>. La version de référence en anglais est disponible sur <ulink url="&maint-guide;index.en.html"/> et dans le paquet <package>maint-guide</package>. La traduction en français est également disponible dans le paquet <package>maint-guide-fr</package>.

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.
fr: Puisqu'il s'agit d'un tutoriel, il a été choisi d'expliquer de façon détaillée chaque étape pour certains sujets importants. Certains d'entre eux pourrait vous sembler hors-sujet. Veuillez être patient. Certains cas particuliers ont été sautés, et seuls des liens ont été fournis pour conserver la simplicité de ce document.

note: type: Content of: <book><chapter><section><title>
en: Social dynamics of Debian
fr: Dynamique sociale de 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:
fr: Voici quelques observations sur la dynamique sociale de Debian, en espérant qu'elles puissent vous préparer à interagir avec Debian :

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: We all are volunteers.
fr: Nous sommes tous bénévoles.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: You cannot impose on others what to do.
fr: Vous ne pouvez pas forcer les autres à faire quoi que ce soit.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: You should be motivated to do things by yourself.
fr: Vous devriez être motivé à faire des choses vous-même.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Friendly cooperation is the driving force.
fr: La coopération amicale est la force motrice.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Your contribution should not overstrain others.
fr: Vos contributions ne devraient pas surmener les autres.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Your contribution is valuable only when others appreciate it.
fr: Vos contributions n'ont de sens que si les autres les apprécient.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Debian is not your school where you get automatic attention of teachers.
fr: Debian n'est pas une école où vous attirez automatiquement l'attention des professeurs.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: You should be able to learn many things by yourself.
fr: Vous devriez être capable d'apprendre la plupart des choses par vous-même.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Attention from other volunteers is a very scarce resource.
fr: L'attention des autres bénévoles est une ressource très rare.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Debian is constantly improving.
fr: Debian s'améliore sans cesse.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: You are expected to make high quality packages.
fr: On s'attend à ce que vous fassiez des paquets de haute qualité.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: You should adapt yourself to change.
fr: Vous devrez vous adapter vous-même aux modifications.

note: type: Content of: <book><chapter><section><para>
en: There are several types of people interacting around Debian with different roles:
fr: Plusieurs sortes de personnes ont rapport à Debian avec différent rôles :

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <emphasis role="strong">upstream author</emphasis>: the person who made the original program.
fr: <emphasis role="strong">auteur amont</emphasis> : la personne qui a créé le programme à l'origine ;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <emphasis role="strong">upstream maintainer</emphasis>: the person who currently maintains the program.
fr: <emphasis role="strong">responsable amont</emphasis> : la personne qui maintient actuellement le programme ;

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.
fr: <emphasis role="strong">responsable</emphasis> : la personne qui maintient le paquet Debian du programme ;

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).
fr: <emphasis role="strong">parrain</emphasis> : une personne qui aide les responsables à envoyer des paquets dans l'archive officielle de paquets Debian (après en avoir vérifié le contenu) ;

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.
fr: <emphasis role="strong">mentor</emphasis> : une personne qui aide les responsables débutants pour l'empaquetage, etc. ;

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.
fr: <emphasis role="strong">développeur Debian</emphasis> (DD) : un membre du projet Debian avec tous les droits d'envoi vers l'archive officielle de paquets Debian ;

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.
fr: <emphasis role="strong">responsable Debian</emphasis> (DM) : une personne avec des droits d'envoi limités vers l'archive officielle de paquets 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>.
fr: Veuillez remarquer qu'il n'est pas possible de devenir <emphasis role="strong">développeur Debian</emphasis> (DD) en une nuit car il ne suffit pas de compétences techniques. Veuillez ne pas vous décourager. Si c'est utile à d'autres, vous pouvez toujours envoyer vos paquets, soit en tant que <emphasis role="strong">responsable</emphasis> à l’aide d’un <emphasis role="strong">parrain</emphasis>, soit comme un <emphasis role="strong">responsable 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"/>).
fr: Remarquez qu'il n'est pas nécessaire de créer de nouveau paquet pour devenir un développeur Debian officiel. Contribuer aux paquets existants peut aussi fournir une voie pour devenir un développeur Debian. Beaucoup de paquets sont en attente de bons responsables (consultez <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:
fr: Puisque nous nous concentrons dans ce document exclusivement sur les aspects techniques de l'empaquetage, veuillez consulter les documents suivants pour apprendre comment Debian fonctionne et comment vous investir :

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)
fr: <ulink url="&logiciellibre;">Debian : 17 ans de logiciel libre, « do-ocracy » et démocratie</ulink> (diapositives introductives en anglais au)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&debianorghelp;">How can you help Debian?</ulink> (official)
fr: <ulink url="&debianorghelp;">Comment pouvez-vous aider Debian ?</ulink> (officiel)

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)
fr: <ulink url="&debianfaqhelp;">La FAQ Debian GNU/Linux, Chapitre 13 — Participer au projet Debian</ulink> (semi-officiel)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&debianwikihelp;">Debian Wiki, HelpDebian</ulink> (supplemental)
fr: <ulink url="&debianwikihelp;">Wiki Debian, HelpDebian</ulink> (supplémentaire)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&nm-do;">Debian New Member site</ulink> (official)
fr: <ulink url="&nm-do;">Site du nouveau membre Debian</ulink> (officiel)

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

note: type: Content of: <book><chapter><section><title>
en: Programs needed for development
fr: Programmes nécessaires au développement

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.
fr: Avant de commencer quoi que ce soit, vous devriez vous assurer d'avoir correctement installé certains paquets nécessaires au développement. Notez que la liste ne contient aucun paquet marqué <literal>essential</literal> ou <literal>required</literal> (essentiel ou requis) — nous supposons que ceux-ci sont déjà installés.

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 it with <literal>aptitude show <replaceable>package</replaceable></literal> or with <literal>dpkg -s <replaceable>package</replaceable></literal>.
fr: Les paquets suivants sont fournis dans l'installation standard de Debian, de sorte que vous les avez probablement déjà (ainsi que les paquets supplémentaires dont ils dépendent). Néanmoins, vous devriez le vérifier avec <literal>aptitude show <replaceable>paquet</replaceable></literal> ou avec <literal>dpkg -s <replaceable>paquet</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.
fr: Le paquet le plus important à installer sur un système de développement est <systemitem role="package">build-essential</systemitem>. Lors de son installation, il <emphasis>tirera</emphasis> avec lui d'autres paquets nécessaires à un environnement de compilation de base.

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:
fr: Pour certaines catégories de paquets, c'est tout ce dont vous aurez besoin. Cependant d'autres paquets, bien que non essentiels à toutes les constructions de paquet, sont utiles ou peuvent être nécessaires pour votre paquet :

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.
fr: <systemitem role="package">autoconf</systemitem>, <systemitem role="package">automake</systemitem> et <systemitem role="package">autotools-dev</systemitem> — beaucoup de nouveaux programmes utilisent des scripts de configuration et des fichiers <filename>Makefile</filename> prétraités à l'aide de programmes comme ceux-ci (consultez <literal>info autoconf</literal> et <literal>info automake</literal>). <systemitem role="package">autotools-dev</systemitem> conserve les versions à jour de certains de ces fichiers automatiques et fournit une documentation sur la meilleure façon d'utiliser ces fichiers ;

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.
fr: D'autres paquets plus spécialisés mais similaires existent aussi comme <systemitem role="package">dh-make-perl</systemitem>, <systemitem role="package">dh-make-php</systemitem>, etc.

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"/>
fr: <systemitem role="package">debhelper</systemitem> et <systemitem role="package">dh-make</systemitem> — <systemitem role="package">dh-make</systemitem> est nécessaire pour créer le squelette de notre exemple de paquet et il utilise certains outils de <systemitem role="package">debhelper</systemitem> pour créer les paquets. Ils ne sont pas indispensables pour cela, mais sont <emphasis>fortement</emphasis> recommandés pour les nouveaux responsables. Ils rendent le processus complet bien plus facile à démarrer et à contrôler par la suite (consultez <citerefentry> <refentrytitle>dh_make</refentrytitle> <manvolnum>8</manvolnum> </citerefentry> et <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.
fr: Le nouveau paquet <systemitem role="package">debmake</systemitem> peut être utilisé comme alternative au paquet standard <systemitem role="package">dh-make</systemitem>. Il est plus puissant et fourni avec une documentation HTML incluant des exemples complets d’empaquetage.

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>.)
fr: <systemitem role="package">devscripts</systemitem> — ce paquet contient des scripts utiles pouvant aider les responsables, mais ils ne sont pas indispensables pour la création de paquets. Les paquets recommandés et suggérés par celui-ci valent le coup d'œil (consultez <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>.)
fr: <systemitem role="package">fakeroot</systemitem> — cet utilitaire vous laisse prétendre être le superutilisateur, ce qui est nécessaire pour certaines parties du processus de construction (consultez <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>.)
fr: <systemitem role="package">file</systemitem> — ce programme pratique peut déterminer la nature d'un fichier (consultez <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>.)
fr: <systemitem role="package">gfortran</systemitem> — le compilateur Fortran 95 de GNU, nécessaire si votre programme est écrit en Fortran (consultez <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>).)
fr: <systemitem role="package">git</systemitem> — ce paquet fournit un système populaire de gestion de version conçu pour manipuler de très gros projets rapidement et efficacement ; il est utilisé pour des projets libres de grande envergure, en particulier le noyau Linux (consultez <citerefentry> <refentrytitle>git</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> et le manuel de 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 it 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>.)
fr: <systemitem role="package">gnupg</systemitem> — un outil qui vous permet de <emphasis>signer</emphasis> numériquement les paquets. Cela est spécialement important si vous comptez les distribuer à d'autres personnes, et c'est certainement ce que vous ferez quand votre travail sera inclus dans la distribution Debian (consultez <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>.)
fr: <systemitem role="package">gpc</systemitem> — le compilateur Pascal de GNU, nécessaire si votre programme est écrit en Pascal. Méritant d'être mentionné ici, <systemitem role="package">fp-compiler</systemitem>, le compilateur Pascal libre, convient également (consultez <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 can let 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>.)
fr: <systemitem role="package">lintian</systemitem> — c'est le vérificateur de paquet Debian, qui peut indiquer de nombreuses erreurs courantes après la construction du paquet et expliquer les erreurs trouvées (consultez <citerefentry> <refentrytitle>lintian</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> et le <ulink url="&lintian-doc;">manuel utilisateur de Lintian</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>.)
fr: <systemitem role="package">patch</systemitem> — ce programme très utile prend un fichier contenant une liste de différences (produite par le programme <command>diff</command>) et l'applique au fichier original, produisant une version modifiée (consultez <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.
fr: <systemitem role="package">patchutils</systemitem> — ce paquet contient certains utilitaires pour travailler avec les correctifs comme les commandes <command>lsdiff</command>, <command>interdiff</command> et <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 <command>chroot</command> environment.  Building Debian package in this <command>chroot</command> environment verifies the proper build dependency and avoid 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>)
fr: <systemitem role="package">pbuilder</systemitem> — ce paquet contient des programmes utilisés pour créer et maintenir un environnement « <command>chroot</command>é ». Construire un paquet Debian dans cet environnement permet de vérifier les dépendances correctes de construction et évite les bogues FTBFS (« Fails To Build From Source » pour les échecs de construction à partir du paquet source) (consultez <citerefentry> <refentrytitle>pbuilder</refentrytitle> <manvolnum>8</manvolnum> </citerefentry> et <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>.)
fr: <systemitem role="package">perl</systemitem> — Perl est un des langages de script les plus utilisés sur les systèmes modernes similaires à UNIX, souvent qualifié de « tronçonneuse suisse d'UNIX » (consultez <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>.)
fr: <systemitem role="package">python</systemitem> — Python fait aussi partie des langages de script les plus utilisés sur le système Debian, combinant une remarquable puissance et une syntaxe très claire (consultez <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>.)
fr: <systemitem role="package">quilt</systemitem> — ce paquet aide à gérer un grand nombre de correctifs en gardant une trace du rôle de chacun. Les correctifs peuvent être appliqués, enlevés, rafraîchis, etc. (consultez <citerefentry> <refentrytitle>quilt</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> et <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>.)
fr: <systemitem role="package">xutils-dev</systemitem> — certains programmes, d'ordinaire ceux conçus pour X11, utilisent aussi ces programmes pour générer les fichiers <filename>Makefile</filename> à partir d'un ensemble de fonctions macros (consultez <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.
fr: Les courtes descriptions données ci-dessus ne servent qu’à vous présenter ce que fait chaque paquet. Avant de continuer, veuillez lire la documentation de chaque programme pertinent, y compris ceux installés par les dépendances du paquet comme <command>make</command>, au moins celle concernant l'utilisation standard. Cela peut vous sembler fastidieux maintenant, mais plus tard vous serez <emphasis>très</emphasis> content de l'avoir fait. Si vous avez des questions particulières par la suite, vous devriez relire les documents mentionnés ci-dessus.

note: type: Content of: <book><chapter><section><title>
en: Documentation needed for development
fr: Documentation nécessaire au développement

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:
fr: Les documents suivants sont <emphasis>très importants</emphasis> et doivent être lus en parallèle à ce document :

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>.)
fr: <systemitem role="package">debian-policy</systemitem> — la <ulink url="&debian-policy;">Charte Debian</ulink> inclut des explications sur la structure et le contenu de l'archive Debian, plusieurs considérations sur l'architecture du système d'exploitation, la norme de hiérarchie des fichiers (« <ulink url="&fhs;">Filesystem Hierarchy Standard</ulink> » ou FHS, qui définit où chaque fichier et répertoire doivent se trouver), etc. Le plus important pour vous est qu'elle décrive les critères que chaque paquet doit vérifier pour être inclus dans la distribution (consultez les copies locales de <filename>&policy-pdf;</filename> et <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>.)
fr: <systemitem role="package">developers-reference</systemitem> — la <ulink url="&developers-reference;">Référence du développeur Debian</ulink> concerne tout ce qui n'est pas spécifique aux détails techniques de la création de paquets, comme la structure des archives, comment renommer, abandonner, adopter les paquets, faire une NMU (« Non-Maintainer Uploads » ou mise à jour indépendante), comment gérer les bogues, les meilleures pratiques d'empaquetage, où et quand faire des envois de paquets, etc. (consultez la copie locale de <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:
fr: Les documents suivants sont <emphasis>importants</emphasis> et doivent être lus en parallèle à ce document :

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.
fr: Le <ulink url="&autotools-tutorial;">tutoriel des Autotools</ulink> fournit un très bon tutoriel pour le <ulink url="http://fr.wikipedia.org/wiki/Autotools">système de construction GNU connu sous le nom de GNU Autotools</ulink> dont les composants les plus importants sont Autoconf, Automake, Libtool et 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>.)
fr: <systemitem role="package">gnu-standards</systemitem> — ce paquet contient deux documentations issues du projet GNU : les <ulink url="&gnu-standard;">normes GNU de codage</ulink>, et les <ulink url="&gnu-maintainer;">informations pour les responsables de programme GNU</ulink>. Bien que Debian n'exige pas que ces recommandations soient suivies, elles sont néanmoins utiles en tant que lignes directrices et bon sens (consultez les copies locales de <filename>&gnu-standard-pdf;</filename> et <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>.
fr: Si ce document contredit n'importe quelle documentation précédente, celle-ci est prioritaire. Veuillez signaler un bogue sur le paquet <systemitem role="package">maint-guide</systemitem> avec <command>reportbug</command>.

note: type: Content of: <book><chapter><section><para>
en: The following is an alternative tutorial documentation which you may read along with this document:
fr: Voici d'autres tutoriels qui peuvent être lus en parallèle à ce document :

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&debpkg-tutorial0;">Debian Packaging Tutorial</ulink>
fr: <ulink url="&debpkg-tutorial0;">tutoriel d'empaquetage Debian</ulink> ;

note: type: Content of: <book><chapter><section><title>
en: Where to ask for help
fr: Où demander de l'aide

note: type: Content of: <book><chapter><section><para>
en: Before you decide to ask your question in some public place, please read the fine documentation:
fr: Avant de vous décider à poser publiquement une question, veuillez lire la documentation :

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
fr: fichiers de <filename>/usr/share/doc/<replaceable>paquet</replaceable></filename> pour tous les paquets appropriés ;

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
fr: contenu de <literal><command>man</command> <replaceable>commande</replaceable></literal> pour tous les paquets appropriées ;

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
fr: contenu de <literal><command>info</command> <replaceable>commande</replaceable></literal> pour tous les paquets appropriées ;

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>
fr: contenu des <ulink url="&debian-mentors-ldo;">archives de la liste de diffusion 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>
fr: contenu des <ulink url="&debian-devel-ldo;">archives de la liste de diffusion 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.
fr: Vous pouvez utiliser le moteur de recherche plus efficacement en indiquant des chaînes de recherche comme <literal>site:lists.debian.org</literal> pour limiter le domaine.

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.
fr: Faire un petit paquet de test est une bonne façon d'apprendre les particularités de l'empaquetage. Examiner les paquets bien maintenus est le meilleur moyen d'apprendre comment les autres font leurs paquets.

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:
fr: Si vous avez encore des questions sur la création de paquets pour lesquelles vous n'avez pas pu trouver de réponse dans la documentation disponible ou sur la toile, vous pouvez les poser de façon interactive :

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.)
fr: <ulink url="&debian-mentors-ldo;">liste de diffusion debian-mentors@lists.debian.org</ulink> (cette liste est pour les débutants) ;

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.)
fr: <ulink url="&debian-devel-ldo;">liste de diffusion debian-devel@lists.debian.org</ulink> (cette liste est pour les spécialistes) ;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&irc-debian;">IRC</ulink> such as <literal>#debian-mentors</literal>.
fr: <ulink url="&irc-debian;">IRC</ulink>, par exemple <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>)
fr: équipes se concentrant sur un ensemble particulier de paquets (liste complète à <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>)
fr: listes de diffusion de certaines langues comme debian-devel-{french,italian,portuguese,spanish}@lists.debian.org ou debian-devel@debian.or.jp (liste complète à <ulink url="&listdevel;">https://lists.debian.org/devel.html</ulink> et <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.
fr: Les responsables Debian les plus expérimentés seront heureux de vous aider, si vous demandez correctement après avoir fait les efforts nécessaires.

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>.
fr: Quand vous recevrez un rapport de bogue (oui, un vrai rapport de bogue !), vous saurez qu'il est temps de vous plonger dans le <ulink url="&bts;">système de suivi de bogues Debian</ulink> et de lire la documentation, pour être à même de gérer les rapports efficacement. La lecture de la <ulink url="&devref-bug-handling;">référence du développeur Debian, chapitre 5.8. « Manipulation des bogues »</ulink> est fortement recommandée.

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...  Just kidding.  :-)
fr: Même si tout fonctionne bien, il est temps de commencer à prier. Pourquoi ? Parce que dans quelques heures (ou jours) les utilisateurs du monde entier vont commencer à utiliser votre paquet, et si vous avez fait des erreurs critiques, vous serez bombardé par les courriers électroniques d'utilisateurs Debian furieux… :-)

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!
fr: Relaxez-vous et soyez prêt pour les rapports de bogues, parce qu'il y aura beaucoup plus de travail à faire avant que votre paquet ne soit parfaitement conforme aux règles Debian (une fois encore, lisez la <emphasis>vraie documentation</emphasis> pour les détails). Bonne chance !

note: type: Content of: <book><chapter><title>
en: First steps
fr: Premiers pas

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).
fr: Commencez par créer votre propre paquet (ou, encore mieux, par en adopter un).

note: type: Content of: <book><chapter><section><title>
en: Debian package building workflow
fr: Processus de construction de paquet 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:
fr: Si vous faites un paquet Debian à partir d'un programme amont, le processus typique de construction de paquet Debian implique de créer plusieurs fichiers au nom spécifique pour chaque étape comme suit :

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Get a copy of the upstream software, usually in a compressed tar format.
fr: obtenir une copie du logiciel amont, généralement distribuée sous la forme d'un fichier au format tar compressé :

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><literal>
en: <replaceable>package</replaceable>-<replaceable>version</replaceable>.tar.gz
fr: <replaceable>paquet</replaceable>-<replaceable>version</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.
fr: ajouter les modifications spécifiques à Debian au programme amont dans le répertoire <filename>debian</filename>, et créer un paquet source non natif (c'est-à-dire, le jeu de fichiers d'entrée utilisés pour la construction du paquet Debian) au format <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
fr: <replaceable>paquet</replaceable>_<replaceable>version</replaceable>.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
fr: <replaceable>paquet</replaceable>_<replaceable>version</replaceable>-<replaceable>révision</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.
fr: Les paquets source Debian non natifs au style plus ancien de format <literal>1.0</literal> utilisent à la place <literal><replaceable>paquet</replaceable>_<replaceable>version</replaceable>-<replaceable>révision</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
fr: <replaceable>paquet</replaceable>_<replaceable>version</replaceable>-<replaceable>révision</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.
fr: construire les paquets binaires Debian, qui sont des fichiers de paquet installable classique au format <literal>.deb</literal> (ou <literal>.udeb</literal> pour l'installateur Debian) à partir du paquet source 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
fr: <replaceable>paquet</replaceable>_<replaceable>version</replaceable>-<replaceable>révision</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.
fr: Veuillez remarquer que le caractère séparant <literal><replaceable>paquet</replaceable></literal> de <literal><replaceable>version</replaceable></literal> a été modifié : le tiret (<literal>-</literal>) dans le nom de l'archive source a été remplacée par un tiret bas (<literal>_</literal>) dans les noms de fichier de paquet 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.
fr: Consultez <ulink url="&policy-source;">5.6.1 « Source »</ulink>, <ulink url="&policy-package;">5.6.7 « Paquet »</ulink> et <ulink url="&policy-version;">5.6.12 « Version »</ulink>. L'<emphasis role="strong">architecture du paquet</emphasis> doit suivre la <ulink url="&policy-architecture;">Charte Debian, 5.6.8 « Architecture »</ulink> et est automatiquement attribuée par le processus de construction du paquet.

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"/>
fr: Dans les noms de fichier précédents, la partie <literal><replaceable>paquet</replaceable></literal> du nom de fichier est remplacé par le <emphasis role="strong">nom du paquet</emphasis>, la partie <literal><replaceable>version</replaceable></literal> par la <emphasis role="strong">version amont</emphasis>, la partie <literal><replaceable>révision</replaceable></literal> par la <emphasis role="strong">révision Debian</emphasis> et la partie <literal><replaceable>arch</replaceable></literal> par l'<emphasis role="strong">architecture du paquet</emphasis>, conformément à la Charte 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.
fr: Chaque étape de ces grandes lignes sera expliquée avec des exemples détaillés dans les sections suivantes.

note: type: Content of: <book><chapter><section><title>
en: Choose your program
fr: Choix du programme

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:
fr: Vous avez probablement choisi le paquet que vous voulez créer.  La première chose à faire est de vérifier si le paquet ne se trouve pas déjà dans l'archive de la distribution en utilisant ce qui suit :

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: the <command>aptitude</command> command
fr: la commande <command>aptitude</command> ;

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

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: the <ulink url="&packages-qa-do;">Debian Package Tracking System</ulink> web page
fr: la page du <ulink url="&packages-qa-do;">système de suivi de paquets 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>.
fr: Consultez la <ulink url="&devref-adopt;">référence du Développeur Debian 5.9.5. « Adoption de paquet »</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"/>
fr: Si le paquet existe déjà, et bien, installez-le :-). S'il se trouve qu'il est <emphasis role="strong">orphelin</emphasis> (c'est à dire si son responsable est <ulink url="&qa-do;">Debian QA Group</ulink>), vous devriez pouvoir le reprendre s'il est toujours disponible. Vous pouvez aussi adopter un paquet dont le responsable a rempli une demande d'adoption (« Request for Adoption » ou <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:
fr: Plusieurs ressources d'état de propriété de paquet Debian existent :

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&wnpp-do;">Work-Needing and Prospective Packages</ulink>
fr: <ulink url="&wnpp-do;">liste des paquets en souffrance et paquets souhaités</ulink> ;

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>
fr: <ulink url="&wnpp-bts;">journal de rapports de bogue Debian : bogues du pseudo-paquet <systemitem role="package">wnpp</systemitem> dans <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>
fr: <ulink url="&wnpp-dn;">paquets Debian en manque d'amour</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>
fr: <ulink url="&wnpp-debtags;">naviguer parmi les bogues <systemitem role="package">wnpp</systemitem> en fonction des 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.
fr: Cela dit, il existera toujours des paquets qui vaudront la peine d'être empaquetés.

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:
fr: En remarque, il est important de souligner que Debian possède déjà des paquets pour quasiment tous les types de programme, et que le nombre de paquets déjà dans l'archive Debian est bien plus important que le nombre de personnes ayant les droits suffisants pour envoyer les mises à jour. Par conséquent, contribuer aux paquets existants déjà dans l'archive est bien plus apprécié (avec plus de chances d'être parrainé) des autres développeurs <placeholder type="footnote" id="0"/>. Il est possible de contribuer de plusieurs façons comme suit :

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: taking over orphaned, yet actively used, packages
fr: se charger de paquets orphelins, encore largement utilisés ;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: joining <ulink url="&teams;">packaging teams</ulink>
fr: rejoindre des <ulink url="&teams;">équipes d'empaquetage</ulink> ;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: triaging bugs of very popular packages
fr: trier des bogues de paquets populaires ;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: preparing <ulink url="&devref-nmu;">QA or NMU uploads</ulink>
fr: préparer des <ulink url="&devref-nmu;">envois de QA ou des 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 for your case.
fr: Si vous pouvez adopter le paquet, récupérez les sources (avec quelque chose comme <literal>apt-get source <replaceable>nomdepaquet</replaceable></literal>) et examinez-les. Malheureusement ce document n'inclut pas d'informations exhaustives sur l'adoption de paquets. Heureusement, vous ne devriez pas avoir de problèmes à comprendre comment le paquet fonctionne, puisque quelqu'un s'est déjà occupé de la configuration initiale pour vous. Continuez quand même à lire ce document, une bonne partie des conseils qui suivent seront applicables dans votre cas.

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:
fr: Si le paquet est nouveau, et que vous aimeriez le voir dans Debian, procédez comme suit :

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.
fr: d'abord, assurez-vous que le programme fonctionne, et essayez-le pendant quelques temps pour confirmer son 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 - find another interesting program that nobody is maintaining.
fr: vérifiez que personne d'autre ne travaille déjà sur ce paquet en consultant la <ulink url="&wnpp-do;">liste des paquets en souffrance et paquets souhaités</ulink>. Si personne ne travaille dessus, déclarez votre intention de l'empaqueter (« Intent To Package » ou ITP) avec un bogue ITP sur le pseudo-paquet <systemitem role="package">wnpp</systemitem> en utilisant <command>reportbug</command>. Si quelqu'un travaille déjà dessus, contactez-le si vous voulez. Sinon, trouvez un autre programme intéressant dont personne ne s'occupe ;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The software <emphasis role="strong">must have a license</emphasis>.
fr: le logiciel <emphasis role="strong">doit</emphasis> avoir une licence :

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.
fr: pour la section <literal>main</literal> (principale), la Charte Debian exige qu'il <emphasis role="strong">soit totalement conforme aux principes du logiciel libre selon Debian</emphasis> (« Debian Free Software Guidelines » ou <ulink url="&dfsg;">DFSG</ulink>) et qu’<emphasis role="strong">il ne dépende pas de paquets hors de <literal>main</literal></emphasis> pour la compilation ou l'exécution. C'est le cas idéal ;

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.
fr: pour la section <literal>contrib</literal> (contributions), il doit être conforme à tous les DFSG mais peut dépendre de paquets hors de <literal>main</literal> pour la compilation ou l'exécution ;

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>.
fr: pour la section <literal>non-free</literal> (non libre), il peut être non conforme aux DFSG mais <emphasis role="strong">doit être distribuable</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.
fr: en cas de doute sur la section à laquelle il devrait appartenir, envoyez la licence sur <ulink url="&debian-legal-ldo;">debian-legal@lists.debian.org</ulink> et demandez conseil ;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The program should <emphasis role="strong">not</emphasis> introduce security and maintenance concerns to the Debian system.
fr: le programme ne devrait <emphasis role="strong">pas</emphasis> introduire dans Debian de problèmes relatifs à la sécurité et à la maintenance :

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).
fr: le programme devrait être bien documenté, et le code doit être compréhensible (c'est-à-dire, pas volontairement obscur) ;

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.
fr: vous devriez contacter les auteurs du programme pour vérifier qu'ils sont d'accord pour la création du paquet et bienveillants envers Debian. Il est important de pouvoir consulter les auteurs en cas de problèmes spécifiques au programme, n'essayez donc pas de créer un paquet à partir d'un logiciel non maintenu ;

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.
fr: le programme ne devrait certainement <emphasis role="strong">pas</emphasis> être exécuté setuid root, ou encore mieux, il ne devrait pas être setuid ou setgid pour quoi que ce soit ;

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.
fr: le programme ne devrait ni être un démon, ni s'installer dans un répertoire <filename>*/sbin</filename>, ni ouvrir un port en tant que superutilisateur.

note: type: Content of: <book><chapter><section><para>
en: Of course, the last one is just a safety measures, and intended to save you from enraging users if you do something wrong in some setuid daemon...  When you gain more experience in packaging, you'll be able to package such software.
fr: Bien sûr, cette dernière remarque n'est qu'une mesure de sécurité, et n'a pour but que de vous préserver d'utilisateurs fous de rage si vous faites une erreur dans un démon setuid… Quand vous aurez plus d'expérience dans la création de paquets, vous pourrez empaqueter un logiciel de ce type.

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.
fr: En tant que nouveau responsable vous devriez acquérir de l'expérience dans l'empaquetage de paquets plus faciles plutôt que de créer des paquets compliqués :

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Simple packages
fr: paquets simples :

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)
fr: paquet binaire unique, arch = all (collection de données comme par exemple des fonds d'écran) ;

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)
fr: paquet binaire unique, arch = all (exécutables écrits en langage interprété comme le shell POSIX) ;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Intermediate complexity packages
fr: paquet de complexité intermédiaire :

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++)
fr: paquet binaire unique, arch = any (exécutables binaires ELF provenant de langages comme C ou 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)
fr: plusieurs paquets binaires, arch = any + all (paquets pour exécutables binaires ELF et documentation) ;

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>
fr: sources amont dans un autre format que <filename>tar.gz</filename> ou <filename>tar.bz2</filename> ;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: upstream source containing undistributable contents
fr: sources amont contenant du contenu non distribuable ;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: High complexity packages
fr: paquets plus compliqués :

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: interpreter module package used by other packages
fr: paquet de module interpréteur utilisé par d'autres programmes ;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: generic ELF library package used by other packages
fr: paquet de bibliothèque générique ELF utilisé par d'autres paquets ;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: multiple binary packages including an ELF library package
fr: plusieurs paquets binaires dont un paquet de bibliothèque ELF ;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: source package with multiple upstream sources
fr: paquet source avec plusieurs sources amont ;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: kernel module packages
fr: paquets de modules du noyau ;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: kernel patch packages
fr: paquets de correctifs du noyau ;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: any package with non-trivial maintainer scripts
fr: paquets avec des scripts du responsable non triviaux.

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:
fr: Ce n'est pas si difficile d'empaqueter des paquets plus compliqués, mais cela exige un peu plus de connaissances. Vous devriez chercher de l'aide particulière pour chaque fonctionnalité compliquée. Par exemple, certains langages ont leur propre sous-charte :

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&policy-perl;">Perl policy</ulink>
fr: <ulink url="&policy-perl;">charte Perl</ulink> ;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&policy-python;">Python policy</ulink>
fr: <ulink url="&policy-python;">charte Python</ulink> ;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&policy-java;">Java policy</ulink>
fr: <ulink url="&policy-java;">charte Java</ulink>.

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"/>.
fr: Ne vous inquiétez pas du <filename>Makefile</filename> manquant. Vous pouvez installer la commande <command>hello</command> en utilisant simplement <command>debhelper</command> comme en <xref linkend="install"/>, ou en modifiant le source amont pour ajouter un nouveau <filename>Makefile</filename> avec la cible <literal>install</literal> comme en <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 followings may offer a good starting point:<placeholder type="footnote" id="0"/>
fr: Un autre vieux proverbe latin s'applique : « <emphasis>fabricando fit faber</emphasis> » (c'est en forgeant que l'on devient forgeron). La pratique et l'expérience de toutes les étapes de l'empaquetage sont <emphasis>vivement</emphasis> recommandées avec des paquets simples lors de la lecture de ce tutoriel. Une archive source amont triviale comme <filename>hello-sh-1.0.tar.gz</filename> créée comme suit peut servir de bon point de départ : <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><screen>
en: $ mkdir -p hello-sh/hello-sh-1.0; cd hello-sh/hello-sh-1.0
    $ cat &gt; hello &lt;&lt;EOF
    #!/bin/sh
    # (C) 2011 Foo Bar, GPL2+
    echo "Hello!"
    EOF
    $ chmod 755 hello
    $ cd ..
    $ tar -cvzf hello-sh-1.0.tar.gz hello-sh-1.0
fr: $ mkdir -p hello-sh/hello-sh-1.0; cd hello-sh/hello-sh-1.0
    $ cat &gt; hello &lt;&lt;EOF
    #!/bin/sh
    # (C) 2011 Truc Bidule, GPL2+
    echo "Bonjour !"
    EOF
    $ chmod 755 hello
    $ cd ..
    $ tar -cvzf hello-sh-1.0.tar.gz hello-sh-1.0

note: type: Content of: <book><chapter><section><title>
en: Get the program, and try it out
fr: Obtenir le programme et l'essayer

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.
fr: La première chose à faire est de trouver et télécharger le code source d'origine. Supposons que vous ayez déjà le fichier source pris sur la page web de l'auteur. Les sources pour les logiciels UNIX libres sont d'habitude distribués au format <command>tar</command>+<command>gzip</command> avec l'extension <filename>.tar.gz</filename>, ou au format <command>tar</command>+<command>bzip2</command> avec l'extension <filename>.tar.bz2</filename>. Elles contiennent normalement un sous-répertoire nommé <filename><replaceable>paquet</replaceable>-<replaceable>version</replaceable></filename> avec toutes les sources dedans.

note: type: Content of: <book><chapter><section><para>
en: If the latest version of the source is available through a 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.
fr: Si la dernière version de la source est disponible dans un dépôt de gestion de version tel que Git, Subversion ou CVS, vous devez la prendre avec <literal>git clone</literal>, <literal>svn co</literal>, ou <literal>cvs co</literal> et la compresser vous-même au format <command>tar</command>+<command>gzip</command> avec l'option <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.
fr: Vous pouvez identifier le format de l'archive en utilisant la commande <command>file</command> si l'extension du fichier ne suffit pas.

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.
fr: Si les sources du programme sont disponibles dans un autre format d'archive (par exemple, le programme se termine par <filename>.Z</filename> ou <filename>.zip</filename> <placeholder type="footnote" id="0"/>), vous devriez le décompresser à l'aide des outils adéquats et le recompresser.

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>.
fr: Si le programme est distribué avec du contenu non compatible avec les principes du logiciel libre selon Debian, vous devriez aussi le décompresser pour enlever ce contenu et le recompresser avec une version amont modifiée contenant <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.
fr: Ce programme est déjà empaqueté. La <ulink url="&gentoo-package;">version actuelle</ulink> utilise Autotools comme structure de construction et est substantiellement différente des exemples suivants qui étaient basés sur la version 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"/>
fr: Comme exemple, le programme nommé <command>gentoo</command> (un gestionnaire de fichiers utilisant GTK+) sera utilisé. <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:
fr: Créez un sous-répertoire dans votre répertoire personnel nommé <filename>debian</filename> ou <filename>deb</filename> ou quoi que ce soit d'adéquat (par exemple le nom du programme, <filename>~/gentoo</filename>, ferait l'affaire dans ce cas). Placez l'archive téléchargée dedans, et décompressez-la avec <literal>tar xzf gentoo-0.9.12.tar.gz</literal>. Assurez-vous qu'aucun message d'avertissement ne se produit, même <emphasis>sans importance</emphasis>, sinon les outils de décompression d'autres personnes pourraient ne pas gérer ces problèmes, et être incapables de les décompresser. La ligne de commande de votre interpréteur devrait ressembler à ceci :

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"/>).
fr: Maintenant vous avez un autre sous-répertoire, nommé <filename>gentoo-0.9.12</filename>. Allez dans ce répertoire et lisez <emphasis>attentivement</emphasis> la documentation fournie. Il s'agit généralement de fichiers nommés <filename>README*</filename>, <filename>INSTALL*</filename>, <filename>*.lsm</filename> ou <filename>*.html</filename>. Vous devez trouver les instructions pour compiler et installer le programme (elles supposent très probablement que vous voulez l'installer dans le répertoire <filename>/usr/local/bin</filename> ; ce n'est pas le cas, mais ce point sera traité plus tard en <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.
fr: Vous devriez commencer la création du paquet avec un répertoire source complètement propre (originel), ou simplement avec les sources fraîchement décompressées.

note: type: Content of: <book><chapter><section><title>
en: Simple build systems
fr: Systèmes de construction simples

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Many modern programs come with a script <filename>configure</filename> which when executed creates a <filename>Makefile</filename> customized for your system.
fr: Beaucoup de programmes récents sont livrés avec un script <filename>configure</filename> qui crée un fichier <filename>Makefile</filename> personnalisé pour le système au moment de son exécution.

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>.
fr: Des programmes simples sont généralement fournis avec un fichier <filename>Makefile</filename> et peuvent être compilés en appelant simplement <literal>make</literal>. <placeholder type="footnote" id="0"/> Certains d'entre eux gèrent <literal>make check</literal>, qui exécute des vérifications internes. L'installation dans les répertoires de destination se fait normalement avec <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.
fr: Maintenant, essayez de compiler et d'exécuter le programme, pour vous assurer qu'il fonctionne correctement et ne casse rien d'autre quand il est installé ou utilisé.

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.
fr: Sachez aussi que vous pouvez généralement utiliser <literal>make clean</literal> (ou mieux, <literal>make distclean</literal>) pour nettoyer le répertoire de compilation. Parfois, <literal>make uninstall</literal> peut être utilisé pour retirer tous les fichiers installés.

note: type: Content of: <book><chapter><section><title>
en: Popular portable build systems
fr: Systèmes de construction portables répandus

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>.
fr: De nombreux logiciels libres sont écrits en <ulink url="&c-program;">C</ulink> et <ulink url="&cxx;">C++</ulink>. Beaucoup d'entre eux utilisent les Autotools ou CMake pour les rendre portables sur différentes architectures. Ces outils de construction doivent être utilisés pour créer les <filename>Makefile</filename> et d'autres fichiers sources nécessaires. Ensuite, de tels programmes sont construits en utilisant l'habituel <literal>make; make install</literal>.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Autotools is too big to deal 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.
fr: Les Autotools sont trop importants pour être traités dans ce petit tutoriel. Cette section a seulement pour but de fournir les mots-clefs et les références. Veuillez vous assurer d'avoir lu le <ulink url="&autotools-tutorial;">tutoriel des Autotools</ulink> et la copie locale de <filename>&autotools-readme;</filename> si vous avez besoin de les utiliser.

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"/>
fr: Les <ulink url="&gnu-build-system;">Autotools</ulink> sont les outils de construction GNU. Ils comprennent <ulink url="&autoconf;">Autoconf</ulink>, <ulink url="&automake;">Automake</ulink>, <ulink url="&libtool;">Libtool</ulink> et <ulink url="&gettext;">gettext</ulink>. Vous pouvez reconnaître de telles sources à l'aide des fichiers <filename>configure.ac</filename>, <filename>Makefile.am</filename> et <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.
fr: La première étape du travail des Autotools est généralement faite par les auteurs amont qui exécutent <literal>autoreconf -i -f</literal> dans le répertoire des sources et distribuent les fichiers créés avec les sources.

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>.
fr: Modifier les fichiers <filename>configure.ac</filename> et <filename>Makefile.am</filename> nécessite un peu de connaissance de <command>autoconf</command> et <command>automake</command>. Consultez <literal>info autoconf</literal> et <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>.
fr: La deuxième étape du travail des Autotools est habituellement que les utilisateurs se procurent ces sources et exécutent <literal>./configure &amp;&amp; make</literal> dans le répertoire des sources pour compiler le programme en une commande exécutable <command><replaceable>binaire</replaceable></command>.

note: type: Content of: <book><chapter><section><screen>
en: Makefile.in -----+                +-&gt; Makefile -----+-&gt; make -&gt; <replaceable>binary</replaceable>
    src/Makefile.in -+-&gt; ./configure -+-&gt; src/Makefile -+
    config.h.in -----+                +-&gt; config.h -----+
                     |
      config.status -+
      config.guess --+
fr: Makefile.in -----+                +-&gt; Makefile -----+-&gt; make -&gt; <replaceable>binaire</replaceable>
    src/Makefile.in -+-&gt; ./configure -+-&gt; src/Makefile -+
    config.h.in -----+                +-&gt; config.h -----+
                     |
      config.status -+
      config.guess --+

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>.
fr: Vous pouvez modifier plein de choses dans le fichier <filename>Makefile</filename> ; vous pouvez, par exemple, modifier l'emplacement par défaut du répertoire d'installation en utilisant la commande <literal>./configure --prefix=/usr</literal>.

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"/>.
fr: Vous pouvez automatiser ce processus en utilisant le paquet <systemitem role="package">dh-autoreconf</systemitem>. Consultez <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"/>
fr: Bien que ce ne soit pas nécessaire, mettre à jour <filename>configure</filename> et les autres fichiers avec <literal>autoreconf -i -f</literal> peut améliorer la compatibilité des sources. <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.
fr: <ulink url="&cmake;">CMake</ulink> est un système de construction alternatif. De tels sources peuvent être reconnus avec le fichier <filename>CMakeLists.txt</filename>.

note: type: Content of: <book><chapter><section><title>
en: Package name and version
fr: Nom et version de paquet

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.
fr: Si le code source amont est distribué sous le nom de <filename>gentoo-0.9.12.tar.gz</filename>, vous pouvez prendre <literal>gentoo</literal> comme <emphasis role="strong">nom de paquet</emphasis> (source) et <literal>0.9.12</literal> comme <emphasis role="strong">version amont</emphasis>. Ces désignations seront aussi utilisées dans le fichier <filename>debian/changelog</filename> décrit plus loin dans <xref linkend="changelog"/>.

note: type: Content of: <book><chapter><section><para>
en: Although this simple approach works most of the times, 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.
fr: Même si cette simple approche fonctionne la plupart du temps, vous pourriez devoir remplacer <emphasis role="strong">nom de paquet</emphasis> et <emphasis role="strong">version amont</emphasis> en renommant les sources amont afin de suivre la Charte Debian et les conventions existantes.

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.
fr: La longueur par défaut du champ de nom de paquet dans <command>aptitude</command> est de 30 caractères. Plus de 90 % des paquets ont un nom de paquet inférieur à 24 caractères.

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 ones.  It is a good idea to keep its length within 30 characters.  <placeholder type="footnote" id="0"/>
fr: Le <emphasis role="strong">nom de paquet</emphasis> ne doit contenir que des lettres minuscules (<literal>a-z</literal>), des chiffres (<literal>0-9</literal>), les signes plus (<literal>+</literal>) ou moins (<literal>-</literal>) et des points (<literal>.</literal>). Il doit comporter au moins deux caractères, commencer par un caractère alphanumérique et ne doit pas être déjà utilisé. Il est préférable de garder sa longueur inférieure à trente caractères. <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 issues.
fr: Si vous suivez la <ulink url="&devref-newpackage;">référence du Développeur Debian 5.1. « Nouveaux paquets »</ulink>, le processus d'ITP devrait permettre de se rendre compte de ce genre de problèmes.

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"/>
fr: Si l'amont utilise quelques termes génériques comme <literal>test-suite</literal> comme nom, il vaut mieux les renommer pour identifier son contenu de façon explicite et éviter de polluer l'espace de nom. <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.
fr: Cette règle plus stricte devrait permettre d'éviter toute confusion de noms de fichier.

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.
fr: La longueur par défaut du champ de version dans <command>aptitude</command> est de 10 caractères. La révision Debian précédée par un tiret en utilise au moins 2. Plus de 80 % des paquets ont une version amont inférieure à 8 caractères et une révision Debian inférieure à 2 caractères. Plus de 90 % des paquets ont une version amont inférieure à 10 caractères et une révision Debian inférieure à 3 caractères.

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 (<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"/>
fr: La <emphasis role="strong">version amont</emphasis> ne devrait contenir que des caractères alphanumériques (<literal>0-9A-Za-z</literal>), plus (<literal>+</literal>), tildes (<literal>~</literal>) et points (<literal>.</literal>). Elle doit commencer par un chiffre (<literal>0-9</literal>). <placeholder type="footnote" id="0"/> Il est conseillé de garder sa longueur inférieure à huit caractères si possible. <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 future, use the <literal>0~YYMMDD</literal> format such as <literal>0~110429</literal> as upstream version, instead.
fr: Si l'amont n'utilise pas un système d'affectation de version classique comme <literal>2.30.32</literal> mais utilise plutôt une sorte de date comme <literal>11Apr29</literal>, un nom de code aléatoire ou une somme de hachage d'un système de gestion de versions dans la version, assurez-vous d'enlever ces parties de la <emphasis role="strong">version amont</emphasis>. Ces renseignements peuvent être enregistrés dans le fichier <filename>debian/changelog</filename>. Si vous devez inventer une version, utilisez le format <literal>AAAAMMJJ</literal>, par exemple <literal>20110429</literal>, comme numéro de version. Cela garantit que <command>dpkg</command> interprète correctement les futures versions comme des mises à niveau. Pour permettre des mises à niveau en douceur vers un schéma de version classique comme <literal>0.1</literal> dans l'avenir, utilisez plutôt la forme <literal>0~AAMMJJ</literal> comme <literal>0~110429</literal> pour la version amont.

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.
fr: Les chaînes de version peuvent être <emphasis role="strong">version amont</emphasis> (<literal><replaceable>version</replaceable></literal>), <emphasis role="strong">révision Debian</emphasis> (<literal><replaceable>révision</replaceable></literal>) ou <emphasis role="strong">version</emphasis> (<literal><replaceable>version</replaceable></literal>-<literal><replaceable>révision</replaceable></literal>). Consultez <xref linkend="newrevision"/> pour la façon dont la <emphasis role="strong">révision Debian</emphasis> est incrémentée.

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:
fr: Les chaînes de version <placeholder type="footnote" id="0"/> peuvent être comparées en utilisant <citerefentry> <refentrytitle>dpkg</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> comme suit :

note: type: Content of: <book><chapter><section><para>
en: The version comparison rule can be summarized as:
fr: La règle de comparaison de version peut être résumée par :

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Strings are compared from the head to the tail.
fr: les chaînes sont comparées en commençant par le début ;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Letters are larger than digits.
fr: les lettres sont plus grandes que les nombres ;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Numbers are compared as integers.
fr: les nombres sont comparés comme des entiers ;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Letters are compared in ASCII code order.
fr: les lettres sont comparées dans l'ordre de leur code 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:
fr: des règles particulières sont appliquées pour les points (<literal>.</literal>), plus (<literal>+</literal>) et tildes (<literal>~</literal>) comme suit :

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>.
fr: Un cas délicat se produit quand une version amont <filename>gentoo-0.9.12-ReleaseCandidate-99.tar.gz</filename> est publiée comme une préversion de <filename>gentoo-0.9.12.tar.gz</filename>. Vous devez vous assurer que la mise à niveau fonctionne correctement en renommant les sources amont en <filename>gentoo-0.9.12~rc99.tar.gz</filename>.

note: type: Content of: <book><chapter><section><title>
en: Setting up <command>dh_make</command>
fr: Configuration de <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>.
fr: Le texte qui suit présuppose que l'interpréteur de commandes que vous utilisez à la connexion est Bash. Si vous utilisez un autre interpréteur de commandes, par exemple zsh, il est nécessaire d'utiliser le fichier de configuration correspondant au lieu de <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"/>
fr: Configurez les variables d'environnement de l'interpréteur de commandes <literal>$DEBEMAIL</literal> et <literal>$DEBFULLNAME</literal> de telle sorte que plusieurs outils de maintenance Debian identifient l’adresse électronique et le nom à utiliser pour les paquets : <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><screen>
en: $ cat &gt;&gt;~/.bashrc &lt;&lt;EOF
    DEBEMAIL="your.email.address@example.org"
    DEBFULLNAME="Firstname Lastname"
    export DEBEMAIL DEBFULLNAME
    EOF
    $ . ~/.bashrc
fr: $ cat &gt;&gt;~/.bashrc &lt;&lt;EOF
    DEBEMAIL="your.email.address@example.org"
    DEBFULLNAME="Prénom Nom"
    export DEBEMAIL DEBFULLNAME
    EOF
    $ . ~/.bashrc

note: type: Content of: <book><chapter><section><title>
en: Initial non-native Debian package
fr: Paquet Debian non natif initial

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:
fr: Les paquets Debian normaux sont des paquets Debian non natifs réalisés à partir de programmes amont. Pour créer un paquet Debian non natif à partir d'une source amont <filename>gentoo-0.9.12.tar.gz</filename>, vous pouvez lui créer un paquet Debian non natif initial en appelant la commande <command>dh_make</command> comme suit :

note: type: Content of: <book><chapter><section><screen>
en: $ cd ~/gentoo
    $ wget http://example.org/gentoo-0.9.12.tar.gz
    $ tar -xvzf gentoo-0.9.12.tar.gz
    $ cd gentoo-0.9.12
    $ dh_make -f ../gentoo-0.9.12.tar.gz
fr: $ cd ~/gentoo
    $ wget http://www.example.org/gentoo-0.9.12.tar.gz
    $ tar xvzf gentoo-0.9.12.tar.gz
    $ cd gentoo-0.9.12
    $ dh_make -f ../gentoo-0.9.12.tar.gz

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 for your Debian package.
fr: Si les sources amont fournissent le répertoire <filename>debian</filename> et son contenu, exécutez la commande <command>dh_make</command> avec l'option supplémentaire <literal>--addmissing</literal>. Le nouveau format source <literal>3.0 (quilt)</literal> est suffisamment robuste pour ne pas casser même avec ces paquets. Vous pourriez avoir besoin de mettre à jour le contenu fourni en amont pour votre paquet 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.
fr: Bien sûr, remplacez le nom de fichier par celui de votre archive source d'origine. <placeholder type="footnote" id="0"/> Consultez <citerefentry> <refentrytitle>dh_make</refentrytitle> <manvolnum>8</manvolnum> </citerefentry> pour plus de précisions.

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.
fr: Il y a plusieurs choix à ce moment : <literal>s</literal> pour un seul paquet binaire, <literal>i</literal> pour un paquet binaire indépendant de l'architecture, <literal>m</literal> pour plusieurs paquets binaires, <literal>l</literal> pour un paquet de bibliothèque, <literal>k</literal> pour un paquet de module du noyau, <literal>n</literal> pour un paquet de correctif du noyau et <literal>b</literal> pour un paquet <systemitem role="package">cdbs</systemitem>. Ce document se concentre sur l'utilisation de la commande <command>dh</command> (du paquet <systemitem role="package">debhelper</systemitem>) pour créer un seul paquet binaire, mais effleure aussi son utilisation pour les paquets binaires indépendants de l'architecture ou de plusieurs paquets binaires. Le paquet <systemitem role="package">cdbs</systemitem> propose une autre infrastructure de scripts de paquet que la commande <command>dh</command> et sort du cadre de ce document.

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 - it creates only one binary package, i.e, one <filename>.deb</filename> file - 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"/>
fr: Vous devriez voir quelques questions sur le type de paquet vous voulez créer. Gentoo est un paquet binaire simple — il ne crée qu'un paquet binaire, c'est-à-dire un seul fichier <filename>.deb</filename> — donc la première option sera sélectionnée (avec la touche <literal>s</literal>). Une fois l'information vérifiée sur l'écran, confirmez en pressant <literal><replaceable>Entrée</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:
fr: Cette exécution de <command>dh_make</command> crée une copie de l'archive amont en <filename>gentoo_0.9.12.orig.tar.gz</filename> dans le répertoire parent pour permettre ensuite la création d'un paquet source Debian non natif nommé <filename>debian.tar.gz</filename> plus tard :

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>:
fr: Veuillez remarquer deux caractéristiques du nom de fichier <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).
fr: le nom de paquet et la version sont séparés par le caractère tiret bas (<literal>_</literal>) ;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The string <filename>.orig</filename> is inserted before the <filename>.tar.gz</filename>.
fr: la chaîne <filename>.orig</filename> est insérée avant le <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.
fr: Vous devriez aussi remarquer que de nombreux fichiers modèles sont créés dans les sources sous le répertoire <filename>debian</filename>. Ce sera expliqué en <xref linkend="dreq"/> et <xref linkend="dother"/>. Vous devriez aussi comprendre que l'empaquetage ne peut pas être un processus complètement automatisé. Vous aurez à modifier les sources amont pour Debian (consultez <xref linkend="modify"/>). Après cela, vous devez utiliser les méthodes correctes pour construire les paquets Debian (<xref linkend="build"/>), les vérifier (<xref linkend="checkit"/>) et les envoyer (<xref linkend="upload"/>). Toutes ces étapes seront expliquées.

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.
fr: Si vous effacez par mégarde quelques fichiers modèles en travaillant dessus, vous pouvez les retrouver en exécutant de nouveau <command>dh_make</command> avec l'option <literal>--addmissing</literal> dans une arborescence de paquet 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"/>.
fr: La mise à jour d'un paquet existant peut devenir compliquée puisqu'il pourrait utiliser d'anciennes techniques. Lors de l'apprentissage des bases, veuillez vous en tenir aux cas d'empaquetage récent ; des explications sont données plus loin en <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"/>).
fr: Veuillez noter que le fichier source ne doit pas forcément contenir de système de construction comme en <xref linkend="simplemake"/> et <xref linkend="portable"/>. Il peut simplement s'agir d'un ensemble de données graphiques par exemple. L'installation de fichiers peut être effectuée en utilisant juste les fichiers de configuration de <systemitem role="package">debhelper</systemitem> comme <filename>debian/install</filename> (consultez <xref linkend="install"/>).

note: type: Content of: <book><chapter><title>
en: Modifying the source
fr: Modification du code source

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.
fr: La place manque pour entrer dans <emphasis>tous</emphasis> les détails de modification des sources amont, mais voici quelques étapes basiques et quelques problèmes créant des difficultés.

note: type: Content of: <book><chapter><section><title>
en: Setting up <command>quilt</command>
fr: Configuration de <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:
fr: Le programme <command>quilt</command> fournit une méthode fondamentale pour enregistrer les modifications du code source amont pour l'empaquetage Debian. Il est utile d'avoir de légères personnalisations du paramétrage par défaut, configurez donc un alias <command>dquilt</command> pour l'empaquetage Debian en ajoutant les lignes suivantes à <filename>~/.bashrc</filename>. La deuxième ligne fournit les mêmes fonctionnalités de complétion de l’interpréteur pour la commande <command>dquilt</command> que pour la commande <command>quilt</command> :

note: type: Content of: <book><chapter><section><para>
en: Then let's create <filename>~/.quiltrc-dpkg</filename> as follows:
fr: Ensuite créez <filename>~/.quiltrc-dpkg</filename> comme suit :

note: type: Content of: <book><chapter><section><screen>
en: d=. ; while [ ! -d $d/debian -a `readlink -e $d` != / ]; do d=$d/..; done
    if [ -d $d/debian ] &amp;&amp; [ -z $QUILT_PATCHES ]; then
        # if in Debian packaging tree with unset $QUILT_PATCHES
        QUILT_PATCHES="debian/patches"
        QUILT_PATCH_OPTS="--reject-format=unified"
        QUILT_DIFF_ARGS="-p ab --no-timestamps --no-index --color=auto"
        QUILT_REFRESH_ARGS="-p ab --no-timestamps --no-index"
        QUILT_COLORS="diff_hdr=1;32:diff_add=1;34:diff_rem=1;31:diff_hunk=1;33:diff_ctx=35:diff_cctx=33"
        if ! [ -d $d/debian/patches ]; then mkdir $d/debian/patches; fi
    fi
fr: d=. ; while [ ! -d $d/debian -a `readlink -e $d` != / ]; do d=$d/..; done
    if [ -d $d/debian ] &amp;&amp; [ -z $QUILT_PATCHES ]; then
        # dans le cas d'une arborescence de paquet Debian avec $QUILT_PATCHES non configuré
        QUILT_PATCHES="debian/patches"
        QUILT_PATCH_OPTS="--reject-format=unified"
        QUILT_DIFF_ARGS="-p ab --no-timestamps --no-index --color=auto"
        QUILT_REFRESH_ARGS="-p ab --no-timestamps --no-index"
        QUILT_COLORS="diff_hdr=1;32:diff_add=1;34:diff_rem=1;31:diff_hunk=1;33:diff_ctx=35:diff_cctx=33"
        if ! [ -d $d/debian/patches ]; then mkdir $d/debian/patches; fi
    fi

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>.
fr: Consultez <citerefentry> <refentrytitle>quilt</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> et <filename>&quilt-pdf;</filename> pour apprendre à utiliser <command>quilt</command>.

note: type: Content of: <book><chapter><section><title>
en: Fixing upstream bugs
fr: Correction de bogues amont

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>.
fr: Si vous trouvez une erreur dans le <filename>Makefile</filename> amont comme suit, où <literal>install: gentoo</literal> aurait dû être <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.
fr: Le répertoire <filename>debian/patches</filename> devrait maintenant exister si vous avez exécuté <command>dh_make</command> comme décrit auparavant. Cet exemple de manipulation le crée seulement si vous mettez à jour un paquet existant.

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"/>
fr: Corrigez l'erreur et enregistrez-la avec la commande <command>dquilt</command> sous <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:
fr: Modifiez le fichier <filename>Makefile</filename> comme suit :

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>:
fr: Demandez à <command>dquilt</command> de créer <filename>debian/patches/fix-gentoo-target.patch</filename> et ajoutez sa description conformément à <ulink url="&dep3;">DEP-3 : Directives pour l'étiquetage des correctifs</ulink> :

note: type: Content of: <book><chapter><section><screen>
en: $ dquilt refresh
    $ dquilt header -e
    ... describe patch
fr: $ dquilt refresh
    $ dquilt header -e
    ... description du correctif

note: type: Content of: <book><chapter><section><title>
en: Installation of files to their destination
fr: Installation des fichiers à leur emplacement

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).
fr: La plupart des logiciels tiers s'installent d'eux-mêmes dans le répertoire <filename>/usr/local</filename>. Dans Debian, il est réservé à l'usage privé de l'administrateur système, les paquets ne doivent donc pas utiliser de répertoires comme <filename>/usr/local/bin</filename>, mais devraient plutôt utiliser les répertoires système comme <filename>/usr/bin</filename>, conformément à la norme de hiérarchie des fichiers (<ulink url="&fhs;">FHS</ulink>).

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.
fr: Habituellement, <citerefentry> <refentrytitle>make</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> est utilisé pour automatiser la construction du programme et l'exécution de <literal>make install</literal> installe les programmes directement à l'endroit voulu (d'après la cible <literal>install</literal> du <filename>Makefile</filename>). Pour permettre à Debian de fournir des paquets installables préconstruits, il modifie le système de construction pour installer les programmes dans une image de l'arborescence de fichiers créée dans un répertoire temporaire plutôt que dans la destination réelle.

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:
fr: Ces deux différences entre l'installation normale du programme d'un côté et le système d'empaquetage Debian de l'autre peuvent être abordées de façon transparente par le paquet <systemitem role="package">debhelper</systemitem> à l'aide des commandes <command>dh_auto_configure</command> et <command>dh_auto_install</command> si les conditions suivantes sont vérifiées :

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>.
fr: Consultez les <ulink url="&gnu-destdir;">normes GNU de codage : 7.2.4 DESTDIR : prise en charge des installations détournées</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"/>
fr: le <filename>Makefile</filename> doit suivre les conventions GNU et gérer la variable <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).
fr: les sources doivent suivre la norme de hiérarchie des fichiers (« Filesystem Hierarchy Standard » ou 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.
fr: Les programmes qui utilisent GNU <command>autoconf</command> suivent les conventions GNU automatiquement, de telle sorte qu'ils peuvent être faciles à empaqueter. Sur cette base et d'autres paramètres, on estime que le paquet <systemitem role="package">debhelper</systemitem> fonctionnera pour 90 % des paquets sans modification intrusive de leur système de construction. L'empaquetage n'est donc pas aussi compliqué qu'il y parait.

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.
fr: Si vous devez modifier le <filename>Makefile</filename>, vous devriez vous assurer qu'il gère la variable <literal>$(DESTDIR)</literal>. Bien qu'elle ne soit pas configurée par défaut, la variable <literal>$(DESTDIR)</literal> précède chaque chemin de fichier utilisé par le programme d'installation. Le script d'empaquetage configurera <literal>$(DESTDIR)</literal> en tant que répertoire temporaire.

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.
fr: Pour un paquet source créant plusieurs paquets binaires, la commande <command>dh_auto_install</command> utilise <filename>debian/tmp</filename> comme répertoire temporaire alors que la commande <command>dh_install</command>, à l'aide des fichiers <filename>debian/<replaceable>paquet-1</replaceable>.install</filename> et <filename>debian/<replaceable>paquet-2</replaceable>.install</filename>, séparera le contenu de <filename>debian/tmp</filename> dans les répertoires temporaires <filename>debian/<replaceable>paquet-1</replaceable></filename> et <filename>debian/<replaceable>paquet-2</replaceable></filename> pour créer les paquets binaires <filename><replaceable>paquet-1</replaceable>_*.deb</filename> et <filename><replaceable>paquet-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.
fr: Pour un paquet source créant un seul paquet binaire, le répertoire temporaire utilisé par la commande <command>dh_auto_install</command> sera configurée en <filename>debian/<replaceable>paquet</replaceable></filename>. <placeholder type="footnote" id="0"/> Le contenu du répertoire temporaire sera copié sur le système de l'utilisateur qui installera votre paquet, la seule différence est que <command>dpkg</command> placera ces fichiers dans des chemins relatifs au répertoire racine plutôt qu'au répertoire de travail.

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.
fr: Gardez à l'esprit que même si le programme s'installe dans <filename>debian/<replaceable>paquet</replaceable></filename>, il doit continuer à s'exécuter correctement quand il est installé à partir du paquet <filename>.deb</filename> sous le répertoire racine. Vous ne devez donc pas laisser le système de construction coder en dur des chaînes de caractères comme <literal>/home/moi/deb/<replaceable>paquet</replaceable>-<replaceable>version</replaceable>/usr/share/<replaceable>paquet</replaceable></literal> dans les fichiers du paquet.

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>.
fr: Il s'agit simplement d'un exemple pour montrer à quoi le <filename>Makefile</filename> devrait ressembler. Si le <filename>Makefile</filename> est créé par la commande <command>./configure</command>, la bonne façon de modifier ce genre de <filename>Makefile</filename> est d'exécuter <command>./configure</command> à partir de la commande <command>dh_auto_configure</command> avec les options par défaut y compris <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"/>:
fr: Voici les parties concernées du <filename>Makefile</filename> de <systemitem role="package">gentoo</systemitem> <placeholder type="footnote" id="0"/> :

note: type: Content of: <book><chapter><section><screen>
en: # Where to put executable commands on 'make install'?
    BIN     = /usr/local/bin
    # Where to put icons on 'make install'?
    ICONS   = /usr/local/share/gentoo
fr: # Emplacement des commandes exécutables lors de « make install »
    BIN     = /usr/local/bin
    # Emplacement des icônes lors de « make install »
    ICONS   = /usr/local/share/gentoo

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 to:
fr: Les fichiers sont configurés pour s'installer sous <filename>/usr/local/</filename>. Conformément aux explications précédentes, ce répertoire est réservé pour les utilisations locales de Debian, changez donc ces chemins en :

note: type: Content of: <book><chapter><section><screen>
en: # Where to put executable commands on 'make install'?
    BIN     = $(DESTDIR)/usr/bin
    # Where to put icons on 'make install'?
    ICONS   = $(DESTDIR)/usr/share/gentoo
fr: # Emplacement des commandes exécutables lors de « make install »
    BIN     = $(DESTDIR)/usr/bin
    # Emplacement des icônes lors de « make install »
    ICONS   = $(DESTDIR)/usr/share/gentoo

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.
fr: Les emplacements exacts qui devraient être utilisés pour les exécutables, icônes, documentation, etc., sont décrits dans la norme de hiérarchie des fichiers (FHS). Vous devriez la consulter et lire les sections relatives à votre paquet.

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>.
fr: Dès lors, les commandes exécutables devraient être installées sous <filename>/usr/bin</filename> plutôt que sous <filename>/usr/local/bin</filename>, la page de manuel sous <filename>/usr/share/man/man1</filename> plutôt que sous <filename>/usr/local/man/man1</filename> et ainsi de suite. Remarquez qu'il n'y a pas de page de manuel mentionnée dans le fichier <filename>Makefile</filename> de <systemitem role="package">gentoo</systemitem>, mais comme la Charte Debian exige que chaque programme en ait une, il faudra en créer une plus tard et l'installer dans <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:
fr: Certains programmes n'utilisent pas les variables des fichiers <filename>Makefile</filename> pour définir des chemins comme ceux-ci. Cela signifie que vous risquez de devoir modifier de vrais fichiers sources C pour qu'ils utilisent les emplacements corrects. Mais où, et que chercher exactement ? Vous pouvez le découvrir avec :

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.
fr: <command>grep</command> va parcourir récursivement l'arbre des sources et donner le nom des fichiers et le numéro des lignes où il trouve une occurrence.

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:
fr: Modifiez ces fichiers en remplaçant dans ces lignes, <literal>usr/local/lib</literal> par <literal>usr/lib</literal>. Cela peut être automatisé comme suit :

note: type: Content of: <book><chapter><section><para>
en: If you want to confirm each substitution instead, this can be done interactively as follows:
fr: Afin de confirmer toutes les substitutions, vous pouvez procéder de façon interactive comme suit :

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>.
fr: Ensuite, vous devriez trouver la cible <literal>install</literal> (chercher la ligne qui commence par <literal>install:</literal> fonctionne en général) et renommez toutes les références aux répertoires autres que ceux définis au début du <filename>Makefile</filename>.

note: type: Content of: <book><chapter><section><para>
en: Originally, <systemitem role="package">gentoo</systemitem>'s <literal>install</literal> target said:
fr: À l'origine, la cible <literal>install</literal> de <systemitem role="package">gentoo</systemitem> était de la forme :

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>.
fr: Corrigez ce bogue amont et enregistrez la modification avec la commande <command>dquilt</command> sous <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:
fr: Dans votre éditeur, modifiez cela pour le paquet Debian comme suit :

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.
fr: Vous aurez remarqué qu'il y a maintenant une commande <literal>install -d</literal> avant les autres dans la règle. Elle n'existait pas dans le <filename>Makefile</filename> d'origine parce qu'habituellement <literal>/usr/local/bin</literal> et les autres répertoires existent déjà sur le système dans lequel <literal>make install</literal> est exécuté. Cependant, puisque dans notre cas l'installation se fait dans une arborescence spécifique nouvellement créée, chacun de ces répertoires doit être créé.

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:
fr: D'autres choses peuvent être ajoutés à la fin de la règle, comme l'installation de la documentation additionnelle que l'auteur amont oublie parfois :

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:
fr: Vérifiez soigneusement, et si tout est bon, demandez à <command>dquilt</command> de créer le correctif <filename>debian/patches/install.patch</filename> et ajoutez sa description :

note: type: Content of: <book><chapter><section><para>
en: Now you have a series of patches.
fr: Vous avez maintenant un ensemble de correctifs.

note: type: Content of: <book><chapter><section><orderedlist><listitem><para>
en: Upstream bug fix: <filename>debian/patches/fix-gentoo-target.patch</filename>
fr: correction d'un bogue amont : <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>
fr: modification spécifique à l'empaquetage 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 - or even Unix! Make them portable.  This will make your fixes much easier to apply.
fr: Chaque fois que vous faites des modifications qui ne sont pas spécifiques à Debian comme <filename>debian/patches/fix-gentoo-target.patch</filename>, envoyez-les au responsable amont pour qu'elles puissent être intégrées dans la version suivante du programme et que tout le monde puisse en profiter. Évitez aussi de faire des corrections spécifiques à Debian ou Linux — ou même UNIX ! Faites-les portables. Cela rendra vos corrections beaucoup plus faciles à appliquer.

note: type: Content of: <book><chapter><section><para>
en: Note that you don't have to send the <filename>debian/*</filename> files upstream.
fr: Remarquez que vous ne devez pas envoyer les fichiers <filename>debian/*</filename> en amont.

note: type: Content of: <book><chapter><section><title>
en: Differing libraries
fr: Bibliothèques différentes

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 which doesn't exist on the Debian system.  In that case, we need to change it to a library which does exist in Debian, and serves the same purpose.
fr: Il y a un autre problème courant : des bibliothèques sont souvent différentes d'une plate-forme à l'autre. Par exemple, <filename>Makefile</filename> peut contenir une référence à une bibliothèque qui n'existe pas sur le système Debian. Dans ce cas, remplacez-la par une bibliothèque qui existe dans Debian, et qui sert à la même chose.

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.
fr: Supposons qu'une ligne de <filename>Makefile</filename> (ou <filename>Makefile.in</filename>) du programme comme suit :

note: type: Content of: <book><chapter><section><screen>
en: LIBS = -lfoo -lbar
fr: LIBS = -ltruc -lbidule

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.
fr: Si des modifications de l'API existent entre les bibliothèques <literal>truc</literal> et <literal>truc2</literal>, les modifications nécessaires au code source doivent être faites pour correspondre à la nouvelle 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"/>
fr: Si votre programme ne compile pas depuis que la bibliothèque <literal>truc</literal> n'existe plus et que son équivalent est fournie par la bibliothèque <literal>truc2</literal> sur le système Debian, vous pouvez corriger ce problème de construction en <filename>debian/patches/truc2.patch</filename> en modifiant <literal>truc</literal> en <literal>truc2</literal> : <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><screen>
en: $ dquilt new foo2.patch
    $ dquilt add Makefile
    $ sed -i -e 's/-lfoo/-lfoo2/g' Makefile
    $ dquilt refresh
    $ dquilt header -e
    ... describe patch
fr: $ dquilt new truc2.patch
    $ dquilt add Makefile
    $ sed -i -e 's/-ltruc/-ltruc2/g' Makefile
    $ dquilt refresh
    $ dquilt header -e
    ... description du correctif

note: type: Content of: <book><chapter><title>
en: Required files under the <filename>debian</filename> directory
fr: Fichiers nécessaires dans le répertoire <filename>debian</filename>

note: type: Content of: <book><chapter><para><footnote><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.
fr: Dans ce chapitre, <filename>debian/</filename> est omis pour simplifier l'écriture des fichiers du répertoire <filename>debian</filename> quand la signification n'est pas ambiguë.

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"/>
fr: Un nouveau sous-répertoire se trouve dans le répertoire des sources du programme, nommé <filename>debian</filename>. Certains fichiers de ce répertoire sont à modifier pour personnaliser le comportement du paquet. Les plus importants sont <filename>control</filename>, <filename>changelog</filename>, <filename>copyright</filename> et <filename>rules</filename>, ils sont nécessaires pour tous les paquets. <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>.
fr: Ce fichier contient plusieurs valeurs utilisées par <command>dpkg</command>, <command>dselect</command>, <command>apt-get</command>, <command>apt-cache</command>, <command>aptitude</command> et d'autres outils de gestion de paquets pour gérer le paquet. Cela est défini par la <ulink url="&policy-control;">Charte Debian, 5 « Fichiers de contrôle et leurs champs »</ulink>.

note: type: Content of: <book><chapter><section><para>
en: Here is the <filename>control</filename> file <command>dh_make</command> created for us:
fr: Le fichier <filename>control</filename> créé par <command>dh_make</command> ressemble à :

note: type: Content of: <book><chapter><section><screen>
en:  1 Source: gentoo
     2 Section: unknown
     3 Priority: extra
     4 Maintainer: Josip Rodin &lt;joy-mg@debian.org&gt;
     5 Build-Depends: debhelper (&gt;=9)
     6 Standards-Version: 3.9.4
     7 Homepage: &lt;insert the upstream URL, if relevant&gt;
     8
     9 Package: gentoo
    10 Architecture: any
    11 Depends: ${shlibs:Depends}, ${misc:Depends}
    12 Description: &lt;insert up to 60 chars description&gt;
    13  &lt;insert long description, indented with spaces&gt;
fr:  1 Source: gentoo
     2 Section: unknown
     3 Priority: extra
     4 Maintainer: Prénom Nom &lt;votre.adresse.mail@example.org&gt;
     5 Build-Depends: debhelper (&gt;=9)
     6 Standards-Version: 3.9.4
     7 Homepage: &lt;URL amont, si pertinente&gt;
     8
     9 Package: gentoo
    10 Architecture: any
    11 Depends: ${shlibs:Depends}, ${misc:Depends}
    12 Description: &lt;description courte de 60 caractères au maximum&gt;
    13  &lt;description longue, indentée par des espaces&gt;

note: type: Content of: <book><chapter><section><para>
en: (I've added the line numbers.)
fr: (Les numéros de ligne ont été ajoutés.)

note: type: Content of: <book><chapter><section><para>
en: Lines 1-7 are the control information for the source package.  Lines 9-13 are the control information for the binary package.
fr: Les lignes 1 à 7 sont les informations de contrôle pour le paquet source. Les lignes 9 à 13 sont les informations de contrôle pour le paquet binaire.

note: type: Content of: <book><chapter><section><para>
en: Line 1 is the name of the source package.
fr: La ligne 1 est le nom du paquet source.

note: type: Content of: <book><chapter><section><para>
en: Line 2 is the section of the distribution the source package goes into.
fr: La ligne 2 est la section de la distribution à laquelle ce paquet appartient.

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>.
fr: Consultez la <ulink url="&policy-subsections;">Charte Debian, 2.4 « Sections »</ulink> et la <ulink url="&sections-unstable;">liste des sections dans <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"/>
fr: Comme vous avez pu le constater, l'archive Debian est divisée en plusieurs parties : <literal>main</literal> (logiciels libres), <literal>non-free</literal> (logiciels non libres), et <literal>contrib</literal> (logiciels libres qui dépendent de logiciels non libres). Chacune d'entre elles est divisée en sections qui classent les paquets en catégories grossières. Entre autres existent <literal>admin</literal> pour les programmes destinés aux administrateurs, <literal>devel</literal> pour les outils de programmation, <literal>doc</literal> pour la documentation, <literal>libs</literal> pour les bibliothèques, <literal>mail</literal> pour les lecteurs et les démons de courrier électronique, <literal>net</literal> pour les applications et démons de réseau, <literal>x11</literal> pour les programmes X11 qui ne conviennent pas mieux ailleurs, et bien d'autres. <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.)
fr: Changez la section en x11 (le préfixe <literal>main/</literal> est implicite, et peut donc être omis).

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&policy-priorities;">Debian Policy Manual, 2.5 "Priorities"</ulink>.
fr: Consultez la <ulink url="&policy-priorities;">Charte Debian, 2.5 « Priorités »</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"/>
fr: La ligne 3 décrit l'importance pour l'utilisateur d'installer ce paquet : <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.
fr: la priorité <literal>optional</literal> fonctionne habituellement pour les nouveaux paquets qui ne sont pas en conflit avec d'autres se réclamant de priorité <literal>required</literal>, <literal>important</literal> ou <literal>standard</literal> ;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The <literal>extra</literal> priority will usually work for new packages that conflict with others with non-<literal>extra</literal> priorities.
fr: la priorité <literal>extra</literal> fonctionne habituellement pour les nouveaux paquets qui sont en conflit avec d'autres de priorité non <literal>extra</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.
fr: Les sections et les priorités sont utilisées par des interfaces comme <command>aptitude</command> quand elles trient les paquets et sélectionnent les valeurs par défaut. Quand vous enverrez le paquet dans Debian, les valeurs de ces deux champs peuvent être modifiées par les responsables des archives, auquel cas vous serez notifié par courrier.

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>.
fr: Comme c'est un paquet de priorité normale et qu'il n'entre pas en conflit avec quoi que ce soit, il suffit de laisser la priorité à <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.
fr: La ligne 4 est le nom et l'adresse électronique du responsable. Assurez-vous que ce champ contient un en-tête <literal>To</literal> valable pour un courrier électronique, car après l'envoi du paquet, le système de suivi des bogues l'utilisera pour vous distribuer les courriers relatifs aux bogues. Évitez d'utiliser les virgules, esperluettes (<literal>&amp;</literal>) ou parenthèses.

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>.
fr: Consultez la <ulink url="&policy-relationships;#s-sourcebinarydeps">Charte Debian, 7.7 « Relations entre paquets source et binaires — 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.
fr: La ligne 5 contient la liste des paquets nécessaires pour construire le paquet dans le champ <literal>Build-Depends</literal>. Le champ <literal>Build-Depends-Indep</literal> peut-être ajouté dans une ligne supplémentaire. <placeholder type="footnote" id="0"/> Certains paquets comme <systemitem role="package">gcc</systemitem> ou <systemitem role="package">make</systemitem> sont implicites, puisqu'ils dépendent de <systemitem role="package">build-essential</systemitem>. Si d'autres outils sont nécessaires pour construire le paquet, vous devez les ajouter à ces champs. Les multiples éléments sont séparées par des virgules ; lisez ci-après les explications sur les dépendances entre paquets binaires pour mieux comprendre la syntaxe de ces lignes :

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.
fr: pour tous les paquets empaquetés avec la commande <command>dh</command> dans le fichier <filename>debian/rules</filename>, <literal>debhelper (&gt;=9)</literal> doit faire partie du champ <literal>Build-Depends</literal> pour être conforme à la Charte Debian au sujet de la cible <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.
fr: les paquets source de paquets binaires avec <literal>Architecture: any</literal> sont reconstruits par les empaqueteurs automatiques (« autobuilder »). Puisque la procédure des serveurs d'empaquetage automatique installe seulement les paquets indiqués dans le champ <literal>Build-Depends</literal> avant d'exécuter <literal>debian/rules build</literal> (consultez <xref linkend="autobuilder"/>), ce champ <literal>Build-Depends</literal> doit indiquer pratiquement tous les paquets nécessaires et <literal>Build-Depends-Indep</literal> est rarement utilisé ;

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.
fr: pour les paquets source de paquets binaires dont tous sont <literal>Architecture: all</literal>, le champ <literal>Build-Depends-Indep</literal> peut indiquer tous les paquets nécessaires à moins qu'ils ne soient déjà indiqués dans le champ <literal>Build-Depends</literal> pour être conforme à la Charte Debian au sujet de la cible <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>.
fr: Cette situation quelque peu étrange est une fonctionnalité bien expliquée dans la <ulink url="&policy-build-depends-indep;">Charte Debian, note de bas de page 55</ulink>. Ce n'est pas lié à l'utilisation de la commande <command>dh</command> dans le fichier <filename>debian/rules</filename> mais au fonctionnement de <command>dpkg-buildpackage</command>. La même situation s'applique au <ulink url="https://bugs.launchpad.net/launchpad-buildd/+bug/238141">système de construction automatique pour 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"/>
fr: En cas de doute, utilisez le champ <literal>Build-Depends</literal> pour être sûr.  <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:
fr: Pour déterminer les paquets nécessaires à la construction, exécutez la commande :

note: type: Content of: <book><chapter><section><para>
en: To manually find exact build dependencies for <command><replaceable>/usr/bin/foo</replaceable></command>, execute
fr: Pour déterminer manuellement les dépendances de construction exactes pour <command><replaceable>/usr/bin/toto</replaceable></command>, exécutez :

note: type: Content of: <book><chapter><section><screen>
en: $ objdump -p <replaceable>/usr/bin/foo</replaceable> | grep NEEDED
fr: $ objdump -p <replaceable>/usr/bin/toto</replaceable> | grep NEEDED

note: type: Content of: <book><chapter><section><para>
en: and for each library listed, e.g., <command>libfoo.so.6</command>, execute
fr: et pour chaque bibliothèque affichée, par exemple <command>libtoto.so.6</command>, exécutez

note: type: Content of: <book><chapter><section><screen>
en: $ dpkg -S libfoo.so.6
fr: $ dpkg -S libtoto.so.6

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.
fr: Ajoutez ensuite simplement la version <literal>-dev</literal> de chaque paquet dans le champ <literal>Build-Depends</literal>. Si vous utilisez <command>ldd</command> à cet effet, des dépendances de bibliothèque indirectes seront indiquées, introduisant un problème de dépendances de construction excessives.

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>.
fr: <systemitem role="package">gentoo</systemitem> a aussi besoin de <systemitem role="package">xlibs-dev</systemitem>, <systemitem role="package">libgtk1.2-dev</systemitem> et <systemitem role="package">libgl1.2-dev</systemitem> pour être construit, ils doivent donc être ajoutés à côté de <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.
fr: La ligne 6 est la version de la <ulink url="&debian-policy;">Charte Debian</ulink> que ce paquet respecte, celle que vous lisez quand vous créez le paquet.

note: type: Content of: <book><chapter><section><para>
en: On line 7 you can put the URL of the software's upstream homepage.
fr: En ligne 7 vous pouvez indiquer l'URL de la page d'accueil du programme amont.

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.
fr: La ligne 9 est le nom du paquet binaire. C'est d'ordinaire le même que le nom du paquet source, mais ce n'est pas nécessairement le cas.

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.
fr: Consultez la <ulink url="&policy-architecture;">Charte Debian, 5.6.8 « Architecture »</ulink> pour de plus amples précisions.

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"/>
fr: La ligne 10 décrit les architectures pour lesquelles le paquet binaire peut être compilé. Cette valeur est en général un des suivantes en fonction du type de paquet binaire : <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.
fr: le paquet binaire créé dépend de l'architecture, en général dans un langage compilé ;

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.
fr: le paquet binaire créé est indépendant de l'architecture, en général du texte, des images ou des scripts en langage interprété.

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.
fr: La ligne 10 est laissée telle quelle car c'est écrit en C. <citerefentry><refentrytitle>dpkg-gencontrol</refentrytitle><manvolnum>1</manvolnum></citerefentry> indiquera la valeur d'architecture appropriée pour chaque machine sur laquelle ce paquet source sera compilé.

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.
fr: Si le paquet est indépendant d'une architecture (par exemple, un script shell ou Perl, ou un document), changez ce paramètre en <literal>all</literal>, et lisez plus loin en <xref linkend="rules"/> comment utiliser la règle <literal>binary-indep</literal> au lieu de <literal>binary-arch</literal> pour construire le paquet.

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>.
fr: La ligne 11 montre une des caractéristiques les plus puissantes du système de paquet Debian. Les paquets peuvent être liés entre eux de plusieurs façons. Hormis <literal>Depends</literal>, les autres champs décrivant ces relations sont <literal>Recommends</literal>, <literal>Suggests</literal>, <literal>Pre-Depends</literal>, <literal>Breaks</literal>, <literal>Conflicts</literal>, <literal>Provides</literal> et <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.)
fr: Les outils de gestion de paquets se comportent d'ordinaire de la même manière quand ils gèrent ces relations ; sinon, ce sera précisé (consultez <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.)

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>.
fr: Consultez la <ulink url="&policy-priorities;">Charte Debian, 7 « Déclaration de relations entre paquets »</ulink>.

note: type: Content of: <book><chapter><section><para>
en: Here is a simplified description of package relationships: <placeholder type="footnote" id="0"/>
fr: Voici une description simplifiée des relations entre paquets : <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.
fr: le paquet ne sera pas installé sans que les paquets dont il dépend ne soient installés. Utilisez-le si le programme ne s'exécute absolument pas (ou cause des dégâts sérieux) si un paquet particulier n'est pas présent ;

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.
fr: à utiliser pour les paquets qui ne sont pas vraiment indispensables mais qui sont généralement utilisés avec le programme. Lorsqu'un utilisateur installe le paquet, toutes les interfaces devraient proposer d'installer les paquets recommandés. <command>aptitude</command> et <command>apt-get</command> installent par défaut les paquets recommandés avec le paquet (mais l'utilisateur peut désactiver ce comportement). <command>dpkg</command> ignorera ce champ ;

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.
fr: à utiliser pour les paquets qui fonctionnent bien avec le programme mais qui ne sont pas du tout indispensables. Lorsqu'un utilisateur installe le programme, il ne lui sera probablement pas proposé d'installer les paquets suggérés. <command>aptitude</command> peut être configuré pour installer les paquets suggérés avec le paquet mais ce n'est pas le comportement par défaut. <command>dpkg</command> et <command>apt-get</command> ignoreront ce champ ;

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.  :-)
fr: cela est plus fort que <literal>Depends</literal>. Le paquet ne sera pas installé avant que les paquets dont il pré-dépend ne soient installés et <emphasis>correctement configurés</emphasis>. Utilisez-le <emphasis>très</emphasis> rarement et seulement après en avoir discuté sur la liste de discussion <ulink url="&debian-devel-ldo;">debian-devel@lists.debian.org</ulink>. Autrement dit : ne l'utilisez pas du tout ; :-)

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.
fr: le paquet ne sera pas installé tant que les paquets avec lesquels il est en conflit n'aient été retirés. À utiliser si le programme ne peut absolument pas fonctionner ou s'il cause d'énormes problèmes quand un paquet particulier est présent ;

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.
fr: les paquets énumérés seront cassés une fois que le paquet ait été installé. En général, une entrée <literal>Breaks</literal> indique qu'elle s'applique aux versions antérieures à une certaine valeur. La résolution de conflit se fait en utilisant des gestionnaires de paquets de haut niveau pour généralement à mettre à niveau les paquets énumérés ;

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.
fr: quand il y a plusieurs alternatives pour certains types de paquets, des noms virtuels ont été définis. La liste complète est disponible dans le fichier <ulink url="&virtual-package;">virtual-package-names-list.txt.gz</ulink>. À utiliser si le programme fournit une fonction d'un paquet virtuel existant ;

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.
fr: à utiliser quand le programme remplace des fichiers d'un autre paquet, ou remplace complètement un autre paquet (utilisé en conjonction avec <literal>Conflicts</literal>).  Les fichiers du paquet nommé seront écrasés par les fichiers de votre paquet.

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).
fr: Tous ces champs ont une syntaxe uniforme. Il s'agit d'une liste de paquets séparés par des virgules. Ces noms de paquets peuvent aussi être une liste d'alternatives, séparées par des barres verticales <literal>|</literal> (symbole tube ou « 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,
fr: Le domaine d'application des champs peut être restreint à des versions particulières de chaque paquet nommé. La restriction de chaque paquet particulier est indiquée entre parenthèses après son nom, et devrait contenir une relation dans la liste suivante suivie par une valeur de numéro de version. Les relations autorisées sont <literal>&lt;&lt;</literal>, <literal>&lt;=</literal>, <literal>=</literal>, <literal>&gt;=</literal> et <literal>&gt;&gt;</literal> (respectivement : strictement plus petit, plus petit ou égal, exactement égal, plus grand ou égal et strictement plus grand). Par exemple :

note: type: Content of: <book><chapter><section><screen>
en: Depends: foo (&gt;= 1.2), libbar1 (= 1.3.4)
    Conflicts: baz
    Recommends: libbaz4 (&gt;&gt; 4.0.7)
    Suggests: quux
    Replaces: quux (&lt;&lt; 5), quux-foo (&lt;= 7.6)
fr: Depends: toto (&gt;= 1.2), libbidule1 (= 1.3.4)
    Conflicts: machin
    Recommends: libmachin4 (&gt;&gt; 4.0.7)
    Suggests: truc
    Replaces: truc (&lt;&lt; 5), truc-toto (&lt;= 7.6)

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.
fr: La dernière fonctionnalité à connaître est <literal>${shlibs:Depends}</literal>, <literal>${perl:Depends}</literal>, <literal>${misc:Depends}</literal>, etc.

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>.
fr: <citerefentry> <refentrytitle>dh_shlibdeps</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> calcule les dépendances en bibliothèques partagées pour les paquets binaires. Il crée une liste d'exécutables <ulink url="&elf;">ELF</ulink> et de bibliothèques partagées trouvées pour chaque paquet binaire. Cette liste est utilisée en remplacement de <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>.
fr: <citerefentry> <refentrytitle>dh_perl</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> calcule les dépendances de Perl. Il crée une liste de dépendances vers <literal>perl</literal> ou <literal>perlapi</literal> pour chaque paquet binaire. Cette liste est utilisée en remplacement de <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>.
fr: Certaines commandes de <systemitem role="package">debhelper</systemitem> peuvent rendre le paquet créé dépendant de paquets supplémentaires. Toutes ces commandes créent une liste de paquets nécessaires pour chaque paquet binaire. Cette liste est utilisée en remplacement de <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.
fr: <citerefentry> <refentrytitle>dh_gencontrol</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> crée <filename>DEBIAN/control</filename> pour chaque paquet binaire en substituant <literal>${shlibs:Depends}</literal>, <literal>${perl:Depends}</literal>, <literal>${misc:Depends}</literal>, etc.

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.
fr: Cela dit, le champ <literal>Depends</literal> peut rester exactement comme il est maintenant, et une autre ligne avec <literal>Suggests: file</literal> peut être ajoutée, car <systemitem role="package">gentoo</systemitem> peut utiliser certaines fonctionnalités fournies par le paquet <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;"/>.
fr: La ligne 9 est l'URL de la page d'accueil. Supposons qu'il s'agisse de <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>.
fr: La ligne 12 est la description courte. Les terminaux sont larges de 80 colonnes par convention, aussi elle ne devrait pas dépasser les 60 caractères. <literal>fully GUI-configurable, two-pane X file manager</literal> convient ici.

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>.
fr: Ces descriptions sont en anglais. Les traductions de ces descriptions sont fournies par <ulink url="&ddtp;">Le projet de traduction de descriptions de Debian — 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"/>
fr: À la ligne 13 commence la description longue. Celle-ci devrait être un paragraphe qui donne plus de détails sur le paquet. La colonne 1 de chaque ligne doit être vide. Il ne peut y avoir de ligne vide, mais vous pouvez mettre un seul <literal>.</literal> (point) dans la colonne 2 pour simuler une ligne vide. De plus, il ne peut pas y avoir plus d'une ligne vide après la description longue. <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>.
fr: Consultez la <ulink url="&devref-bpp-vcs;">référence du Développeur Debian, 6.2.5. « Emplacement du système de gestion de versions »</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>.
fr: Le champ <literal>Vcs-*</literal> pour documenter le système de gestion de versions (VCS) peut être inséré entre les lignes 6 et 7. <placeholder type="footnote" id="0"/> Considérons que le paquet <systemitem role="package">gentoo</systemitem> a son VCS localisé sur le service Git d'Alioth en <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:
fr: Finalement, voici le fichier <filename>control</filename> mis à jour :

note: type: Content of: <book><chapter><section><screen>
en:  1 Source: gentoo
     2 Section: x11
     3 Priority: optional
     4 Maintainer: Josip Rodin &lt;joy-mg@debian.org&gt;
     5 Build-Depends: debhelper (&gt;=9), xlibs-dev, libgtk1.2-dev, libglib1.2-dev
     6 Standards-Version: 3.9.4
     7 Vcs-Git: git://git.debian.org/git/collab-maint/gentoo.git
     8 Vcs-browser: http://git.debian.org/?p=collab-maint/gentoo.git
     9 Homepage: &gentoo;
    10
    11 Package: gentoo
    12 Architecture: any
    13 Depends: ${shlibs:Depends}, ${misc:Depends}
    14 Suggests: file
    15 Description: fully GUI-configurable, two-pane X file manager
    16  gentoo is a two-pane file manager for the X Window System. gentoo lets the
    17  user do (almost) all of the configuration and customizing from within the
    18  program itself. If you still prefer to hand-edit configuration files,
    19  they're fairly easy to work with since they are written in an XML format.
    20  .
    21  gentoo features a fairly complex and powerful file identification system,
    22  coupled to an object-oriented style system, which together give you a lot
    23  of control over how files of different types are displayed and acted upon.
    24  Additionally, over a hundred pixmap images are available for use in file
    25  type descriptions.
    26  .
    29  gentoo was written from scratch in ANSI C, and it utilizes the GTK+ toolkit
    30  for its interface.
fr:  1 Source: gentoo
     2 Section: x11
     3 Priority: optional
     4 Maintainer: Prénom Nom &lt;votre.adresse.mail@example.org&gt;
     5 Build-Depends: debhelper (&gt;=9), xlibs-dev, libgtk1.2-dev, libglib1.2-dev
     6 Standards-Version: 3.9.4
     7 Vcs-Git: git://git.debian.org/git/collab-maint/gentoo.git
     8 Vcs-browser: http://git.debian.org/?p=collab-maint/gentoo.git
     9 Homepage: &gentoo;
    10
    11 Package: gentoo
    12 Architecture: any
    13 Depends: ${shlibs:Depends}, ${misc:Depends}
    14 Suggests: file
    15 Description: fully GUI-configurable, two-pane X file manager
    16  gentoo is a two-pane file manager for the X Window System. gentoo lets the
    17  user do (almost) all of the configuration and customizing from within the
    18  program itself. If you still prefer to hand-edit configuration files,
    19  they're fairly easy to work with since they are written in an XML format.
    20  .
    21  gentoo features a fairly complex and powerful file identification system,
    22  coupled to an object-oriented style system, which together give you a lot
    23  of control over how files of different types are displayed and acted upon.
    24  Additionally, over a hundred pixmap images are available for use in file
    25  type descriptions.
    26  .
    29  gentoo was written from scratch in ANSI C, and it utilizes the GTK+ toolkit
    30  for its interface.

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.
fr: Ce fichier contient des renseignements sur le copyright et la licence des sources amont. La <ulink url="&policy-copyright;">Charte Debian, 12.5 « Informations sur le copyright »</ulink> impose son contenu et la <ulink url="&dep5;">DEP-5 : <filename>debian/copyright</filename> analysable automatiquement</ulink> fournit des directives pour son format.

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.
fr: <command>dh_make</command> peut proposer un modèle de fichier <filename>copyright</filename>. L'option <literal>--copyright gpl2</literal> peut être utilisée ici pour obtenir un modèle de fichier pour le paquet <systemitem role="package">gentoo</systemitem> publié sous GPL-2.

note: type: Content of: <book><chapter><section><para>
en: You must fill in missing information to complete this file, such as the place you got the package from, the actual copyright notice, and the license.  For certain common free software licenses (GNU GPL-1, GNU GPL-2, GNU GPL-3, LGPL-2, LGPL-2.1, LGPL-3, GNU FDL-1.2, GNU FDL-1.3, Apache-2.0, or the Artistic license), you can just refer to the appropriate file in the <filename>/usr/share/common-licenses/</filename> directory that exists on every Debian system.  Otherwise, you must include the complete license.
fr: Les choses à ajouter obligatoirement à ce fichier sont l'endroit où vous avez trouvé ce paquet, ainsi que le copyright et la licence d'exploitation réelle. Si la licence est une des licences de logiciel libre populaires (GNU GPL-1, GNU GPL-2, GNU GPL-3, LGPL-2, LGPL-2.1, LGPL-3, GNU FDL-1.2, GNU FDL-1.3, Apache ou Artistic), vous pouvez juste faire référence au fichier approprié dans le répertoire <filename>/usr/share/common-licenses/</filename>, qui existe sur chaque système Debian. Sinon, vous devez inclure la licence en entier.

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:
fr: En bref, voici ce à quoi le fichier <filename>copyright</filename> de <systemitem role="package">gentoo</systemitem> devrait ressembler :

note: type: Content of: <book><chapter><section><screen>
en:  1 Format-Specification: http://svn.debian.org/wsvn/dep/web/deps/dep5.mdwn?op=file&amp;rev=135
     2 Name: gentoo
     3 Maintainer: Josip Rodin &lt;joy-mg@debian.org&gt;
     4 Source: http://sourceforge.net/projects/gentoo/files/
     5
     6 Copyright: 1998-2010 Emil Brink &lt;emil@obsession.se&gt;
     7 License: GPL-2+
     8
     9 Files: icons/*
    10 Copyright: 1998 Johan Hanson &lt;johan@tiq.com&gt;
    11 License: GPL-2+
    12
    13 Files: debian/*
    14 Copyright: 1998-2010 Josip Rodin &lt;joy-mg@debian.org&gt;
    15 License: GPL-2+
    16
    17 License: GPL-2+
    18  This program is free software; you can redistribute it and/or modify
    19  it under the terms of the GNU General Public License as published by
    20  the Free Software Foundation; either version 2 of the License, or
    21  (at your option) any later version. 
    22  .
    23  This program is distributed in the hope that it will be useful,
    24  but WITHOUT ANY WARRANTY; without even the implied warranty of
    25  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
    26  GNU General Public License for more details.
    27  .
    28  You should have received a copy of the GNU General Public License along
    29  with this program; if not, write to the Free Software Foundation, Inc.,
    30  51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
    31  .
    32  On Debian systems, the full text of the GNU General Public
    33  License version 2 can be found in the file
    34  `/usr/share/common-licenses/GPL-2'.
fr:  1 Format-Specification: http://svn.debian.org/wsvn/dep/web/deps/dep5.mdwn?op=file&amp;rev=135
     2 Name: gentoo
     3 Maintainer: Prénom Nom &lt;votre.adresse.mail@example.org&gt;
     4 Source: http://sourceforge.net/projects/gentoo/files/
     5
     6 Copyright: 1998-2010 Emil Brink &lt;emil@obsession.se&gt;
     7 License: GPL-2+
     8
     9 Files: icons/*
    10 Copyright: 1998 Johan Hanson &lt;johan@tiq.com&gt;
    11 License: GPL-2+
    12
    13 Files: debian/*
    14 Copyright: 2010 Prénom Nom &lt;votre.adresse.mail@example.org&gt;
    15 License: GPL-2+
    16
    17 License: GPL-2+
    18  This program is free software; you can redistribute it and/or modify
    19  it under the terms of the GNU General Public License as published by
    20  the Free Software Foundation; either version 2 of the License, or
    21  (at your option) any later version. 
    22  .
    23  This program is distributed in the hope that it will be useful,
    24  but WITHOUT ANY WARRANTY; without even the implied warranty of
    25  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
    26  GNU General Public License for more details.
    27  .
    28  You should have received a copy of the GNU General Public License along
    29  with this program; if not, write to the Free Software Foundation, Inc.,
    30  51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
    31  .
    32  On Debian systems, the full text of the GNU General Public
    33  License version 2 can be found in the file
    34  `/usr/share/common-licenses/GPL-2'.

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;"/>.
fr: Veuillez suivre les indications fournies par les responsables de l'archive et envoyées sur la liste 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.
fr: C'est un fichier obligatoire, avec un format spécifique décrit dans la <ulink url="&policy-dpkgchangelog;">Charte Debian, 4.4 « debian/changelog »</ulink>. Ce format est utilisé par <command>dpkg</command> et d'autres programmes pour obtenir le numéro de version, de révision, de distribution et l'urgence de votre paquet.

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.
fr: Pour vous, il est également important, puisqu'il est bon de documenter toutes les modifications effectuées. Cela permettra aux personnes qui téléchargent le paquet de voir s'il y a des problèmes à connaître. Il sera conservé en <filename>/usr/share/doc/gentoo/changelog.Debian.gz</filename> dans le paquet binaire.

note: type: Content of: <book><chapter><section><para>
en: <command>dh_make</command> created a default one, and this is what it looks like:
fr: <command>dh_make</command> en crée un par défaut, et il ressemble à ceci :

note: type: Content of: <book><chapter><section><screen>
en: 1  gentoo (0.9.12-1) unstable; urgency=low
    2
    3   * Initial release (Closes: #<replaceable>nnnn</replaceable>)  &lt;<replaceable>nnnn</replaceable> is the bug number of your ITP&gt;
    4
    5  -- Josip Rodin &lt;joy-mg@debian.org&gt;  Mon, 22 Mar 2010 00:37:31 +0100
    6
fr: 1  gentoo (0.9.12-1) unstable; urgency=low
    2
    3   * Initial release (Closes: #<replaceable>nnnn</replaceable>)  &lt;<replaceable>nnnn</replaceable> est le numéro de bogue de votre ITP&gt;
    4
    5  -- Prénom Nom &lt;votre.adresse.mail@example.org&gt;  Mon, 22 Mar 2010 00:37:31 +0100
    6

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 shouldn't be changed to anything higher than <literal>low</literal>.  :-)
fr: La ligne 1 contient le nom du paquet, la version, la distribution et l'urgence. Le nom doit correspondre au nom du paquet source, la distribution devrait être <literal>unstable</literal>, et l'urgence ne devrait pas être changée en quoi que ce soit de supérieur à <literal>low</literal>. :-)

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 - 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>, or manually with a text editor.
fr: Les lignes 3 à 5 composent l'entrée de journal, où vous documentez les modifications effectuées dans la révision du paquet (pas les modifications amont — il y a un fichier spécial pour cela, créé par les auteurs amont, que vous installerez comme <filename>/usr/share/doc/gentoo/changelog.gz</filename>). Supposons que votre rapport de bogue ITP (« Intent To Package » ou intention d'empaqueter) avait pour numéro <literal>12345</literal>. Les nouvelles lignes doivent être insérées juste en dessous de la première ligne qui commence avec une astérisque (<literal>*</literal>). Vous pouvez utiliser <citerefentry> <refentrytitle>dch</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> pour le modifier.

note: type: Content of: <book><chapter><section><para>
en: In order to prevent a package being accidentally uploaded before completing the package, it is good idea to change the distribution value to an invalid distribution value <literal>UNRELEASED</literal>.
fr: Pour éviter d'envoyer un paquet accidentellement avant qu'il ne soit terminé, il vaut mieux modifier la valeur de distribution à <literal>UNRELEASED</literal> qui n'est pas valable.

note: type: Content of: <book><chapter><section><para>
en: You will end up with something like this:
fr: Vous obtiendrez quelque chose comme :

note: type: Content of: <book><chapter><section><screen>
en: 1  gentoo (0.9.12-1) UNRELEASED; urgency=low
    2
    3   * Initial Release. Closes: #12345
    4   * This is my first Debian package.
    5   * Adjusted the Makefile to fix $(DESTDIR) problems.
    6
    7  -- Josip Rodin &lt;joy-mg@debian.org&gt;  Mon, 22 Mar 2010 00:37:31 +0100
    8
fr: 1  gentoo (0.9.12-1) UNRELEASED; urgency=low
    2
    3   * Initial Release. Closes: #12345
    4   * This is my first Debian package.
    5   * Adjusted the Makefile to fix $(DESTDIR) problems.
    6
    7  -- Prénom Nom &lt;votre.adresse.mail@example.org&gt;  Mon, 22 Mar 2010 00:37:31 +0100
    8

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.
fr: Si vous utilisez la commande <literal>dch -r</literal> pour faire cette dernière modification, n'oublier pas de sauver le fichier <filename>changelog</filename> explicitement dans l'éditeur.

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"/>
fr: Une fois satisfait de toutes les modifications, correctement documentées dans <filename>changelog</filename>, vous devriez modifier la valeur de distribution d'<literal>UNRELEASED</literal> à la valeur de distribution cible <literal>unstable</literal> (ou même <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"/>.
fr: Vous pouvez en apprendre plus sur la mise à jour du fichier <filename>changelog</filename> plus loin en <xref linkend="update"/>.

note: type: Content of: <book><chapter><section><para>
en: Now we need to take a look at the exact rules which <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.
fr: Il faut maintenant examiner les règles utilisées par <citerefentry> <refentrytitle>dpkg-buildpackage</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> pour créer vraiment le paquet. Ce fichier est en fait un autre <filename>Makefile</filename>, mais différent de ceux des sources amont. Contrairement aux autres fichiers de <filename>debian</filename>, celui-ci est marqué comme exécutable.

note: type: Content of: <book><chapter><section><section><title>
en: Targets of the <filename>rules</filename> file
fr: Cibles du fichier <filename>rules</filename>

note: type: Content of: <book><chapter><section><section><para><footnote><para>
en: You can start learning how to write <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.
fr: Vous pouvez apprendre les bases pour écrire un <filename>Makefile</filename> dans la <ulink url="&debref-make;">référence Debian, 12.2. « Make »</ulink>. La documentation complète est disponible en <ulink url="&gnu-make;"></ulink> et dans le paquet <systemitem role="package">make-doc</systemitem> de la partie <literal>non-free</literal> de l'archive.

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.
fr: La <ulink url="&policy-debianrules;">Charte Debian, 4.9 « Script de construction principal : debian/rules »</ulink> explique les détails.

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"/>
fr: Tous les fichiers <filename>rules</filename>, comme n'importe quel <filename>Makefile</filename>, sont constitués de plusieurs règles, chacune d'entre elles définissant une cible et comment la réaliser. <placeholder type="footnote" id="0"/> Une nouvelle règle commence avec la déclaration de sa cible en première colonne. Les lignes suivantes commençant par une tabulation (caractère ASCII 9 : TAB) indiquent ce qui doit être réalisé pour cette cible. Les lignes vides et celles qui commencent par dièse (<literal>#</literal>) sont traitées comme des commentaires et sont ignorées. <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.
fr: Une règle que vous voulez exécuter est appelée par le nom de sa cible comme un argument de la ligne de commande. Par exemple <literal>debian/rules <replaceable>build</replaceable></literal> et <literal>fakeroot make -f debian/rules <replaceable>binary</replaceable></literal> exécutent respectivement les règles pour les cibles <literal><replaceable>build</replaceable></literal> et <literal><replaceable>binary</replaceable></literal>.

note: type: Content of: <book><chapter><section><section><para>
en: Here is a simplified explanation of the targets:
fr: Voici une explication simplifiée des cibles :

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)
fr: <literal>clean</literal> (obligatoire) : pour nettoyer tous les fichiers compilés, créés, et inutiles de l'arborescence de construction ;

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)
fr: <literal>build</literal> (obligatoire) : pour construire les programmes compilés et les documents formatés à partir des sources dans l'arborescence de construction ;

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)
fr: <literal>build-arch</literal> (obligatoire) : pour construire les programmes compilés dépendants de l'architecture à partir des sources dans l'arborescence de construction ;

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)
fr: <literal>build-indep</literal> (obligatoire) : pour construire les documents formatés indépendants de l'architecture à partir des sources dans l'arborescence de construction ;

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)
fr: <literal>install</literal> (optionnelle) : pour installer les fichiers dans l'arborescence de chaque paquet binaire dans le répertoire <filename>debian</filename>. Si elles existent, les cibles <literal>binary*</literal> dépendent en réalité de cette cible.

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"/>.
fr: Cette cible est utilisée par <literal>dpkg-buildpackage</literal> comme en <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"/>
fr: <literal>binary</literal> (obligatoire) : pour créer tous les paquets binaires (en réalité, une combinaison des cibles <literal>binary-arch</literal> et <literal>binary-indep</literal>) ; <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"/>.
fr: Cette cible est utilisée par <literal>dpkg-buildpackage -B</literal> comme en <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"/>
fr: <literal>binary-arch</literal> (obligatoire) : pour créer tous les paquets binaires dépendants de l'architecture (<literal>Architecture: any</literal>) dans le répertoire parent ;<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>.
fr: Cette cible est utilisée par <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"/>
fr: <literal>binary-indep</literal> (obligatoire) : pour créer tous les paquets binaires indépendants de l'architecture (<literal>Architecture: all</literal>) dans le répertoire parent ;<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)
fr: <literal>get-orig-source</literal> (optionnelle) : pour obtenir la dernière version du paquet source d'origine à partir d'une archive amont.

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.
fr: Vous vous sentez sans doute submergé pour l'instant, mais les choses vont vraiment se simplifier à l'examen du fichier <filename>rules</filename> que <command>dh_make</command> donne par défaut.

note: type: Content of: <book><chapter><section><section><title>
en: Default <filename>rules</filename> file
fr: Fichier <filename>rules</filename> par défaut

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:
fr: Les versions récentes de <command>dh_make</command> créent un fichier <filename>rules</filename> par défaut très simple mais aussi très puissant en utilisant la commande <command>dh</command> :

note: type: Content of: <book><chapter><section><section><screen>
en:  1 #!/usr/bin/make -f
     2 # See debhelper(7) (uncomment to enable)
     3 # output every command that modifies files on the build system.
     4 #DH_VERBOSE = 1
     5 
     6 # see EXAMPLES in dpkg-buildflags(1) and read /usr/share/dpkg/*
     7 DPKG_EXPORT_BUILDFLAGS = 1
     8 include /usr/share/dpkg/default.mk
     9 
    10 # see FEATURE AREAS in dpkg-buildflags(1)
    11 #export DEB_BUILD_MAINT_OPTIONS = hardening=+all
    12
    13 # see ENVIRONMENT in dpkg-buildflags(1)
    14 # package maintainers to append CFLAGS
    15 #export DEB_CFLAGS_MAINT_APPEND  = -Wall -pedantic
    16 # package maintainers to append LDFLAGS
    17 #export DEB_LDFLAGS_MAINT_APPEND = -Wl,--as-needed
    18 
    19 # main packaging script based on dh7 syntax
    20 %:
    21         dh $@
fr:  1 #!/usr/bin/make -f
     2 # consulter debhelper(7) (décommenter lorsque nécessaire)
     3 # afficher chaque commande modifiant un fichier dans le système construit
     4 #DH_VERBOSE = 1
     5 
     6 # consulter EXAMPLES dans dpkg-buildflags(1) et lire /usr/share/dpkg/*
     7 DPKG_EXPORT_BUILDFLAGS = 1
     8 include /usr/share/dpkg/default.mk
     9 
    10 # consulter FEATURE AREAS dans dpkg-buildflags(1)
    11 #export DEB_BUILD_MAINT_OPTIONS = hardening=+all
    12
    13 # consulter ENVIRONMENT dans dpkg-buildflags(1)
    14 # mainteneurs de paquet à ajouter à CFLAGS
    15 #export DEB_CFLAGS_MAINT_APPEND  = -Wall -pedantic
    16 # mainteneurs de paquet à ajouter à append LDFLAGS
    17 #export DEB_LDFLAGS_MAINT_APPEND = -Wl,--as-needed
    18 
    19 # principal script d’empaquetage basé sur la syntaxe de dh7
    20 %:
    21         dh $@

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.)
fr: (Les numéros de ligne ont été ajoutés et certains commentaires réduits. Dans le vrai fichier <filename>rules</filename>, l’espace de début est une tabulation.)

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>.
fr: Vous avez probablement l'habitude de la ligne 1 avec les scripts shell et Perl. Cela signifie que ce fichier doit être exécuté par <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.
fr: La ligne 4 peut être décommentée pour configurer la variable <literal>DH_VERBOSE</literal> à 1, afin que la commande <command>dh</command> affiche les commandes <command>dh_*</command> qu'elle exécute. Vous pouvez également ajouter ici une ligne <literal>export DH_OPTIONS=-v</literal>, afin que chaque commande <command>dh_*</command> affiche les commandes qu'elle exécute. Cela permet de comprendre ce qui se passe exactement derrière ce simple fichier <filename>rules</filename>, et de déboguer ses problèmes. Ce nouveau <command>dh</command> est conçu pour constituer un élément essentiel des outils <systemitem role="package">debhelper</systemitem> sans rien vous cacher.

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.
fr: Ceci utilise les fonctionnalités du nouveau <systemitem role="package">debhelper</systemitem> v7+. Ses concepts fondateurs sont expliqués dans la présentation <ulink url="&debhelper-slides;">Pas le debhelper de papy</ulink> réalisé lors de la dixième conférence Debian par l'auteur de <systemitem role="package">debhelper</systemitem>. Sous <literal>Lenny</literal>, <command>dh_make</command> créait un fichier <filename>rules</filename> beaucoup plus compliqué avec des règles explicites et de nombreux scripts <command>dh_*</command> énumérés pour chacune, la plupart n'étant plus nécessaires maintenant (et montre l'âge du paquet). La nouvelle commande <command>dh</command> plus simple libère le responsable de ce travail de routine « manuel ». Vous gardez les pleins pouvoirs de personnalisation du processus avec les cibles <literal>override_dh_*</literal>. Consultez <xref linkend="customrules"/>. Il se base uniquement sur le paquet <systemitem role="package">debhelper</systemitem> et ne rend pas obscur le processus de construction comme le paquet <systemitem role="package">cdbs</systemitem> a tendance à le faire.

note: type: Content of: <book><chapter><section><section><para><footnote><para>
en: You can verify the actual sequences of <command>dh_*</command> programs invoked for a given <literal><replaceable>target</replaceable></literal> without really running them by invoking <literal>dh --no-act <replaceable>target</replaceable></literal> or <literal>debian/rules -- '--no-act <replaceable>target</replaceable>'</literal>.
fr: Vous pouvez vérifier les réelles séquences des programmes <command>dh_*</command> pour une <literal><replaceable>cible</replaceable></literal> donnée sans vraiment les exécuter en appelant <literal>dh --no-act <replaceable>cible</replaceable></literal> ou <literal>debian/rules -- '--no-act <replaceable>cible</replaceable>'</literal>.

note: type: Content of: <book><chapter><section><section><para>
en: Lines 20 and 21 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 which runs appropriate sequences of <command>dh_*</command> programs depending on its argument.  <placeholder type="footnote" id="1"/>
fr: Tout le travail est réalisé aux lignes 20 et 21 avec une règle implicite utilisant la règle de motif. Le caractère pourcent (<literal>%</literal>) représente « n’importe quelle cible », lequel appelle alors un seul programme, <command>dh</command>, avec le nom de la cible. <placeholder type="footnote" id="0"/> La commande <command>dh</command> est un script d'emballage qui exécute les séquences opportunes de programmes <command>dh_*</command> dépendant de ses paramètres : <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:
fr: <literal>debian/rules clean</literal> exécute <literal>dh clean</literal>, qui exécute à son tour :

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:
fr: <literal>debian/rules build</literal> exécute <literal>dh build</literal>, qui exécute à son tour :

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.
fr: L'exemple suivant suppose que <filename>debian/compat</filename> a une valeur au moins égale à 9 pour éviter d'invoquer une commande d'assistance Python automatiquement.

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"/>:
fr: <literal>fakeroot debian/rules binary</literal> exécute <literal>fakeroot dh binary</literal>, qui exécute à son tour : <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.
fr: <literal>fakeroot debian/rules binary-arch</literal> exécute <literal>fakeroot dh binary-arch</literal>, qui exécute à son tour la même séquence que <literal>fakeroot dh binary</literal> mais avec l'option <literal>-a</literal> ajoutée à chaque commande ;

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.
fr: <literal>fakeroot debian/rules binary-indep</literal> exécute <literal>fakeroot dh binary-indep</literal>, qui exécute à son tour à peu près la même séquence que <literal>fakeroot dh binary</literal> à l'exception de <command>dh_strip</command>, <command>dh_makeshlibs</command> et <command>dh_shlibdeps</command>, et avec l'option <literal>-i</literal> ajoutée à chaque commande restante.

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.
fr: Pour obtenir des renseignements complets sur le rôle exact de tous ces scripts <command>dh_*</command> et sur leurs options, veuillez lire leur page de manuel respective et la documentation de <systemitem role="package">debhelper</systemitem>.

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.
fr: Ces commandes gèrent d'autres environnements, comme <filename>setup.py</filename>, qui peuvent être énumérés en exécutant <literal>dh_auto_build --list</literal> dans le répertoire d'un paquet source.

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"/>
fr: Le rôle des commandes <command>dh_*</command> est presque évident d'après leur nom. <placeholder type="footnote" id="0"/> Les plus remarquables d'entre elles valent la peine d'être (très) brièvement présentées de façon simplifiée, dans l'hypothèse d'un environnement de construction basé sur un <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.
fr: En fait, il recherche la première cible disponible dans le <filename>Makefile</filename> parmi <literal>distclean</literal>, <literal>realclean</literal> et <literal>clean</literal>, et l'exécute.

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"/>
fr: <command>dh_auto_clean</command> exécute normalement ce qui suit si un <filename>Makefile</filename> fournit la cible <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).
fr: <command>dh_auto_configure</command> exécute normalement ce qui suit si <filename>./configure</filename> existe (les paramètres sont abrégés pour la lisibilité) :

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.
fr: <command>dh_auto_build</command> exécute normalement ce qui suit pour exécuter la première cible de <filename>Makefile</filename> si elle existe :

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.
fr: En fait, il recherche dans le <filename>Makefile</filename> la première cible disponible parmi <literal>test</literal> et <literal>check</literal>, et l'exécute.

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"/>
fr: <command>dh_auto_test</command> exécute normalement ce qui suit si un <filename>Makefile</filename> fournit la cible <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).
fr: <command>dh_auto_install</command> exécute normalement ce qui suit si un <filename>Makefile</filename> fournit la cible <literal>install</literal> (la ligne est coupée pour la lisibilité) :

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><screen>
en: make install \
      DESTDIR=<replaceable>/path/to</replaceable>/<replaceable>package</replaceable>_<replaceable>version</replaceable>-<replaceable>revision</replaceable>/debian/<replaceable>package</replaceable>
fr: make install \
      DESTDIR=<replaceable>/chemin/vers</replaceable>/<replaceable>paquet</replaceable>_<replaceable>version</replaceable>-<replaceable>révision</replaceable>/debian/<replaceable>paquet</replaceable>

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.
fr: Toutes les cibles ayant besoin de la commande <command>fakeroot</command> contiendront <command>dh_testroot</command>, qui se terminera en erreur si vous n'utilisez pas cette commande afin de vous faire passer pour le superutilisateur.

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.
fr: Le plus important à propos du fichier <filename>rules</filename> créé par <command>dh_make</command>, c'est qu'il ne s'agit que d'une suggestion. Il fonctionnera pour la plupart des paquets, mais pour les plus compliqués, vous ne devez pas hésiter à le modifier pour le faire correspondre à vos besoins.

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>.
fr: Bien que la cible <literal>install</literal> ne soit pas obligatoire, elle est prise en charge. <literal>fakeroot dh install</literal> se comporte comme <literal>fakeroot dh binary</literal> mais s'arrête après <command>dh_fixperms</command>.

note: type: Content of: <book><chapter><section><section><title>
en: Customization of <filename>rules</filename> file
fr: Personnalisation du fichier <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.
fr: Il existe plusieurs façons de personnaliser le fichier <filename>rules</filename> créé avec la nouvelle commande <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>.
fr: Si un paquet installe le fichier <filename>/usr/share/perl5/Debian/Debhelper/Sequence/<replaceable>nom_personnalise</replaceable>.pm</filename>, vous devriez déclencher sa fonction de personnalisation avec <literal>dh $@ --with <replaceable>nom-personnalise</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"/>
fr: La commande <literal>dh $@</literal> peut être personnalisée comme suit : <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.
fr: L'utilisation de la commande <command>dh_python2</command> est préférable à <command>dh_pysupport</command> ou <command>dh_pycentral</command>. N'utilisez pas la commande <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"/>
fr: ajout de l'assistance pour la commande <command>dh_python2</command> (la meilleure solution pour 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>.
fr: ajout de <systemitem role="package">python</systemitem> à <literal>Build-Depends</literal> ;

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with python2</literal>.
fr: utilisation de <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.
fr: conséquence : gestion des modules Python avec la structure <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)
fr: ajout de l'assistance pour la commande <command>dh_pysupport</command> (obsolète) :

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>.
fr: ajout de <systemitem role="package">python-support</systemitem> à <literal>Build-Depends</literal> ;

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with pysupport</literal>.
fr: utilisation de <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.
fr: conséquence : gestion des modules Python avec la structure <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)
fr: ajout de l'assistance pour la commande <command>dh_pycentral</command> (obsolète) :

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>.
fr: ajout de <systemitem role="package">python-central</systemitem> à <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.
fr: utilisation de <literal>dh $@ --with python-central</literal> à la place ;

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This also deactivates the <command>dh_pysupport</command> command.
fr: conséquence : désactivation de la commande <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.
fr: conséquence : gestion des modules Python avec la structure <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.
fr: ajout de l'assistance pour la commande <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>.
fr: ajout de <systemitem role="package">tex-common</systemitem> à <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.
fr: utilisation de <literal>dh $@ --with tex</literal> à la place ;

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.
fr: conséquence : enregistrement des fontes de Type 1, des modèles de césure et des formats avec 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.
fr: ajout de l'assistance pour les commandes <command>dh_quilt_patch</command> et <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>.
fr: ajout de <systemitem role="package">quilt</systemitem> à <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.
fr: utilisation de <literal>dh $@ --with quilt</literal> à la place ;

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.
fr: conséquence : application et retrait des correctifs au code source amont à partir des fichiers du répertoire <filename>debian/patches</filename> pour les paquets source au format <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.
fr: inutile pour les paquets source au format <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.
fr: ajout de l'assistance pour la commande <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>.
fr: ajout de <systemitem role="package">dkms</systemitem> à <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.
fr: utilisation de <literal>dh $@ --with dkms</literal> à la place ;

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This correctly handles DKMS usage by kernel module packages.
fr: conséquence : gestion correcte de l'utilisation de DKMS par les paquets de modules du noyau ;

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.
fr: ajout de l'assistance pour les commandes <command>dh_autotools-dev_updateconfig</command> et <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>.
fr: ajout de <systemitem role="package">autotools-dev</systemitem> à <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.
fr: utilisation de <literal>dh $@ --with autotools-dev</literal> à la place ;

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>.
fr: conséquence : mise à jour et restauration de <filename>config.sub</filename> et <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.
fr: ajout de l'assistance pour les commandes <command>dh_autoreconf</command> et <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>.
fr: ajout de <systemitem role="package">dh-autoreconf</systemitem> à <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.
fr: utilisation de <literal>dh $@ --with autoreconf</literal> à la place ;

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.
fr: conséquence : mise à jour des fichiers du système de construction GNU et restauration de ceux-ci après la construction ;

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>dh_girepository</command> command.
fr: ajout de l'assistance pour la commande <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>.
fr: ajout de <systemitem role="package">gobject-introspection</systemitem> à <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.
fr: utilisation de <literal>dh $@ --with gir</literal> à la place ;

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.
fr: conséquence : calcul des dépendances pour les paquets embarquant des données d'introspection GObject et génération de la variable de substitution <literal>${gir:Depends}</literal> pour les dépendances du paquet ;

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>bash</command> completion feature.
fr: ajout de l'assistance pour la fonctionnalité de complétion de <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>.
fr: ajout de <systemitem role="package">bash-completion</systemitem> à <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.
fr: utilisation de <literal>dh $@ --with bash-completion</literal> à la place ;

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>.
fr: conséquence : installation des complétions de <command>bash</command> en utilisant un fichier de configuration <filename>debian/<replaceable>paquet</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.
fr: De nombreuses commandes <command>dh_*</command> invoquées par la nouvelle commande <command>dh</command> peuvent être personnalisées par les fichiers de configuration correspondants dans le répertoire <filename>debian</filename>. Consultez <xref linkend="dother"/> et la page de manuel de chaque commande pour la personnalisation de telles fonctionnalités.

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.
fr: Avec <literal>Lenny</literal>, pour modifier le comportement d'un script <command>dh_*</command> il fallait trouver et adapter la ligne pertinente du fichier <filename>rules</filename>.

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"/>
fr: Certaines commandes <command>dh_*</command>, invoquées à l'aide de la nouvelle commande <command>dh</command>, doivent parfois être exécutées avec des arguments supplémentaires, exécuter d'autres commandes avec elles ou être ignorées. Pour cela, créez une cible <literal>override_dh_<replaceable>toto</replaceable></literal> avec sa règle dans le fichier <filename>rules</filename> définissant une cible <literal>override_dh_<replaceable>toto</replaceable></literal> pour remplacer la commande <command>dh_<replaceable>toto</replaceable></command>. Son rôle est fondamentalement de dire <emphasis>exécute-moi à la place</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.
fr: Les commandes <command>dh_auto_*</command> ont tendance à en faire plus que ce qui a été présenté ici (très) simplement, pour prendre en compte toutes les situations délicates. Évitez d'utiliser les cibles <literal>override_dh_*</literal> pour remplacer <literal>dh_*</literal> par des commandes équivalentes simplifiées (à part pour la cible <literal>override_dh_auto_clean</literal>) car elles pourraient contourner des fonctionnalités intelligentes de <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:
fr: Ainsi, par exemple pour conserver les données de configuration dans le répertoire <filename>/etc/gentoo</filename> au lieu du répertoire consacré <filename>/etc</filename> du dernier paquet <systemitem role="package">gentoo</systemitem> utilisant Autotools, il suffit de remplacer l'option <literal>--sysconfig=/etc</literal> donnée par la commande <command>dh_auto_configure</command> à la commande <command>./configure</command> avec :

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 retains any other, benign arguments to the <command>./configure</command> command.
fr: Les options données après <literal>--</literal> sont ajoutées aux options par défaut du programme exécuté automatiquement dans le but de les remplacer. L'utilisation de la commande <command>dh_auto_configure</command> est ici préférable à l'appel de la commande <command>./configure</command> puisqu'elle remplacera seulement l'option <literal>--sysconfig</literal> et conservera toutes les autres options à propos de la commande <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>.
fr: <command>dh_auto_build</command> sans autre option exécutera la première cible du <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.
fr: Si le <filename>Makefile</filename> des sources de <systemitem role="package">gentoo</systemitem> nécessite de préciser <literal>build</literal> comme cible pour la construction <placeholder type="footnote" id="0"/>, vous pouvez créer une cible <literal>override_dh_auto_build</literal> pour cela.

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.
fr: Cela garantit l'exécution de <literal>$(MAKE)</literal> avec toutes les options par défaut données à la commande <command>dh_auto_build</command> avec en plus le paramètre <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.
fr: Si le <filename>Makefile</filename> des sources de <systemitem role="package">gentoo</systemitem> oblige à préciser la cible <literal>packageclean</literal> pour nettoyer le paquet Debian au lieu d'utiliser les cibles <literal>distclean</literal> ou <literal>clean</literal>, vous pouvez créer une cible <literal>override_dh_auto_clean</literal> pour l'activer.

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.
fr: Si le <filename>Makefile</filename> des sources pour <systemitem role="package">gentoo</systemitem> contient une cible <literal>test</literal> dont vous ne voulez pas pour exécuter le processus de construction du paquet Debian, vous pouvez utiliser une cible <literal>override_dh_auto_test</literal> vide pour l'omettre.

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>.
fr: Les fichiers <filename>debian/changelog</filename> et <filename>debian/NEWS</filename> sont toujours installés automatiquement. Le journal de modification amont est trouvé en convertissant les noms de fichiers en minuscule puis en vérifiant l'existence de <filename>changelog</filename>, <filename>changes</filename>, <filename>changelog.txt</filename> et <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"/>
fr: Si <systemitem role="package">gentoo</systemitem> possède un fichier journal de modification inhabituel appelé <filename>FIXES</filename>, <command>dh_installchangelogs</command> ne l'installera pas par défaut. La commande <command>dh_installchangelogs</command> a besoin de <filename>FIXES</filename> en option pour l'installer. <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.
fr: Lors de l'utilisation de la nouvelle commande <command>dh</command>, la compréhension des effets exacts des cibles explicites comme celles énumérées en <xref linkend="targets"/> (à part <literal>get-orig-source</literal>) peut être rendue difficile. Veuillez limiter les cibles explicites aux cibles <literal>override_dh_*</literal>, et à celles complètement indépendantes, si possible.

note: type: Content of: <book><chapter><title>
en: Other files under the <filename>debian</filename> directory
fr: Autres fichiers dans le répertoire <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.
fr: Pour contrôler la plupart des actions de <systemitem role="package">debhelper</systemitem> lors de la construction du paquet, placez des fichiers de configuration optionnels dans le répertoire <filename>debian</filename>. Ce chapitre présentera globalement le rôle de ces fichiers et leur format. Veuillez consulter la <ulink url="&debian-policy;">Charte Debian</ulink> et la <ulink url="&developers-reference;">référence du développeur Debian</ulink> pour les principes d'empaquetage.

note: type: Content of: <book><chapter><para>
en: The <command>dh_make</command> command will create some template configuration files under the <filename>debian</filename> directory.  Most of them come with filenames suffixed by <literal>.ex</literal>.  Some of them come with filenames prefixed by the binary package name such as <literal><replaceable>package</replaceable></literal>.  Take a look at all of them.  <placeholder type="footnote" id="0"/>
fr: La commande <command>dh_make</command> crée quelques modèles de fichiers de configuration dans le répertoire <filename>debian</filename>. La plupart d'entre eux ont une extension <literal>.ex</literal>. Certains d'entre eux ont le nom du paquet binaire comme préfixe : <literal><replaceable>paquet</replaceable></literal>. Regardez-les tous. <placeholder type="footnote" id="0"/>

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.
fr: Certains modèles de fichiers de configuration de <systemitem role="package">debhelper</systemitem> risquent de ne pas être créés par la commande <command>dh_make</command>. Dans ce cas, vous devez les créer avec un éditeur.

note: type: Content of: <book><chapter><para>
en: If you wish or need to activate any of these, please do the following:
fr: Pour activer certains d'entre eux, veuillez suivre les instructions suivantes :

note: type: Content of: <book><chapter><itemizedlist><listitem><para>
en: rename template files by removing the <literal>.ex</literal> or <literal>.EX</literal> suffix if they have one;
fr: renommer les fichiers modèles en enlevant l'extension <literal>.ex</literal> ou <literal>.EX</literal> si elle existe ;

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>;
fr: renommer les fichiers de configuration pour utiliser le véritable nom du paquet binaire à la place de <literal><replaceable>paquet</replaceable></literal> ;

note: type: Content of: <book><chapter><itemizedlist><listitem><para>
en: modify template file contents to suit your needs;
fr: modifiez le contenu des fichiers modèles selon vos besoins ;

note: type: Content of: <book><chapter><itemizedlist><listitem><para>
en: remove template files which you do not need;
fr: enlevez les fichiers modèles dont vous n'avez pas besoin ;

note: type: Content of: <book><chapter><itemizedlist><listitem><para>
en: modify the <filename>control</filename> file (see <xref linkend="control"/>), if necessary;
fr: si nécessaire, modifiez le fichier <filename>control</filename> (consultez <xref linkend="control"/>) ;

note: type: Content of: <book><chapter><itemizedlist><listitem><para>
en: modify the <filename>rules</filename> file (see <xref linkend="rules"/>), if necessary.
fr: si nécessaire, modifiez le fichier <filename>rules</filename> (consultez <xref linkend="rules"/>).

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.
fr: Les fichiers de configuration de <systemitem role="package">debhelper</systemitem> sans préfixe <filename><replaceable>paquet</replaceable></filename> comme <filename>install</filename> sont relatifs au premier paquet binaire. Lorsqu'il y a plusieurs paquets binaires, leur configuration respective peut être précisée en ajoutant leur nom en préfixe du nom de fichier de configuration : <filename><replaceable>paquet-1</replaceable>.install</filename>, <filename><replaceable>paquet-2</replaceable>.install</filename>, etc.

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.
fr: Tous les détails ou différences entre le paquet original et votre version Debian devraient être documentés ici.

note: type: Content of: <book><chapter><section><para>
en: <command>dh_make</command> created a default one; this is what it looks like:
fr: <command>dh_make</command> en crée un par défaut, qui ressemble à ceci :

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>.
fr: Si vous n'avez rien à documenter, effacez ce fichier, consultez <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> v9 as follows:
fr: Le fichier <filename>compat</filename> définit le niveau de compatibilité de <systemitem role="package">debhelper</systemitem>. Actuellement, vous devriez le définir à <systemitem role="package">debhelper</systemitem> v9 comme suit :

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>.
fr: Consultez <citerefentry> <refentrytitle>dpkg</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> et la <ulink url="&policy-conffiles;">Charte 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.
fr: Une des choses les plus irritantes à propos des logiciels est de consacrer beaucoup de temps et d'efforts pour configurer un programme, et de voir une seule mise à jour détruire tous ses changements. Debian résout ce problème en marquant ces fichiers de configuration comme des conffiles. <placeholder type="footnote" id="0"/> Lors de la mise à jour d'un paquet, une question sera posée, permettant de garder les anciens fichiers de configuration ou non.

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.
fr: <citerefentry> <refentrytitle>dh_installdeb</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> considère <emphasis>automatiquement</emphasis> tous les fichiers du répertoire <filename>/etc</filename> comme des conffiles, donc si tous les fichiers de configuration de votre programme sont dans ce répertoire, il n'est pas nécessaire de les indiquer dans ce fichier. Pour la plupart des paquets, le seul endroit devant contenir des conffiles est <filename>/etc</filename>, donc ce fichier ne devrait pas exister.

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.
fr: Si votre programme utilise des fichiers de configuration, mais les réécrit aussi de son côté, il vaut mieux ne pas les marquer comme conffiles, parce que <command>dpkg</command> va alors interroger les utilisateurs pour vérifier les modifications tout le temps.

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:
fr: Si le programme que vous empaquetez force tous les utilisateurs à modifier les fichiers de configuration du répertoire <filename>/etc</filename>, il y a deux façons classiques de ne pas les marquer comme conffiles, et garder <command>dpkg</command> silencieux :

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.
fr: créer un lien symbolique dans le répertoire <filename>/etc</filename> vers un fichier du répertoire <filename>/var</filename> créé par les scripts du responsable ;

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.
fr: créer un fichier généré par les scripts du responsable dans le répertoire <filename>/etc</filename>.

note: type: Content of: <book><chapter><section><para>
en: For information on maintainer scripts, see <xref linkend="maintscripts"/>.
fr: Pour obtenir des renseignements sur les scripts du responsable, consultez <xref linkend="maintscripts"/>.

note: type: Content of: <book><chapter><section><title>
en: <filename><replaceable>package</replaceable>.cron.*</filename>
fr: <filename><replaceable>paquet</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:
fr: Si le paquet a besoin d'exécuter des tâches régulièrement pour fonctionner correctement, vous pouvez utiliser ces fichiers pour les configurer. Vous pouvez programmer des tâches régulières horaires, quotidiennes, mensuelles ou qui se produiront au moment que vous préférez. Les noms de fichiers sont :

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.
fr: <filename><replaceable>paquet</replaceable>.cron.hourly</filename> — installé comme <filename>/etc/cron.hourly/<replaceable>paquet</replaceable></filename> et exécuté une fois par heure ;

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.
fr: <filename><replaceable>paquet</replaceable>.cron.daily</filename> — installé comme <filename>/etc/cron.daily/<replaceable>paquet</replaceable></filename> et exécuté une fois par jour ;

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.
fr: <filename><replaceable>paquet</replaceable>.cron.weekly</filename> — installé comme <filename>/etc/cron.weekly/<replaceable>paquet</replaceable></filename> et exécuté une fois par semaine ;

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.
fr: <filename><replaceable>paquet</replaceable>.cron.monthly</filename> — installé comme <filename>/etc/cron.monthly/<replaceable>paquet</replaceable></filename> et exécuté une fois par mois ;

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.
fr: <filename><replaceable>paquet</replaceable>.cron.d</filename> — installé comme <filename>/etc/cron.d/<replaceable>paquet</replaceable></filename> et exécuté à tout autre moment.

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>.
fr: La plupart de ces fichiers sont des scripts shell, à l'exception de <filename><replaceable>paquet</replaceable>.cron.d</filename> dont le format est celui de <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>.
fr: Aucun fichier <filename>cron.*</filename> n'est nécessaire pour configurer la rotation des journaux ; pour cela, voyez <citerefentry> <refentrytitle>dh_installlogrotate</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> et <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>.
fr: Ce fichier indique les répertoires nécessaires mais qui ne sont pas créés par la procédure d'installation normale (<literal>make install DESTDIR=...</literal> invoquée par <literal>dh_auto_install</literal>). C'est souvent dû à un problème avec le <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"/>.
fr: Les fichiers énumérés dans un fichier <filename>install</filename> n'ont pas besoin que leurs répertoires soient créés avant, consultez <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.
fr: Il est préférable d'essayer d'exécuter l'installation, et d'utiliser seulement ce recours si vous avez des problèmes. Il n'y a pas de barre oblique (<literal>/</literal>) au début des noms de répertoire dans la liste du fichier <filename>dirs</filename>.

note: type: Content of: <book><chapter><section><title>
en: <filename><replaceable>package</replaceable>.doc-base</filename>
fr: <filename><replaceable>paquet</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>.
fr: Si votre paquet est fournit avec une autre documentation que des pages de manuel et d'information, vous devriez utiliser le fichier <systemitem role="package">doc-base</systemitem> pour l'enregistrer, de sorte que l'utilisateur puisse la trouver avec par exemple <citerefentry> <refentrytitle>dhelp</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>dwww</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> ou <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>.
fr: Cela inclut normalement les fichiers HTML, PS et PDF, inclus dans <filename>/usr/share/doc/<replaceable>nomdepaquet</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:
fr: Voici ce à quoi le fichier <filename>gentoo.doc-base</filename> de <systemitem role="package">gentoo</systemitem> ressemble :

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.
fr: Pour obtenir plus de renseignements sur le format de ce fichier, consultez <citerefentry> <refentrytitle>install-docs</refentrytitle> <manvolnum>8</manvolnum> </citerefentry> et la copie locale <filename>&doc-base;</filename> du manuel Debian de <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"/>.
fr: Pour obtenir plus de renseignements sur l'installation de documentation supplémentaire, consultez <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.
fr: Ce fichier spécifie les noms des fichiers de documentation que <citerefentry> <refentrytitle>dh_installdocs</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> peut installer pour vous dans le répertoire temporaire.

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.
fr: Par défaut, il inclut tous les fichiers, existant dans le répertoire racine des sources, qui sont nommés <filename>BUGS</filename>, <filename>README*</filename>, <filename>TODO</filename>, etc.

note: type: Content of: <book><chapter><section><para>
en: For <systemitem role="package">gentoo</systemitem>, some other files are also included:
fr: Pour <systemitem role="package">gentoo</systemitem>, d'autres fichiers sont aussi inclus :

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.
fr: Si votre paquet fournit des fichiers Emacs qui peuvent être byte-compilés au moment de l'installation, vous pouvez utiliser ces fichiers pour les configurer.

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>.
fr: Ils sont installés dans le répertoire temporaire par <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.
fr: Si vous n'en avez pas besoin, effacez-les.

note: type: Content of: <book><chapter><section><title>
en: <filename><replaceable>package</replaceable>.examples</filename>
fr: <filename><replaceable>paquet</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.
fr: La commande <citerefentry> <refentrytitle>dh_installexamples</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> installe les fichiers et répertoires énumérés ici comme des fichiers d'exemple.

note: type: Content of: <book><chapter><section><title>
en: <filename><replaceable>package</replaceable>.init</filename> and <filename><replaceable>package</replaceable>.default</filename>
fr: <filename><replaceable>paquet</replaceable>.init</filename> et <filename><replaceable>paquet</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? :-)
fr: Si votre paquet est un démon qui doit être exécuté au démarrage du système, vous avez de toute évidence ignoré les recommandations initiales, n'est-ce-pas ? :-)

note: type: Content of: <book><chapter><section><para>
en: The <filename><replaceable>package</replaceable>.init</filename> file is installed as the <filename>/etc/init.d/<replaceable>package</replaceable></filename> script which starts and stops the daemon.  Its fairly generic skeleton template is provided by the <command>dh_make</command> command as <filename>init.d.ex</filename>.  You'll likely have to rename and edit it, a lot, while making sure to provide <ulink url="&lsb;">Linux Standard Base</ulink> (LSB) compliant headers.  It gets installed into the temporary directory by <citerefentry> <refentrytitle>dh_installinit</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.
fr: Le fichier <filename><replaceable>paquet</replaceable>.init</filename> est installé comme un script qui sert à démarrer et arrêter le démon en <filename>/etc/init.d/<replaceable>paquet</replaceable></filename>. Un squelette de modèle générique est fournit par la commande <command>dh_make</command> en <filename>init.d.ex</filename>. Vous devrez sans doute le renommer et le modifier, beaucoup, en vous assurant que les en-têtes respectent la <ulink url="&lsb;">Linux Standard Base</ulink> (LSB). Il est installé dans le répertoire temporaire par <citerefentry> <refentrytitle>dh_installinit</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.

note: type: Content of: <book><chapter><section><para>
en: The <filename><replaceable>package</replaceable>.default</filename> file will be installed as <filename>/etc/default/<replaceable>package</replaceable></filename>.  This file sets defaults that are sourced by the init script.  This <filename><replaceable>package</replaceable>.default</filename> file is most often used to disable running a daemon, or to set some default flags or timeouts.  If your init script has certain configurable features, you can set them in the <filename><replaceable>package</replaceable>.default</filename> file, instead of in the init script itself.
fr: Le fichier <filename><replaceable>paquet</replaceable>.default</filename> est installé en tant que <filename>/etc/default/<replaceable>paquet</replaceable></filename>. Ce fichier définit les valeurs par défaut des variables utilisées par le script d'initialisation. Ce fichier est le plus souvent utilisé pour désactiver le démarrage d'un démon ou pour paramétrer quelques options ou temps limites. Si le script d'initialisation contient certaines fonctionnalités <emphasis>paramétrables</emphasis>, elles ont leur place dans ce fichier <filename><replaceable>paquet</replaceable>.default</filename> au lieu du script d'initialisation lui-même.

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:
fr: Si le programme amont fournit un fichier pour le script d'initialisation, vous avez le choix de l'utiliser ou non. Si vous n'utilisez pas leur script d'initialisation, créez-en un nouveau en <filename><replaceable>paquet</replaceable>.init</filename>. Cependant, si le script d'initialisation amont semble fonctionnel et s'installe au bon endroit, il vous faudra tout de même configurer le lien symbolique <filename>rc*</filename>. Pour cela, il faut remplacer <command>dh_installinit</command> dans le fichier <filename>rules</filename> avec les lignes suivantes :

note: type: Content of: <book><chapter><section><para>
en: If you don't need this, remove the files.
fr: Si vous n'en avez pas besoin, effacez ces fichiers.

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.
fr: Cela remplace la commande obsolète <citerefentry> <refentrytitle>dh_movefiles</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> configurée par le fichier <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 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.
fr: Si des fichiers doivent être installés dans le paquet mais que <literal>make install</literal> normal ne le fait pas, il faut ajouter les noms de fichiers et leur destination dans ce fichier <filename>install</filename>. Ils sont installés par <citerefentry> <refentrytitle>dh_install</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.<placeholder type="footnote" id="0"/> Vous devriez d'abord vérifier s'il n'y a pas un outil plus approprié à utiliser. Par exemple, les documents devraient être dans le fichier <filename>docs</filename> et non dans celui-ci.

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:
fr: Ce fichier <filename>install</filename> possède une ligne par fichier installé, avec le nom du fichier (par rapport au répertoire de construction principal) suivi d'un espace puis du répertoire d'installation (par rapport au répertoire d'installation). Par exemple, si un binaire <filename>src/<replaceable>truc</replaceable></filename> n'est pas installé, le fichier <filename>install</filename> pourrait ressembler à :

note: type: Content of: <book><chapter><section><screen>
en: src/<replaceable>bar</replaceable> usr/bin
fr: src/<replaceable>truc</replaceable> usr/bin

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>.
fr: Cela signifie que lors de l'installation du paquet, il y aura une commande exécutable <filename>/usr/bin/<replaceable>truc</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.
fr: Ce fichier <filename>install</filename> peut renseigner seulement le nom du fichier sans le répertoire d'installation quand le chemin relatif n'est pas modifié. Ce format est normalement utilisé pour un gros paquet qui découpe le résultat de la construction en plusieurs paquets binaires à l'aide de <filename><replaceable>paquet-1</replaceable>.install</filename>, <filename><replaceable>paquet-2</replaceable>.install</filename>, etc.

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>).
fr: La commande <command>dh_install</command> finira par chercher les fichiers dans <filename>debian/tmp</filename>, s'il ne les trouve pas dans le répertoire courant (ou quelque soit l'endroit où il lui a été demandé de chercher avec <literal>--sourcedir</literal>).

note: type: Content of: <book><chapter><section><title>
en: <filename><replaceable>package</replaceable>.info</filename>
fr: <filename><replaceable>paquet</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.
fr: Si le paquet possède des pages d'information, vous devriez les installer avec <citerefentry> <refentrytitle>dh_installinfo</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> en les énumérant dans un fichier <filename><replaceable>paquet</replaceable>.info</filename>.

note: type: Content of: <book><chapter><section><title>
en: <filename><replaceable>package</replaceable>.links</filename>
fr: <filename><replaceable>paquet</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.
fr: Pour créer des liens symboliques supplémentaires dans les répertoires de construction du paquet en tant que responsable du paquet, vous devriez les installer avec <citerefentry> <refentrytitle>dh_link</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> en énumérant leurs chemins complets de fichiers source et destination dans un fichier <filename><replaceable>paquet</replaceable>.links</filename>.

note: type: Content of: <book><chapter><section><title>
en: <filename>{<replaceable>package</replaceable>.,source/}lintian-overrides</filename>
fr: <filename>{<replaceable>paquet</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 Lintian User's Manual (<filename>&lintian-doc;</filename>) and refrain from abusing this.
fr: Si <systemitem role="package">lintian</systemitem> signale des erreurs dans son diagnostic alors que la Charte accepte des exceptions à certaines règles, vous pouvez utiliser <filename><replaceable>paquet</replaceable>.lintian-overrides</filename> ou <filename>source/lintian-overrides</filename> pour le rendre silencieux. Veuillez lire le manuel utilisateur de Lintian (<filename>&lintian-doc;</filename>) et vous abstenir d'en abuser.

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.
fr: <filename><replaceable>paquet</replaceable>.lintian-overrides</filename> concerne le paquet binaire appelé <systemitem role="package"><replaceable>paquet</replaceable></systemitem>, il est installé en <filename>usr/share/lintian/overrides/<replaceable>paquet</replaceable></filename> par la commande <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.
fr: <filename>source/lintian-overrides</filename> concerne le paquet source. Il n'est pas installé.

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.
fr: Le programme devrait être livré avec une page de manuel. Sinon, vous devriez en créer au moins une. La commande <command>dh_make</command> crée quelques modèles de fichiers pour pages de manuel. Ils doivent être copiés et modifiés pour chaque commande à laquelle il manque une page de manuel. Veuillez vous assurer d'avoir effacé les modèles non utilisés.

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.
fr: Les pages de manuel sont normalement écrites en <citerefentry> <refentrytitle>nroff</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>. L'exemple <filename>manpage.1.ex</filename> est aussi écrit en <command>nroff</command>. Lisez la page de manuel <citerefentry> <refentrytitle>man</refentrytitle> <manvolnum>7</manvolnum> </citerefentry> pour une brève description sur la façon d'éditer ce genre de fichiers.

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:
fr: Le nom de fichier de la page de manuel devrait donner le nom du programme qu'elle documente, donc <literal>manpage</literal> doit être renommé en <literal>gentoo</literal>. Le nom de fichier inclut aussi <literal>.1</literal> comme premier suffixe, qui signifie que c'est une page de manuel pour une commande utilisateur. Assurez-vous de vérifier que cette section est effectivement la bonne. Voici une courte liste des sections de pages de manuel :

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

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Executable commands or scripts
fr: Commandes ou scripts exécutables

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: System calls
fr: Appels système

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Functions provided by the kernel
fr: Fonctions fournies par le noyau

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Library calls
fr: Appels de bibliothèque

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Functions within system libraries
fr: Fonctions des bibliothèques système

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Special files
fr: Fichiers spéciaux

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Usually found in <filename>/dev</filename>
fr: Situés généralement dans <filename>/dev</filename>

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: File formats
fr: Formats de fichier

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: E.g. <filename>/etc/passwd</filename>'s format
fr: Par exemple le format de <filename>/etc/passwd</filename>

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

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Games or other frivolous programs
fr: Jeux ou autres programmes frivoles

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Macro packages
fr: Macropaquets

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Such as <command>man</command> macros
fr: Comme les macros de <command>man</command>

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: System administration
fr: Administration système

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Programs typically only run by root
fr: Programmes normalement exécutés par le superutilisateur

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Kernel routines
fr: Sous-programmes du noyau

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Non-standard calls and internals
fr: Appels non standards et routines internes

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.
fr: Ainsi, la page de manuel de <systemitem role="package">gentoo</systemitem> devrait être appelée <filename>gentoo.1</filename>. S'il n'y avait pas de page de manuel <filename>gentoo.1</filename> dans les sources originales, il aurait fallu renommer le modèle <filename>manpage.1.ex</filename> en <filename>gentoo.1</filename> puis le modifier à partir des informations de l'exemple et de la documentation amont.

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.
fr: Remarquez que la page de manuel initiale créée par <command>help2man</command> prétendra que des renseignements supplémentaires sont disponibles dans le système d'information. Si la commande n'a pas non plus de page <command>info</command>, vous devriez modifier manuellement la page créée par la commande <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"/>
fr: La commande <command>help2man</command> peut aussi être utilisée pour créer une page de manuel à partir de la sortie de <literal>--help</literal> et <literal>--version</literal> pour chaque programme. <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:
fr: D'un autre côté, si vous préférez écrire du SGML plutôt que du <command>nroff</command>, vous pouvez utiliser le modèle <filename>manpage.sgml.ex</filename>. Si vous le faites, vous devez :

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: rename the file to something like <filename>gentoo.sgml</filename>.
fr: renommer le fichier en quelque chose comme <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
fr: installer le paquet <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
fr: ajouter <literal>docbook-to-man</literal> à la ligne <literal>Build-Depends</literal> dans le fichier <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:
fr: ajouter une cible <literal>override_dh_auto_build</literal> au fichier <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:
fr: Si vous préférez XML à SGML, vous pouvez utiliser le modèle <literal>manpage.xml.ex</literal>. Si vous le faites, vous devez :

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: rename the source file to something like <literal>gentoo.1.xml</literal>
fr: renommer le fichier en quelque chose comme <literal>gentoo.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)
fr: installer le paquet <systemitem role="package">docbook-xsl</systemitem> et un processeur XSLT comme <systemitem role="package">xsltproc</systemitem> (recommandé) ;

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
fr: ajouter <literal>docbook-xsl</literal>, <literal>docbook-xml</literal> et <literal>xsltproc</literal> à la ligne <literal>Build-Depends</literal> dans le fichier <literal>control</literal> ;

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><screen>
en: override_dh_auto_build:
            xsltproc --nonet \
             --param make.year.ranges 1 \
             --param make.single.year.ranges 1 \
             --param man.charmap.use.subset 0 \
             -o debian/ \
    http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl\
            debian/gentoo.1.xml
            dh_auto_build
fr: override_dh_auto_build:
            xsltproc --nonet \
             --param make.year.ranges 1 \
             --param make.single.year.ranges 1 \
             --param man.charmap.use.subset 0 \
             -o debian/ \
     http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl\
            debian/gentoo.1.xml
            dh_auto_build

note: type: Content of: <book><chapter><section><title>
en: <filename><replaceable>package</replaceable>.manpages</filename>
fr: <filename><replaceable>paquet</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.
fr: Si le paquet possède des pages de manuel, vous devriez les installer avec <citerefentry> <refentrytitle>dh_installman</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> en les énumérant dans un fichier <filename><replaceable>paquet</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:
fr: Pour installer <filename>docs/gentoo.1</filename> en tant que page de manuel du le paquet <systemitem role="package">gentoo</systemitem>, créez le fichier <filename>gentoo.manpages</filename> contenant :

note: type: Content of: <book><chapter><section><para>
en: X Window System users usually have a window manager with a menu that can be customized to launch programs.  If they have installed the Debian <systemitem role="package">menu</systemitem> package, a set of menus for every program on the system will be created for them.
fr: Les utilisateurs de X Window ont un gestionnaire de fenêtres avec un menu qui peut être configuré pour lancer des programmes. S'ils ont installé le paquet <systemitem role="package">menu</systemitem> de Debian, un ensemble de menus pour chaque programme sur le système sera créé pour eux.

note: type: Content of: <book><chapter><section><para>
en: Here's the default <filename>menu.ex</filename> file that <command>dh_make</command> created:
fr: Voici le fichier <filename>menu.ex</filename> créé par défaut par <command>dh_make</command> :

note: type: Content of: <book><chapter><section><para>
en: The first field after the colon character is <literal>needs</literal>, and it specifies what kind of interface the program needs.  Change this to one of the listed alternatives, e.g.  <literal>text</literal> or <literal>X11</literal>.
fr: Le premier champ après les deux points est <literal>needs</literal>, il indique le genre d'interface dont a besoin le programme. Changez ceci en une des alternatives énumérées, par exemple <literal>text</literal> ou <literal>X11</literal>.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: The current list of sections is in <ulink url="&menu-structure;">The Debian Menu sub-policy, 2.1 "Preferred menu structure"</ulink>.  There was a major reorganization of menu structure for <literal>squeeze</literal>.
fr: La liste actuelle des sections est dans la <ulink url="&menu-structure;">sous-charte de menu Debian 2.1 « structure de menu conseillée »</ulink>. Une réorganisation majeure de la structure du menu a été réalisée pour <literal>Squeeze</literal>.

note: type: Content of: <book><chapter><section><para>
en: The next is the <literal>section</literal> that the menu and submenu entry should appear in.  <placeholder type="footnote" id="0"/>
fr: Le champ suivant est la <literal>section</literal> où l'entrée de menu et de sous-menu devrait apparaître. <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: The <literal>title</literal> field is the name of the program.  You can start this one in uppercase if you like.  Just keep it short.
fr: Le champ <literal>title</literal> est le nom du programme. Vous pouvez le commencer par une majuscule si vous le souhaitez. Mais gardez-le court.

note: type: Content of: <book><chapter><section><para>
en: Finally, the <literal>command</literal> field is the command that runs the program.
fr: Enfin, le champ <literal>command</literal> est la commande qui exécute le programme.

note: type: Content of: <book><chapter><section><para>
en: Let's change the file name to <filename>menu</filename> and change the menu entry to this:
fr: Une fois le fichier renommé en <filename>menu</filename>, l'entrée de menu peut être modifiée comme ceci :

note: type: Content of: <book><chapter><section><para>
en: You can also add other fields like <literal>longtitle</literal>, <literal>icon</literal>, <literal>hints</literal> etc.  See <citerefentry> <refentrytitle>dh_installmenu</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>menufile</refentrytitle> <manvolnum>5</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>update-menus</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, and <ulink url="&policy-menu;">The Debian Menu sub-policy</ulink> for more information.
fr: Vous pouvez aussi ajouter d'autres champs comme <literal>longtitle</literal>, <literal>icon</literal>, <literal>hints</literal>, etc. Consultez <citerefentry> <refentrytitle>dh_installmenu</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>menufile</refentrytitle> <manvolnum>5</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>update-menus</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> et la <ulink url="&policy-menu;">sous-charte de menu Debian</ulink> pour obtenir plus de renseignements.

note: type: Content of: <book><chapter><section><para>
en: The <citerefentry> <refentrytitle>dh_installchangelogs</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> command installs this.
fr: La commande <citerefentry> <refentrytitle>dh_installchangelogs</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> l'installe.

note: type: Content of: <book><chapter><section><title>
en: <filename>{pre,post}{inst,rm}</filename>
fr: <filename>{post,pre}{inst,rm}</filename>

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.
fr: Malgré l'utilisation de raccourcis <command>bash</command> pour présenter les noms des fichiers <filename>{pre,post}{inst,rm}</filename>, vous devriez utiliser une syntaxe pure POSIX pour les scripts du responsable pour être compatibles avec <command>dash</command> comme interpréteur de commande du système.

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.
fr: Les fichiers <filename>postinst</filename>, <filename>preinst</filename>, <filename>postrm</filename>, et <filename>prerm</filename> <placeholder type="footnote" id="0"/> sont nommés <emphasis>scripts du responsable</emphasis>. Ces scripts sont placés dans la zone de contrôle du paquet et sont exécutés par <command>dpkg</command> lorsque le paquet est installé, mis à jour ou supprimé.

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>.
fr: En tant que responsable débutant, vous devriez éviter de modifier manuellement les scripts du responsable parce qu'ils ont tendance à être complexes. Pour obtenir plus de renseignements, consultez dans la <ulink url="&policy-mantainerscripts;">Charte Debian, chapitre 6 « scripts du responsable et procédure d'installation »</ulink> et examinez les fichiers d'exemple fournis par <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>.
fr: Si vous préférez n'en faire qu'à votre tête en personnalisant vos scripts du responsable pour un paquet, vous devriez les essayer non seulement lors de l'<emphasis role="strong">installation</emphasis> et la <emphasis role="strong">mise à jour</emphasis>, mais aussi pour la <emphasis role="strong">désinstallation</emphasis> et la <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).
fr: Les mises à jour devraient être silencieuses et non intrusives (les utilisateurs existants ne devraient pas remarquer la mise à jour à part en constatant la résolution de vieux bogues et peut-être l'arrivée de nouvelles fonctionnalités).

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.
fr: Lorsque la mise à niveau est forcément intrusive (par exemple des fichiers de configuration dispersés dans plusieurs répertoires personnels avec des structures complètement différentes), vous pouvez envisager en dernier recours de basculer le paquet vers un état de repli sûr (par exemple en désactivant un service) et en fournissant la documentation adéquate conformément à la Charte Debian (<filename>README.Debian</filename> et <filename>NEWS.Debian</filename>). N'embêtez pas l'utilisateur avec des notes <command>debconf</command> déclenchées par les scripts du responsable lors des mises à niveau.

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.
fr: Le paquet <systemitem role="package">ucf</systemitem> fournit un dispositif <emphasis>à la conffile</emphasis> pour conserver les modifications des utilisateurs pour les fichiers qui n'ont pas été marqués comme <emphasis>conffiles</emphasis> comme ceux gérés par les scripts du responsable. Cela permet de réduire les problèmes associés à ces fichiers.

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.
fr: Ces scripts du responsable font partie des améliorations de Debian qui expliquent <emphasis role="strong">pourquoi les gens choisissent Debian</emphasis>. Prenez garde de ne pas les transformer en source d'agacement.

note: type: Content of: <book><chapter><section><title>
en: <filename><replaceable>package</replaceable>.symbols</filename>
fr: <filename><replaceable>paquet</replaceable>.symbols</filename>

note: type: Content of: <book><chapter><section><para>
en: Packaging of 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"/>.
fr: L'empaquetage de bibliothèque n'est pas facile pour un mainteneur débutant, et devrait être évité. Cela dit, si le paquet fournit des bibliothèques, des fichiers <filename>debian/<replaceable>paquet</replaceable>.symbols</filename> devraient exister. Consultez <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.
fr: La commande <citerefentry> <refentrytitle>dh_installdocs</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> l'installe.

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 from.  This is also used by the <ulink url="&dehs;">Debian External Health Status (DEHS)</ulink> service.
fr: Le format du fichier <filename>watch</filename> est documenté dans la page de manuel <citerefentry> <refentrytitle>uscan</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>. Le fichier <filename>watch</filename> configure le programme <command>uscan</command> (dans le paquet <systemitem role="package">devscripts</systemitem>) pour surveiller le site sur lequel vous avez obtenu les sources. C'est également utilisé par le service d'<ulink url="&dehs;">état de santé extérieur à Debian ou « Debian External Health Status » (DEHS)</ulink>.

note: type: Content of: <book><chapter><section><para>
en: Here are its contents:
fr: Voici ce qu'il contient :

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.
fr: Normalement, avec un fichier <filename>watch</filename>, la page servie à l'URL <literal>&sf-net;/gentoo</literal> est téléchargée pour chercher des liens sous la forme <literal>&lt;a href=...&gt;</literal>. Le nom de base (juste après la dernière <literal>/</literal>) de chaque URL liée est comparé au motif de l'expression rationnelle Perl <literal>gentoo-(.+)\.tar\.gz</literal> (consultez <citerefentry> <refentrytitle>perlre</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>). Parmi les fichiers correspondants, celui avec le plus grand numéro de version est téléchargé puis le programme <command>uupdate</command> est exécuté pour créer une arborescence source mise à jour.

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 an 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.
fr: Bien que ce soit vrai pour les autres sites, le service de téléchargement de SourceForge en <ulink url="&sf-net;"/> est une exception. Quand le fichier <filename>watch</filename> comporte une URL correspondant au motif d'expression rationnelle <literal>^http://sf\.net/</literal>, le programme <command>uscan</command> le remplace par <literal>&qa-do;watch/sf.php/</literal> et applique ensuite cette règle. Le service de redirection en <ulink url="&qa-do;"/> est conçu pour offrir un service stable vers le fichier voulu pour les motifs <filename>watch</filename> de la forme <literal>&sf-net;/<replaceable>projet</replaceable>/<replaceable>nom-d-archive</replaceable>-(.+)\.tar\.gz</literal>. Le but est de résoudre le problème lié au fréquent changement d'URL 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>.
fr: Si la source propose une signature cryptographique pour l’archive, il est recommandé de vérifier son authenticité en utilisant l’option <literal>pgpsigurlmangle</literal> comme expliqué dans <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:
fr: Dans le fichier <filename>debian/source/format</filename>, il devrait y avoir une seule ligne indiquant le format voulu du paquet source (vérifier en <citerefentry> <refentrytitle>dpkg-source</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> pour une liste exhaustive). Après <literal>Squeeze</literal>, il devrait contenir selon les cas :

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>3.0 (native)</literal> for native Debian packages or
fr: <literal>3.0 (native)</literal> pour les paquets Debian natifs ;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>3.0 (quilt)</literal> for everything else.
fr: <literal>3.0 (quilt)</literal> pour tout le reste.

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.
fr: Consulter <ulink url="&debsrc3;">DebSrc3.0</ulink> pour un résumé de la conversion des sources aux formats source <literal>3.0 (quilt)</literal> et <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.
fr: En fait, ce nouveau format permet de gérer des archives amont multiples et plusieurs méthodes de compression. Ces considérations sortent du cadre de ce document.

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"/>
fr: Le récent format source <literal>3.0 (quilt)</literal> enregistre les modifications dans un ensemble de correctifs <command>quilt</command> dans <filename>debian/patches</filename>. Ces changements sont alors appliqués automatiquement lors de l'extraction du paquet source. <placeholder type="footnote" id="0"/> Les modifications Debian sont simplement conservées dans une archive <filename>debian.tar.gz</filename> contenant tous les fichiers du répertoire <filename>debian</filename>. Ce nouveau format permet d'inclure des fichiers binaires comme des icônes PNG sans bidouillage. <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.
fr: Quand <command>dpkg-source</command> extrait un paquet source au format <literal>3.0 (quilt)</literal>, il applique automatiquement tous les correctifs énumérés dans <filename>debian/patches/series</filename>. Vous pouvez éviter que les correctifs soient appliqués à la fin de l'extraction avec l'option <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.
fr: Lors de la maintenance de paquet Debian avec un système de gestion de version, il faut généralement créer une branche (par exemple <literal>upstream</literal>) pour suivre les sources amont, et une autre branche (typiquement <literal>master</literal> avec Git) pour suivre le paquet Debian. Pour cette dernière, il est préférable de garder les sources amont non modifiés aux côtés des fichiers <filename>debian/*</filename> du paquet Debian pour faciliter la fusion avec les nouveaux sources d’amont.

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>).
fr: Après la construction d'un paquet, les sources sont normalement laissés modifiés (« patched »). <literal>dquilt pop -a</literal> doit être exécuté avant d'envoyer vers la branche <literal>master</literal>. Créer un fichier optionnel <filename>debian/source/local-options</filename> contenant <literal>unapply-patches</literal> permet d'automatiser cela. Ce fichier n'est pas inclus dans le paquet source créé et modifie seulement le comportement de construction local. Ce fichier peut aussi contenir <literal>abort-on-upstream-changes</literal> (consultez <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"/>.
fr: Les fichiers créés automatiquement dans l'arborescence source peuvent être assez agaçants pour l'empaquetage puisqu'ils sont à l'origine de grands fichiers de correctif sans signification. Des modules personnalisés comme <command>dh_autoreconf</command> permettent d'atténuer ce problème comme décrit en <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.
fr: Vous pouvez fournir une expression rationnelle Perl en argument de l'option <literal>--extend-diff-ignore</literal> de <citerefentry> <refentrytitle>dpkg-source</refentrytitle><manvolnum>1</manvolnum> </citerefentry> pour ignorer les modifications faites aux fichiers créés automatiquement lors de la création du paquet source.

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>.
fr: Comme solution générique pour aborder ce problème de fichiers créés automatiquement, vous pouvez enregistrer ces arguments d'option de <command>dpkg-source</command> dans le fichier <filename>source/options</filename> du paquet source. L'exemple suivant permet de sauter la création de fichiers de correctif pour <filename>config.sub</filename>, <filename>config.guess</filename> et <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.
fr: L'ancien format source <literal>1.0</literal> créait un unique et gros fichier <filename>diff.gz</filename> contenant les fichiers de maintenance du paquet dans <filename>debian</filename> et les correctifs aux sources. Un tel paquet est un peu délicat à inspecter et à comprendre pour chaque modification de l'arbre source par la suite. Ce n'est pas conseillé.

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.
fr: Plusieurs méthodes de maintenance des ensembles de correctifs ont été proposés et sont utilisés dans les paquets Debian. Le système <command>quilt</command> est le système de maintenance conseillé. Parmi d'autres, <command>dpatch</command>, <command>dbs</command> et <command>cdbs</command> existent. La plupart d'entre eux conservent aussi les correctifs dans des fichiers <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"/>
fr: Le nouveau format source <literal>3.0 (quilt)</literal> conserve les correctifs dans les fichiers <filename>debian/patches/*</filename> en utilisant la commande <command>quilt</command>. Ces correctifs et les autres données de paquet qui sont toutes contenues dans le répertoire <filename>debian</filename> sont empaquetés dans le fichier <filename>debian.tar.gz</filename>. Puisque la commande <command>dpkg-source</command> peut gérer les correctifs au format <command>quilt</command> des sources <literal>3.0 (quilt)</literal> sans le paquet <systemitem role="package">quilt</systemitem>, il n'est pas nécessaire d'ajouter <systemitem role="package">quilt</systemitem> en <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.
fr: Si vous demandez à un parrain d'envoyer le paquet, cette sorte de séparation claire et documentation de vos modifications est très importante pour accélérer l'examen du paquet.

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"/>
fr: La commande <command>quilt</command> est expliquée en <citerefentry> <refentrytitle>quilt</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>. Elle enregistre les modifications des sources comme une pile de fichiers correctifs <literal>-p1</literal> dans le répertoire <filename>debian/patches</filename> et l'arborescence source n'est pas modifiée en dehors du répertoire <filename>debian</filename>. L'ordre d'application de ces correctifs est enregistré dans le fichier <filename>debian/patches/series</filename>. Vous pouvez appliquer (« <literal>push</literal> »), enlever (« <literal>pop</literal> »), et rafraîchir (« <literal>refresh</literal> ») les correctifs facilement. <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>.
fr: En <xref linkend="modify"/>, trois correctifs ont été créés dans <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"/>.
fr: Puisque les correctifs Debian sont localisés en <filename>debian/patches</filename>, veuillez vous assurer d'avoir configuré correctement la commande <command>dquilt</command> conformément à la description en <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:
fr: Quand quelqu'un (éventuellement vous-même) fournit un correctif <filename><replaceable>toto</replaceable>.patch</filename> par la suite, la modification d'un paquet source <literal>3.0 (quilt)</literal> est assez simple :

note: type: Content of: <book><chapter><section><screen>
en: $ dpkg-source -x gentoo_0.9.12.dsc
    $ cd gentoo-0.9.12
    $ dquilt import ../<replaceable>foo</replaceable>.patch
    $ dquilt push
    $ dquilt refresh
    $ dquilt header -e
    ... describe patch
fr: $ dpkg-source -x gentoo_0.9.12.dsc
    $ cd gentoo-0.9.12
    $ dquilt import ../<replaceable>toto</replaceable>.patch
    $ dquilt push
    $ dquilt refresh
    $ dquilt header -e
    ... description du correctif

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>.
fr: Les correctifs conservés au nouveau format source <literal>3.0 (quilt)</literal> doivent être sans approximation (« <emphasis>fuzz</emphasis> »). Vous pouvez vous en assurer avec <literal>dquilt pop -a; while dquilt push; do dquilt refresh; done</literal>.

note: type: Content of: <book><chapter><title>
en: Building the package
fr: Construction du paquet

note: type: Content of: <book><chapter><para>
en: We should now be ready to build the package.
fr: Tout devrait maintenant être prêt pour construire le paquet.

note: type: Content of: <book><chapter><section><title>
en: Complete (re)build
fr: Reconstruction complète

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
fr: Pour réaliser correctement la reconstruction complète d'un paquet, doivent être installés :

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: the <systemitem role="package">build-essential</systemitem> package,
fr: le paquet <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
fr: les paquets énumérés dans le champ <literal>Build-Depends</literal> (consultez <xref linkend="control"/>) ;

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"/>).
fr: les paquets énumérés dans le champ <literal>Build-Depends-indep</literal> (consultez <xref linkend="control"/>).

note: type: Content of: <book><chapter><section><para>
en: Then you issue the following command in the source directory:
fr: Ensuite, exécutez la commande suivante dans le répertoire des sources :

note: type: Content of: <book><chapter><section><para>
en: This will do everything to make full binary and source packages for you.  It will:
fr: Cela fera tout le nécessaire pour créer entièrement les paquets binaires et source à votre place :

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: clean the source tree (<literal>debian/rules clean</literal>)
fr: nettoyage de l'arbre des sources (<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>)
fr: construction du paquet source (<literal>dpkg-source -b</literal>) ;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: build the program (<literal>debian/rules build</literal>)
fr: construction du programme (<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>)
fr: construction des paquets binaires (<literal>fakeroot debian/rules binary</literal>) ;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: make the <filename>.dsc</filename> file
fr: création du fichier <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>
fr: création du fichier <filename>.changes</filename>, en utilisant <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>.
fr: Cette clef GPG doit être signée par un développeur Debian pour être connectée au réseau de confiance et doit être enregistrée dans le <ulink url="&keyring;">trousseau Debian</ulink>. Cela permet à vos paquets d'être acceptés dans l'archive Debian. Consultez la page de <ulink url="&keycreate;">création d'une nouvelle clef GPG</ulink> et le <ulink url="&keysigning;">wiki Debian à propos de la signature de clef</ulink>.

note: type: Content of: <book><chapter><section><para>
en: If the build result is satisfactory one, 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"/>
fr: Si le résultat de la construction est satisfaisant, signez les fichiers <filename>.dsc</filename> et <filename>.changes</filename> avec votre clef privée GPG avec la commande <command>debsign</command>. Vous devez entrer votre phrase secrète deux fois. <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:
fr: Pour un paquet Debian non natif, par exemple <systemitem role="package">gentoo</systemitem>, vous verrez les fichiers suivants dans le répertoire parent (<filename>~/gentoo</filename>) après la construction des paquets :

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 <literal>dh_make -f ../gentoo-0.9.12.tar.gz</literal>.
fr: c'est le code source amont d'origine, simplement renommé pour être conforme aux normes Debian. Il a été créé au début avec <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>.
fr: c'est un résumé du contenu du code source. Il est créé à partir du fichier <filename>control</filename>, et est utilisé pour décompresser les sources avec <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>.
fr: cette archive compressée contient le répertoire <filename>debian</filename>. Tous les ajouts et modifications au code source d'origine sont conservés en tant que correctif <command>quilt</command> dans <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.
fr: Il est possible de ne pas appliquer les correctifs <command>quilt</command> du format source <literal>3.0 (quilt)</literal> à la fin de l'extraction avec l'option <literal>--skip-patches</literal>. Sinon, il est aussi possible d'exécuter <literal>dquilt pop -a</literal> après l'extraction normale.

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"/>
fr: Si quelqu'un d'autre veut recréer le paquet depuis le début, il peut facilement le faire en utilisant ces trois fichiers. La procédure d'extraction est facile : copier simplement ces trois fichiers quelque part et exécuter <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.
fr: c'est le paquet binaire terminé. Vous pouvez utiliser <command>dpkg</command> pour l'installer ou le retirer comme n'importe quel autre paquet ;

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.
fr: ce fichier décrit toutes les modifications effectuées dans la révision actuelle du paquet, et est utilisé par les programmes de maintenance des archives FTP Debian pour y installer les paquets binaires et sources. Il est partiellement créé à partir des fichiers <filename>changelog</filename> et <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.
fr: Au fur et à mesure que vous travaillez sur le paquet, son comportement va évoluer et de nouvelles fonctionnalités seront ajoutées. Les gens qui téléchargent votre paquet peuvent lire ce fichier et voir rapidement ce qui a changé. Les programmes de maintenance des archives Debian vont aussi poster le contenu de ce fichier sur la liste de diffusion <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.
fr: Les fichiers <filename>gentoo_0.9.12-1.dsc</filename> et <filename>gentoo_0.9.12-1_i386.changes</filename> doivent être signés en utilisant la commande <command>debsign</command> avec votre clef privée GPG du répertoire <filename>~/.gnupg/</filename>, avant de les téléverser dans l’archive FTP de Debian. La signature GPG fournit la preuve que ce sont vraiment vos fichiers par l’utilisation de votre clef publique GPG.

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>:
fr: La commande <command>debsign</command> peut être utilisée pour signer avec votre identifiant de clef secrète GPG (utile pour les paquets parrainés) dans <filename>~/.devscripts</filename> comme suit :

note: type: Content of: <book><chapter><section><screen>
en: DEBSIGN_KEYID=Your_GPG_keyID
fr: DEBSIGN_KEYID=Votre_ID_de_clef_GPG

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.
fr: Les longues chaînes de chiffres dans les fichiers <filename>.dsc</filename> et <filename>.changes</filename> sont les sommes SHA1 et SHA256 des fichiers indiqués. Les personnes téléchargeant vos fichiers peuvent les vérifier avec <citerefentry> <refentrytitle>sha1sum</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> ou <citerefentry> <refentrytitle>sha256sum</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, et si les fichiers ne correspondent pas, elles sauront que le fichier a été corrompu ou falsifié.

note: type: Content of: <book><chapter><section><title>
en: Autobuilder
fr: Serveurs d'empaquetage automatique (« autobuilder »)

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.
fr: Le véritable réseau de serveurs d'empaquetage automatique a un fonctionnement autrement plus compliqué que celui présenté ici. De tels détails sortent du cadre de ce document.

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"/>
fr: Debian gère de nombreux <ulink url="&ports;">portages</ulink> avec le <ulink url="&buildd;">réseau de serveurs d'empaquetage automatique</ulink> faisant fonctionner des démons <command>buildd</command> sur de nombreux ordinateurs d'architectures différentes. Même si vous n'avez pas besoin de le faire vous-même, vous devriez être au courant de ce qui va arriver à vos paquets. La suite présente brièvement comment les paquets sont reconstruits sur plusieurs architectures. <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
fr: Les paquets <literal>Architecture: any</literal> sont reconstruits par les serveurs d'empaquetage automatique. Seront installés :

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: the <systemitem role="package">build-essential</systemitem> package, and
fr: le paquet <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"/>).
fr: les paquets énumérés dans le champ <literal>Build-Depends</literal>, (consultez <xref linkend="control"/>).

note: type: Content of: <book><chapter><section><para>
en: Then it issues the following command in the source directory:
fr: Ensuite, la commande suivante est exécutée dans le répertoire des sources :

note: type: Content of: <book><chapter><section><para>
en: This will do everything to make architecture dependent binary packages on another architecture.  It will:
fr: Cela fera tout le nécessaire pour créer entièrement les paquets binaires dépendants de l'architecture sur l'architecture concernée :

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: build architecture dependent binary packages (<literal>fakeroot debian/rules binary-arch</literal>)
fr: construction des paquets binaires dépendants de l'architecture (<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>
fr: signature du fichier source <filename>.dsc</filename>, en utilisant <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>
fr: création et signature du fichier de téléchargement <filename>.changes</filename>, en utilisant <command>dpkg-genchanges</command> et <command>gpg</command>.

note: type: Content of: <book><chapter><section><para>
en: This is why you see your package for other architectures.
fr: C'est pourquoi votre paquet est disponible sur plusieurs architectures.

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.
fr: contrairement à celui du paquet <systemitem role="package">pbuilder</systemitem>, l'environnement <command>chroot</command> du paquet <systemitem role="package">sbuild</systemitem> utilisé par les serveurs d'empaquetage automatique n'est pas forcément minimal et plusieurs paquets peuvent rester installés.

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"/>).
fr: Bien qu'il soit nécessaire d'installer les paquets énumérés dans le champ <literal>Build-Depends-Indep</literal> pour l'empaquetage normal (consultez <xref linkend="completebuild"/>), il n'est pas nécessaire de les installer sur le serveur d'empaquetage automatique puisqu'il ne construit que les paquets binaires dépendants de l'architecture. <placeholder type="footnote" id="0"/> Cette distinction entre l'empaquetage normal et celui des serveurs d'empaquetage automatique permet de déterminer si les paquets doivent être énumérés dans le champ <literal>Build-Depends</literal> ou <literal>Build-Depends-Indep</literal> du fichier <filename>debian/control</filename> (consultez <xref linkend="control"/>).

note: type: Content of: <book><chapter><section><title>
en: <command>debuild</command> command
fr: Commande <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>.
fr: Vous pouvez automatiser le processus de construction en utilisant la commande <command>dpkg-buildpackage</command> et empaqueter ensuite avec la commande <command>debuild</command>, consultez <citerefentry> <refentrytitle>debuild</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.

note: type: Content of: <book><chapter><section><para>
en: The <command>dbuild</command> command executes the <command>lintian</command> command to make the static check after building the Debian package.  The <command>lintian</command> command can be customized with the following in the <filename>~/.devscripts</filename>:
fr: La commande <command>dbuild</command> exécute la commande <command>lintian</command> pour une analyse statique après la construction du paquet Debian. La commande <command>lintian</command> peut être personnalisée dans <filename>~/.devscripts</filename> avec ce qui suit :

note: type: Content of: <book><chapter><section><para>
en: Cleaning the source and rebuilding the package from your user account is as simple as:
fr: Le nettoyage des sources et la reconstruction du paquet avec un compte utilisateur est aussi simple que :

note: type: Content of: <book><chapter><section><para>
en: You can clean the source tree as simply as:
fr: Le nettoyage de l'arborescence des sources est aussi simple que :

note: type: Content of: <book><chapter><section><title>
en: <systemitem role="package">pbuilder</systemitem> package
fr: Paquet <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.
fr: Comme le paquet <systemitem role="package">pbuilder</systemitem> est en constante évolution, vous devriez vérifier les possibilités réelles de la configuration en consultant la dernière documentation officielle.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&buildd-do;"/> for more on Debian package auto-building.
fr: Consultez <ulink url="&buildd-do;"/> pour obtenir plus de renseignements sur le service de construction automatique de paquets 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"/>
fr: Pour un environnement de construction propre (<command>chroot</command>) permettant de vérifier les dépendances de construction, <systemitem role="package">pbuilder</systemitem> est très utile. <placeholder type="footnote" id="0"/> Cela garantit une construction propre des sources en construction automatique sous <literal>sid</literal> pour différentes architectures et évite une erreur sérieuse FTBFS (« Fails To Build From Source » pour les échecs de construction à partir du paquet source), qui est toujours en catégorie RC (« Release Critical », bloquant la publication). <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:
fr: Le paquet <systemitem role="package">pbuilder</systemitem> est personnalisable de la manière suivante :

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.
fr: configuration du répertoire <filename>/var/cache/pbuilder/result</filename> accessible en écriture pour l'utilisateur ;

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.
fr: création d'un répertoire, par exemple <filename><replaceable>/var/cache/pbuilder/hooks</replaceable></filename>, accessible en écriture pour l'utilisateur pour y placer ses scripts 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.
fr: configuration de <filename>~/.pbuilderrc</filename> ou <filename>/etc/pbuilderrc</filename> pour intégrer ce qui suit :

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:
fr: D'abord, le système <command>chroot</command> local de <systemitem role="package">pbuilder</systemitem> doit être initialisé :

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:
fr: Si vous possédez déjà le paquet source terminé, exécutez les commandes suivantes dans le répertoire contenant les fichiers <filename><replaceable>toto</replaceable>.orig.tar.gz</filename>, <filename><replaceable>toto</replaceable>.debian.tar.gz</filename>, et <filename><replaceable>toto</replaceable>.dsc</filename> pour mettre à jour le système <command>chroot</command> de <systemitem role="package">pbuilder</systemitem> et y construire les paquets binaires :

note: type: Content of: <book><chapter><section><screen>
en: $ sudo pbuilder --update
    $ sudo pbuilder --build <replaceable>foo_version</replaceable>.dsc
fr: $ sudo pbuilder --update
    $ sudo pbuilder --build <replaceable>toto_version</replaceable>.dsc

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.
fr: Les paquets nouvellement créés sans signatures GPG sont accessibles en <filename>/var/cache/pbuilder/result/</filename> et n'appartiennent pas au superutilisateur.

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:
fr: Les signatures GPG des fichiers <filename>.dsc</filename> et <filename>.changes</filename> peuvent être créés avec :

note: type: Content of: <book><chapter><section><screen>
en: $ cd /var/cache/pbuilder/result/
    $ debsign <replaceable>foo_version_arch</replaceable>.changes
fr: $ cd /var/cache/pbuilder/result/
    $ debsign <replaceable>toto_version_arch</replaceable>.changes

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:
fr: Si vous possédez une arborescence des sources à jour, mais n'avez pas créé le paquet source correspondant, exécutez plutôt les commandes suivantes dans le répertoire des sources avec le répertoire <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).
fr: Vous pouvez vous connecter à l'environnement <command>chroot</command> avec la commande <literal>pbuilder --login --save-after-login</literal> et le configurer à votre convenance. Cet environnement peut être sauvegardé en quittant l'invite de commande avec <literal>^D</literal> (Contrôle-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.
fr: Cela suppose que <literal>HOOKDIR=/var/cache/pbuilder/hooks</literal> est déjà configuré. De nombreux exemples de scripts hook sont disponibles dans le répertoire <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"/>
fr: La dernière version de la commande <command>lintian</command> peut être exécutée dans l'environnement <literal>chroot</literal> en utilisant le script hook <filename><replaceable>/var/cache/pbuilder/hooks</replaceable>/B90lintian</filename> configuré comme suit : <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><screen>
en: #!/bin/sh
    set -e
    install_packages() {
            apt-get -y --force-yes install "$@"
            }
    install_packages lintian
    echo "+++ lintian output +++"
    su -c "lintian -i -I --show-overrides /tmp/buildd/*.changes" - pbuilder
    # use this version if you don't want lintian to fail the build
    #su -c "lintian -i -I --show-overrides /tmp/buildd/*.changes; :" - pbuilder
    echo "+++ end of lintian output +++"
fr: #!/bin/sh
    set -e
    install_packages() {
        apt-get -y --force-yes install "$@"
        }
    install_packages lintian
    echo "+++ début de lintian +++"
    su -c "lintian -i -I --show-overrides /tmp/buildd/*.changes" - pbuilder
    # utilisez ceci si vous ne voulez pas que lintian arrête la construction
    #su -c "lintian -i -I --show-overrides /tmp/buildd/*.changes; :" - pbuilder
    echo "+++ fin de lintian +++"

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.
fr: Un environnement <literal>sid</literal> à jour est nécessaire pour construire correctement les paquets destinés à <literal>sid</literal>. En pratique, <literal>sid</literal> peut parfois être victime de problèmes qui peuvent rendre non souhaitable la migration de votre système complet. Le paquet <systemitem role="package">pbuilder</systemitem> peut vous aider à faire face à ce genre de situation.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: There are some restrictions for such updates of your <literal>stable</literal> package.
fr: Il existe des restrictions pour de telles mises à jour de paquet <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 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.
fr: Vous pouvez avoir besoin de mettre à jour vos paquets <literal>stable</literal> après sa publication à destination de <literal>stable-proposed-updates</literal>, <literal>stable/updates</literal>, etc. <placeholder type="footnote" id="0"/> Dans ces cas-là, le fait d'utiliser <literal>sid</literal> est une mauvaise excuse pour ne pas les mettre à jour au plus tôt. Le paquet <systemitem role="package">pbuilder</systemitem> vous permet d'accéder à la plupart des distributions dérivées de Debian pour la même architecture.

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>.
fr: Consultez <ulink url="&pbuilder;"/>, <citerefentry> <refentrytitle>pdebuild</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>pbuilderrc</refentrytitle> <manvolnum>5</manvolnum> </citerefentry>, et <citerefentry> <refentrytitle>pbuilder</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>.

note: type: Content of: <book><chapter><section><title>
en: <command>git-buildpackage</command> command and similars
fr: Commande <command>git-buildpackage</command> et similaires

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&debref-vcs;">Version control systems</ulink> for more.
fr: Consultez <ulink url="&debref-vcs;">Systèmes de contrôle de version</ulink> pour obtenir plus de renseignements.

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.
fr: Si les développeurs amont utilisent un système de gestion de version (VCS) <placeholder type="footnote" id="0"/> pour maintenir leur code source, vous devriez envisager de l'utiliser. Cela rend la fusion et la sélection (« cherry-picking ») des correctifs amont plus facile. De nombreux paquets de scripts d'enrobage sont disponibles pour la construction de paquets Debian pour chaque système de gestion de version :

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.
fr: <systemitem role="package">git-buildpackage</systemitem> : assistants pour les paquets Debian en dépôts 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.
fr: <systemitem role="package">svn-buildpackage</systemitem> : assistants pour la maintenance de paquets Debian en dépôt 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.
fr: <systemitem role="package">cvs-buildpackage</systemitem> : scripts pour paquets Debian en dépôt 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.
fr: Le <ulink url="&debian-alioth-wiki;">wiki Debian sur Alioth</ulink> documente la façon d'utiliser le service <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:
fr: L'utilisation de <systemitem role="package">git-buildpackage</systemitem> devient assez populaire parmi les développeurs Debian pour gérer les paquets Debian avec le serveur Git sur <ulink url="&debian-alioth;">alioth.debian.org</ulink>. <placeholder type="footnote" id="0"/> Ce paquet fournit plusieurs commandes pour <emphasis>automatiser</emphasis> les activités d'empaquetage :

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <citerefentry> <refentrytitle>git-import-dsc</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>: import a previous Debian package to a Git repository.
fr: <citerefentry> <refentrytitle>git-import-dsc</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> : importer un paquet Debian existant dans un dépôt Git ;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <citerefentry> <refentrytitle>git-import-orig</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>: import a new upstream tar to a Git repository.
fr: <citerefentry> <refentrytitle>git-import-orig</refentrytitle> <manvolnum></manvolnum> </citerefentry> : importer une nouvelle archive amont dans un dépôt Git ;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <citerefentry> <refentrytitle>git-dch</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>: generate the Debian changelog from Git commit messages.
fr: <citerefentry> <refentrytitle>git-dch</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> : générer le journal des modifications Debian à partir des messages de commit Git ;

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.
fr: <citerefentry> <refentrytitle>git-buildpackage</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> : construire des paquets Debian à partir d'un dépôt 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>.
fr: <citerefentry> <refentrytitle>git-pbuilder</refentrytitle> <manvolnum></manvolnum> </citerefentry> : construire des paquets Debian à partir d'un dépôt Git en utilisant <command>pbuilder</command> ou <command>cowbuilder</command>.

note: type: Content of: <book><chapter><section><para>
en: These commands use 3 branches to track packaging activity:
fr: Ces commandes utilisent trois branches pour suivre les activités d'empaquetage :

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>main</literal> for Debian package source tree.
fr: <literal>main</literal> pour l'arborescence source de paquet Debian ;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>upstream</literal> for upstream source tree.
fr: <literal>upstream</literal> pour l'arborescence source amont ;

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, which are typically kept in an <literal>upstream</literal> branch in the VCS.
fr: L'option <literal>--pristine-tar</literal> invoque la commande <command>pristine-tar</command> qui peut générer une copie exacte de l'archive amont d'origine en n'utilisant qu'un petit fichier de delta binaire et le contenu de l'archive amont, qui est normalement gardé dans une branche <literal>upstream</literal> du système de gestion de version.

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"/>
fr: <literal>pristine-tar</literal> pour l'archive amont générée par l'option <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.
fr: Voici quelques ressources disponibles sur la toile pour les utilisateurs avancés :

note: type: Content of: <book><chapter><section><para><footnote><itemizedlist><listitem><para>
en: Building Debian Packages with git-buildpackage (<filename>&git-buildpackage-doc;</filename>)
fr: Construction de paquets Debian avec git-buildpackage (<filename>&git-buildpackage-doc;</filename>) ;

note: type: Content of: <book><chapter><section><para><footnote><itemizedlist><listitem><para>
en: <ulink url="&debian-packages-git;">debian packages in git</ulink>
fr: <ulink url="&debian-packages-git;">Paquets Debian avec Git</ulink> ;

note: type: Content of: <book><chapter><section><para><footnote><itemizedlist><listitem><para>
en: <ulink url="&git-debian-packaging;">Using Git for Debian Packaging</ulink>
fr: <ulink url="&git-debian-packaging;">Utilisation de Git pour l'empaquetage Debian</ulink> ;

note: type: Content of: <book><chapter><section><para><footnote><itemizedlist><listitem><para>
en: <ulink url="&git-dpm;">git-dpm: Debian packages in Git manager</ulink>
fr: <ulink url="&git-dpm;">git-dpm : paquets Debian en gestionnaire Git</ulink> ;

note: type: Content of: <book><chapter><section><para><footnote><itemizedlist><listitem><para>
en: <ulink url="&topgit;">Using TopGit to generate quilt series for Debian packaging</ulink>
fr: <ulink url="&topgit;">Utilisation de TopGit pour créer un ensemble quilt pour l'empaquetage Debian</ulink>.

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"/>
fr: <systemitem role="package">git-buildpackage</systemitem> peut être configuré dans <filename>~/.gbp.conf</filename>. Consultez <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
fr: Reconstruction rapide

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Environment variables which 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.
fr: Les variables d'environnement qui devraient normalement être configurées correctement à cette étape ne sont pas configurées par cette méthode. Ne créez jamais de vrais paquets pour l'envoi avec cette méthode <emphasis role="strong">rapide</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"/>:
fr: Avec un paquet imposant, vous ne voudrez sans doute pas reconstruire depuis le début chaque fois que vous faites une petite modification à <filename>debian/rules</filename>. Pour tester, vous pouvez faire un fichier <filename>.deb</filename> sans reconstruire les sources amont comme ceci <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:
fr: Ou faites simplement comme suit pour voir s'il y a construction ou non :

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.
fr: Une fois terminés vos ajustements, souvenez-vous de reconstruire en suivant la procédure correcte ci-dessus. Vous pouvez être incapable d'envoyer proprement si vous essayez d'envoyer des fichiers <filename>.deb</filename> construits de cette façon.

note: type: Content of: <book><chapter><section><title>
en: Command hierarchy
fr: Hiérarchie des commandes

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.
fr: Voici un résumé sommaire de la façon dont beaucoup de commandes s’assemblent de manière hiérarchique. Il y a plusieurs manières de faire la même chose :

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <filename>debian/rules</filename> = maintainer script for the package building
fr: <filename>debian/rules</filename> = script du mainteneur pour la construction du paquet ;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <command>dpkg-buildpackage</command> = core of the package building tool
fr: <command>dpkg-buildpackage</command> = partie principale de l’outil de construction de paquet ;

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)
fr: <command>debuild</command> = <command>dpkg-buildpackage</command> + <command>lintian</command> (construction avec des variables d’environnement vérifiées) ;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <command>pbuilder</command> = core of the Debian chroot environment tool
fr: <command>pbuilder</command> = partie principale de l’outil pour l’environnement chroot de 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)
fr: <command>pdebuild</command> = <command>pbuilder</command> + <command>dpkg-buildpackage</command> (construction dans le chroot) ;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <command>cowbuilder</command> = speed up the <command>pbuilder</command> execution
fr: <command>cowbuilder</command> = accélération de l’exécution de <command>pbuilder</command> ;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <command>gbp</command> = manage the Debian source under the git repo
fr: <command>gbp</command> = gestion des sources Debian dans le dépôt git ;

note: type: Content of: <book><chapter><title>
en: Checking the package for errors
fr: Contrôle des erreurs du paquet

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.
fr: Quelques techniques sont à connaître pour rechercher des erreurs sur le paquet avant de l'envoyer sur les archives publiques.

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.
fr: Il est aussi conseillé d'effectuer des essais sur une machine différente de la vôtre. Vous devez observer de près chaque alerte ou erreur pour tous les tests décrits ici.

note: type: Content of: <book><chapter><section><title>
en: Suspicious changes
fr: Modifications suspectes

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"/>.
fr: Si vous trouvez un nouveau fichier de correctif autocréé comme <filename>debian-changes-*</filename> dans le répertoire <filename>debian/patches</filename> après la construction de votre paquet Debian non natif au format <literal>3.0 (quilt)</literal>, il y a des chances que vous ayez accidentellement modifié quelques fichiers ou que le script de construction ait modifié les sources amont. Si c'est de votre faute, corrigez votre erreur. Si c'est provoqué par le script de construction, corrigez l'erreur à la racine avec <command>dh-autoreconf</command> comme en <xref linkend="customrules"/> ou contournez-la avec <filename>source/options</filename> comme en <xref linkend="sourceopt"/>.

note: type: Content of: <book><chapter><section><title>
en: Verifying a package's installation
fr: Vérification de l'installation d'un paquet

note: type: Content of: <book><chapter><section><para>
en: You must test your package for whether it installs without problem.  The <citerefentry> <refentrytitle>debi</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> command helps you to test installing all the generated binary packages.
fr: Vous devez essayer votre paquet pour vérifier qu'il s'installe sans problème. La commande <citerefentry> <refentrytitle>debi</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> vous permet d'essayer l'installation de tout paquet binaire créé.

note: type: Content of: <book><chapter><section><para>
en: To prevent installation problem 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.
fr: Pour éviter les problèmes d'installation sur différents systèmes, vous devez vérifier qu'il n'y a pas de nom de fichier en conflit avec ceux existants dans d'autres paquets à l'aide du fichier <filename>Contents-<replaceable>i386</replaceable></filename> téléchargé depuis l'archive Debian. La commande <command>apt-file</command> peut être pratique pour cela. S'il existe des collisions, veuillez prendre les mesures nécessaires pour éviter ces vrais problèmes : en renommant le fichier, en déplaçant le fichier commun dans un paquet différent dont plusieurs paquets peuvent dépendre, en utilisant le mécanisme d'alternatives (consultez <citerefentry> <refentrytitle>update-alternatives</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>) en coordination avec les responsables de l'autre paquet concerné, ou encore en déclarant une relation de <literal>Conflicts</literal> dans le fichier <filename>debian/control</filename>.

note: type: Content of: <book><chapter><section><title>
en: Verifying a package's maintainer scripts
fr: Vérification des scripts du responsable d'un paquet

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"/>).
fr: Tous les scripts du responsable, (c'est-à-dire les fichiers <filename>preinst</filename>, <filename>prerm</filename>, <filename>postinst</filename> et <filename>postrm</filename>), sont difficiles à écrire correctement, à moins qu'ils n'aient été générés automatiquement par les programmes <systemitem role="package">debhelper</systemitem>. Ne les utilisez donc pas si vous êtes un responsable débutant (consultez <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:
fr: Si le paquet utilise des scripts du responsable non triviaux, veuillez les essayer non seulement pour le processus d'installation, mais aussi les processus de suppression, purge et mise à niveau. De nombreux bogues dans les scripts du responsable surviennent lors de la suppression et de la purge. Utilisez la commande <command>dpkg</command> comme ceci pour les essayer :

note: type: Content of: <book><chapter><section><screen>
en: $ sudo dpkg -r gentoo
    $ sudo dpkg -P gentoo
    $ sudo dpkg -i gentoo_<replaceable>version</replaceable>-<replaceable>revision</replaceable>_<replaceable>i386</replaceable>.deb
fr: $ sudo dpkg -r gentoo
    $ sudo dpkg -P gentoo
    $ sudo dpkg -i gentoo_<replaceable>version</replaceable>-<replaceable>révision</replaceable>_<replaceable>i386</replaceable>.deb

note: type: Content of: <book><chapter><section><para>
en: This should be done with sequences such as the following:
fr: Les séquences suivantes devraient être essayées :

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: install the previous version (if needed).
fr: installation de la version précédente (si elle existe) ;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: upgrade it from the previous version.
fr: mise à niveau depuis la version précédente ;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: downgrade it back to the previous version (optional).
fr: dégradation (« downgrade ») à la version précédente (optionnel) ;

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

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: install the new package.
fr: installation du nouveau paquet ;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: remove it.
fr: suppression (« remove ») du paquet ;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: install it again.
fr: installation du paquet, encore ;

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.
fr: Pour votre premier paquet, vous devriez créer des paquets factices avec différentes versions pour essayer votre paquet à l'avance et éviter des problèmes par la suite.

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.
fr: Gardez à l'esprit que si votre paquet a déjà été publié avec Debian, des gens vont mettre à jour ce paquet à partir de la version qui était dans la publication Debian précédente. N’oubliez pas d'essayer aussi les mises à jour à partir de cette version.

note: type: Content of: <book><chapter><section><para>
en: Although downgrading is not officially supported, supporting it is a friendly gesture.
fr: Même si la réinstallation vers une version antérieure n'est pas officiellement gérée, il est préférable de la permettre.

note: type: Content of: <book><chapter><section><title>
en: Using <systemitem role="package">lintian</systemitem>
fr: Utilisation de <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"/>.
fr: Il n'est pas nécessaire d'ajouter le paramètre <literal>-i -I --show-overrides</literal> à <command>lintian</command> si vous avez personnalisé <filename>/etc/devscripts.conf</filename> ou <filename>~/.devscripts</filename> comme décrit en <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"/>
fr: Exécutez <citerefentry> <refentrytitle>lintian</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> sur le fichier <filename>.changes</filename>. La commande <command>lintian</command> exécute de nombreux scripts de tests pour vérifier la plupart des erreurs habituelles d'empaquetage. <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:
fr: Bien sûr, remplacez le nom de fichier par celui du fichier <filename>.changes</filename> créé pour votre paquet. La sortie de la commande <command>lintian</command> utilise les balises suivants :

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>E:</literal> for error; a sure policy violation or packaging error.
fr: <literal>E:</literal> pour erreur ; une violation certaine de la Charte ou erreur d'empaquetage ;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>W:</literal> for warning; a possible policy violation or packaging error.
fr: <literal>W:</literal> pour avertissement ; une violation possible de la Charte ou erreur d'empaquetage ;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>I:</literal> for info; information on certain aspects of packaging.
fr: <literal>I:</literal> pour information ; une information sur certains aspects d'empaquetage ;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>N:</literal> for note; a detailed message to help your debugging.
fr: <literal>N:</literal> pour note ; un message détaillé pour vous aider à déboguer ;

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.
fr: <literal>O:</literal> pour ignoré ; un message ignoré par le fichier <filename>lintian-overrides</filename> mais affiché avec le paramètre <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"/>.
fr: En cas d'avertissements, mettez au point le paquet pour les éviter ou vérifiez qu'ils sont infondés. S'ils sont infondés, configurez les fichiers <filename>lintian-overrides</filename> comme décrit en <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>.
fr: Vous pouvez reconstruire le paquet avec <command>dpkg-buildpackage</command> et lancer <command>lintian</command> en une seule commande, si vous utilisez <citerefentry> <refentrytitle>debuild</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> ou <citerefentry> <refentrytitle>pdebuild</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.

note: type: Content of: <book><chapter><section><title>
en: The <command>debc</command> command
fr: Commande <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.
fr: La commande <citerefentry> <refentrytitle>debc</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> permet d'énumérer les fichiers du paquet Debian binaire.

note: type: Content of: <book><chapter><section><screen>
en: $ debc <replaceable>package</replaceable>.changes
fr: $ debc <replaceable>paquet</replaceable>.changes

note: type: Content of: <book><chapter><section><title>
en: The <command>debdiff</command> command
fr: Commande <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.
fr: La commande <citerefentry> <refentrytitle>debdiff</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> peut comparer les contenus de fichiers entre deux paquets Debian source

note: type: Content of: <book><chapter><section><screen>
en: $ debdiff <replaceable>old-package</replaceable>.dsc <replaceable>new-package</replaceable>.dsc
fr: $ debdiff <replaceable>ancien-paquet</replaceable>.dsc <replaceable>nouveau-paquet</replaceable>.dsc

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.
fr: La commande <citerefentry> <refentrytitle>debdiff</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> permet aussi de comparer les listes de fichiers entre deux ensembles de paquets Debian binaires.

note: type: Content of: <book><chapter><section><screen>
en: $ debdiff <replaceable>old-package</replaceable>.changes <replaceable>new-package</replaceable>.changes
fr: $ debdiff <replaceable>ancien-paquet</replaceable>.changes <replaceable>nouveau-paquet</replaceable>.changes

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.
fr: Ces commandes sont utiles pour identifier ce qui a été modifié dans les paquets source et pour vérifier d'éventuelles modifications faites par inadvertance lors de la mise à jour des paquets binaires, comme par exemple des fichiers déplacés ou enlevés involontairement.

note: type: Content of: <book><chapter><section><title>
en: The <command>interdiff</command> command
fr: Commande <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.
fr: Vous pouvez comparer deux fichiers <filename>diff.gz</filename> avec la commande <citerefentry> <refentrytitle>interdiff</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>. C'est utile pour vérifier qu'aucune modification involontaire n'a été effectuée sur les sources par le responsable en mettant à jour les paquets à l'ancien format source <literal>1.0</literal>.

note: type: Content of: <book><chapter><section><screen>
en: $ interdiff -z <replaceable>old-package</replaceable>.diff.gz <replaceable>new-package</replaceable>.diff.gz
fr: $ interdiff -z <replaceable>ancien-paquet</replaceable>.diff.gz <replaceable>nouveau-paquet</replaceable>.diff.gz

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.
fr: Le nouveau format source <literal>3.0</literal> garde les modifications dans plusieurs fichiers de correctifs comme décrit en <xref linkend="patches"/>. Vous pouvez aussi suivre les modifications de tous les fichiers <filename>debian/patches/*</filename> en utilisant <command>interdiff</command>.

note: type: Content of: <book><chapter><section><title>
en: The <command>mc</command> command
fr: Commande <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.
fr: Toutes ces opérations d'inspection de fichier peuvent être transformées en un processus intuitif avec un gestionnaire de fichiers comme <citerefentry> <refentrytitle>mc</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> qui vous permet de consulter non seulement le contenu des fichiers paquet <filename>*.deb</filename>, mais aussi les fichiers <filename>*.udeb</filename>, <filename>*.debian.tar.gz</filename>, <filename>*.diff.gz</filename> et <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.
fr: Soyez attentif aux fichiers inutiles ou de taille nulle, dans les paquets binaires et source. Souvent les fichiers inutiles ne sont pas nettoyés correctement ; adaptez le fichier <filename>rules</filename> pour compenser.

note: type: Content of: <book><chapter><title>
en: Updating the package
fr: Mise à jour de paquet

note: type: Content of: <book><chapter><para>
en: After you release a package, you will soon need to update it.
fr: Après la publication d'un paquet, il sera rapidement nécessaire de le mettre à jour.

note: type: Content of: <book><chapter><section><title>
en: New Debian revision
fr: Nouvelle révision 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:
fr: Soit un rapport de bogue numéroté <literal>#654321</literal>, concernant votre paquet et décrivant un problème que vous pouvez résoudre. Voici ce que vous devez faire pour créer une nouvelle révision du paquet :

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If this is to be recorded as a new patch, do the following:
fr: pour un nouveau correctif :

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;
fr: configurer le nom du correctif : <literal>dquilt new <replaceable>nomdubogue.patch</replaceable></literal> ;

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;
fr: déclarer le fichier à modifier : <literal>dquilt add <replaceable>fichier-bogué</replaceable></literal> ;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Correct the problem in the package source for the upstream bug;
fr: corriger le problème dans le paquet source pour le bogue amont ;

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>;
fr: l'enregistrer en <filename><replaceable>nomdubogue.patch</replaceable></filename> : <literal>dquilt refresh</literal> ;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt header -e</literal> to add its description;
fr: ajouter sa description : <literal>dquilt header -e</literal> ;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If this is to update an existing patch, do the following:
fr: pour la mise à jour d'un correctif :

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>;
fr: rappeler le correctif <filename><replaceable>toto.patch</replaceable></filename> existant : <literal>dquilt pop <replaceable>toto.patch</replaceable></literal> ;

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>;
fr: corriger le problème dans l'ancien <filename><replaceable>toto.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>;
fr: mettre à jour <filename><replaceable>toto.patch</replaceable></filename> : <literal>dquilt refresh</literal> ;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt header -e</literal> to update its description;
fr: mettre à jour sa description : <literal>dquilt header -e</literal> ;

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>;
fr: appliquer tous les correctifs en enlevant les approximations (<emphasis>fuzz</emphasis>) : <literal>while dquilt push; do dquilt refresh; done</literal> ;

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>.
fr: Pour obtenir la date au format voulu, utilisez <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"/>
fr: ajouter une nouvelle révision au début du fichier <filename>changelog</filename> Debian, par exemple avec <literal>dch -i</literal>, ou explicitement avec <literal>dch -v <replaceable>version</replaceable>-<replaceable>révision</replaceable></literal>, et ajoutez ensuite les commentaires en utilisant votre éditeur favori ;<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.
fr: ajouter une courte description du bogue et de la solution dans l'entrée du changelog, suivie par <literal>Closes: #654321</literal>. De cette manière, le rapport de bogue sera <emphasis>automagiquement</emphasis> fermé par le logiciel de maintenance des archives une fois le paquet accepté dans l'archive Debian ;

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.
fr: répéter les opérations précédentes pour corriger plus de bogues tout en mettant à jour le fichier <filename>changelog</filename> avec <literal>dch</literal> selon votre besoin ;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Repeat what you did in <xref linkend="completebuild"/> and <xref linkend="checkit"/>.
fr: recommencer ce qui a été fait en <xref linkend="completebuild"/> et <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"/>
fr: une fois satisfait, modifier la valeur de distribution dans <filename>changelog</filename> d'<literal>UNRELEASED</literal> à la valeur de distribution cible <literal>unstable</literal> (ou même <literal>experimental</literal>). <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Upload the package as <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.
fr: envoyer le paquet comme en <xref linkend="upload"/>. La différence est que cette fois, l'archive source originale ne sera pas incluse, car elle n'a pas été modifiée et est déjà dans l'archive 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 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.
fr: Un cas délicat peut se produire quand vous faites un paquet local pour expérimenter l'empaquetage avant d'envoyer la version normale vers l'archive officielle, par exemple <literal><replaceable>1.0.1</replaceable>-<replaceable>1</replaceable></literal>. Pour des mises à niveau plus en douceur, il vaut mieux créer une entrée de <filename>changelog</filename> avec une chaîne de version comme <literal><replaceable>1.0.1</replaceable>-<replaceable>1~rc1</replaceable></literal>. Vous pouvez nettoyer le <filename>changelog</filename> en fusionnant ces entrées de modification en une unique entrée pour le paquet officiel. Consultez <xref linkend="namever"/> pour l'ordre des chaînes de version.

note: type: Content of: <book><chapter><section><title>
en: Inspection of the new upstream release
fr: Examen d'une nouvelle version amont

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.
fr: Lors de la préparation de paquets d'une nouvelle version amont pour l'archive Debian, vous devez commencer par vérifier la nouvelle version amont.

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.
fr: Commencez par lire les <filename>changelog</filename> et <filename>NEWS</filename> amonts, ainsi que toute autre documentation distribuée avec la nouvelle version.

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:
fr: Examinez ensuite les modifications entre les anciennes et nouvelles sources amont, pour guetter tout changement suspect :

note: type: Content of: <book><chapter><section><screen>
en: $ diff -urN <replaceable>foo</replaceable>-<replaceable>oldversion</replaceable> <replaceable>foo</replaceable>-<replaceable>newversion</replaceable>
fr: $ diff -urN <replaceable>toto</replaceable>-<replaceable>ancienneversion</replaceable> <replaceable>toto</replaceable>-<replaceable>nouvelleversion</replaceable>

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.
fr: Les modifications de certains fichiers automatiquement créés par Autotools comme <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> et <filename>Makefile.in</filename> peuvent être ignorées. Vous pouvez les effacer avant d'exécuter <command>diff</command> pour examiner les sources.

note: type: Content of: <book><chapter><section><title>
en: New upstream release
fr: Nouvelle version amont

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.
fr: Si un paquet <systemitem role="package"><replaceable>toto</replaceable></systemitem> est empaqueté avec l'ancien format <literal>1.0</literal>, ce peut plutôt être réalisé en exécutant <literal>zcat /<replaceable>chemin</replaceable>/<replaceable>vers</replaceable>/<replaceable>toto</replaceable>_<replaceable>ancienneversion</replaceable>.diff.gz|patch -p1</literal> depuis la nouvelle arborescence source décompressée.

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:
fr: Si un paquet <systemitem role="package"><replaceable>toto</replaceable></systemitem> est correctement empaqueté au nouveau format <literal>3.0 (native)</literal> ou <literal>3.0 (quilt)</literal>, empaqueter une nouvelle version amont consiste essentiellement à déplacer l'ancien répertoire <filename>debian</filename> dans les nouvelles sources. Ce peut être réalisé en exécutant <literal>tar xvzf /<replaceable>chemin</replaceable>/<replaceable>vers</replaceable>/<replaceable>toto</replaceable>_<replaceable>ancienneversion</replaceable>.debian.tar.gz</literal> depuis la nouvelle arborescence source décompressée. <placeholder type="footnote" id="0"/> Bien sûr, vous devez vous occuper de quelques routines évidentes :

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.
fr: création d'une copie des sources amont dans un fichier <filename>toto_<replaceable>nouvelleversion</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>.
fr: mise à jour du ficher <filename>changelog</filename> Debian avec <literal>dch -v <replaceable>nouvelleversion</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>.
fr: ajout d'une entrée avec <literal>New upstream release.</literal> (nouvelle version amont) ;

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>.
fr: description succincte des modifications <emphasis>dans la nouvelle version amont</emphasis> qui corrigent des bogues et ferment les rapports associés en ajoutant <literal>Closes: #<replaceable>numéro_de_bogue</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>.
fr: description succincte des modifications <emphasis>à la nouvelle version amont</emphasis> par le responsable qui corrigent des bogues et ferment les rapports associés en ajoutant <literal>Closes: #<replaceable>numéro_de_bogue</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>.
fr: application de tous les correctifs en enlevant les approximations (« <emphasis>fuzz</emphasis> ») : <literal>while dquilt push; do dquilt refresh; done</literal>.

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).
fr: Si la fusion des correctifs ne s'applique pas proprement, examinez la situation (des indices sont laissés dans les fichiers <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,
fr: si un correctif appliqué aux sources a été intégré aux sources amont :

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt delete</literal> to remove it.
fr: <literal>dquilt delete</literal> pour l'enlever ;

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,
fr: si un correctif appliqué aux sources entre en confit avec les nouvelles modifications des sources amont :

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>.
fr: <literal>dquilt push -f</literal> pour appliquer les anciens correctifs tout en forçant les rejets comme <filename><replaceable>truc</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>.
fr: édition manuelle du fichier <filename><replaceable>truc</replaceable></filename> pour obtenir le résultat attendu de <filename><replaceable>truc</replaceable>.rej</filename> ;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt refresh</literal> to update the patch.
fr: <literal>dquilt refresh</literal> pour mettre à jour le correctif ;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Continue as usual with <literal>while dquilt push; do dquilt refresh; done</literal>.
fr: continuer comme d'habitude avec <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:
fr: Cette méthode peut être automatisé avec <citerefentry> <refentrytitle>uupdate</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> :

note: type: Content of: <book><chapter><section><screen>
en: $ apt-get source <replaceable>foo</replaceable>
    ...
    dpkg-source: info: extracting <replaceable>foo</replaceable> in <replaceable>foo</replaceable>-<replaceable>oldversion</replaceable>
    dpkg-source: info: unpacking <replaceable>foo</replaceable>_<replaceable>oldversion</replaceable>.orig.tar.gz
    dpkg-source: info: applying <replaceable>foo</replaceable>_<replaceable>oldversion</replaceable>-1.debian.tar.gz
    $ ls -F
    <replaceable>foo</replaceable>-<replaceable>oldversion</replaceable>/
    <replaceable>foo</replaceable>_<replaceable>oldversion</replaceable>-1.debian.tar.gz
    <replaceable>foo</replaceable>_<replaceable>oldversion</replaceable>-1.dsc
    <replaceable>foo</replaceable>_<replaceable>oldversion</replaceable>.orig.tar.gz
    $ wget http://example.org/<replaceable>foo</replaceable>/<replaceable>foo</replaceable>-<replaceable>newversion</replaceable>.tar.gz
    $ cd <replaceable>foo</replaceable>-<replaceable>oldversion</replaceable>
    $ uupdate -v <replaceable>newversion</replaceable> ../<replaceable>foo</replaceable>-<replaceable>newversion</replaceable>.tar.gz
    $ cd ../<replaceable>foo</replaceable>-<replaceable>newversion</replaceable>
    $ while dquilt push; do dquilt refresh; done
    $ dch
    ... document changes made
fr: $ apt-get source <replaceable>toto</replaceable>
    ...
    dpkg-source: info: extraction de <replaceable>toto</replaceable> dans <replaceable>toto</replaceable>-<replaceable>ancienneversion</replaceable>
    dpkg-source: info: extraction de <replaceable>toto</replaceable>_<replaceable>ancienneversion</replaceable>.orig.tar.gz
    dpkg-source: info: extraction de <replaceable>toto</replaceable>_<replaceable>ancienneversion</replaceable>-1.debian.tar.gz
    $ ls -F
    <replaceable>toto</replaceable>-<replaceable>ancienneversion</replaceable>/
    <replaceable>toto</replaceable>_<replaceable>ancienneversion</replaceable>-1.debian.tar.gz
    <replaceable>toto</replaceable>_<replaceable>ancienneversion</replaceable>-1.dsc
    <replaceable>toto</replaceable>_<replaceable>ancienneversion</replaceable>.orig.tar.gz
    $ wget http://example.org/<replaceable>toto</replaceable>/<replaceable>toto</replaceable>-<replaceable>nouvelleversion</replaceable>.tar.gz
    $ cd <replaceable>toto</replaceable>-<replaceable>ancienneversion</replaceable>
    $ uupdate -v <replaceable>nouvelleversion</replaceable> ../<replaceable>toto</replaceable>-<replaceable>nouvelleversion</replaceable>.tar.gz
    $ cd ../<replaceable>toto</replaceable>-<replaceable>nouvelleversion</replaceable>
    $ while dquilt push; do dquilt refresh; done
    $ dch
    ... documentation des modifications réalisées

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.
fr: Si la commande <command>uscan</command> télécharge les sources mises à jour mais n'exécute pas la commande <command>uupdate</command>, vous devriez corriger le fichier <filename>debian/watch</filename> pour avoir <literal>debian uupdate</literal> après l'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"/>
fr: Si le fichier <filename>debian/watch</filename> est configuré comme décrit en <xref linkend="watch"/>, la commande <command>wget</command> est inutile. Exécutez simplement <citerefentry> <refentrytitle>uscan</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> dans le répertoire <filename><replaceable>toto</replaceable>-<replaceable>ancienneversion</replaceable></filename> à la place de la commande <command>uupdate</command> suffit. Les sources mises à jour seront <emphasis>automagiquement</emphasis> recherchées, téléchargées, et la commande <command>uupdate</command> sera exécutée. <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"/>.
fr: Vous pouvez publier ces sources mises à jour en recommençant ce qui a été fait en <xref linkend="completebuild"/>, <xref linkend="checkit"/> et <xref linkend="upload"/>.

note: type: Content of: <book><chapter><section><title>
en: Updating the packaging style
fr: Mise à jour du style d'empaquetage

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.
fr: Si votre parrain ou d'autres responsables s'opposent à la mise à jour du style d'empaquetage existant, ne vous embêtez pas à argumenter. Il y a des choses plus importantes à faire.

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"/>
fr: La mise à jour du style d'empaquetage n'est pas nécessaire lors de la mise à jour d'un paquet. Néanmoins, le faire permet de profiter de tout le potentiel du système <systemitem role="package">debhelper</systemitem> moderne et du format source <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.
fr: si vous devez, pour quelque raison que ce soit, recréer des fichiers modèles qui avaient été effacés, vous pouvez exécuter <command>dh_make</command> à nouveau depuis le répertoire des sources Debian, avec l'option <literal>--addmissing</literal>. Puis modifiez-les de façon adéquate ;

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.
fr: si le paquet n'a pas été mis à jour pour utiliser la syntaxe <command>dh</command> de <systemitem role="package">debhelper</systemitem> v7+ dans le fichier <filename>debian/rules</filename>, mettez-le à jour pour utiliser <command>dh</command>. Mettez à jour le fichier <filename>debian/control</filename> en conséquence ;

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.
fr: si vous voulez mettre à jour le fichier <filename>rules</filename> créé avec le mécanisme d'héritage <filename>Makefile</filename> du système de compilation usuel Debian (<systemitem role="package">cdbs</systemitem>) vers la syntaxe <command>dh</command>, consultez les documents suivants pour comprendre ses variables de configuration <literal>DEB_*</literal> :

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: local copy of <filename>&cdbs-doc;</filename>
fr: copie locale de <filename>&cdbs-doc;</filename> ;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <ulink url="&cdbs-tutorial;">The Common Debian Build System (CDBS), FOSDEM 2009</ulink>
fr: <ulink url="&cdbs-tutorial;">Le système de compilation usuel Debian (CDBS), FOSDEM 2009</ulink> ;

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.
fr: si vous avez un paquet source <literal>1.0</literal> sans fichier <filename><replaceable>toto</replaceable>.diff.gz</filename>, vous pouvez le mettre à jour au récent format source <literal>3.0 (native)</literal> en créant <filename>debian/source/format</filename> contenant <literal>3.0 (native)</literal>. Le reste des fichiers <filename>debian/*</filename> peut être simplement copié ;

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.
fr: vous pouvez découper <filename>gros.diff</filename> en plusieurs petits correctifs incrémentaux avec la commande <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"/>
fr: si vous avez un paquet source <literal>1.0</literal> avec fichier <filename><replaceable>toto</replaceable>.diff.gz</filename>, vous pouvez le mettre à jour au récent format source <literal>3.0 (quilt)</literal> en créant <filename>debian/source/format</filename> contenant <literal>3.0 (quilt)</literal>. Le reste des fichiers <filename>debian/*</filename> peut être simplement copié. Importez le fichier <filename>gros.diff</filename> créé par la commande <literal>filterdiff -z -x '*/debian/*' <replaceable>toto</replaceable>.diff.gz &gt; gros.diff</literal> dans votre système <command>quilt</command>, au besoin ; <placeholder type="footnote" id="0"/>

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.
fr: si l'empaquetage a été créé avec la commande <command>dh</command> et le paramètre <literal>--with quilt</literal> ou les commandes <command>dh_quilt_patch</command> et <command>dh_quilt_unpatch</command>, enlevez-les et utilisez le nouveau format source <literal>3.0 (native)</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.
fr: Vous devriez consulter les <ulink url="&dep;">propositions d'améliorations Debian (DEP - Debian Enhancement Proposals)</ulink> et adopter les propositions marquées « ACCEPTED ».

note: type: Content of: <book><chapter><section><para>
en: You need to do the other tasks described in <xref linkend="newupstream"/>, too.
fr: Les autres tâches décrites en <xref linkend="newupstream"/> sont aussi à effectuer.

note: type: Content of: <book><chapter><section><title>
en: UTF-8 conversion
fr: Conversion en 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.
fr: Si les documents amonts sont encodés avec d'anciens jeux de caractères, les convertir en <ulink url="&utf8;">UTF-8</ulink> peut être utile :

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.
fr: avec <citerefentry> <refentrytitle>iconv</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> pour convertir l'encodage de fichiers texte :

note: type: Content of: <book><chapter><section><itemizedlist><listitem><screen>
en: iconv -f latin1 -t utf8 <replaceable>foo_in.txt</replaceable> &gt; <replaceable>foo_out.txt</replaceable>
fr: iconv -f latin1 -t utf8 <replaceable>truc_entrée.txt</replaceable> &gt; <replaceable>truc_sortie.txt</replaceable>

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.
fr: avec <citerefentry> <refentrytitle>w3m</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> pour convertir les fichiers HTML en fichier texte UTF-8. Assurez-vous d'exécuter cette commande avec des paramètres régionaux en UTF-8 :

note: type: Content of: <book><chapter><section><itemizedlist><listitem><screen>
en: LC_ALL=en_US.UTF-8 w3m -o display_charset=UTF-8 \
            -cols 70 -dump -no-graph -T text/html \
            &lt; <replaceable>foo_in.html</replaceable> &gt; <replaceable>foo_out.txt</replaceable>
fr: LC_ALL=en_US.UTF-8 w3m -o display_charset=UTF-8 \
            -cols 70 -dump -no-graph -T text/html \
            &lt; <replaceable>foo_in.html</replaceable> &gt; <replaceable>truc_sortie.txt</replaceable>

note: type: Content of: <book><chapter><section><title>
en: Reminders for updating packages
fr: Rappels pour la mise à jour de paquets

note: type: Content of: <book><chapter><section><para>
en: Here are few reminders for updating packages:
fr: Voici quelques rappels pour la mise à jour de paquets :

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>.)
fr: préservez les anciennes entrées <filename>changelog</filename> (cela va de soit, mais des personnes ont parfois utilisé <literal>dch</literal> au lieu de <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.
fr: les modifications Debian existantes doivent être réévaluées ; jetez tout ce qui a été incorporé en amont (sous une forme ou une autre), et souvenez-vous de garder ce qui ne l'a pas été, à moins qu'il n'y ait une bonne raison de ne pas le faire ;

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.
fr: si le système de construction a été modifié (avec un peu de chance, vous êtes au courant depuis l'inspection des modifications amont), mettez à jour les dépendances de construction <filename>debian/rules</filename> et <filename>debian/control</filename>, si besoin est ;

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.
fr: vérifiez dans le <ulink url="&bts;">système de gestion de bogues (BTS)</ulink> que personne n'a fourni de correctifs aux bogues ouverts ;

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.
fr: vérifiez le contenu du fichier <filename>.changes</filename> pour vous assurer que vous envoyez vers la bonne distribution, que les rapports de bogue refermés sont correctement listés dans les champs <literal>Closes</literal>, que les champs <literal>Maintainer</literal> et <literal>Changed-By</literal> correspondent, que le fichier est signé avec GPG, etc.

note: type: Content of: <book><chapter><title>
en: Uploading the package
fr: Envoi de paquet

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.
fr: Maintenant que votre nouveau paquet a été testé en détail, vous voulez le publier sur une archive publique afin de le partager.

note: type: Content of: <book><chapter><section><title>
en: Uploading to the Debian archive
fr: Envoi vers l'archive Debian

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <xref linkend="socialdynamics"/>.
fr: Consultez <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.
fr: Des archives publiquement accessibles comme <ulink url="&mentors-dn;"/> qui fonctionnent à peu près de la même façon que l'archive Debian fournissent un espace d'envoi accessible publiquement aux non-DD (développeurs Debian). Vous pouvez configurer vous-même une archive équivalente en utilisant les outils de <ulink url="&deb-archive;"/>. Cette section est donc utile aussi aux 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.
fr: Le paquet <systemitem role="package">dput</systemitem> semble fournir plus de fonctionnalités, et devient plus populaire que le paquet <systemitem role="package">dupload</systemitem>. Il utilise le fichier <filename>/etc/dput</filename> pour la configuration globale et le fichier <filename>~/.dput.cf</filename> pour la configuration par utilisateur. Il gère aussi d’origine les services relatifs à 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"/>
fr: Une fois devenu un développeur Debian officiel, <placeholder type="footnote" id="0"/> vous pouvez envoyer le paquet sur les archives Debian. <placeholder type="footnote" id="1"/> Vous pouvez le faire vous-même, mais il est plus facile d'utiliser les outils automatiques existants, comme <citerefentry> <refentrytitle>dupload</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> ou <citerefentry> <refentrytitle>dput</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>. Nous décrirons la façon de faire avec <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.
fr: D'abord vous devez écrire le fichier de configuration de <command>dupload</command>. Vous pouvez soit éditer le fichier global <filename>/etc/dupload.conf</filename>, soit avoir votre propre fichier <filename>~/.dupload</filename> pour remplacer les quelques détails que vous voulez changer.

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.
fr: Vous pouvez lire la page de manuel <citerefentry> <refentrytitle>dupload.conf</refentrytitle> <manvolnum>5</manvolnum> </citerefentry> pour comprendre ce que chacune de ces options signifie.

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>.
fr: Consultez la <ulink url="&devref-upload;">référence du Développeur Debian 5.6. « Envois de paquets »</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"/>
fr: L'option <literal>$default_host</literal> détermine la file de téléchargement qui sera utilisée par défaut. <literal>anonymous-ftp-master</literal> est la principale, mais il est possible que vous souhaitiez en utiliser une autre. <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:
fr: Une fois connecté à Internet, vous pouvez envoyer le paquet :

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.
fr: <command>dupload</command> vérifie que les sommes SHA1 et SHA256 des fichiers correspondent à celles du fichier <filename>.changes</filename>. Dans le cas contraire, un avertissement proposera de le reconstruire comme décrit en <xref linkend="completebuild"/> pour pouvoir charger le fichier correctement.

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.
fr: Consultez <ulink url="&uploadqueue-readme;"/>. Vous pouvez aussi utiliser la commande <command>dcut</command> du paquet <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>:
fr: Si vous rencontrez un problème d'envoi à <ulink url="&uploadqueue;"/>, vous pouvez le résoudre manuellement en envoyant un fichier <filename>*.commands</filename> signé avec GPG à <ulink url="&uploadqueue;"/> avec <command>ftp</command>. <placeholder type="footnote" id="0"/> Par exemple en utilisant <filename>hello.commands</filename> :

note: type: Content of: <book><chapter><section><screen>
en: -----BEGIN PGP SIGNED MESSAGE-----
    Hash: SHA1
    Uploader: Foo Bar &lt;Foo.Bar@example.org&gt;
    Commands: 
     rm hello_1.0-1_i386.deb
     mv hello_1.0-1.dsx hello_1.0-1.dsc
    -----BEGIN PGP SIGNATURE-----
    Version: GnuPG v1.4.10 (GNU/Linux)
    
    [...]
    -----END PGP SIGNATURE-----
fr: -----BEGIN PGP SIGNED MESSAGE-----
    Hash: SHA1
    Uploader: Machin Bidule &lt;Machin.Bidule@example.org&gt;
    Commands: 
     rm hello_1.0-1_i386.deb
     mv hello_1.0-1.dsx hello_1.0-1.dsc
    -----BEGIN PGP SIGNATURE-----
    Version: GnuPG v1.4.10 (GNU/Linux)
    
    [...]
    -----END PGP SIGNATURE-----

note: type: Content of: <book><chapter><section><title>
en: Including <filename>orig.tar.gz</filename> for upload
fr: Inclusion de <filename>orig.tar.gz</filename> pour l'envoi

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>.
fr: Lors du premier envoi d'un paquet vers l'archive, il faut aussi inclure les sources <filename>orig.tar.gz</filename> d'origine. Si le numéro de révision Debian de ce paquet n'est ni <literal>1</literal> ni <literal>0</literal>, vous devez passer l'option <literal>-sa</literal> à la commande <command>dpkg-buildpackage</command>.

note: type: Content of: <book><chapter><section><para>
en: For the <command>dpkg-buildpackage</command> command:
fr: Pour la commande <command>dpkg-buildpackage</command> :

note: type: Content of: <book><chapter><section><para>
en: For the <command>debuild</command> command:
fr: Pour la commande <command>debuild</command> :

note: type: Content of: <book><chapter><section><para>
en: For the <command>pdebuild</command> command:
fr: Pour la commande <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.
fr: D'un autre côté, l'option <literal>-sd</literal> forcera l'exclusion des sources <filename>orig.tar.gz</filename> originales.

note: type: Content of: <book><chapter><section><title>
en: Skipped uploads
fr: Versions non envoyées

note: type: Content of: <book><appendix><title>
en: Advanced packaging
fr: Empaquetage avancé

note: type: Content of: <book><appendix><para>
en: Here are some hints and pointers for advanced packaging topics which you are most likely to deal with.  You are strongly advised to read all the references suggested here.
fr: Voici quelques conseils et pointeurs pour des sujets d'empaquetage avancé auxquels vous serez sans doute confrontés. La lecture de toutes les références suggérées ici est vivement recommandée.

note: type: Content of: <book><appendix><section><title>
en: Shared libraries
fr: Bibliothèques partagées

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:
fr: Avant d'empaqueter des <ulink url="&library;">bibliothèques</ulink> partagées, vous devriez lire les références essentielles suivantes avec attention :

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <ulink url="&policy-sharedlibraries;">Debian Policy Manual, 8 "Shared libraries"</ulink>
fr: <ulink url="&policy-sharedlibraries;">Charte Debian, 8 « Bibliothèques partagées »</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>
fr: <ulink url="&policy-fhs;">Charte Debian, 9.1.1 « Structure de système de fichiers »</ulink> ;

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <ulink url="&policy-libraries;">Debian Policy Manual, 10.2 "Libraries"</ulink>
fr: <ulink url="&policy-libraries;">Charte Debian, 10.2 « Bibliothèques »</ulink>.

note: type: Content of: <book><appendix><section><para>
en: Here are some oversimplified hints for you to get started:
fr: Voici quelques conseils simplifiés à l'extrême pour commencer :

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Shared libraries are <ulink url="&elf;">ELF</ulink> object files containing compiled code.
fr: les bibliothèques partagées sont des fichiers objet <ulink url="&elf;">ELF</ulink> contenant du code compilé ;

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)
fr: les bibliothèques partagées sont distribuées en fichiers <filename>*.so</filename> (pas en fichiers <filename>*.a</filename> ni en fichiers <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.
fr: les bibliothèques partagées sont surtout utilisées pour partager du code commun à plusieurs exécutables avec le mécanisme <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.
fr: les bibliothèques partagées sont parfois utilisées pour fournir plusieurs greffons à un exécutable avec le mécanisme <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 enables access to them from the linked executables.
fr: les bibliothèques partagées exportent des <ulink url="&symbol;">symboles</ulink> qui représentent des objets compilés comme des variables, des fonctions et des classes ; elles permettent qu’on y accède à partir des exécutables liés ;

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>
fr: Alternative : <literal>readelf -d lib<replaceable>truc</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"/>
fr: le <ulink url="&soname;">SONAME</ulink> d'une bibliothèque partagée <filename>lib<replaceable>truc</replaceable>.so</filename>.<replaceable>1</replaceable> : <literal>objdump -p lib<replaceable>truc</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).
fr: le SONAME d'une bibliothèque partagée correspond normalement au nom du fichier de bibliothèque (mais pas toujours) ;

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>
fr: Alternative : <literal>readelf -d lib<replaceable>truc</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"/>
fr: le SONAME d'une bibliothèque partagée liée à <filename><replaceable>/usr/bin/truc</replaceable></filename> : <literal>objdump -p <replaceable>/usr/bin/truc</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>.
fr: Consultez la <ulink url="&policy-runtime;">Charte Debian, 8.1 « Bibliothèques partagées au moment de l'exécution »</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"/>
fr: <systemitem role="package">lib<replaceable>truc</replaceable><replaceable>1</replaceable></systemitem> : le paquet de bibliothèque pour la bibliothèque partagée <filename>lib<replaceable>truc</replaceable>.so.<replaceable>1</replaceable></filename> avec la version d'ABI SONAME <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>.
fr: Consultez la <ulink url="&policy-ldconfig;">Charte 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"/>
fr: les scripts du responsable du paquet de bibliothèque doivent appeler <command>ldconfig</command> dans des circonstances particulières pour créer les liens symboliques nécessaires au 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 which contains the debugging symbols for the shared library package <systemitem role="package">lib<replaceable>foo</replaceable><replaceable>1</replaceable></systemitem>.
fr: <systemitem role="package">lib<replaceable>truc</replaceable><replaceable>1</replaceable>-dbg</systemitem> : le paquet de symboles de débogage qui contient les symboles de débogage du paquet de bibliothèque partagée <systemitem role="package">lib<replaceable>truc</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>.
fr: Consultez la <ulink url="&policy-static;">Charte Debian, 8.3 « Bibliothèques statiques »</ulink> et la <ulink url="&policy-dev;">Charte Debian, 8.4 « Fichiers de développement »</ulink>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <systemitem role="package">lib<replaceable>foo</replaceable>-dev</systemitem>: the development package which contains the header files etc. for the shared library <filename>lib<replaceable>foo</replaceable>.so.<replaceable>1</replaceable></filename>.<placeholder type="footnote" id="0"/>
fr: <systemitem role="package">lib<replaceable>truc</replaceable>-dev</systemitem> : le paquet de développement qui contient les fichiers d'en-têtes, etc. de la bibliothèque partagée <filename>lib<replaceable>truc</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>.
fr: Consultez le <ulink url="&removela;">wiki Debian sur l'objectif de publication relatif à la suppression des fichiers <filename>*.la</filename></ulink>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Debian package should not contain <filename>*.la</filename> Libtool archive files in general.<placeholder type="footnote" id="0"/>
fr: les paquets Debian ne devraient normalement pas contenir de fichiers d'archive 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>.
fr: Consultez le <ulink url="&rpathissues;">wiki Debian sur les problèmes avec RPATH<filename>*.la</filename></ulink>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Debian package should not use RPATH in general.<placeholder type="footnote" id="0"/>
fr: les paquets Debian ne devraient normalement pas utiliser 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.
fr: bien qu'il soit dépassé et que ce ne soit qu'une référence secondaire, le <ulink url="&debianlibrarypackagingguide;">guide d'empaquetage de bibliothèques Debian</ulink> peut encore être utile.

note: type: Content of: <book><appendix><section><title>
en: Managing <filename>debian/<replaceable>package</replaceable>.symbols</filename>
fr: Gestion de <filename>debian/<replaceable>paquet</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.
fr: Les modifications d'ABI non rétrocompatibles devraient normalement nécessiter une mise à jour du SONAME de la bibliothèque et du nom de paquet de la bibliothèque partagée.

note: type: Content of: <book><appendix><section><para>
en: When you package a shared library, you should create <filename>debian/<replaceable>package</replaceable>.symbols</filename> file to manage the minimal version associated to 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:
fr: Lors de l'empaquetage d'une bibliothèque partagée, il faut créer un fichier <filename>debian/<replaceable>paquet</replaceable>.symbols</filename> pour gérer la version minimale associée à chaque symbole pour les modifications d'ABI rétrocompatibles sous le même SONAME de la bibliothèque pour le même nom de paquet de bibliothèque partagée.<placeholder type="footnote" id="0"/> Vous devriez lire les références essentielles suivantes avec attention :

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.
fr: Pour les bibliothèques C++ et d'autres cas lorsque le suivi de symboles individuels est trop compliqué, suivez plutôt la <ulink url="&policy-library-shlibs;">Charte Debian, 8.6.4 « Le système de shlibs »</ulink>.

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"/>
fr: <ulink url="&policy-library-symbols;">Charte Debian, 8.6.3 « Le système de symboles »</ulink> ;<placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <citerefentry> <refentrytitle>dh_makeshlibs</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>
fr: <citerefentry> <refentrytitle>dh_makeshlibs</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> ;

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <citerefentry> <refentrytitle>dpkg-gensymbols</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>
fr: <citerefentry> <refentrytitle>dpkg-gensymbols</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> ;

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <citerefentry> <refentrytitle>dpkg-shlibdeps</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>
fr: <citerefentry> <refentrytitle>dpkg-shlibdeps</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> ;

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <citerefentry> <refentrytitle>deb-symbols</refentrytitle> <manvolnum>5</manvolnum> </citerefentry>
fr: <citerefentry> <refentrytitle>deb-symbols</refentrytitle> <manvolnum>5</manvolnum> </citerefentry>.

note: type: Content of: <book><appendix><section><para>
en: Here is a rough example to create the <systemitem role="package">libfoo1</systemitem> package to the upstream version <literal>1.3</literal> with the proper <filename>debian/libfoo1.symbols</filename> file:
fr: Voici un exemple grossier de création du paquet <systemitem role="package">libtruc1</systemitem> à la version amont <literal>1.3</literal> avec le fichier <filename>debian/libtruc1.symbols</filename> adéquat :

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.
fr: préparer le squelette d'arborescence source Debian en utilisant le fichier amont <filename>libtruc-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.
fr: s'il s'agit du premier empaquetage du paquet <systemitem role="package">libtruc1</systemitem>, créer le fichier vide <filename>debian/libtruc1.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.
fr: si la version amont précédente <literal>1.2</literal> a été empaquetée en tant que paquet <systemitem role="package">libtruc1</systemitem> contenant le fichier <filename>debian/libtruc1.symbols</filename> adéquat dans son paquet source, le réutiliser ;

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>
fr: Toutes les versions précédentes des paquets Debian sont disponibles sur <ulink url="&snapshot;">http://snapshot.debian.org/</ulink>. La révision Debian est supprimée de la version pour faciliter le rétroportage du paquet : <literal>1.1</literal> &lt;&lt; <literal>1.1-1~bpo70+1</literal> &lt;&lt; <literal>1.1-1</literal> et <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 the <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"/>
fr: si la version amont précédente <literal>1.2</literal> n'a pas été empaquetée avec le fichier <filename>debian/libtruc1.symbols</filename> adéquat, le créer comme fichier <filename>symbols</filename> à partir de tous les paquets binaires disponibles de même nom de paquet de bibliothèque partagée contenant le même SONAME de la bibliothèque, par exemple de versions <literal>1.1-1</literal> et <literal>1.2-1</literal> :<placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><screen>
en: $ dpkg-deb -x libfoo1_1.1-1.deb libfoo1_1.1-1
    $ dpkg-deb -x libfoo1_1.2-1.deb libfoo1_1.2-1
    $ : > symbols
    $ dpkg-gensymbols -v1.1 -plibfoo1 -Plibfoo1_1.1-1 -Osymbols
    $ dpkg-gensymbols -v1.2 -plibfoo1 -Plibfoo1_1.2-1 -Osymbols
fr: $ dpkg-deb -x libtruc1_1.1-1.deb libtruc1_1.1-1
    $ dpkg-deb -x libtruc1_1.2-1.deb libtruc1_1.2-1
    $ : > symbols
    $ dpkg-gensymbols -v1.1 -plibtruc1 -Plibtruc1_1.1-1 -Osymbols
    $ dpkg-gensymbols -v1.2 -plibtruc1 -Plibtruc1_1.2-1 -Osymbols

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 which require you to bump the shared library package name to something like <systemitem role="package">libfoo1a</systemitem> and you should start over again.)
fr: essayer de construire depuis l'arborescence source avec des outils comme <command>debuild</command> et <command>pdebuild</command> (en cas d'échecs dus à des symboles manquants, etc., c'est qu'il y a eu des modifications d'ABI non rétrocompatibles qui nécessitent de changer le nom de paquet de bibliothèque partagée en quelque chose comme <systemitem role="package">libtruc1a</systemitem> avant de recommencer) :

note: type: Content of: <book><appendix><section><itemizedlist><listitem><screen>
en: $ cd libfoo-1.3
    $ debuild
    ...
    dpkg-gensymbols: warning: some new symbols appeared in the symbols file: ...
     see diff output below
    --- debian/libfoo1.symbols (libfoo1_1.3-1_amd64)
    +++ dpkg-gensymbolsFE5gzx        2012-11-11 02:24:53.609667389 +0900
    @@ -127,6 +127,7 @@
      foo_get_name@Base 1.1
      foo_get_longname@Base 1.2
      foo_get_type@Base 1.1
    + foo_get_longtype@Base 1.3-1
      foo_get_symbol@Base 1.1
      foo_get_rank@Base 1.1
      foo_new@Base 1.1
    ...
fr: $ cd libtruc-1.3
    $ debuild
    ...
    dpkg-gensymbols: warning: some new symbols appeared in the symbols file: ...
     see diff output below
    --- debian/libtruc1.symbols (libtruc1_1.3-1_amd64)
    +++ dpkg-gensymbolsFE5gzx        2012-11-11 02:24:53.609667389 +0900
    @@ -127,6 +127,7 @@
      truc_get_name@Base 1.1
      truc_get_longname@Base 1.2
      truc_get_type@Base 1.1
    + truc_get_longtype@Base 1.3-1
      truc_get_symbol@Base 1.1
      truc_get_rank@Base 1.1
      truc_new@Base 1.1
    ...

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>
fr: La révision Debian est supprimée de la version pour faciliter le rétroportage du paquet : <literal>1.1</literal> &lt;&lt; <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 updated proper <filename>symbols</filename> file from the generated binary package of the shared library.  <placeholder type="footnote" id="0"/>
fr: si un différentiel est affiché par <command>dpkg-gensymbols</command> comme ci-dessus, extraire le fichier <filename>symbols</filename> du paquet binaire généré de la bibliothèque partagée :<placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><screen>
en: $ cd ..
    $ dpkg-deb -R  libfoo1_1.3_amd64.deb libfoo1-tmp
    $ sed -e 's/1\.3-1/1\.3/' libfoo1-tmp/DEBIAN/symbols \
            >libfoo-1.3/debian/libfoo1.symbols
fr: $ cd ..
    $ dpkg-deb -R  libtruc1_1.3_amd64.deb libtruc1-tmp
    $ sed -e 's/1\.3-1/1\.3/' libtruc1-tmp/DEBIAN/symbols \
            >libtruc-1.3/debian/libtruc1.symbols

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>.
fr: construire les paquets pour la publication avec des outils comme <command>debuild</command> et <command>pdebuild</command> :

note: type: Content of: <book><appendix><section><itemizedlist><listitem><screen>
en: $ cd libfoo-1.3
    $ debuild clean
    $ debuild
    ...
fr: $ cd libtruc-1.3
    $ debuild clean
    $ debuild
    ...

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>.
fr: Consultez la <ulink url="&policy-library-abi;">Charte Debian, 8.6.2 « Modifications d'ABI dans les bibliothèques partagées »</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"/>
fr: En plus des exemples précédents, il faut vérifier plus profondément la compatibilité d'ABI et changer vous-même les versions de certains symboles si nécessaire. <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.
fr: Bien que ce ne soit qu'une référence secondaire, le <ulink url="&usingsymbolsfiles;">wiki Debian sur l'utilisation de fichiers symboles</ulink> et les pages web qui y sont liées peuvent être utiles.

note: type: Content of: <book><appendix><section><title>
en: Multiarch
fr: Multiarchitecture

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:
fr: La fonctionnalité de multiarchitecture introduite dans Debian Wheezy intègre la prise en charge pour l'installation interarchitecture de paquets binaires (en particulier entre <literal>i386</literal> et <literal>amd64</literal>, mais aussi d'autres combinaisons) dans <systemitem role="package">dpkg</systemitem> et <systemitem role="package">apt</systemitem>. Vous devriez lire les références suivantes avec attention :

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <ulink url="&multiarchspec;">Ubuntu wiki MultiarchSpec</ulink> (upstream)
fr: <ulink url="&multiarchspec;">wiki Ubuntu sur la spécification multiarchitecture</ulink> (amont) ;

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <ulink url="&multiarchimplementation;">Debian wiki Multiarch/Implementation</ulink> (Debian situation)
fr: <ulink url="&multiarchimplementation;">wiki Debian sur le multiarchitecture et son implémentation</ulink> (situation dans Debian).

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 any more.
fr: Certains anciens chemins de bibliothèques particulières comme <filename>/lib32/</filename> et <filename>/lib64/</filename> ne sont plus utilisés.

note: type: Content of: <book><appendix><section><informaltable><tgroup><thead><row><entry>
en: Old path
fr: Ancien chemin

note: type: Content of: <book><appendix><section><informaltable><tgroup><thead><row><entry>
en: i386 multiarch path
fr: Chemin multiarchitecture i386

note: type: Content of: <book><appendix><section><informaltable><tgroup><thead><row><entry>
en: amd64 multiarch path
fr: Chemin multiarchitecture amd64

note: type: Content of: <book><appendix><section><para>
en: Here are some typical multiarch package split scenario examples for the followings:
fr: Voici quelques exemples typiques de scénarios de découpage de paquet multiarchitecture pour les paquets suivants :

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: a library source <filename>lib<replaceable>foo</replaceable>-1.tar.gz</filename>
fr: une bibliothèque source <filename>lib<replaceable>truc</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
fr: un outil source <filename><replaceable>bidule</replaceable>-1.tar.gz</filename> écrit en langage compilé ;

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
fr: un outil source <filename><replaceable>machin</replaceable>-tar.gz</filename> écrit en langage interprété :

note: type: Content of: <book><appendix><section><informaltable><tgroup><thead><row><entry>
en: Package
fr: Paquet

note: type: Content of: <book><appendix><section><informaltable><tgroup><thead><row><entry>
en: Architecture:
fr: Architecture

note: type: Content of: <book><appendix><section><informaltable><tgroup><thead><row><entry>
en: Multi-Arch:
fr: Multi-Arch

note: type: Content of: <book><appendix><section><informaltable><tgroup><thead><row><entry>
en: Package content
fr: Contenu du paquet

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: <systemitem role="package">lib<replaceable>foo</replaceable><replaceable>1</replaceable></systemitem>
fr: <systemitem role="package">lib<replaceable>truc</replaceable><replaceable>1</replaceable></systemitem>

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the shared library, co-installable
fr: la bibliothèque partagée, co-installable

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: <systemitem role="package">lib<replaceable>foo</replaceable><replaceable>1</replaceable>-dbg</systemitem>
fr: <systemitem role="package">lib<replaceable>truc</replaceable><replaceable>1</replaceable>-dbg</systemitem>

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the shared library debug symbols, co-installable
fr: les symboles de débogage de bibliothèque partagée, co-installable

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: <systemitem role="package">lib<replaceable>foo</replaceable>-dev</systemitem>
fr: <systemitem role="package">lib<replaceable>truc</replaceable>-dev</systemitem>

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the shared library header files etc., co-installable
fr: les fichiers d'en-tête, etc. de bibliothèque partagée, co-installable

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: <systemitem role="package">lib<replaceable>foo</replaceable>-tools</systemitem>
fr: <systemitem role="package">lib<replaceable>truc</replaceable>-tools</systemitem>

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the run-time support programs, not co-installable
fr: les programmes de prise en charge en cours d'exécution, non co-installable

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: <systemitem role="package">lib<replaceable>foo</replaceable>-doc</systemitem>
fr: <systemitem role="package">lib<replaceable>truc</replaceable>-doc</systemitem>

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the shared library documentation files
fr: les fichiers de documentation de bibliothèque partagée

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: <systemitem role="package"><replaceable>bar</replaceable></systemitem>
fr: <systemitem role="package"><replaceable>bidule</replaceable></systemitem>

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the compiled program files, not co-installable
fr: les fichiers du programme compilé, non co-installable

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: <systemitem role="package"><replaceable>bar</replaceable>-doc</systemitem>
fr: <systemitem role="package"><replaceable>bidule</replaceable>-doc</systemitem>

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the documentation files for the program
fr: les fichiers de documentation du programme

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: <systemitem role="package"><replaceable>baz</replaceable></systemitem>
fr: <systemitem role="package"><replaceable>machin</replaceable></systemitem>

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the interpreted program files
fr: les fichiers du programme interprété

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>
fr: Veuillez remarquer que le paquet de développement devrait contenir un lien symbolique vers la bibliothèque partagée associée <emphasis role="strong">sans numéro de version</emphasis>. Par exemple : <filename>/usr/lib/x86_64-linux-gnu/libtruc.so</filename> → <filename>libtruc.so.1</filename>.

note: type: Content of: <book><appendix><section><title>
en: Building a shared library package
fr: Construction d'un paquet de bibliothèque partagée

note: type: Content of: <book><appendix><section><para>
en: You can build a Debian library package enabling the multiarch support using <citerefentry> <refentrytitle>dh</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> as follows:
fr: Un paquet de bibliothèque partagée peut être construit en activant la prise en charge multiarchitecture en utilisant <citerefentry> <refentrytitle>dh</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> comme ceci :

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Update <filename>debian/control</filename>.
fr: mettre à jour <filename>debian/control</filename> :

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Add <literal>Build-Depends: debhelper (>=9)</literal> for the source package section.
fr: ajouter <literal>Build-Depends: debhelper (>=9)</literal> à la section du paquet source ;

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.
fr: ajouter <literal>Pre-Depends: ${misc:Pre-Depends}</literal> pour chaque paquet binaire de bibliothèque partagée ;

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Add <literal>Multi-Arch:</literal> stanza for each binary package section.
fr: ajouter la définition <literal>Multi-Arch:</literal> à chaque section de paquet binaire ;

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Set <filename>debian/compat</filename> to "9".
fr: définir <filename>debian/compat</filename> à « 9 » ;

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.
fr: ajuster le chemin classique <literal>/usr/lib/</literal> en <literal>/usr/lib/$(DEB_HOST_MULTIARCH)/</literal> multiarchitecture pour tous les scripts d'empaquetage :

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 <literal>DEB_HOST_MULTIARCH</literal> variable, first.
fr: appeler d'abord <literal>DEB_HOST_MULTIARCH ?= $(shell dpkg-architecture -qDEB_HOST_MULTIARCH)</literal> dans <filename>debian/rules</filename> pour définir la variable <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>.
fr: remplacer <literal>/usr/lib/</literal> par <literal>/usr/lib/$(DEB_HOST_MULTIARCH)/</literal> dans <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>.
fr: Sinon, les arguments <literal>--libdir=\$${prefix}/lib/$(DEB_HOST_MULTIARCH)</literal> et <literal>--libexecdir=\$${prefix}/lib/$(DEB_HOST_MULTIARCH)</literal> peuvent être ajoutés à <literal>./configure</literal>. Veuillez remarquer que <literal>--libexecdir</literal> indique le chemin par défaut pour installer les programmes exécutables démarrés par d'autres programmes plutôt que par des utilisateurs. Sa valeur Autotools par défaut est <filename>/usr/libexec/</filename> mais sa valeur Debian par défaut est <filename>/usr/lib/</filename>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: If <literal>./configure</literal> is used in the part of <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"/>
fr: si <literal>./configure</literal> est utilisé par la cible <literal>override_dh_auto_configure</literal> dans <filename>debian/rules</filename>, assurez-vous de le remplacer par <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.
fr: remplacer toutes les occurrences de <literal>/usr/lib/</literal> par <literal>/usr/lib/*/</literal> dans les fichiers <filename>debian/<replaceable>truc</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 <literal>override_dh_auto_configure</literal> target in <filename>debian/rules</filename>.
fr: générer les fichiers comme <filename>debian/<replaceable>truc</replaceable>.links</filename> à partir de <filename>debian/<replaceable>truc</replaceable>.links.in</filename> dynamiquement en ajoutant un script à la cible <literal>override_dh_auto_configure</literal> dans <filename>debian/rules</filename> :

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><screen>
en: override_dh_auto_configure:
            dh_auto_configure
            sed 's/@DEB_HOST_MULTIARCH@/$(DEB_HOST_MULTIARCH)/g' \
                    debian/<replaceable>foo</replaceable>.links.in > debian/<replaceable>foo</replaceable>.links
fr: override_dh_auto_configure:
            dh_auto_configure
            sed 's/@DEB_HOST_MULTIARCH@/$(DEB_HOST_MULTIARCH)/g' \
                    debian/<replaceable>truc</replaceable>.links.in > debian/<replaceable>truc</replaceable>.links

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.
fr: Veuillez vous assurer d'avoir vérifié que le paquet de bibliothèque partagée ne contient que les fichiers attendus, et que le paquet -dev fonctionne toujours.

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 on differences generated by the data byte order and by the compression algorithm.
fr: Tous les fichiers installés simultanément par des paquets multiarchitectures au même endroit devraient avoir exactement le même contenu. Vous devez faire attention aux différences générées par l'ordre des octets de données (boutisme) et par les algorithmes de compression.

note: type: Content of: <book><appendix><section><title>
en: Native Debian package
fr: Paquet Debian natif

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.
fr: Si un paquet est maintenu uniquement pour Debian ou simplement pour un usage local, ses sources peuvent contenir tous les fichiers <filename>debian/*</filename>. Il existe deux façons de l’empaqueter.

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 the non-native Debian package as in <xref linkend="workflow"/>.  This is the normal way which some people encourage to use.
fr: Vous pouvez créer l’archive amont en excluant les fichiers <filename>debian/*</filename> et l’empaqueter comme un paquet Debian non natif comme dans <xref linkend="workflow"/>. C’est la méthode normale que certaines personnes préconisent d’utiliser.

note: type: Content of: <book><appendix><section><para>
en: The alternative is the workflow of the native Debian package.
fr: L’autre méthode est d’utiliser la manière de procéder pour un paquet Debian natif.

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.
fr: créer le paquet source Debian natif au format <literal>3.0 (native)</literal> en utilisant un seul fichier tar compressé où tous les fichiers sont intégrés :

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><literal>
en: <replaceable>package</replaceable>_<replaceable>version</replaceable>.tar.gz
fr: <replaceable>paquet</replaceable>_<replaceable>version</replaceable>.tar.gz

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><literal>
en: <replaceable>package</replaceable>_<replaceable>version</replaceable>.dsc
fr: <replaceable>paquet</replaceable>_<replaceable>version</replaceable>.dsc

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Build Debian binary packages from the native Debian source package.
fr: construire les paquets binaires Debian à partir du paquet source Debian natif :

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><literal>
en: <replaceable>package</replaceable>_<replaceable>version</replaceable>_<replaceable>arch</replaceable>.deb
fr: <replaceable>paquet</replaceable>_<replaceable>version</replaceable>_<replaceable>arch</replaceable>.deb

note: type: Content of: <book><appendix><section><screen>
en: $ cd ~/mypackage-1.0
    $ dh_make --native
fr: $ cd ~/monpaquet-1.0
    $ dh_make --native

note: type: Content of: <book><appendix><section><para>
en: Then the <filename>debian</filename> directory and its contents are created just like <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.
fr: Alors le répertoire <filename>debian</filename> et son contenu sont créés comme en <xref linkend="non-native-dh-make"/>. Aucune archive compressée n'est créée puisqu'il s'agit d'un paquet Debian natif, mais c'est la seule différence. La suite de l'empaquetage est à peu près similaire.

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:
fr: Après exécution de la commande <command>dpkg-buildpackage</command>, les fichiers suivants apparaîtront dans le répertoire parent :

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <filename>mypackage_1.0.tar.gz</filename>
fr: <filename>monpaquet_1.0.tar.gz</filename>

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>.)
fr: c'est l'archive compressée du code source créé à partir du répertoire <filename>monpaquet-1.0</filename> par la commande <command>dpkg-source</command> (il ne se termine pas par <filename>orig.tar.gz</filename>) ;

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <filename>mypackage_1.0.dsc</filename>
fr: <filename>monpaquet_1.0.dsc</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.)
fr: c'est un résumé du contenu du code source comme dans un paquet Debian non natif (il n'y a pas de révision Debian) ;

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <filename>mypackage_1.0_i386.deb</filename>
fr: <filename>monpaquet_1.0_i386.deb</filename>

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.)
fr: c'est le paquet binaire terminé comme dans un paquet Debian non natif (il n'y a pas de révision Debian) ;

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <filename>mypackage_1.0_i386.changes</filename>
fr: <filename>monpaquet_1.0_i386.changes</filename>

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.)
fr: ce fichier décrit toutes les modifications effectuées dans la version actuelle du paquet comme dans un paquet Debian non natif (il n'y a pas de révision Debian).
