maint-guide 1.116 - en to ca translation catalogue (925 entries)

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

note: type: Content of: <book><title>
en: Debian New Maintainers' Guide
ca: Guia del nou desenvolupador de Debian

note: type: Content of: <book><bookinfo><authorgroup><author><contrib>
en: original contents
ca: continguts originals

note: type: Content of: <book><bookinfo><authorgroup><author><contrib>
en: updated contents
ca: continguts actualitzats

note: type: Content of: <book><bookinfo><releaseinfo>
en: version &docversion;
ca: Version &docversion;

note: type: Content of: <book><bookinfo><legalnotice><para>
en: This document was made using these two documents as examples:
ca: Aquest document s'ha escrit fent servir aquest dos documents com a exemples:

note: type: Content of: <book><chapter><title>
en: Getting started The Right Way
ca: Començant correctament.

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).
ca: Aquest document descriurà com es construeix un paquet Debian GNU/Linux per a un usuari comú Debian i per a futurs desenvolupadors, fent servir un llenguatge informal i incloent molts exemples.  Un antic dit romà diu <emphasis>Longum iter est per preaecepta, breve et efficax per exempla!</emphasis> («És un llarg camí amb les normes, però curt i eficient amb els exemples»).

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.
ca: En el document s'assumeix que fas servir la versió <literal>&base-release;</literal>.  Si vols fer servir aquest document amb versions anteriors (incloses sistemes Ubuntu i d'altres), cal que tenguis instal·lats (com a mínim) els paquets <systemitem role="package">dpkg</systemitem> i <systemitem role="package">debhelper</systemitem> .

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.
ca: Podràs aprendre les operacions bàsiques dels sistemes Debian a <ulink url="&debref;">Debian Reference</ulink>. També s'expliquen alguns aspectes de la programació en sistemes 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"/>
ca: Una de les característiques que fan de Debian una de les distribucions més importants del mercat és el seu sistema de paquets.  Tot i què hi ha una gran quantitat de programes disponibles en paquets de Debian, de vegades pots haver de fer servir programes que no estan disponibles en aquest format.  Pot ésser que et demanis com construir els teus paquets i que pensis que és una tasca difícil. Bé doncs, si ets un principiant en GNU/Linux, pot ésser difícil, però si acabes de començar amb aquest sistema, no és recomanable que comencis per aquí :-). Cal saber algunes coses sobre programació en Unix, tot i què no és necessari ésser un mestre <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.
ca: Tot i així, una cosa és del tot segura: per construir i fer el manteniment de paquets Debian adequadament, calen moltes hores.  Per a què el nostre sistema no tengui errors, cal que els nostres desenvolupadors siguin tècnicament competents.

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.
ca: Les noves versions d'aquest document es publiquen a <ulink url="&maint-guide;"/> i en el paquet <systemitem role="package">maint-guide</systemitem>. Les traduccions es poden aconseguir en els paquets del tipus <systemitem role="package">maint-guide-ca</systemitem>. Teniu en compte que les traduccions poden estar sense actualitzar.

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.
ca: Com es tracta d'un tutorial, he decidit explicar detalladament cada etapa dels temes importants. Alguns d'ells poden semblar-te irrellevants. Sigues pacient. També he omès intencionadament alguns casos extrems i sempre punters només per mantenir senzill aquest document.

note: type: Content of: <book><chapter><section><title>
en: Social dynamics of Debian
ca: Dinamisme social a 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:
ca: Aquest és un recull de les meves observacions sobre la interacció social a Debian: espero que t'ajudin en la teva interacció amb Debian:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: We all are volunteers.
ca: Tots som voluntaris.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: You cannot impose on others what to do.
ca: No podeu imposar als altres el que s'ha de fer.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: You should be motivated to do things by yourself.
ca: Cal estar motivat per fer les coses per tu mateix.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Friendly cooperation is the driving force.
ca: La cooperació amistosa és la força motriu.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Your contribution should not overstrain others.
ca: La teva contribució no ha de sobre-esforçar als altres.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Your contribution is valuable only when others appreciate it.
ca: La teva contribució és valuosa només quan els altres t'ho agraeixen.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Debian is not your school where you get automatic attention of teachers.
ca: Debian no és la teva escola on automàticament reps atenció dels docents.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: You should be able to learn many things by yourself.
ca: Cal ésser capaç d'aprendre moltes coses per un mateix.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Attention from other volunteers is a very scarce resource.
ca: L'atenció d'altres voluntaris és un recurs molt escàs.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Debian is constantly improving.
ca: Debian millora contínuament.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: You are expected to make high quality packages.
ca: S'espera que construeixis paquets d'alta qualitat.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: You should adapt yourself to change.
ca: Cal adaptar-se al canvi.

note: type: Content of: <book><chapter><section><para>
en: There are several types of people interacting around Debian with different roles:
ca: En el desenvolupament i manteniment de Debian, es fan servir les següents expressions per referir-se a les persones implicades en la construcció i manteniment dels programes i paquets:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <emphasis role="strong">upstream author</emphasis>: the person who made the original program.
ca: <emphasis role="strong">autor original</emphasis> («upstream author»): és la persona que ha escrit el codi original del programa (o l'original del document en el cas de paquets de documentació).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <emphasis role="strong">upstream maintainer</emphasis>: the person who currently maintains the program.
ca: <emphasis role="strong">desenvolupador original</emphasis> («upstream maintainer»): la persona actualment responsable del manteniment del codi original.

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.
ca: <emphasis role="strong">empaquetador (desenvolupador)</emphasis> («maintainer»): la persona encarregada de la construcció i actualització dels paquets per a Debian.

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).
ca: <emphasis role="strong">patrocinador</emphasis> («sponsor»): la persona (cal que sigui un DD o DM) que transfereix els paquets construïts pels desenvolupadors al repositori de Debian després de comprovar que el paquet s'ajusta a las normes de Debian.

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.
ca: <emphasis role="strong">mentor</emphasis>: la persona que ajuda als desenvolupadors principiants a iniciar-se en la construcció i manteniment del paquet.

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.
ca: <emphasis role="strong">desenvolupador de Debian (DD)</emphasis> («Debian Developer»): la persona que es membre de Debian.  Té autorització (sense limitacions) per transferir paquets al repositori oficial de 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.
ca: <emphasis role="strong">empaquetador/responsable de Debian (DM)</emphasis>(«Debian Maintainer»): la persona amb autorització limitada per transferir paquets al repositori oficial de 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>.
ca: No és possible arribar a ésser <emphasis role="strong">desenvolupador oficial de Debian</emphasis> (DD) de la nit al dia degut a què no és suficient ésser tècnicament competent. Cal no desanimar-se per això. Pots aconseguir que el teu paquet passi al repositori, si és d'utilitat als usuaris, com a <emphasis role="strong">responsable</emphasis> mitjançant un <emphasis role="strong">patrocinador</emphasis> o un <emphasis role="strong">responsable de 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"/>).
ca: No és necessari construir un nou paquet per ésser desenvolupador oficial de Debian.  Una opció és contribuir en el manteniment d'algun dels paquets de la distribució.  Hi ha molts paquets pendents d'algú que s'en faci càrrec (consulta <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:
ca: Com que ens concentrem només en els aspectes tècnics dels paquets en el present document, consulta el següent per saber com funciona Debian i com pots participar-hi:

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)
ca: <ulink url="&logiciellibre;">Debian: 17 years of Free Software, "do-ocracy", and democracy</ulink> (PDF amb diapositives d'introducció en anglès)

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

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)
ca: <ulink url="&debianfaqhelp;">The Debian GNU/Linux FAQ, Chapter 13 - 'Contributing to the Debian Project'</ulink> (document semi-oficial)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&debianwikihelp;">Debian Wiki, HelpDebian</ulink> (supplemental)
ca: <ulink url="&debianwikihelp;">Debian Wiki, HelpDebian</ulink> (documentació complementària)

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

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&debianmentorfaq;">Debian Mentors FAQ</ulink> (supplemental)
ca: <ulink url="&debianmentorfaq;">Debian Mentors FAQ</ulink> (documentació complementària)

note: type: Content of: <book><chapter><section><title>
en: Programs needed for development
ca: Programes necessaris per treballar.

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.
ca: Abans de començar, cal instal·lar els paquets necessaris per a la construcció de paquets.  A la llista de paquets no estan inclosos paquets amb prioritat «essencial» o «requerit» (<literal>essential</literal> i <literal>required</literal>) degut a què segurament ja estan instal·lats.

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.
ca: El paquet imprescindible per al desenvolupament és <systemitem role="package">build-essential</systemitem>.  Quan s'instal·la, <emphasis>també s'instal·len</emphasis> altres paquets necessaris, obtenint-se la instal·lació bàsica per a la construcció de paquets.

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:
ca: Per a la construcció d'alguns paquets, amb això seria suficient, però n'hi ha d'altres que, sense ésser imprescindibles, pot ésser útil instal·lar-los o, fins i tot, necessaris:

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.
ca: <systemitem role="package">autoconf</systemitem>, <systemitem role="package">automake</systemitem> i <systemitem role="package">autotools-dev</systemitem> - molts programes fan servir fitxers de configuració i fitxers <filename>Makefile</filename> que es gestionen amb aquests programes (llegeix <literal>info autoconf</literal>, <literal>info automake</literal>).  El paquet <systemitem role="package">autotools-dev</systemitem> permet mantenir versions actualitzades dels fitxers «autoconf» i «automake» i conté documentació per aprendre a fer servir amb eficàcia aquest tipus de fitxers.

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.
ca: Hi ha d'altres paquets semblants pel que fa a la seva funcionalitat però més específics, com és ara <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"/>
ca: <systemitem role="package">dh-make</systemitem> i <systemitem role="package">debhelper</systemitem> - <systemitem role="package">dh-make</systemitem> es fa servir en la construcció de l'esquelet dels paquets, i es faran servir algunes eines de <systemitem role="package">debhelper</systemitem> per construir alguns paquets.  Tot i que no són imprescindibles per a la construcció de paquets és del <emphasis>tot</emphasis> recomanable per als nous desenvolupadors.  Faciliten molt el procés de construcció inicial així com el manteniment posterior (llegiu <citerefentry> <refentrytitle>dh_make</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>debhelper</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, <filename>/usr/share/doc/debhelper/README</filename>)  <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The new <systemitem role="package">debmake</systemitem> may be used as the alternative to the standard <systemitem role="package">dh-make</systemitem>.  It does more and comes with HTML documentation with extensive packaging examples in <systemitem role="package">debmake-doc</systemitem>.
ca: La nova ordre <systemitem role="package">debmake</systemitem> es pot fer servir com a alternativa a l'ordre <systemitem role="package">dh-make</systemitem>. Compte amb més funcionalitats i una documentació extensa en format HTML amb exemples per a la construcció de paquets a  <systemitem role="package">debmake-doc</systemitem>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">devscripts</systemitem> - this package contains some useful scripts that can be helpful for maintainers, but they are also not necessary for building packages.  Packages recommended and suggested by this package are worth looking into.  (See <filename>&devscripts-readme;</filename>.)
ca: <systemitem role="package">devscripts</systemitem> - aquest paquet conté alguns guions útils per als desenvolupadors, però no són necessaris en la construcció de paquets.  Val la pena mirar els paquets recomanats i suggerits per aquest paquet (llegeix <filename>&devscripts-readme;</filename>).

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>.)
ca: <systemitem role="package">file</systemitem> - aquest programa és molt útil per saber de quin tipus és un fitxer determinat (consulta <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>.)
ca: <systemitem role="package">gfortran</systemitem> - el compilador GNU per a Fortran 95, necessari si el programa està escrit en Fortran (llegeix <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>).)
ca: <systemitem role="package">git</systemitem> - aquest paquet instal·la el popular sistema de control de versions, dissenyat per al seguiment de grans projectes amb eficàcia i rapidesa; es fa servir amb molts projectes de codi lliure importants entre el quals el nucli de Linux (llegeix <citerefentry> <refentrytitle>git</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, git Manual (<filename>&git-doc;</filename>)).

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>.)
ca: <systemitem role="package">gpc</systemitem> - el compilador GNU de Pascal, necessari si el programa fa servir aquest llenguatge.  També hi ha el compilador <systemitem role="package">fp-compiler</systemitem>, de codi lliure per a Pascal (llegeix <citerefentry> <refentrytitle>gpc</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> i <citerefentry> <refentrytitle>ppc386</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>).

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>.)
ca: <systemitem role="package">patch</systemitem> - és una utilitat molt útil.  Permet aplicar un arxiu amb una llista de diferències (produït pel programa <command>diff</command>) en el fitxer original, i obtenir una versió apedaçada del fitxer original (vegeu <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.
ca: <systemitem role="package">patchutils</systemitem> - aquest paquet proporciona programes per gestionar els pegats, entre d'altres <command>lsdiff</command>, <command>interdiff</command> i <command>filterdiff</command>.

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>.)
ca: <systemitem role="package">perl</systemitem> - Perl és un dels llenguatges interpretats usats amb més freqüència per als guions (o «scripts») en els sistemes Un*x.  Tant és així que es fa servir l'expressió «navalla suïssa d'Unix» per fer referència en aquest llenguatge (llegeix <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>.)
ca: <systemitem role="package">python</systemitem> - Python és una altre llenguatge interpretat per a fer guions a Debian degut a la combinació de funcionalitat i clara sintaxi (consulta <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>.)
ca: <systemitem role="package">quilt</systemitem> - aquest paquet permet aplicar els pegats i fer el seguiment dels canvis realitzats.  Fa les modificacions segons l'ordre establert i, amb ell, és possible aplicar  («push»), desfer  («pop») i actualitzar les modificacions fàcilment (llegeix <citerefentry> <refentrytitle>quilt</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> i <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>.)
ca: <systemitem role="package">xutils-dev</systemitem> - alguns programes, si més no els escrits per a X11, fan servir aquest paquet per generar fitxers <filename>Makefile</filename> executant conjunts de funcions macro (llegeix <citerefentry> <refentrytitle>imake</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> i <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.
ca: Les descripcions anteriors només són un resum de la funcionalitat de cada paquet.  Abans de continuar, si us plau, llegeix la documentació de cada programa, al menys pel que fa a la seva funcionalitat bàsica.  Pot semblar una mica pesat, però et farà <emphasis>molt profit</emphasis> aquesta lectura.

note: type: Content of: <book><chapter><section><title>
en: Documentation needed for development
ca: Documents necessaris per treballar.

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:
ca: La documentació llistada a continuació és <emphasis>imprescindible</emphasis> llegir-la mentre es llegeix aquest 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>.)
ca: <systemitem role="package">debian-policy</systemitem> - a <ulink url="&debian-policy;">Debian Policy Manual</ulink> s'explica l'estructura i contingut del repositori, alguns aspectes del disseny del sistema operatiu, l'estàndard del sistema de fitxers («Filesystem Hierarchy Standard») i el què és més important, descriu els requisits per a què un paquet s'afegeixi a la distribució (llegix les còpies locals de <filename>&policy-pdf;</filename> i <filename>&fhs-pdf;</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:
ca: La documentació següent és <emphasis>important</emphasis> llegir-la mentre es llegeix aquest document:

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>.)
ca: <systemitem role="package">gnu-standards</systemitem> - aquest paquet proporciona dos documents del projecte GNU: <ulink url="&gnu-standard;">«GNU Coding Standards»</ulink> i <ulink url="&gnu-maintainer;">«Information for Maintainers of GNU Software»</ulink>.  Encara que no són d'aplicació obligada a Debian, són útils com a orientació (llegeix les còpies locals de <filename>&gnu-standard-pdf;</filename> i <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>.
ca: Si aquest document és contradictori amb algun aspecte amb els documents anteriors, serà d'aplicació l'establert per aquest darrers.  En aquest cas, si us plau comunica l'error del paquet <systemitem role="package">maint-guide</systemitem> fent servir <command>reportbug</command>.

note: type: Content of: <book><chapter><section><title>
en: Where to ask for help
ca: On demanar ajuda.

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
ca: els arxius de <filename>/usr/share/doc/<replaceable>package</replaceable></filename> per a cada paquet

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
ca: el contingut de <literal><command>man</command> <replaceable>command</replaceable></literal> per a cada una de les ordres

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
ca: el contingut de <literal><command>info</command> <replaceable>command</replaceable></literal> per a cada una de les ordres

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>
ca: els continguts de <ulink url="&debian-mentors-ldo;">l'arxiu de la llista de correu 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>
ca: el contingut de <ulink url="&debian-devel-ldo;">l'arxiu de la llista de correu 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.
ca: Considera fer servir el motor de cerca web mitjançant la inclusió eficaç de cadenes de recerca, com ara  <literal>site:lists.debian.org</literal> per limitar el domini.

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.
ca: Començar a treballar en un paquet petit és una bona opció per aprendre els detalls de la creació de paquets.  Inspeccionar els paquets mantinguts per altres persones és una excel·lent manera d'aprendre.

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:
ca: Si encara tens preguntes sobre la construcció de paquets que no poden trobar resposta en la documentació disponible i els recursos web, pots fer consultes de forma interactiva:

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.)
ca: <ulink url="&debian-mentors-ldo;">debian-mentors@lists.debian.org mailing list</ulink>. (Aquesta llista de correu és per a principiants.)

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.)
ca: <ulink url="&debian-devel-ldo;">llista de correu debian-devel@lists.debian.org</ulink>. (Aquesta llista de correu és per a experts.)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&irc-debian;">IRC</ulink> such as <literal>#debian-mentors</literal>.
ca: <ulink url="&irc-debian;">IRC</ulink> con és ara <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>)
ca: Equips centrats en un conjunt de paquets específic. (La llista completa està disponible a <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>)
ca: Llistes de correu específiques per a un idioma com per exemple debian-devel-{french,italian,portuguese,spanish}@lists.debian.org o debian-devel@debian.or.jp. (La llista completa està disponible a <ulink url="&listdevel;">https://lists.debian.org/devel.html</ulink> i <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.
ca: Els desenvolupadors de Debian amb més experiència t'ajudaran amb gust, si fas les preguntes després de fer el treball necessari.

note: type: Content of: <book><chapter><section><para>
en: When you receive a bug report (yes, actual bug reports!), you will know that it is time for you to dig into the <ulink url="&bts;">Debian Bug Tracking System</ulink> and read the documentation there, to be able to deal with the reports efficiently.  I highly recommend reading the <ulink url="&devref-bug-handling;">Debian Developer's Reference, 5.8.  "Handling bugs"</ulink>.
ca: En rebre un avís d'error (sí, un avís d'error de veritat!) serà el moment de donar un cop d'ull al <ulink url="&bts;">Sistema de seguiment d'errades de Debian</ulink> i llegir la documentació per tal de conèixer el procediment adequat.  Et recomano la lectura de la <ulink url="&devref-bug-handling;">Developer's Reference, 5.8.  'Handling bugs'</ulink>.

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!
ca: Relaxa't i estiguis preparat per rebre informes d'errades, perquè el camí és llarg per aconseguir el compliment de las Normes de Debian (una vegada més llegeix la <emphasis>documentació real</emphasis> per a més detalls).  Bona sort!

note: type: Content of: <book><chapter><title>
en: First steps
ca: Primers passos.

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).
ca: Començarem la construcció del teu paquet (o encara millor, pots adoptar un paquet ja existent).

note: type: Content of: <book><chapter><section><title>
en: Debian package building workflow
ca: Pla de treball de la construcció de paquets 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:
ca: Si estàs treballant en la construcció d'un paquet Debian a partir de les fonts d'un programa, el pla de treball típic requereix la construcció d'arxius amb noms específics a cada una de les etapes de la següent manera:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Get a copy of the upstream software, usually in a compressed tar format.
ca: Obtindre una còpia del codi font del programa, normalment en un arxiu comprimit en format «tar».

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><literal>
en: <replaceable>package</replaceable>-<replaceable>version</replaceable>.tar.gz
ca: <replaceable>nom_del_paquet</replaceable>-<replaceable>versió</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.
ca: Afegir les modificacions específiques de la construcció del paquet Debian a les fonts del programa en el directori  <filename>debian</filename>, i generar un paquet font no nadiu (o sigui, el conjunt d'arxius d'entrada que es fan servir en la compilació del paquet Debian).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><literal>
en: <replaceable>package</replaceable>_<replaceable>version</replaceable>.orig.tar.gz
ca: <replaceable>nom_del_paquet</replaceable>_<replaceable>versió</replaceable>.orig.tar.gz

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><literal>
en: <replaceable>package</replaceable>_<replaceable>version</replaceable>-<replaceable>revision</replaceable>.debian.tar.gz
ca: <replaceable>nom_del_paquet</replaceable>_<replaceable>versió</replaceable>-<replaceable>revisió</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.
ca: Per a paquets no nadius Debian construïts amb l'antic format <literal>1.0</literal>, es fa servir <literal><replaceable>nom_del_paquet</replaceable>_<replaceable>versió</replaceable>-<replaceable>revisió</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
ca: <replaceable>nom_del_paquet</replaceable>_<replaceable>versió</replaceable>-<replaceable>revisió</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.
ca: Construir paquets binaris Debian, habitualment paquets ordinaris per a la instal·lació en format <literal>.deb</literal> (o en format <literal>.udeb</literal>, fet servir per l'instal·lador de Debian) a partir del paquet font 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
ca: <replaceable>nom_del_paquet</replaceable>_<replaceable>versió</replaceable>-<replaceable>revisió</replaceable>_<replaceable>arquitectura</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.
ca: Observa que el caràcter que separa <literal><replaceable>nom_del_paquet</replaceable></literal> i <literal><replaceable>versió</replaceable></literal> s'ha canviat de <literal>-</literal> (guió) a l'arxiu comprimit original a <literal>_</literal> (guió baix) en el nom del 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.
ca: Consulta <ulink url="&policy-source;">5.6.1 "Source"</ulink>, <ulink url="&policy-package;">5.6.7 "Package"</ulink>, i <ulink url="&policy-version;">5.6.12 "Version"</ulink>. El codi de l'<emphasis role="strong">arquitectura del paquet</emphasis> segueix el <ulink url="&policy-architecture;">Debian Policy Manual, 5.6.8 "Architecture"</ulink> i s'assigna automàticament en el procés de construcció del 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"/>
ca: En els noms del arxius anteriors, cal substituir <literal><replaceable>nom_del_paquet</replaceable></literal> pel <emphasis role="strong">nom del paquet</emphasis>, <literal><replaceable>versió</replaceable></literal> pel codi de <emphasis role="strong">versió del codi font</emphasis>, <literal><replaceable>revisió</replaceable></literal> pel codi de la <emphasis role="strong">revisió Debian</emphasis> i <literal><replaceable>arquitectura</replaceable></literal> per l'<emphasis role="strong">arquitectura del paquet</emphasis> com es defineix en el Manual de Normes de 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.
ca: Cada etapa d'aquest esquema s'explica amb detall en seccions posteriors.

note: type: Content of: <book><chapter><section><title>
en: Choose your program
ca: Seleccionar el programa.

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:
ca: Probablement ja tens clar quin paquet vols construir. Primer cal que comprovis si ja està inclòs en el repositori fent servir:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: the <command>aptitude</command> command
ca: l'ordre <command>aptitude</command>.

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

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: the <ulink url="&debtrack;">Debian Package Tracker</ulink> web page
ca: pàgina web <ulink url="&debtrack;">Debian Package Tracker</ulink> (Sistema de seguiment de paquets de Debian)

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"/>
ca: Si el paquet ja existeix, comença per instal·lar-ho.  Si és un paquet <emphasis role="strong">orfe</emphasis> (si el responsable actual és el <ulink url="&qa-do;">«Debian QA Group»</ulink>, el grup de qualitat de Debian), pots adoptar-lo (convertir-te en el responsable del manteniment) si està disponible.  Cal que ho comprovis a <ulink url="&wnpp-bts;">«Debian Bug report logs»: errors en el paquet «wnpp» de la distribució de treball («inestable» o «sid»)</ulink>.  També pots adoptar un paquet si hi ha un avís de «sol·licitud d'adopció» («Request for Adoption» o <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:
ca: Hi ha diversos recursos de seguiment dels paquets:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The <command>wnpp-alert</command> command from the <systemitem role="package">devscripts</systemitem> package
ca: L'ordre <command>wnpp-alert</command> del paquet <systemitem role="package">devscripts</systemitem>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&wnpp-do;">Work-Needing and Prospective Packages</ulink>
ca: <ulink url="&wnpp-do;">Work-Needing and Prospective Packages</ulink> (Paquets en què es treballa i futurs paquets)

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>
ca: <ulink url="&wnpp-bts;">Registre Debian d'Informes d'errors: errors en el pseudo-paquet <systemitem role="package">wnpp</systemitem> a <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>
ca: <ulink url="&wnpp-dn;">Paquets Debian que necessiten atenció</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>
ca: <ulink url="&wnpp-debtags;">Navegació en els errors del paquet <systemitem role="package">wnpp</systemitem> basada en paraules clau</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.
ca: Tot i així, hi ha nous programes que són d'interès per a Debian.

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:
ca: Cal tenir present que Debian incorpora paquets d'un gran nombre de programes de tot tipus i que la quantitat de paquets disponibles en el repositori de Debian és major que el nombre de col·laboradors amb autorització per afegir paquets al repositori.  En conseqüència, la col·laboració en el manteniment de paquets que ja estan en el repositori es valora molt positivament (i és més fàcil trobar un patrocinador) per la resta de desenvolupadors <placeholder type="footnote" id="0"/>.  Per col·laborar en el manteniment de paquets ja disponibles en el repositori tens les següents opcions:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: taking over orphaned, yet actively used, packages
ca: Fer-te càrrec de paquets orfes d'ús freqüent

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: joining <ulink url="&teams;">packaging teams</ulink>
ca: unir-te als <ulink url="&teams;">equips de desenvolupadors</ulink>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: triaging bugs of very popular packages
ca: Selecciona errors dels paquets més populars.

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

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:
ca: Si el paquet és nou i decideixes que t'agradaria posar-lo a disposició dels usuaris de Debian, has de seguir els passos indicats a continuació:

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.
ca: Aprèn el funcionament del programa i fes-ho servir una temporada (per comprovar la seva utilitat).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The software <emphasis role="strong">must have a license</emphasis>.
ca: Cal que el programa <emphasis role="strong">tengui una llicència</emphasis>:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: For the <literal>main</literal> section, Debian Policy requires it <emphasis role="strong">to be fully compliant with the Debian Free Software Guidelines</emphasis> (<ulink url="&dfsg;">DFSG</ulink>)  and <emphasis role="strong">not to require a package outside of <literal>main</literal></emphasis> for compilation or execution.  This is the desired case.
ca: Per a paquets de la secció <literal>main</literal> cal que el programa <emphasis role="strong">s'ajusti a les Directrius de Debian per al programari (DFSG)</emphasis> lliure (consulta <ulink url="&dfsg;">DFSG</ulink>)  i <emphasis role="strong">no ha de precisar la instal·lació de cap altre paquet</emphasis> que no pertanyi a la secció <literal>main</literal> en la compilació o execució com requereix la directiva de Debian («Debian Policy»).

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.
ca: Per a paquets de la secció <literal>contrib</literal>, la llicència cal que compleixi tots els requisits de la DFSG però pot precisar la instal·lació d'altres paquets que no siguin de la secció <literal>main</literal> en la compilació o execució.

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>.
ca: Per a paquets de la secció <literal>non-free</literal>, no és necessari que la llicència compleixi tots els requisits de la DFSG però <emphasis role="strong">cal que permeti la distribució del programa</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.
ca: Si tens dubtes a l'hora d'assignar el paquet a una secció, envia un correu amb el text de la llicència (en anglès) adreçat a <ulink url="&debian-legal-ldo;">debian-legal@lists.debian.org</ulink>.

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.
ca: Cal que contactis amb l'autor o autors del programa per comprovar que accepten la construcció del paquet.  És important que els autors continuïn amb el manteniment del programa de manera que puguis fer consultes sobre problemes específics del programa.  No comencis a empaquetar un programa que no sigui mantingut pels autors.

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.
ca: El programa <emphasis role="strong">no</emphasis> s'ha d'executar com a «setuid root»: cal que no sigui «setuid» ni «setgid».

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: The program should not be a daemon, or go in an <filename>*/sbin</filename> directory, or open a port as root.
ca: Cal que el programa no sigui un dimoni, o que s'instal·li en els directoris <filename>*/sbin</filename> o obrir un port com a usuari administrador.

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.
ca: Com a nou desenvolupador, s'aconsella l'adquisició d'experiència amb la construcció de paquets senzills i  no s'aconsella la construcció de paquets complicats.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Simple packages
ca: 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)
ca: un únic paquet binari, arquitectura = totes (col·lecció de dades com per exemple gràfics de fons de pantalla)

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)
ca: un únic paquet binari, arquitectura = totes (executables escrits en un llenguatge interpretat com per exemple POSIX)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Intermediate complexity packages
ca: Paquets de complexitat intermèdia

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++)
ca: un únic paquet binari, arquitectura = totes (executables binaris ELF escrits en un llenguatge compilat com és ara C i 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)
ca: paquet múltiple binari, arquitectura = qualsevol i totes  (paquets amb executables binaris ELF i documentació)

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>
ca: el format de l'arxiu font no és ni  <filename>tar.gz</filename> ni <filename>tar.bz2</filename>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: upstream source containing undistributable contents
ca: paquets amb parts de les fonts que no es poden distribuir.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: High complexity packages
ca: Paquets molt complexes

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: interpreter module package used by other packages
ca: paquets amb mòduls d'intèrprets fets servir per altres paquets

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: generic ELF library package used by other packages
ca: paquets de biblioteques genèriques ELF que fan servir altres paquets

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: multiple binary packages including an ELF library package
ca: paquets amb múltiples binaris incloent paquets de biblioteques ELF

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: source package with multiple upstream sources
ca: paquets de fonts amb fonts originals diverses

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: kernel module packages
ca: paquets amb mòduls del nucli

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: kernel patch packages
ca: paquets amb pegats del nucli.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: any package with non-trivial maintainer scripts
ca: qualsevol paquet amb guions del desenvolupador no trivials

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:
ca: Construir paquets molt complexes no és molt difícil, però requereix tenir més coneixements. Hauràs de buscar una orientació específica per a cada funció complexa. Per exemple, alguns llenguatges tenen els seus propis documents de normes:

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

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&policy-java;">Java policy</ulink>
ca: <ulink url="&policy-java;">Normes per a 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"/>.
ca: No et preocupis per l'arxiu <filename>Makefile</filename> perdut. Pots instal·lar l'ordre <command>hello</command> fent servir l'ordre <command>debhelper</command> com s'ha explicat a <xref linkend="install"/> o modificant les fonts originals afegint un nou <filename>Makefile</filename> amb l'objectiu <literal>install</literal> com a <xref linkend="modify"/>.

note: type: Content of: <book><chapter><section><title>
en: Get the program, and try it out
ca: Aconsegueix el programa i prova'l.

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.
ca: La primera passa és trobar i descarregar el codi font original del programa.  Les fonts dels programes lliures de GNU/Linux és habitual que es distribueixin en fitxers amb format <command>tar</command>+<command>gzip</command> amb extensió <filename>.tar.gz</filename> o amb format <command>tar</command>+<command>bzip2</command> amb extensió <filename>.tar.bz2</filename>, i generalment tenen un directori amb el nom <filename><replaceable>programa</replaceable>-<replaceable>versió</replaceable></filename> amb tots els fitxers del codi font.

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.
ca: Pots identificar el format de l'arxius fent servir l'ordre <command>file</command>.

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.
ca: Si el programa està disponible en una altre format (pot ésser un arxiu acabat en <filename>.Z</filename> o <filename>.zip</filename><placeholder type="footnote" id="0"/>), ho descomprimeixes amb l'eina adequada i el tornes a empaquetar adequadament.

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>.
ca: Si algun dels continguts del codi font del teu programa no compleix les directrius DFSG, has de descomprimir-ho per eliminar-los hi tornar a comprimir-los afegint <literal>dfsg</literal> a la cadena de la versió del codi original.

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.
ca: Aquest programa ja està empaquetat.  La <ulink url="&gentoo-package;">versió actual</ulink> fa servir «Autotools» en la seva construcció i ha canviat molt respecte a la versió 0.9.12 feta servir en els exemples.

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"/>
ca: Com exemple, faré servir el programa <command>gentoo</command>, un gestor de fitxers de X11 fet amb GTK+ <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><para>
en: Create a subdirectory under your home directory named <filename>debian</filename> or <filename>deb</filename> or anything you find appropriate (e.g.  just <filename>~/gentoo</filename> would do fine in this case).  Place the downloaded archive in it, and extract it (with <literal>tar xzf gentoo-0.9.12.tar.gz</literal>).  Make sure there are no warning messages, even <emphasis>irrelevant</emphasis> ones, because other people's unpacking tools may or may not ignore these anomalies, so they may have problems unpacking them.  Your shell command line may look something like this:
ca: Fes un nou directori al teu directori d'usuari amb el nom <filename>debian</filename> o <filename>deb</filename> o el que trobis més adequat (p.e.  <filename>~/gentoo/</filename> és molt adequat).  Copia en aquest nou directori el fitxer del codi font i extreu el seu contingut executant <literal>tar xzf gentoo-0.9.12.tar.gz</literal>.  Comprova que no hi ha hagut errors, fins i tot els més <emphasis>irrellevants</emphasis>, degut a què és possible que hi hagi errors en desempaquetar-ho en sistemes d'altres persones que no ignorin aquestes errades.  En el terminal hauràs fet el següent:

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"/>).
ca: Ara tens un nou directori amb el nom <filename>gentoo-0.9.12</filename>. Accedeix en aquest directori i llegeix <emphasis>atentament</emphasis> la documentació del programa, normalment en fitxers amb el nom <filename>README*</filename>, <filename>INSTALL*</filename>, <filename>*.lsm</filename> o <filename>*.html</filename>.  Hi haurà instruccions per a la compilació i instal·lació del programa (probablement la instal·lació es farà a <filename>/usr/local/bin</filename>, però veurem a <xref linkend="destdir"/> que no és la destinació correcta).

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.
ca: Per començar la construcció del paquet, cal fer-ho amb el directori del codi font «net», o simplement només amb els fitxers de l'arxiu comprimit del codi font.

note: type: Content of: <book><chapter><section><title>
en: Simple build systems
ca: Sistemes de compilació simples

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>.
ca: Alguns programes tenen un arxiu <filename>Makefile</filename> i és possible compilar-los simplement executant <literal>make</literal> <placeholder type="footnote" id="0"/>. Molts d'ells permeten executar <literal>make check</literal>, per fer comprovacions. La instal·lació en el directori de destí es fa executant <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.
ca: Una vegada s'ha compilat el programa, prova'l i comprova que tot funciona correctament i que no es genera cap errada en el sistema en l'execució i/o instal·lació.

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.
ca: L'execució de l'ordre <literal>make clean</literal> (o <literal>make distclean</literal>) eliminarà del directori els fitxers generats per a la compilació i que són innecessaris.  Habitualment, serà possible des-instal·lar el programa amb l'ordre <literal>make uninstall</literal>.

note: type: Content of: <book><chapter><section><title>
en: Popular portable build systems
ca: Sistemes de compilació populars

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>.
ca: La majoria de programes lliures estan escrits en llenguatge <ulink url="&c-program;">C</ulink> i <ulink url="&cxx;">C++</ulink>. Molts fan servir les «Autotools» i «CMake» per compilar en diferents arquitectures. Aquestes eines generen un arxiu <filename>Makefile</filename> i d'altres fitxers necessaris per a la compilació. Així, molts programes es compilen i instal·len amb l'execució de <literal>make; make install</literal>.

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"/>
ca: <ulink url="&gnu-build-system;">Les Autotools</ulink> són el sistema de compilació GNU que comprèn <ulink url="&autoconf;">Autoconf</ulink>, <ulink url="&automake;">Automake</ulink> (si l'entrada no existeix a la Viquipèdia, s'ha posat l'enllaç a la versió en castellà), <ulink url="&libtool;">Libtool</ulink> i <ulink url="&gettext;">gettext</ulink>. Confirmaràs que el programa fa servir les «autoools» per la presència dels arxius <filename>configure.ac</filename>, <filename>Makefile.am</filename>, i <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.
ca: La primera etapa en l'ús de les «Autotools» és l'execució de l'ordre (per l'autor del codi font) <literal>autoreconf -i -f</literal> amb la qual es generen, fent servir el fitxers font (a l'esquerra del diagrama) els fitxers (a la dreta del diagrama) que després farà servir l'ordre «configure».

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>.
ca: Per a l'edició dels fitxers <filename>configure.ac</filename> i <filename>Makefile.am</filename> cal conèixer el funcionament de <command>autoconf</command> i <command>automake</command>.  Consulta <literal>info autoconf</literal> i <literal>info automake</literal> (executant les ordres en el terminal).

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>.
ca: La segona etapa del pla de treball amb «Autotools» és l'obtenció de les fonts i l'execució de <literal>./configure &amp;&amp; make</literal> en el directori del codi font per compilar el programa generant el fitxer <command><replaceable>binari</replaceable></command>.

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>.
ca: Pots fer canvis en el fitxer <filename>Makefile</filename> com és el directori d'instal·lació predeterminat fent servir les opcions <command>./configure --prefix=/usr</command>.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: You can automate this by using <systemitem role="package">dh-autoreconf</systemitem> package.  See <xref linkend="customrules"/>.
ca: Pots automatitzar el procés utilitzant <systemitem role="package">dh-autoreconf</systemitem>. Consulta <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"/>
ca: Tot i què no és necessari, l'actualització del fitxer <filename>configure</filename> i dels altres fitxers amb l'ordre <literal>autoreconf -i -f</literal> és la forma més adient per comprovar la compatibilitat del codi font <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.
ca: <ulink url="&cmake;">CMake</ulink> (en el moment de fer aquesta traducció, aquesta entrada no existeix a la Viquipèdia en català) és un sistema de compilació alternatiu.  Els programes que fan servir aquest sistema de compilació tenen un arxiu <filename>CMakeLists.txt</filename> en el codi font.

note: type: Content of: <book><chapter><section><title>
en: Package name and version
ca: Nom del paquet i versió.

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.
ca: Si el codi font te el nom <filename>gentoo-0.9.12.tar.gz</filename>, pots fer servir <literal>gentoo</literal> com a <emphasis role="strong">nom del paquet</emphasis> (de les fonts) i <literal>0.9.12</literal> com a codi de la <emphasis role="strong">versió del codi font</emphasis>. Aquestes denominacions es fan servir a l'arxiu <filename>debian/changelog</filename> que es descriu més endavant a <xref linkend="changelog"/>

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.
ca: La longitud predeterminada pel nom del paquet de l'ordre <command>aptitude</command> és 30. Per a més del 90% dels paquets, el nom del paquet té menys de 24 caràcters.

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"/>
ca: Si l'autor original fa servir termes genèrics com <literal>prova</literal> de nom, és convenient canviar el nom de forma que identifiqui el seu contingut i evitar «embrutar» l'espai de noms <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.
ca: Aquesta norma més estricta hauria d'ajudar a evitar noms d'arxius confusos.

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.
ca: La longitud predeterminada pel codi de versió de l'ordre <command>aptitude</command> és 10. El codi de revisió Debian precedit per un guió en consumeix 2. Per a més del 80% dels paquets, la versió del codi font té una longitud inferior a 8 caràcters i el codi de la revisió Debian menys de 2. Per a més del 90% dels paquets, la versió del codi font té menys de 10 caràcters i la revisió Debian menys de 3.

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.
ca: Les cadenes de versió poden ésser <emphasis role="strong">la versió del codi font</emphasis> (<literal><replaceable>versió</replaceable></literal>), <emphasis role="strong">la revisió Debian</emphasis> (<literal><replaceable>revisió</replaceable></literal>), o <emphasis role="strong">versió</emphasis> (<literal><replaceable>versió</replaceable>-<replaceable>revisió</replaceable></literal>).  Consulta <xref linkend="newrevision"/> per saber com cal incrementar la <emphasis role="strong">revisió Debian</emphasis>.

note: type: Content of: <book><chapter><section><para>
en: Version strings <placeholder type="footnote" id="0"/> can be compared using <citerefentry> <refentrytitle>dpkg</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> as follows:
ca: El codi de versió <placeholder type="footnote" id="0"/> serà comparat per <citerefentry> <refentrytitle>dpkg</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> de la següent manera:

note: type: Content of: <book><chapter><section><screen>
en: $ dpkg --compare-versions <replaceable>ver1</replaceable> <replaceable>op</replaceable> <replaceable>ver2</replaceable>
ca: $ dpkg --compare-versions <replaceable>versió_1</replaceable> <replaceable>op</replaceable> <replaceable>versió_2</replaceable>

note: type: Content of: <book><chapter><section><para>
en: The version comparison rule can be summarized as:
ca: La norma de comparació de versions es pot resumir com:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Strings are compared from the head to the tail.
ca: Les cadenes es comparen des del cap fins la cua.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Letters are larger than digits.
ca: Les lletres són anteriors als dígits.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Numbers are compared as integers.
ca: Els nombres es comparen com enters.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Letters are compared in ASCII code order.
ca: Les lletres es comparen per l'ordre del seu codi 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:
ca: Hi ha normes especials per al punt (<literal>.</literal>), signe més (<literal>+</literal>) i <literal>~</literal> com es mostra a continuació:

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>.
ca: Un cas complicat es produeix quan s'allibera una versió del codi font <filename>gentoo-0.9.12-ReleaseCandidate-99.tar.gz</filename> com a versió prèvia de <filename>gentoo-0.9.12.tar.gz</filename>. Cal assegurar que l'actualització funcionarà correctament canviant el nom de codi font per <filename>gentoo-0.9.12~rc99.tar.gz</filename>.

note: type: Content of: <book><chapter><section><title>
en: Setting up <command>dh_make</command>
ca: Configuració de <command>quilt</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>.
ca: El text mostrat a continuació dona per suposat que fas servir «Bash» com a intèrpret d'ordres.  Si fas sevir altres intèrprets, com és ara «Z shell», hauràs de fer servir els seus arxius de configuració en lloc 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"/>
ca: Comença per configurar les variables d'entorn del shell Bash <literal>$DEBEMAIL</literal> i <literal>$DEBFULLNAME</literal> que faran servir les eines de manteniment de Debian per tal d'obtenir el teu nom i adreça electrònica com s'indica a continuació<placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><title>
en: Initial non-native Debian package
ca: Paquet Debian no nadiu inicial.

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:
ca: Els paquets normals Debian són paquets de Debian no nadius construïts a partir dels programes originals. Si vols construir un paquet no nadiu Debian del codi font <filename>gentoo-0.9.12.tar.gz</filename>, pots construir el paquet no nadiu inicial Debian fent servir l'ordre <command>dh_make</command> de la següent manera:

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.
ca: Caldrà canviar el nom del fitxer amb el codi font <placeholder type="footnote" id="0"/>.  Consulta <citerefentry> <refentrytitle>dh_make</refentrytitle> <manvolnum>8</manvolnum> </citerefentry> per a una descripció més detallada.

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.
ca: Les opcions sobre el tipus de paquet són les següents: <literal>s</literal> per a un binari, <literal>i</literal>  per a un paquet independent de l'arquitectura (paquet de codi font o de documentació), <literal>m</literal> per a paquets amb més d'un arxiu binari, <literal>l</literal> per a  biblioteques, <literal>k</literal> per a un mòdul del nucli («kernel»), <literal>n</literal> per a un pegat del nucli i <literal>b</literal> per a paquets <systemitem role="package">cdbs</systemitem>. Aquest document es centra amb l'ús del paquet <systemitem role="package">debhelper</systemitem> i l'ordre <command>dh</command> per a la construcció de paquets amb un binari i tracta només parcialment el seu ús en la construcció de paquets independents de l'arquitectura  i amb més d'un arxiu binari. El paquet <systemitem role="package">cdbs</systemitem> proporciona guions alternatius a l'ordre <command>dh</command> i no s'explica en aquest document.

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:
ca: Desprès d'executar l'ordre <command>dh_make</command>, es fa una còpia del fitxer amb el codi original amb el nom <filename>gentoo_0.9.12.orig.tar.gz</filename> en el directori arrel per facilitar la construcció del paquet de fonts no nadiu de Debian amb el fitxer <filename>debian.tar.gz</filename>:

note: type: Content of: <book><chapter><section><para>
en: Please note two key features of this filename <filename>gentoo_0.9.12.orig.tar.gz</filename>:
ca: Posa atenció en els dos canvis en el nom del fitxer <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).
ca: El nom del paquet i de la versió estan separats per «<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>.
ca: S'ha afegit <filename>.orig</filename> abans de l'extensió <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.
ca: Fitxa't que hi ha nous fitxers (de plantilla) en el directori <filename>debian</filename> dels quals es parlarà en <xref linkend="dreq"/> i <xref linkend="dother"/>.  El procés d'empaquetament no està totalment automatitzat.  La modificació dels fitxers Debian s'explicarà a <xref linkend="modify"/>.  A continuació es compilarà el paquet Debian en l'apartat <xref linkend="build"/>, la revisió del resultat a l'apartat <xref linkend="checkit"/> i la transferència del paquet al repositori a <xref linkend="upload"/>.  S'explicarà cada etapa a continuació.

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.
ca: Si casualment elimines algun dels fitxers de plantilles del directori «debian», pots tornar a generar-los executant <command>dh_make</command> amb l'opció <literal>--addmissing</literal> des del directori de les fonts.

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"/>.
ca: L'actualització d'un paquet ja construït és un procés més complex: es probable que s'hagi construït amb procediments distints als que es fan servir actualment.  Es millor treballar amb paquets actualitzats per aprendre els procediments bàsics de la construcció de paquets.  Per empaquetar una revisió o una nova versió del teu paquet en el futur, faràs servir un procediment distint.  Tot això s'explicarà a la secció <xref linkend="update"/>.

note: type: Content of: <book><chapter><title>
en: Modifying the source
ca: Modificar les fonts originals.

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.
ca: No hi ha espai en aquest document per explicar <emphasis>tots</emphasis> els detalls de les modificacions que poden haver de fer-se a les fonts originals.  Tot i així, a continuació s'expliquen els problemes més freqüents.

note: type: Content of: <book><chapter><section><title>
en: Setting up <command>quilt</command>
ca: Configuració 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:
ca: El programa <command>quilt</command> proporciona un mètode bàsic per aplicar i conservar les modificacions del codi font en la construcció de paquets Debian. Atès que és desitjable fer alguna modificació a la configuració predeterminada, anem a crear un àlies <command>dquilt</command> per a la construcció de paquets Debian afegint la següent línia a l'arxiu <filename>~/.bashrc</filename>. La segona línia garanteix que l'àlies tendrà la mateixa funció d'auto-completar del intèrpret d'ordres per l'ordre <command>dquilt</command> que l'ordre <command>quilt</command>:

note: type: Content of: <book><chapter><section><para>
en: Then let's create <filename>~/.quiltrc-dpkg</filename> as follows:
ca: Ara genera l'arxiu <filename>~/.quiltrc-dpkg</filename> de la següent manera:

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>.
ca: Consulta <citerefentry> <refentrytitle>quilt</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> i <filename>&quilt-pdf;</filename> per fer servir <command>quilt</command>.

note: type: Content of: <book><chapter><section><title>
en: Fixing upstream bugs
ca: Apedaçant el codi font.

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.
ca: L'anterior execució de <command>dh_make</command> hauria d'haver generat el directori <filename>debian/patches</filename>.  En cas contrari o bé si estàs treballant en l'actualització d'un paquet, caldrà executar la primera ordre «mkdir debian/patches».

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"/>
ca: Anem a adobar l'errada amb l'ordre <command>dquilt</command> desant les modificacions a realitzar en el fitxer <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:
ca: Ara fes els canvis necessaris en el fitxer <filename>Makefile</filename> (amb un editor) original i deixa'l així:

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>:
ca: A continuació executa <command>dquilt</command> (com s'indica a l'exemple següent) per actualitzar el pedaç generant el fitxer <filename>debian/patches/fix-gentoo-target.patch</filename> i afegeix la descripció de la modificació realitzada com es descriu a <ulink url="&dep3;">DEP-3: Patch Tagging Guidelines</ulink>:

note: type: Content of: <book><chapter><section><screen>
en: $ dquilt refresh
    $ dquilt header -e
    ... describe patch
ca: $ dquilt refresh
    $ dquilt header -e
    ... descriu la modificació

note: type: Content of: <book><chapter><section><title>
en: Installation of files to their destination
ca: La instal lació dels arxius al seu destí

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).
ca: En general, els programes s'instal·len en el directori <filename>/usr/local</filename>.  Però els paquets Debian no poden fer servir aquest directori d'ús privat de l'usuari administrador: les instal·lacions es fan en els directoris del sistema com és ara <filename>/usr/bin</filename> com estableix la normativa de jerarquia del sistema de fitxers («Filesystem Hierarchy Standard» <ulink url="&fhs;">Filesystem Hierarchy Standard</ulink> (FHS).).

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.
ca: És freqüent fer servir l'ordre <citerefentry> <refentrytitle>make</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> per a la construcció (compilació) automatitzada del programa i l'execució de l'ordre <literal>make install</literal> instal·la directament el programa en el directori desitjat executant la secció <literal>install</literal> del fitxer <filename>Makefile</filename>.  En la construcció dels paquets binaris de Debian, el sistema de construcció simula la instal·lació del programa en una reconstrucció de l'estructura de directoris del programa en un directori temporal en lloc de fer-ho en la destinació real.

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:
ca: Aquestes diferències entre la instal·lació del programa i la «simulació» d'instal·lació en el procés d'empaquetament Debian, és gestionada de manera transparent pel paquet <systemitem role="package">debhelper</systemitem> amb les ordres <command>dh_auto_configure</command> i <command>dh_auto_install</command> si es compleixen els següents requisits:

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>.
ca: Consulta <ulink url="&gnu-destdir;">GNU Coding Standards: 7.2.4 DESTDIR: Support for Staged Installs</ulink>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The <filename>Makefile</filename> must follow GNU conventions and support the <literal>$(DESTDIR)</literal> variable.  <placeholder type="footnote" id="0"/>
ca: Cal que el fitxer <filename>Makefile</filename> segueixi les convencions GNU i accepti 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).
ca: Cal que el codi font segueixi l'estàndard de la jerarquia del sistema de fitxers («Filesystem Hierarchy Standard» o 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.
ca: Els programes que fan servir <command>autoconf</command> de GNU compleixen <emphasis>automàticamente</emphasis> amb les convencions GNU i el seu empaquetament es quasi <emphasis>automàtic</emphasis>.  Amb aquests requisits i l'heurística emprada pel paquet <systemitem role="package">debhelper</systemitem>, és possible empaquetar sense fer canvis en el sistema de compilació.  L'empaquetament no es tan complicat com pot semblar.

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.
ca: Per fer canvis en el fitxer <filename>Makefile</filename>, assegura't que permet fer servir la variable <literal>$(DESTDIR)</literal>.  La variable <literal>$(DESTDIR)</literal> no es defineix a l'arxiu i s'afegirà a totes les adreces de directoris que es facin servir en la instal·lació del programa.  El guió d'empaquetament estableix el valor de la variable <literal>$(DESTDIR)</literal> al valor del directori temporal d'instal·lació del programa en el procés de construcció del paquet.

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.
ca: Per a un paquet de fonts que generi  més d'un paquet binari, l'ordre <command>dh_auto_install</command> fa servir el directori temporal <filename>debian/tmp</filename> i l'ordre <command>dh_install</command> amb l'ajuda dels fitxers <filename>debian/<replaceable>paquet-1</replaceable>.install</filename> i <filename>debian/<replaceable>paquet-2</replaceable>.install</filename> distribuirà el contingut del directori <filename>debian/tmp</filename> en els directoris temporals <filename>debian/<replaceable>paquet-1</replaceable></filename> i <filename>debian/<replaceable>paquet-2</replaceable></filename> per tal de construir els paquets binaris <filename><replaceable>package-1</replaceable>_*.deb</filename> i <filename><replaceable>package-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.
ca: Per a un paquet de fonts que generi només un paquet binari, el directori temporal fet servir per l'ordre <command>dh_auto_install</command> és <filename>debian/<replaceable>nom_del_paquet</replaceable></filename> per a paquets amb un arxiu binari <placeholder type="footnote" id="0"/>.  El contingut complet del directori temporal s'instal·larà en el sistema de l'usuari quan aquest instal·li el paquet, amb la diferència que amb <command>dpkg</command> la instal·lació es fa des del directori arrel del sistema (en lloc del directori «debian/» o «debian/tmp» fet servir en la construcció del paquet).

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.
ca: Tots els fitxers i directoris que s'instal·len en el directori <filename>debian/<replaceable>nom_del_paquet</replaceable></filename> en la construcció del paquet, hauran de poder instal·lar-se correctament des del directori arrel quan s'instal·lin fent servir el fitxer <filename>.deb</filename>.  No s'ha de fer servir cadenes del tipus <literal>/home/el_meu/deb/<replaceable>nom_del_paquet</replaceable>-<replaceable>versió</replaceable>/usr/share/<replaceable>nom_del_paquet</replaceable></literal> en la construcció del 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>.
ca: Només és un exemple del contingut de l'arxiu <filename>Makefile</filename>.  Si el fitxer <filename>Makefile</filename> es construeix amb l'ordre <command>./configure</command>, el procediment correcte per solucionar això en l'arxiu <filename>Makefile</filename> és executar l'ordre <command>./configure</command> des de l'ordre <command>dh_auto_configure</command> amb les opcions predeterminades afegint l'opció <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"/>:
ca: Aquest és la part important del fitxer <filename>Makefile</filename> del paquet <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
ca: # On s'instal·laran els executables amb 'make install'?
    BIN     = /usr/local/bin
    # On s'instal·laran els icones amb 'make install'?
    ICONS   = /usr/local/share/gentoo

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
ca: # On s'instal·laran els executables amb 'make install'?
    BIN     = $(DESTDIR)/usr/bin
    # On s'instal·laran els icones amb '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.
ca: El destí correcte dels fitxers binaris, icones, documentació, etc, s'explica en el document «Estàndard de la jerarquia del sistema de fitxers». Cal que llegeixis les seccions que poden ésser d'aplicació al teu 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>.
ca: Així doncs, hauríem d'instal·lar els arxius executables en el directori <filename>/usr/bin</filename> en lloc de <filename>/usr/local/bin</filename> i la pàgina de manual a <filename>/usr/share/man/man1</filename> en lloc de <filename>/usr/local/man/man1</filename>.  No hi ha cap referència a la pàgina de manual en el fitxer <filename>Makefile</filename> de <systemitem role="package">gentoo</systemitem>, però a Debian cal que cada programa tengui la seva pàgina de manual, així que més endavant en farem una i la instal·larem a <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:
ca: Alguns programes no fan servir variables en el fitxer <filename>makefile</filename> per definir les ubicacions dels fitxers.  Això significa que hauràs d'editar alguns dels fitxers de codi C per solucionar això per tal de que es facin servir els directoris correctes.  Però, on cal buscar?, i exactament, què? Prova d'executar el següent:

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.
ca: <command>grep</command> buscarà recursivament en l'estructura de directoris i indicarà el nom del fitxer i la línia on hi hagi alguna concordança.

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:
ca: Ara edita els fitxers i canvia la cadena <literal>usr/local/lib</literal> per <literal>usr/lib</literal>. La següent ordre hauria de fer-ho automàticament:

note: type: Content of: <book><chapter><section><para>
en: If you want to confirm each substitution instead, this can be done interactively as follows:
ca: Si voleu confirmar cada una de les substitucions en el seu lloc, això es pot fer de forma interactiva de la següent manera:

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>.
ca: Fet això hauries de trobar (en el fitxer <filename>Makefile</filename>) l'objectiu <literal>install:</literal> (busca una línia que comenci per «install:») i canviar el nom de totes les referències a directoris distints dels definits a l'inici de l'arxiu <filename>Makefile</filename>.

note: type: Content of: <book><chapter><section><para>
en: Originally, <systemitem role="package">gentoo</systemitem>'s <literal>install</literal> target said:
ca: A l'original, l'objectiu «install» de <systemitem role="package">gentoo</systemitem> posava:

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>.
ca: Corregirem el problema i conservarem les modificacions en el fitxer <filename>debian/patches/install.patch</filename> amb l'ordre <command>dquilt</command>.

note: type: Content of: <book><chapter><section><para>
en: In your editor, change this for the Debian package as follows:
ca: Anem a canviar això per al paquet Debian amb l'editor:

note: type: Content of: <book><chapter><section><para>
en: You'll have noticed that there's now an <literal>install -d</literal> command before the other commands in the rule.  The original <filename>Makefile</filename> didn't have it because usually <literal>/usr/local/bin</literal> and other directories already exist on the system where you are running <literal>make install</literal>.  However, since we will be installing into a newly created private directory tree, we will have to create each and every one of those directories.
ca: Fixa't que hi ha la primera línia que és nova (<literal>install -d</literal>)  abans de les altres.  El fitxer <filename>Makefile</filename> original no estava aquesta ordre degut a què els directoris <literal>/usr/local/bin</literal> ja existeixen en el sistema quan s'executa <literal>make install</literal>.  Per això, com farem la instal·lació en un directori buit (o inexistent), caldrà assegurar-se que els directoris necessaris ja existeixen.

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:
ca: També podem afegir altres coses al final de la regla, com la instal·lació de la documentació addicional que de vegades els autors originals poden haver descuidat:

note: type: Content of: <book><chapter><section><screen>
en:         install -d $(DESTDIR)/usr/share/doc/gentoo/html
            cp -a docs/* $(DESTDIR)/usr/share/doc/gentoo/html
ca:        install -d $(DESTDIR)/usr/share/doc/gentoo/html
           cp -a docs/* $(DESTDIR)/usr/share/doc/gentoo/html

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:
ca: Després de comprovar que tot sigui correcte, fes que <command>dquilt</command> actualitzi la modificació en el fitxer <filename>debian/patches/install.patch</filename> i afegeix la descripció en la capçalera del fitxer:

note: type: Content of: <book><chapter><section><para>
en: Now you have a series of patches.
ca: Ja tens un parell de pegats del paquet:

note: type: Content of: <book><chapter><section><orderedlist><listitem><para>
en: Upstream bug fix: <filename>debian/patches/fix-gentoo-target.patch</filename>
ca: Correcció d'un error en el codi font: <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>
ca: Una modificació específica de l'empaquetat Debian: <filename>debian/patches/install.patch</filename>

note: type: Content of: <book><chapter><section><para>
en: Note that you don't have to send the <filename>debian/*</filename> files upstream.
ca: No cal enviar cap dels fitxers del directori <filename>debian/*</filename> a l'autor original.

note: type: Content of: <book><chapter><section><title>
en: Differing libraries
ca: Diferències a les biblioteques.

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.
ca: Anem a suposar que a l'arxiu <filename>Makefile</filename> (o <filename>Makefile.in</filename>) del teu programa hi ha una línia que posa alguna cosa com el següent.

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.
ca: Si hi ha canvis a l'API de la biblioteca <literal>foo</literal> a la biblioteca <literal>foo2</literal>, els canvis en el codi font s'hauran de fer de manera que siguin compatibles amb la nova 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"/>
ca: Si el teu programa no es compila degut a que la biblioteca <literal>foo</literal> no està present i el seu equivalent és proporcionat per la biblioteca <literal>foo2</literal> en els sistemes Debian, pots corregir aquest problema de compilació canviant <literal>foo</literal> per <literal>foo2</literal> a l'arxiu <filename>debian/patches/foo2.patch</filename> <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
ca: $ dquilt new foo2.patch
    $ dquilt add Makefile
    $ sed -i -e 's/-lfoo/-lfoo2/g' Makefile
    $ dquilt refresh
    $ dquilt header -e
    .. descriu el canvi

note: type: Content of: <book><chapter><title>
en: Required files under the <filename>debian</filename> directory
ca: Fitxers necessaris en el directori <filename>debian</filename>.

note: type: Content of: <book><chapter><para>
en: In this chapter, files in the <filename>debian</filename> directory are referred to without the leading <filename>debian/</filename> for simplicity whenever the meaning is obvious.
ca: En aquest capítol, es farà referència als arxius ubicats en el directori <filename>debian</filename> sense afegir el prefix <filename>debian/</filename> per a simplificar el text i sempre que no hi hagi possibilitat de confusió.

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"/>
ca: Ara tens un nou directori en el directori principal del programa («gentoo-0.9.12»), amb el nom <filename>debian</filename>.  Hi ha alguns fitxers en aquest directori que caldrà editar per adaptar-los.  Els fitxers més importants són <filename>control</filename>, <filename>changelog</filename>, <filename>copyright</filename> i <filename>rules</filename>, tots ells s'han d'incloure a tots els paquets <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><title>
en: <filename>control</filename>
ca: El fitxer <filename>control</filename>.

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>.
ca: La informació d'aquest fitxer es fa servir per <command>dpkg</command>, <command>dselect</command>, <command>apt-get</command>, <command>apt-cache</command>, <command>aptitude</command> i altres eines de gestió de paquets.  El seu contingut està explicat a <ulink url="&policy-control;">«Debian Policy Manual, 5 'Control files and their fields'»</ulink>.

note: type: Content of: <book><chapter><section><para>
en: Here is the <filename>control</filename> file <command>dh_make</command> created for us:
ca: Aquest és el contingut del fitxer <filename>control</filename> generat per <command>dh_make</command>:

note: type: Content of: <book><chapter><section><para>
en: (I've added the line numbers.)
ca: (S'han afegit els números de les línies).

note: type: Content of: <book><chapter><section><para>
en: Line 1 is the name of the source package.
ca: La línia 1 és el nom del paquet font.

note: type: Content of: <book><chapter><section><para>
en: Line 2 is the section of the distribution the source package goes into.
ca: La línia 2 és la secció de la distribució a la qual s'assignarà el paquet.

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>.
ca: Consulta <ulink url="&policy-subsections;">Debian Policy Manual, 2.4 'Sections'</ulink> and <ulink url="&sections-unstable;">Llistat de seccions a <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"/>
ca: Debian està dividit en seccions: <literal>main</literal> (principal, per als programes de codi lliure), <literal>non-free</literal> (propietaris, per als programes propietaris) i <literal>contrib</literal> (per als programes que depenen de programari propietari).  A cada secció hi ha subdivisions segons el tipus de programari.  Tenim <literal>admin</literal> per a programes que es fan servir per l'administració del sistema (habitualment només per l'usuari «root»), <literal>base</literal> per a les eines bàsiques del sistema, <literal>devel</literal> per al programari de desenvolupament, <literal>doc</literal> per a la documentació, <literal>libs</literal> per a les biblioteques, <literal>mail</literal> per a lectors de correu i dimonis de correu electrònic, <literal>net</literal> per a programes i dimonis de xarxa, <literal>x11</literal> per a programes específics de X11 i molts d'altres <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.)
ca: Anem a canviar-ho per x11 (el prefix <literal>main/</literal> és implícit, pel que podem ometre'l).

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&policy-priorities;">Debian Policy Manual, 2.5 "Priorities"</ulink>.
ca: Consulta <ulink url="&policy-priorities;">Manual de normes de Debian, 2.5 'Prioritat'</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"/>
ca: La línia 3 descriu la importància que pot tenir per a l'usuari (o el sistema) la instal·lació del 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.
ca: La prioritat <literal>optional</literal> es fa servir per a paquets nous que no tenen conflictes amb altres paquets amb prioritat <literal>required</literal>, <literal>important</literal> o <literal>standard</literal>.

note: type: Content of: <book><chapter><section><para>
en: Section and priority are used by front-ends like <command>aptitude</command> when they sort packages and select defaults.  Once you upload the package to Debian, the value of these two fields can be overridden by the archive maintainers, in which case you will be notified by email.
ca: «Section» i «Priority» es fan servir per les interfícies com <command>aptitude</command> quan ordenen els paquets i seleccionen els predeterminats.  Una vegada el teu paquet s'afegeixi a Debian, el contingut d'aquests camps pot ésser canviat per les persones responsables del repositori, que t'informaran per correu electrònic.

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>.
ca: Com és un paquet de prioritat normal i no té conflictes amb cap altre paquet, deixarem la prioritat a <literal>optional</literal> (opcional).

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.
ca: A la línia 4 hi ha el nom i l'adreça electrònica del desenvolupador.  Assegura't que l'adreça electrònica és vàlida per al camp <literal>A</literal> : el sistema de seguiment d'errades («Bug Tracking System») la farà servir per enviar-te els missatges de les errades del paquet.  No facis servir «», el signe «&amp;» i parèntesi.

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>.
ca: Consulta <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>.

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.
ca: A tots els paquets construïts amb l'ordre <command>dh</command> en el fitxer <filename>debian/rules</filename>, caldrà posar <literal>debhelper (&gt;=9)</literal> en el camp <literal>Build-Depends</literal> per seguir les normes Debian respecte a l'objectiu <literal>clean</literal>.

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.
ca: Els paquets de fonts amb binaris del tipus <literal>Architecture: all</literal>, el camp <literal>Build-Depends-Indep</literal> inclourà tots els paquets necessaris amb excepció dels llistats en el camp <literal>Build-Depends</literal> per tal de seguir els requeriments de les normes Debian respecte a l'objectiu <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>.
ca: Aquesta situació una mica estranya és una característica ben documentada a la <ulink url="&policy-build-depends-indep;">«Debian Policy Manual, Footnotes 55»</ulink>.  En tot cas, això és degut al funcionament de <command>dpkg-buildpackage</command>, no pel fet de fer servir l'ordre <command>dh</command> en el fitxer <filename>debian/rules</filename>.  Tot això també s'explica a <ulink url="https://bugs.launchpad.net/launchpad-buildd/+bug/238141">«auto build system for 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"/>
ca: Si tens dubtes, fes servir el camp <literal>Build-Depends</literal> <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><para>
en: To find out what packages your package needs to be built run the command:
ca: Si vols saber quins paquets són necessaris per compilar el teu programa, executa l'ordre (si el programa fa servir «configure» per compilar-se):

note: type: Content of: <book><chapter><section><para>
en: To manually find exact build dependencies for <command><replaceable>/usr/bin/foo</replaceable></command>, execute
ca: Si vols saber les dependències de compilació d'un paquet <command><replaceable>/usr/bin/nom_del_paquet</replaceable></command>, executa:

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

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.
ca: Cal fer servir la versió <literal>-dev</literal> de cada un dels paquets llistats en el camp <literal>Build-Depends</literal>.  Si fas servir el programa <command>ldd</command> per saber les dependències, també t'informarà de les dependències de les biblioteques indirectes, la qual cosa pot fer que la llista sigui massa llarga.

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>.
ca: <systemitem role="package">gentoo</systemitem> fa servir <systemitem role="package">xlibs-dev</systemitem>, <systemitem role="package">libgtk1.2-dev</systemitem> i <systemitem role="package">libglib1.2-dev</systemitem> en la compilació, així que caldrà afegir-ho tot a continuació 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.
ca: La línia 6 és la versió dels estàndards definits en les normes Debian i que s'han seguit en la construcció del paquet, és a dir, la versió del manual de normes que has seguit per empaquetar (consulta <ulink url="&debian-policy;">«Debian Policy Manual»</ulink>).

note: type: Content of: <book><chapter><section><para>
en: On line 7 you can put the URL of the software's upstream homepage.
ca: A la línia 7 està l'adreça URL del programa.

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.
ca: La línia 9 és el nom del paquet binari.  Normalment és el mateix que el paquet del codi original, tot i què no és imprescindible que sigui així.

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.
ca: Consulta <ulink url="&policy-architecture;">Debian Policy Manual, 5.6.8 "Architecture"</ulink> per a més detalls.

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"/>
ca: A la línia 10 es descriu les arquitectures en les quals pot ésser compilat el paquet. Aquest valor és un dels següents depenent del tipus de paquet binari <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.
ca: El paquet binari generat és depenent de l'arquitectura, generalment quan es tracta d'un programa escrit en un llenguatge compilat.

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.
ca: El paquet binari generat és independent de l'arquitectura, generalment quan es tracta d'arxius de text, imatges o guions escrits en un llenguatge interpretat.

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.
ca: Eliminarem la línia 10 degut a que el programa està escrit en C. <citerefentry><refentrytitle>dpkg-gencontrol</refentrytitle><manvolnum>1</manvolnum></citerefentry> omplirà el valor apropiat d'arquitectura per a cada màquina en què és possible compilar el paquet de fonts.

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.
ca: Si el teu paquet és independent de l'arquitectura (serà el cas d'un document o d'un guió escrit en Perl), canvia el valor a <literal>all</literal> i consulta més endavant <xref linkend="rules"/> per saber com fer servir la regla <literal>binary-indep</literal> en lloc de <literal>binary-arch</literal> per a la construcció del 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>.
ca: La línia 11 mostra una de les més poderoses possibilitats del sistema de paquets de Debian.  És possible relacionar els paquets entre ells.  A més de <literal>Depends</literal> (depèn de) altres camps de relació són <literal>Recommends</literal> (recomana), <literal>Suggests</literal> (suggereix), <literal>Pre-Depends</literal> (pre-depèn de), <literal>Breaks</literal> (trenca a), <literal>Conflicts</literal> (entre en conflicte amb), <literal>Provides</literal> (proveeix), <literal>Replaces</literal> (reemplaça a).

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.)
ca: Les eines de gestió de paquets tracten de la mateixa manera les relacions entre els paquets; els casos en què no és així s'explicaran en el seu moment (consulta <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>.
ca: Consulta <ulink url="&policy-relationships;">Debian Policy Manual, 7 "Declaring relationships between packages"</ulink>.

note: type: Content of: <book><chapter><section><para>
en: Here is a simplified description of package relationships: <placeholder type="footnote" id="0"/>
ca: Heus aquí una descripció simplificada de les relacions 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.
ca: El programa no s'instal·larà fins què s'instal·lin els paquets dels quals depèn.  Fes servir aquesta opció si el teu programa no funciona (o es trenca fàcilment) sense un paquet determinat.

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.
ca: Aquesta opció és per a paquets que no són imprescindibles per al funcionament del programa però que es fan servir juntament amb ell.  Quan els usuaris instal·lin el teu paquet, totes les interfícies d'instal·lació aconsellaran la instal·lació dels paquets recomanats.  <command>aptitude</command> i <command>apt-get</command> instal·len els paquets recomanats (però l'usuari pot decidir no fer-ho).  <command>dpkg</command> ignora el contingut d'aquest camp.

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.
ca: Fes servir aquesta opció per a paquets que funcionaran bé amb el teu programa però que no són en absolut necessaris.. Quan l'usuari instal·li el teu programa, probablement no se li demanarà que s'instal·lin els paquets suggerits.  És possible configurar <command>aptitude</command> per a què instal·li els paquets suggerits (no és l'opció per defecte).  <command>dpkg</command> i <command>apt-get</command> ignoren aquestes dependències.  Fes servir aquesta opció per a paquets que funcionaran bé amb el teu programa però que no són en absolut necessaris.

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.  :-)
ca: Aquesta opció és més radical que <literal>Depends</literal>.  El paquet no s'instal·larà fins que els paquets dels quals pre-depèn estiguin instal·lats i <emphasis>correctament configurats</emphasis>.  Fes servir aquesta opció <emphasis>poques vegades</emphasis> i només després d'haver-ho discutit a la llista de distribució <ulink url="&debian-devel-ldo;">debian-devel@lists.debian.org</ulink>.  Més clarament: no facis servir aquesta opció :-).

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.
ca: El paquet no s'instal·larà fins què tots el paquets amb els quals entre en conflicte siguin eliminats.  Fes servir aquesta opció si el teu programa no funcionarà amb absolut (o fallarà fàcilment) si un paquet en concret no està instal·lat.

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.
ca: Si el paquet s'instal·la, tots els paquets de la llista es trencaran.  Normalment, els paquets inclosos en la llista <literal>Breaks</literal> tenen una clàusula de versió anterior.  La solució és fe servir eines de gestió de paquets més sofisticades per actualitzar els paquets de la llista.

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.
ca: Fes servir aquesta opció només si el teu programa substitueix fitxers d'un altra paquet o el paquet complet (generalment es fa servir aquesta opció conjuntament amb <literal>Conflicts</literal>).  S'eliminaran els fitxers dels paquets indicats abans d'instal·lar el teu.

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).
ca: Tots aquests camps tenen una sintaxi uniforme: es tracta d'una llista de noms de paquets separats per comes.  Aquests noms de paquets també poden ésser llistes de paquets alternatius, separats amb una barra vertical «<literal>|</literal>» (símbol de tub).

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,
ca: Els camps poden restringir la seva aplicació a versions determinades del paquet llistat.  Aquestes versions s'enumeren entre parèntesi després de cada nom de paquet individual, i ha de contenir una relació de la següent llista seguit pel nombre de versió. Les relacions possibles són: <literal>&lt;&lt;</literal>, <literal>&lt;=</literal>, <literal>=</literal>, <literal>&gt;=</literal> i <literal>&gt;&gt;</literal> per a estrictament anterior, anterior o igual, exactament igual, posterior o igual i estrictament posterior, respectivament.  Per exemple:

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.
ca: L'última funcionalitat que necessites conèixer és <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>.
ca: <citerefentry> <refentrytitle>dh_shlibdeps</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> determina les dependències de biblioteques compartides pels paquets binaris. Genera una llista d'executables <ulink url="&elf;">ELF</ulink> i biblioteques compartides per a cada paquet binari. Aquesta llista es farà sevir per substituir <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>.
ca: <citerefentry> <refentrytitle>dh_perl</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> comprova les dependències Perl. Genera una llista de dependències de <literal>perl</literal> o <literal>perlapi</literal> per a cada paquet binari. Aquesta llista es fa servir per reemplaçar <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>.
ca: Algunes ordres de <systemitem role="package">debhelper</systemitem> determinen les dependències dels paquets llistats anteriorment.  Les ordres generen una llista dels paquets necessaris per a cada un dels paquets binaris. La llista d'aquests paquets reemplaçaran a <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.
ca: <citerefentry> <refentrytitle>dh_gencontrol</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> genera l'arxiu <filename>DEBIAN/control</filename> per a cada paquet binari substituint <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.
ca: La línia <literal>Depends</literal> pot quedar així com està però afegirem una línia <literal>Suggests: file</literal>, degut a què el paquet <systemitem role="package">gentoo</systemitem> fa servir algunes funcions del 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;"/>.
ca: La línia 9 conté la URL del programa. S'assumeix que és <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>.
ca: La línia 12 és una descripció curta del programa.  La major part dels monitors dels usuaris són de 80 columnes d'amplada (els terminals, és clar!)  per la qual cosa la descripció no hauria de tenir més de 60 caràcters.  Canviaré la descripció per a <literal>fully GUI-configurable, two-pane X file manager</literal>. («Interfície gràfica d'usuari GTK+ de gestió de fitxers completament configurable»).

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>.
ca: Aquestes descripcions s'han d'escriure en anglès. De la traducció s'encarrega el <ulink url="&ddtp;">The Debian Description Translation Project - DDTP</ulink>.

note: type: Content of: <book><chapter><section><para>
en: Line 13 is where the long description goes.  This should be a paragraph which gives more details about the package.  Column 1 of each line should be empty.  There must be no blank lines, but you can put a single <literal>.</literal> (dot) in a column to simulate that.  Also, there must be no more than one blank line after the long description. <placeholder type="footnote" id="0"/>
ca: La línia 13 és per fer una descripció més llarga del paquet. Cal que sigui almenys d'un paràgraf amb detalls sobre el paquet. Cada línia començarà amb un espai buit. No hi pot haver línies en blanc, però es pot simular amb un <literal>.</literal> (punt) a la segona columna. Tampoc hi pot haver més d'una línia en blanc al final de la descripció completa <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>.
ca: Consulta <ulink url="&devref-bpp-vcs;">Developer's Reference, 6.2.5.  "Version Control System location"</ulink>.

note: type: Content of: <book><chapter><section><para>
en: We can insert <literal>Vcs-*</literal> fields to document the Version Control System (VCS) location between lines 6 and 7.  <placeholder type="footnote" id="0"/> Let's assume that the <systemitem role="package">gentoo</systemitem> package has its VCS located in the Debian Alioth Git Service at <literal>git://git.debian.org/git/collab-maint/gentoo.git</literal>.
ca: Afegirem els camps <literal>Vcs-*</literal> per a documentar la localització del sistema de control de versions (VCS) entre les línies 6 i 7 <placeholder type="footnote" id="0"/>.  Se suposa que el paquet <systemitem role="package">gentoo</systemitem> està allotjat en el servei «Alioth Git» de Debian a <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:
ca: Finalment, el fitxer <filename>control</filename> actualitzat quedarà així:

note: type: Content of: <book><chapter><section><title>
en: <filename>copyright</filename>
ca: El fitxer <filename>copyright</filename>.

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.
ca: Aquest arxiu conté la informació de la llicència i drets d'autor de les fonts originals del paquet.  <ulink url="&policy-copyright;">Debian Policy Manual, 12.5 "Copyright information"</ulink> concreta el seu contingut i <ulink url="&dep5;">DEP-5: Machine-parseable <filename>debian/copyright</filename></ulink> proporciona directrius per al seu 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.
ca: <command>dh_make</command> proporciona una plantilla per a l'arxiu <filename>copyright</filename>.  Amb l'opció <literal>--copyright gpl2</literal> s'aconsegueix la plantilla per al paquet <systemitem role="package">gentoo</systemitem> amb la llicència GPL-2.

note: type: Content of: <book><chapter><section><para>
en: In short, here's what <systemitem role="package">gentoo</systemitem>'s <filename>copyright</filename> file should look like:
ca: Resumint, el fitxer <filename>copyright</filename> del paquet <systemitem role="package">gentoo</systemitem> hauria de ser més o menys com el següent exemple:

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;"/>.
ca: Consulta el text «COM» redactat pel «ftpmasters» i enviat a «debian-devel-announce»: <ulink url="&howto-copyright;"/>.

note: type: Content of: <book><chapter><section><title>
en: <filename>changelog</filename>
ca: El fitxer <filename>changelog</filename>.

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.
ca: Aquest és un arxiu imprescindible amb un format especial descrit a les normes Debian, <ulink url="&policy-dpkgchangelog;">Debian Policy Manual, 4.4 "debian/changelog"</ulink>. El seu especial format és degut a què <command>dpkg</command> i d'altres programes el fan servir per obtenir informació de la versió, revisió, distribució i urgència del 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.
ca: També és important aquest arxiu: facilita la documentació dels canvis fets en la construcció del paquet.  El fitxer informarà als usuaris que descarreguin el paquet sobre els problemes que pugui tenir el paquet i que ells hagin de saber.  El fitxer es conserva com <filename>/usr/share/doc/gentoo/changelog.Debian.gz</filename> en el paquet.

note: type: Content of: <book><chapter><section><para>
en: <command>dh_make</command> created a default one, and this is what it looks like:
ca: <command>dh_make</command> construeix un arxiu predeterminat amb el següent text:

note: type: Content of: <book><chapter><section><para>
en: You will end up with something like this:
ca: Aquest serà el contingut del fitxer:

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.
ca: Si fas servir l'ordre <literal>dch -r</literal> per fer efectiu aquest darrer canvi, assegura't que deses el fitxer <filename>changelog</filename> des del editor.

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"/>
ca: Quan estiguis satisfet dels canvis i els hagis documentat en el fitxer <filename>changelog</filename>, ja pots canviar el valor de la distribució de <literal>UNRELEASED</literal> pel nom de la distribució de destinació <literal>unstable</literal> (o bé per <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"/>.
ca: A la secció <xref linkend="update"/> s'explicaran alguns aspectes més de l'actualització del fitxer <filename>changelog</filename>.

note: type: Content of: <book><chapter><section><title>
en: <filename>rules</filename>
ca: El fitxer <filename>rules</filename>.

note: type: Content of: <book><chapter><section><section><title>
en: Targets of the <filename>rules</filename> file
ca: Objectius del fitxer <filename>rules</filename>.

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.
ca: <ulink url="&policy-debianrules;">Debian Policy Manual, 4.9 "Main building script: debian/rules"</ulink>  explica els detalls.

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"/>
ca: Cada arxiu <filename>rules</filename>, igual que els arxius <filename>Makefile</filename>, consta de diversos objectius i les seves regles <placeholder type="footnote" id="0"/>. Cada regla comença amb la declaració dels objectius a la primera columna. Les següents línies comencen amb una tabulació (codi ASCII 9) i les seves regles. Les línies buides i les començades amb <literal>#</literal> es tracten com a comentaris i s'ignoren <placeholder type="footnote" id="1"/>.

note: type: Content of: <book><chapter><section><section><para>
en: Here is a simplified explanation of the targets:
ca: A continuació tens una explicació simplificada dels objectius:

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)
ca: <literal>clean</literal> (obligatori): elimina tots els fitxers generats, compilats o innecessaris de l'estructura de directoris de les fonts.

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)
ca: <literal>build</literal> (obligatori): construeix els fitxers executables o els documents amb format a partir dels fitxers de les fonts.

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)
ca: objectiu <literal>build-arch</literal> (obligatori): per compilar les fonts en programes compilats dependents de l'arquitectura en l'arbre de directoris de compilació.

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)
ca: objectiu <literal>build-indep</literal> (obligatori) : per compilar les fonts en documents amb format independents de l'arquitectura en l'arbre de directoris de compilació.

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)
ca: <literal>install</literal> (opcional): fa la instal·lació en l'estructura de directoris temporal en el directori <filename>debian</filename> dels fitxers que constitueixen els paquets binaris.  Si hi ha un objectiu <literal>binary*</literal>, dependrà d'aquest.

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"/>.
ca: Aquest objectiu és utilitzat per <literal>dpkg-buildpackage</literal> com 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"/>
ca: <literal>binary</literal> (obligatori): per a la construcció de cada un dels paquets binaris (combinat amb els objectius <literal>binary-arch</literal> i <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"/>.
ca: Aquest objectiu és utilitzat per <literal>dpkg-buildpackage -B</literal> com 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"/>
ca: <literal>binary-arch</literal> (obligatori): per a la construcció de paquets dependents de l'arquitectura (els que tenen el camp <literal>Architecture: any</literal> en el fitxer «control») <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>.
ca: Aquest objectiu és utilitzat per <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"/>
ca: <literal>binary-indep</literal> (obligatori): per a la construcció de paquets independents de l'arquitectura (<literal>Architecture: all</literal> en el fitxer «control») <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)
ca: <literal>get-orig-source</literal> (opcional): per determinar la versió més recent de les fonts originals des del magatzem de l'autor.

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.
ca: Probablement l'exposició no és gens clara, però tot quedarà més clar després de veure el fitxer <filename>rules</filename> que <command>dh_make</command> construeix com a plantilla.

note: type: Content of: <book><chapter><section><section><title>
en: Default <filename>rules</filename> file
ca: Fitxer <filename>rules</filename> predeterminat.

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:
ca: La nova versió de <command>dh_make</command> genera un arxiu <filename>rules</filename> molt simple però poderós que fa servir l'ordre <command>dh</command>:

note: type: Content of: <book><chapter><section><section><para>
en: (I've added the line numbers and trimmed some comments.  In the actual <filename>rules</filename> file, the leading spaces are a TAB code.)
ca: (He afegit els números de les línies i simplificat els comentaris.  En el fitxer <filename>debian/rules</filename> els espais inicials de les línies són tabulacions).

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>.
ca: Probablement estàs familiaritzat amb línies com la primera per a guions escrits en shell o Perl.  Aquesta línia indica que el fitxer s'executa amb <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.
ca: Cal eliminar la marca de comentari a la línia 4 per assignar el valor 1 a la variable <literal>DH_VERBOSE</literal>.  En aquest cas, l'ordre <command>dh</command> escriurà les ordres <command>dh_*</command> en el terminal així com siguin executades per <command>dh</command>.  Pots afegir la línia <literal>export DH_OPTIONS=-v</literal> aquí.  Això farà que cada ordre <command>dh_*</command> escrigui la sortida d'allò que fa.  Això t'ajudarà a entendre com funciona el fitxer <filename>rules</filename> i a solucionar errades.  La nova ordre <command>dh</command> és part fonamental de les eines <systemitem role="package">debhelper</systemitem> i no t'amaguen res.

note: type: Content of: <book><chapter><section><section><para>
en: Lines 16 and 17 are where all the work is done with an implicit rule using the pattern rule.  The percent sign means "any targets", which then call a single program, <command>dh</command>, with the target name.  <placeholder type="footnote" id="0"/> The <command>dh</command> command is a wrapper script that runs appropriate sequences of <command>dh_*</command> programs depending on its argument.  <placeholder type="footnote" id="1"/>
ca: Tota la feina del fitxer la fan les línies 16 i 17 executant una regla implícita fent servir la regla patró.  El símbol de percentatge substitueix «qualsevol objectiu» per a continuació executar únicament <command>dh</command> amb el nom de l'objectiu (com a opció) <placeholder type="footnote" id="0"/>.  L'ordre <command>dh</command> és un guió que executa les seqüències necessàries d'ordres <command>dh_*</command> segons els seus paràmetres com es descriu a continuació <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:
ca: <literal>debian/rules clean</literal> executa <literal>dh clean</literal>, que al seu torn executa el següent:

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.
ca: El següent exemple assumeix que el teu fitxer <filename>debian/compat</filename> té un valor igual o major a 9 per tal d'evitar invocar qualsevol ordre «python» de suport automàticament.

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.
ca: Per a una descripció més completa de la funció de cada guió <command>dh_*</command> i les seves opcions, consulta els manuals respectius així com la documentació de <systemitem role="package">debhelper</systemitem>.

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"/>
ca: La funció de les ordres <command>dh_*</command> pot deduir-se del seu nom <placeholder type="footnote" id="0"/>. A continuació es resumeix la funció de les ordres més importants per al cas de compilació basada en un arxiu <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.
ca: Mira el primer objectiu disponible a l'arxiu <filename>Makefile</filename> com <literal>distclean</literal>, <literal>realclean</literal> o <literal>clean</literal> a l'arxiu <filename>Makefile</filename> i l'executa.

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"/>
ca: <command>dh_auto_clean</command> executa el següent si hi ha un arxiu <filename>Makefile</filename> amb l'objectiu <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).
ca: <command>dh_auto_configure</command> executa el següent si es fa servir el fitxer <filename>./configure</filename> (els arguments s'ha abreviat per facilitar la lectura):

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.
ca: <command>dh_auto_build</command> executa el següent per executar el primer objectiu del fitxer <filename>Makefile</filename> (si es fa servir aquest arxiu).

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.
ca: En realitat executa el primer dels objectius <literal>test</literal> o <literal>check</literal> del fitxer <filename>Makefile</filename>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <command>dh_auto_test</command> usually executes the following if a <filename>Makefile</filename> exists with the <literal>test</literal> target.  <placeholder type="footnote" id="0"/>
ca: <command>dh_auto_test</command> executa el següent si existeix l'objectiu <literal>test</literal> en el fitxer <filename>Makefile</filename> <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).
ca: <command>dh_auto_install</command> executa el següent si existeix l'objectiu <literal>install</literal> en el fitxer <filename>Makefile</filename> (s'ha truncat la línia per facilitar la lectura):

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>
ca: make install \
      DESTDIR=<replaceable>/directori/del</replaceable>/<replaceable>paquet</replaceable>_<replaceable>versió</replaceable>-<replaceable>revisió</replaceable>/debian/<replaceable>nom_del_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.
ca: Els objectius que cal executar amb l'ordre <command>fakeroot</command> contenen <command>dh_testroot</command>.  Si no fas servir l'ordre «fakeroot» per simular l'execució per l'usuari «root», es produirà una errada que aturarà l'execució.

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.
ca: És important tenir present que el fitxer <filename>rules</filename> construït per <command>dh_make</command> només és un exemple.  Serà útil per a la majoria dels paquets simples, però no deixis de fer les adaptacions necessàries.

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>.
ca: Malgrat que <literal>install</literal> no és un objectiu obligatori, està acceptat.  <literal>fakeroot dh install</literal> es comporta com <literal>fakeroot dh binary</literal> però s'atura després de <command>dh_fixperms</command>.

note: type: Content of: <book><chapter><section><section><title>
en: Customization of <filename>rules</filename> file
ca: Personalització del fitxer <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.
ca: Pots fer molts canvis per adaptar el fitxer <filename>rules</filename> construït per l'ordre <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>.
ca: Si un paquet instal·la el fitxer <filename>/usr/share/perl5/Debian/Debhelper/Sequence/<replaceable>nom_arxiu</replaceable>.pm</filename> pots activar la funció adaptada amb <literal>dh $@ --with <replaceable>nom_arxiu</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"/>
ca: L'ordre <literal>dh $@</literal> permet les següents adaptacions <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.
ca: És preferible fer servir l'ordre <command>dh_python2</command> abans que l'ordre <command>dh_pysupport</command> o <command>dh_pycentral</command>.  No facis servir l'ordre <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"/>
ca: Afegir funcionalitat per a l'ordre <command>dh_python2</command> (la millor opció per a 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>.
ca: Afegeix el paquet <systemitem role="package">python</systemitem> en el camp <literal>Build-Depends</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with python2</literal>.
ca: Fes servir <literal>dh $@ --with python2</literal> en el seu lloc.

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.
ca: Així es gestiona el mòdul Python fent servir el entorn («framework») de <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)
ca: Afegir funcionalitat per a l'ordre <command>dh_pysupport</command> (obsolet).

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>.
ca: Afegeix el paquet <systemitem role="package">python-support</systemitem> en el camp <literal>Build-Depends</literal>.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with pysupport</literal>.
ca: Fes servir <literal>dh $@ --with pysupport</literal> en el seu lloc.

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.
ca: Així es gestiona el mòdul Python fent servir el entorn («framework») de <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)
ca: Afegir funcionalitat per a l'ordre <command>dh_pycentral</command> (obsolet).

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>.
ca: Afegeix el paquet <systemitem role="package">python-central</systemitem> en el camp <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.
ca: Fes servir <literal>dh $@ --with python-central</literal> en el seu lloc.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This also deactivates the <command>dh_pysupport</command> command.
ca: També es desactiva l'ordre <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.
ca: I es gestiona el mòdul Python fent servir l'entorn («framework») de <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.
ca: Afegir funcionalitat per a l'ordre <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>.
ca: Afegeix el paquet <systemitem role="package">tex-common</systemitem> en el camp <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.
ca: Fes servir <literal>dh $@ --with tex</literal> en el seu lloc.

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.
ca: Així es registren els tipus de lletra «Type 1», els patrons per a la separació de paraules («hyphenation patterns») o els formats 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.
ca: Afegir funcionalitat per a les ordres <command>dh_quilt_patch</command> i <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>.
ca: Afegeix el paquet <systemitem role="package">quilt</systemitem> en el camp <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.
ca: Fes servir <literal>dh $@ --with quilt</literal> en el seu lloc.

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.
ca: Així s'apliquen o es desfan, en els fitxers de les fonts originals, les modificacions dels fitxers del directori <filename>debian/patches</filename> en els paquets construïts amb el 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.
ca: Aquesta adaptació no és necessària per als paquets construïts amb el 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.
ca: Afegir funcionalitat per a l'ordre <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>.
ca: Afegeix el paquet <systemitem role="package">dkms</systemitem> en el camp <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.
ca: Fes servir <literal>dh $@ --with dkms</literal> en el seu lloc.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This correctly handles DKMS usage by kernel module packages.
ca: Així es controla correctament l'ús de DKMS en la construcció de paquets del nucli.

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.
ca: Afegir funcionalitat per a les ordres <command>dh_autotools-dev_updateconfig</command> i <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>.
ca: Afegeix el paquet <systemitem role="package">autotools-dev</systemitem> en el camp <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.
ca: Fes servir <literal>dh $@ --with autotools-dev</literal> en el seu lloc.

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>.
ca: Així s'actualitza i restaura <filename>config.sub</filename> i <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.
ca: Afegir funcionalitat per a les ordres <command>dh_autoreconf</command> i <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>.
ca: Afegeix el paquet <systemitem role="package">dh-autoreconf</systemitem> en el camp <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.
ca: Fes servir <literal>h $@ --with autoreconf</literal> en el seu lloc.

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.
ca: Així s'actualitzen els fitxers del sistema de compilació GNU i els restaura després de la compilació.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>dh_girepository</command> command.
ca: Afegir funcionalitat per a l'ordre <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>.
ca: Afegeix el paquet <systemitem role="package">gobject-introspection</systemitem> en el camp <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.
ca: Fes servir <literal>dh $@ --with gir</literal> en el seu lloc.

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.
ca: Això computa les dependències dels paquets d'enviament de dades d'introspecció de «GObject» i genera la substitució de la variable <literal>${gir:Depends}</literal> per les dependències del paquet.

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>bash</command> completion feature.
ca: Afegir funcionalitat d'autocompletar a <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>.
ca: Afegeix el paquet <systemitem role="package">bash-completion</systemitem> en el camp <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.
ca: Fes servir <literal>dh $@ --with bash-completion</literal> en el seu lloc.

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>.
ca: Així s'instal·la la funció d'autocompletar de <command>bash</command> fent servir l'arxiu de configuració de <filename>debian/<replaceable>nom_del_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.
ca: Moltes de les ordres <command>dh_*</command> executades per la nova ordre <command>dh</command> es poden personalitzar amb fitxers de configuració ubicats en el directori <filename>debian</filename>.  Consulta <xref linkend="dother"/> i els manuals (les «manpage») de cada ordre.

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.
ca: En <literal>lenny</literal>, quan calia canviar un guió <command>dh_*</command> calia trobar la línia adequada en el fitxer <filename>rules</filename> i canviar-la.  Ara és suficient afegir un objectiu.

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"/>
ca: Algunes ordres <command>dh_*</command> invocades per la nova ordre <command>dh</command> poden necessitar l'addició d'arguments o l'execució d'ordres addicionals.  Per a aquests casos, hauràs d'afegir l'objectiu <literal>override_dh_<replaceable>nom_ordre</replaceable></literal> en el fitxer <filename>rules</filename> per a l'ordre <command>dh_<replaceable>nom_ordre</replaceable></command> que cal canviar.  Es tracta de <emphasis>execute'm a mi en el seu lloc</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.
ca: Les ordres <command>dh_auto_*</command> fan més coses que les explicades en aquesta explicació simplificada.  L'ús d'ordres equivalents més senzilles en el lloc d'aquestes en els objectius <literal>override_dh_*</literal> (amb l'excepció de l'objectiu <literal>override_dh_auto_clean</literal>) no és una bona idea ja que pot eliminar funcions intel·ligents 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:
ca: Si les dades de configuració del paquet <systemitem role="package">gentoo</systemitem> es desen en el directori <filename>/etc/gentoo</filename> en lloc del directori habitual <filename>/etc</filename>, cal anular l'execució de l'argument predeterminat <literal>--sysconfig=/etc</literal> de l'ordre <command>dh_auto_configure</command> per <command>./configure</command> amb:

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>.
ca: <command>dh_auto_build</command> sense arguments executarà el primer objectiu del fitxer <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.
ca: Si el <filename>Makefile</filename> de les fonts de <systemitem role="package">gentoo</systemitem> requereix l'especificació de l'objectiu <literal>build</literal> per a la compilació <placeholder type="footnote" id="0"/>, pots afegir un objectiu <literal>override_dh_auto_build</literal> per tal d'anul·lar-lo.

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.
ca: D'aquesta forma es garanteix l'execució de <literal>$(MAKE)</literal> amb tots els arguments predeterminats per l'ordre <command>dh_auto_build</command> i de l'argument <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.
ca: Si el fitxer <filename>Makefile</filename> de les fonts de <systemitem role="package">gentoo</systemitem> requereix l'especificació de l'objectiu <literal>packageclean</literal> (per fer neteja després de la compilació), en lloc dels objectius <literal>distclean</literal> o <literal>clean</literal> a l'arxiu <filename>Makefile</filename> pots afegir un objectiu <literal>override_dh_auto_clean</literal> per habilitar l'ordre.

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.
ca: Si el fitxer <filename>Makefile</filename> de les fonts de <systemitem role="package">gentoo</systemitem> té un objectiu <literal>test</literal> i desitges que no s'executi en la construcció del paquet, pots fer servir l'objectiu <literal>override_dh_auto_test</literal> sense ordres per tal de que no es faci res.

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>.
ca: Els fitxers <filename>debian/changelog</filename> i <filename>debian/NEWS</filename> sempre s'instal·len automàticament.  També es busca el fitxer de canvis de l'autor canviant el nom a minúscules i per la seva coincidència amb <filename>changelog</filename>, <filename>changes</filename>, <filename>changelog.txt</filename>, i <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"/>
ca: Si el paquet <systemitem role="package">gentoo</systemitem> inclou el poc freqüent arxiu de canvis de l'autor amb el nom <filename>FIXES</filename>, <command>dh_installchangelogs</command> no en farà la instal·lació (és l'opció predeterminada).  L'ordre <command>dh_installchangelogs</command> requereix l'argument <filename>FIXES</filename> per tal d'instal·lar-lo <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.
ca: Si fas sevir el nou <command>dh</command>, la utilització explícita d'objectius com els llistats a <xref linkend="targets"/> (excepte <literal>get-orig-source</literal>) pot dificultar la correcta comprensió dels seus efectes.  Si us plau, limita l'ús d'objectius explícits a objectius del tipus <literal>override_dh_*</literal> i de manera que siguin completament independents entre ells (sempre que sigui possible).

note: type: Content of: <book><chapter><title>
en: Other files under the <filename>debian</filename> directory
ca: Altres fitxers del directori <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.
ca: Per tal de controlar el treball de <systemitem role="package">debhelper</systemitem> en la compilació del paquet, pots afegir fitxers de configuració en el directori <filename>debian</filename>.  En aquest capítol es resumeix el que pots fer amb cada un d'ells i el seu format.  Consulta <ulink url="&debian-policy;">«Debian Policy Manual»</ulink> i <ulink url="&developers-reference;">«Debian Developer's Reference»</ulink> per a les directrius de construcció de paquets.

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.
ca: En altres casos, <command>dh_make</command> no pot construir plantilles de configuració per a <systemitem role="package">debhelper</systemitem>.  En aquests casos tu mateix escriuràs els fitxers amb un editor.

note: type: Content of: <book><chapter><para>
en: If you wish or need to activate any of these, please do the following:
ca: Si vols fer servir els fitxers generats en la construcció del paquet, fes el següent:

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>;
ca: reanomena els fitxers de configuració fent servir el nom del fitxer del paquet binari en lloc de <literal><replaceable>nom_del_paquet</replaceable></literal>.

note: type: Content of: <book><chapter><itemizedlist><listitem><para>
en: modify template file contents to suit your needs;
ca: modifica el contingut dels fitxers de plantilla per adaptar-los a les teves necessitats.

note: type: Content of: <book><chapter><itemizedlist><listitem><para>
en: remove template files which you do not need;
ca: elimina els fitxers que no necessitis.

note: type: Content of: <book><chapter><itemizedlist><listitem><para>
en: modify the <filename>control</filename> file (see <xref linkend="control"/>), if necessary;
ca: fes les modificacions necessàries en el fitxer <filename>control</filename> (consulta <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.
ca: modifica el fitxer <filename>rules</filename> (consulta <xref linkend="rules"/>) si és necessari.

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.
ca: Els fitxers de configuració construïts per <systemitem role="package">debhelper</systemitem> que no tenen el prefix <filename><replaceable>nnom_del_paquet</replaceable></filename> com és ara <filename>install</filename> s'aplicaran al primer paquet binari.  Si hi ha més d'una paquet binari, les seves configuracions s'especificaran amb el prefix del paquet binari corresponent al seu nom: <filename><replaceable>paquet-1</replaceable>.install</filename>, <filename><replaceable>paquet-2</replaceable>.install</filename>, etc.

note: type: Content of: <book><chapter><section><title>
en: <filename>README.Debian</filename>
ca: <filename>README.Debian</filename> (LLEGEIX-ME.debian)

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.
ca: Qualsevol detall extra o discrepància entre el programa original i la seva versió Debian cal documentar-la en aquest arxiu.

note: type: Content of: <book><chapter><section><para>
en: <command>dh_make</command> created a default one; this is what it looks like:
ca: <command>dh_make</command> en genera un predeterminat, que és el següent:

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>.
ca: Atès que no tenim res per explicar, eliminarem el fitxer.  Consulta <citerefentry> <refentrytitle>dh_installdocs</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.

note: type: Content of: <book><chapter><section><title>
en: <filename>compat</filename>
ca: Fitxer <filename>compat</filename>.

note: type: Content of: <book><chapter><section><title>
en: <filename>conffiles</filename>
ca: Fitxer <filename>conffiles</filename>.

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>.
ca: Consulta <citerefentry> <refentrytitle>dpkg</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> i <ulink url="&policy-conffiles;">Debian Policy Manual, "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.
ca: Una de les coses més molestes dels programes és quan després de dedicar molt de temps i esforç a configurar un programa (com a usuari), una actualització del programa fa inútils els canvis.  Debian resol aquesta situació marcant els fitxers de configuració<placeholder type="footnote" id="0"/> de manera que quan actualitzes un paquet, tens l'opció de mantenir la teva configuració.

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.
ca: Des de la versió 3 de <systemitem role="package">debhelper</systemitem>, <citerefentry> <refentrytitle>dh_installdeb</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> considera <emphasis>automàticament</emphasis> a tots els fitxers ubicats en el directori <filename>/etc</filename> com fitxers de configuració, de manera que si tots els fitxers de configuració del programa són en aquest directori, no es necessari que els incloguis en el fitxer «conffiles» (abreviatura d'arxiu de configuració).  Per a la majoria de paquets, l'única ubicació dels arxius de configuració és <filename>/etc</filename> i en aquest cas pots eliminar aquest arxiu.

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.
ca: Si el teu programa fa servir fitxers de configuració però també els sobreescriu ell mateix (directament des del codi font) es millor no marcar-los com «conffiles».  Si ho fas, <command>dpkg</command> informarà als usuaris que revisin els canvis realitzats en aquests fitxers en cada actualització.

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:
ca: Si el programa que empaquetes requereix que cada usuari modifiqui els fitxers de configuració del directori <filename>/etc</filename>, hi ha dues formes per a no marcar-los com fitxers «conffiles» i que no siguin manipulats per <command>dpkg</command>:

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.
ca: Construir un enllaç simbòlic dels fitxers ubicats en <filename>/etc</filename> que apunti als fitxers ubicats en el directori <filename>/var</filename> generats per <emphasis>guions del desenvolupador</emphasis> («maintainer scripts»).

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.
ca: Posar els fitxers generats pels <emphasis>guions del desenvolupador</emphasis> en el directori <filename>/etc</filename>.

note: type: Content of: <book><chapter><section><para>
en: For information on maintainer scripts, see <xref linkend="maintscripts"/>.
ca: Si vols més informació sobre els <emphasis>guions del desenvolupador</emphasis> consulta <xref linkend="maintscripts"/>.

note: type: Content of: <book><chapter><section><title>
en: <filename><replaceable>package</replaceable>.cron.*</filename>
ca: Fitxers <filename><replaceable>nom_del_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:
ca: Si el teu paquet requereix la realització de tasques periòdiques per funcionar correctament, pots fer servir aquest arxiu.  Pots establir la realització de tasques cada hora, dia, setmana o mes o qualsevol altre període de temps.  Els noms dels fitxers són:

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.
ca: <filename><replaceable>nom_del_paquet</replaceable>.cron.hourly</filename> - instal·lats com <filename>/etc/cron.hourly/<replaceable>nom_del_paquet</replaceable></filename>: s'executen cada hora.

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.
ca: <filename><replaceable>nom_del_paquet</replaceable>.cron.daily</filename> - instal·lats com <filename>/etc/cron.daily/<replaceable>nom_del_paquet</replaceable></filename>: s'executen cada dia, habitualment a primera hora del matí.

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.
ca: <filename><replaceable>nom_del_paquet</replaceable>.cron.weekly</filename> - instal·lats com <filename>/etc/cron.weekly/<replaceable>nom_del_paquet</replaceable></filename>: s'executen cada setmana, habitualment en el matí del diumenge.

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.
ca: <filename><replaceable>nom_del_paquet</replaceable>.cron.hourly</filename> - instal·lats com <filename>/etc/cron.hourly/<replaceable>nom_del_paquet</replaceable></filename>: s'executen cada hora.

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.
ca: <filename><replaceable>nom_del_paquet</replaceable>.cron.d</filename> - instal·lats com <filename>/etc/cron.d/<replaceable>nom_del_paquet</replaceable></filename>: per a qualsevol altre període de temps.

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>.
ca: Els fitxers tenen el format de guions shell.  Amb l'excepció dels fitxers <filename><replaceable>nom_del_paquet</replaceable>.cron.d</filename> que s'ajustaran al format descrit a <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>.
ca: No és necessari explicitar un arxiu <filename>cron.*</filename> per a configurar la rotació de registres, per aquest cas consulta <citerefentry> <refentrytitle>dh_installlogrotate</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> i <citerefentry> <refentrytitle>logrotate</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>.  Elimina aquest arxiu si no s'ha de fer servir amb el teu paquet.

note: type: Content of: <book><chapter><section><title>
en: <filename>dirs</filename>
ca: Fitxer <filename>dirs</filename>.

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>.
ca: Aquest arxiu especifica els directoris necessaris però que per alguna raó no s'han creat en el procés d'instal·lació normal (<literal>make install DESTDIR=...</literal> executat per <literal>dh_auto_install</literal>).  Generalment això és degut a un problema en el fitxer <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"/>.
ca: Els fitxers llistats en el fitxer <filename>install</filename> no requereixen la creació prèvia dels directoris.  Consulta <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.
ca: És recomanable executar en primer lloc la instal·lació i només fer ús d'aquest arxiu si es produeix algú problema.  No s'ha de posar la barra inicial en els noms dels directoris llistats a l'arxiu <filename>dirs</filename>.

note: type: Content of: <book><chapter><section><title>
en: <filename><replaceable>package</replaceable>.doc-base</filename>
ca: Fitxer <filename><replaceable>nom_del_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>.
ca: Si el teu paquet té documentació a més de les pàgines de manual i d'informació, pots fer servir el fitxer <systemitem role="package">doc-base</systemitem> per a registrar-la i així l'usuari la trobarà més fàcilment amb <citerefentry> <refentrytitle>dhelp</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>dwww</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> o <citerefentry> <refentrytitle>doccentral</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.

note: type: Content of: <book><chapter><section><para>
en: This usually includes HTML, PS and PDF files, shipped in <filename>/usr/share/doc/<replaceable>packagename</replaceable>/</filename>.
ca: La documentació inclourà fitxers HTML, PS i PDF ubicats en <filename>/usr/share/doc/<replaceable>nom_del_paquet</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:
ca: Aquest és el contingut del fitxer <filename>gentoo.doc-base</filename> de <systemitem role="package">gentoo</systemitem>:

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.
ca: Per obtenir informació sobre el format del fitxer, consulta <citerefentry> <refentrytitle>install-docs</refentrytitle> <manvolnum>8</manvolnum> </citerefentry> i en el manual Debian <systemitem role="package">doc-base</systemitem> en la còpia local <filename>&doc-base;</filename> proporcionat pel paquet <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"/>.
ca: Per a més detalls sobre la instal·lació de documentació addicional, consulta <xref linkend="destdir"/>.

note: type: Content of: <book><chapter><section><title>
en: <filename>docs</filename>
ca: Fitxer <filename>docs</filename>.

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.
ca: Aquest arxiu especifica els noms dels fitxers de documentació que <citerefentry> <refentrytitle>dh_installdocs</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> instal·larà en el directori temporal.

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.
ca: L'opció predeterminada inclourà tots els fitxers existents en els directoris del nivell més alt del codi amb els noms <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:
ca: També n'inclouré alguns d'altres per a <systemitem role="package">gentoo</systemitem>:

note: type: Content of: <book><chapter><section><screen>
en: BUGS
    CONFIG-CHANGES
    CREDITS
    NEWS
    README
    README.gtkrc
    TODO
ca:   BUGS
      CONFIG-CHANGES
      CREDITS
      ONEWS
      README
      README.gtkrc
      TODO

note: type: Content of: <book><chapter><section><title>
en: <filename>emacsen-*</filename>
ca: Fitxer <filename>emacsen-*</filename>.

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.
ca: Si el teu paquet proporciona fitxers Emacs que es poden compilar a bytes en el moment de la instal·lació, pots fer servir aquests fitxers.

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>.
ca: Aquests fitxers seran instal·lats en el directori temporal per <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.
ca: Elimina'ls si no els necessites.

note: type: Content of: <book><chapter><section><title>
en: <filename><replaceable>package</replaceable>.examples</filename>
ca: Fitxer <filename><replaceable>nom_del_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.
ca: L'ordre <citerefentry> <refentrytitle>dh_installexamples</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> instal·la els fitxers i directoris llistats en aquest arxiu com a fitxers d'exemple.

note: type: Content of: <book><chapter><section><title>
en: <filename><replaceable>package</replaceable>.init</filename> and <filename><replaceable>package</replaceable>.default</filename>
ca: Fitxers <filename><replaceable>nom_del_paquet</replaceable>.init</filename> <filename><replaceable>nom_del_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? :-)
ca: Si el teu paquet és un dimoni que s'executa en iniciar-se el sistema, és que no has fet cas a la meva recomanació inicial, o no? :-)

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:
ca: Si el programa original inclou un arxiu pel <emphasis>guió «init»</emphasis>, tu pots fer-ne ús o bé descartar-ho. Si decideixes no fer servir el guió <emphasis>«init»</emphasis> original, caldrà que en facis un de nou a <filename>debian/<replaceable>nom_del_paquet</replaceable>.init</filename>. Tot i així, si el <emphasis>guió «init»</emphasis> original té bona pinta i s'instal·la en la ubicació correcta, encara caldrà configurar el fitxer <filename>rc*</filename> d'enllaços simbòlics. Caldrà reescriure l'objectiu <command>dh_installinit</command> de l'arxiu <filename>rules</filename> com segueix:

note: type: Content of: <book><chapter><section><para>
en: If you don't need this, remove the files.
ca: Elimina el fitxer si no el fas servir.

note: type: Content of: <book><chapter><section><title>
en: <filename>install</filename>
ca: Fitxer <filename>install</filename>.

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.
ca: Aquesta ordre reemplaça l'ordre obsoleta <citerefentry> <refentrytitle>dh_movefiles</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> que feia servir el fitxer <filename>files</filename>.

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:
ca: En el fitxer <filename>install</filename> hi haurà una línia per a cada un dels fitxers a instal·lar, amb el seu nom (sempre relatiu al directori superior de la compilació) i després d'un espai, el directori d'instal·lació (relatiu al directori d'instal·lació).  En el cas que no s'instal·li el fitxer binari <filename>src/<replaceable>arxiu_binari</replaceable></filename> del <filename>gentoo</filename>, hauries d'escriure el següent:

note: type: Content of: <book><chapter><section><screen>
en: src/<replaceable>bar</replaceable> usr/bin
ca: src/<replaceable>arxiu_binari</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>.
ca: Quan s'instal·li el paquet, hi haurà una ordre executable <filename>/usr/bin/<replaceable>arxiu_binari</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.
ca: En el fitxer <filename>install</filename> pots escriure el nom del fitxer sense el directori d'instal·lació sempre que la ruta relativa de directori no canvii.  Aquest format es fa servir amb paquets grans que separen el resultat de la compilació en més d'un paquet binari fent servir el conjunt de fitxers <filename><replaceable>nom_del_paquet-1</replaceable>.install</filename>, <filename><replaceable>nom_del_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>).
ca: L'ordre <command>dh_install</command> revisarà el directori <filename>debian/tmp</filename> per cercar els fitxers si no els troba en el directori actual (o en la ubicació establerta per a la recerca amb l'opció <literal>--sourcedir</literal>).

note: type: Content of: <book><chapter><section><title>
en: <filename><replaceable>package</replaceable>.info</filename>
ca: Fitxer <filename><replaceable>nom_del_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.
ca: Si el teu paquet fa servir fitxers «info» (sistema d'ajuda), pots instal·lar-los fent servir <citerefentry> <refentrytitle>dh_installinfo</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> que utilitzarà el llistat del fitxer <filename><replaceable>package</replaceable>.info</filename>.

note: type: Content of: <book><chapter><section><title>
en: <filename><replaceable>package</replaceable>.links</filename>
ca: Fitxer <filename><replaceable>nom_del_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.
ca: Si has de generar enllaços simbòlics addicionals en el directori de compilació del paquet com a responsable del paquet, pots fer-ho fent servir <citerefentry> <refentrytitle>dh_link</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> fent un llistat dels directoris complets de l'origen i destí dels fitxers a un fitxer <filename><replaceable>nom_del_paquet</replaceable>.links</filename>

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

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.
ca: El fitxer <filename><replaceable>nom_del_paquet</replaceable>.lintian-overrides</filename> és per a un paquet binari amb el nom <systemitem role="package"><replaceable>nom_del_paquet</replaceable></systemitem> i s'instal·la a <filename>usr/share/lintian/overrides/<replaceable>nom_del_paquet</replaceable></filename> per l'ordre <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.
ca: El fitxer <filename>source/lintian-overrides</filename> és per als paquets de codi original i no s'instal·la.

note: type: Content of: <book><chapter><section><title>
en: <filename>manpage.*</filename>
ca: Fitxers <filename>manpage.*</filename>.

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.
ca: Cal que el programa tengui una pàgina de manual.  Si l'autor original no l'ha fet, l'hauràs de fer tu.  L'ordre <command>dh_make</command> construeix alguns fitxers de plantilla per a les pàgines de manual.  Caldrà editar-los i emplenar-los.  Comprova que elimines els fitxers que no fas servir.

note: type: Content of: <book><chapter><section><section><title>
en: <filename>manpage.1.ex</filename>
ca: Fitxers <filename>manpage.1.ex</filename>

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.
ca: Las pàgines de manual s'escriuen normalment amb <citerefentry> <refentrytitle>nroff</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.  L'exemple <filename>manpage.1.ex</filename> està escrit amb <command>nroff</command>.  Consulta la pàgina de manual <citerefentry> <refentrytitle>man</refentrytitle> <manvolnum>7</manvolnum> </citerefentry> on s'explica com editar el fitxer.

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:
ca: El nom del fitxer de manual ha d'incloure el nom del programa corresponent: així canviaràs el nom de <literal>manpage</literal> a <literal>gentoo</literal>.  El nom del fitxer inclou <literal>.1</literal> com a sufixe: aquest és el codi que indica que la pàgina de manual correspon a un programa d'usuari.  Comprova que és la secció correcta.  Aquí tens una petita llista de les seccions de les pàgines de manual.

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><thead><row><entry>
en: Section
ca: Secció

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><thead><row><entry>
en: Description
ca: Descripció

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: User commands
ca: Ordres d'usuari

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Executable commands or scripts
ca: Ordres o guions executables

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: System calls
ca: Crides del sistema

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Functions provided by the kernel
ca: Funcions proporcionades pel nucli

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Library calls
ca: Crides a biblioteques

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Functions within system libraries
ca: Funcions de les biblioteques del sistema

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Special files
ca: Arxiu especials

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Usually found in <filename>/dev</filename>
ca: En general es troben a <filename>/dev</filename>

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: File formats
ca: Formats d'arxiu

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: E.g. <filename>/etc/passwd</filename>'s format
ca: p.ex. format de <filename>/etc/passwd</filename>

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

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Games or other frivolous programs
ca: Jocs o altres programes d'entreteniment

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Macro packages
ca: Paquets de macros

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Such as <command>man</command> macros
ca: Com ara les macros <command>mc</command>.

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

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Programs typically only run by root
ca: Programes que només sol executar el superusuari

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Kernel routines
ca: Rutines del nucli

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Non-standard calls and internals
ca: Crides al sistema no estàndard i 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.
ca: En el cas del <systemitem role="package">gentoo</systemitem>, el nom del fitxer serà <filename>gentoo.1</filename>.  Com què no hi havia una pàgina de manual en els fitxers de fonts de <filename>gentoo.1</filename>, en vaig escriure una canviant el nom de la plantilla <filename>manpage.1.ex</filename> per <filename>gentoo.1</filename> i editant-la fent servir la informació de l'exemple i la documentació del programador original.

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.
ca: Cal tenir present que el marcador de posició de pàgines de manual <command>help2man</command> reclamarà que la informació més detallada estigui disponible en el sistema d'informació. Si l'ordre no troba una pàgina <command>info</command>, caldrà que editis manualment la pàgina de manual construïda per <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"/>
ca: Fes servir l'ordre <command>help2man</command> per generar la pàgina de manual fent servir la informació aportada per les opcions «<literal>--help</literal>» i «<literal>--version</literal>» de cada programa <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><section><title>
en: <filename>manpage.sgml.ex</filename>
ca: Fitxer <filename>manpage.sgml.ex</filename>.

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:
ca: Si prefereixes fer servir el format SGML en lloc de <command>nroff</command> pots fer servir la plantilla <filename>manpage.sgml.ex</filename>.  En aquest cas hauràs de fer el següent:

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: rename the file to something like <filename>gentoo.sgml</filename>.
ca: reanomenar el fitxer com <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
ca: instal·lar el 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
ca: afegeix <literal>docbook-to-man</literal> en el camp <literal>Build-Depends</literal> de l'arxiu <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:
ca: afegir l'objectiu <literal>override_dh_auto_build</literal> en el fitxer <filename>rules</filename>:

note: type: Content of: <book><chapter><section><section><title>
en: <filename>manpage.xml.ex</filename>
ca: Fitxer <filename>manpage.xml.ex</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:
ca: I si prefereixes treballar en format XML en lloc de SGML, pots fer servir la plantilla <literal>manpage.xml.ex</literal>.  En aquest cas hauràs de fer el següent:

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: rename the source file to something like <literal>gentoo.1.xml</literal>
ca: reanomenar el fitxer a <literal>gentoo.1.xml</literal>

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: install the <systemitem role="package">docbook-xsl</systemitem> package and an XSLT processor like <systemitem role="package">xsltproc</systemitem> (recommended)
ca: instal·lar el paquet <systemitem role="package">docbook-xsl</systemitem> i un processador XSLT com <systemitem role="package">xsltproc</systemitem> (recomanat)

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
ca: afegir els paquets <literal>docbook-xsl</literal>, <literal>docbook-xml</literal> i <literal>xsltproc</literal> a la línia de <literal>Build-Depends</literal> en el fitxer <literal>control</literal>

note: type: Content of: <book><chapter><section><title>
en: <filename><replaceable>package</replaceable>.manpages</filename>
ca: Fitxer <filename><replaceable>nom_del_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.
ca: Si el teu paquet té pàgines de manual, les instal·laràs amb <citerefentry> <refentrytitle>dh_installman</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> llistant els fitxers corresponents en el fitxer <filename><replaceable>nom_del_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:
ca: Per instal·lar el fitxer <filename>docs/gentoo.1</filename> del paquet <systemitem role="package">gentoo</systemitem> com el seu manual, escriu en el fitxer <filename>gentoo.manpages</filename> el següent:

note: type: Content of: <book><chapter><section><title>
en: <filename>NEWS</filename>
ca: Fitxer <filename>NEWS</filename>.

note: type: Content of: <book><chapter><section><para>
en: The <citerefentry> <refentrytitle>dh_installchangelogs</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> command installs this.
ca: L'ordre <citerefentry> <refentrytitle>dh_installchangelogs</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> instal·la aquest arxiu.

note: type: Content of: <book><chapter><section><title>
en: <filename>{pre,post}{inst,rm}</filename>
ca: Fitxers <filename>{pre,post}{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.
ca: Encara que faig servir les expressions <command>bash</command> abreujades <filename>{pre,post}{inst,rm}</filename> pels noms d'aquests arxius, has de fer servir la sintaxi pura POSIX per a aquests guions del desenvolupador per mantenir la compatibilitat el sistema «shell» <command>dash</command>.

note: type: Content of: <book><chapter><section><para>
en: These <filename>postinst</filename>, <filename>preinst</filename>, <filename>postrm</filename>, and <filename>prerm</filename> files <placeholder type="footnote" id="0"/> are called <emphasis>maintainer scripts</emphasis>.  They are scripts which are put in the control area of the package and run by <command>dpkg</command> when your package is installed, upgraded, or removed.
ca: Els arxius <filename>postinst</filename>, <filename>preinst</filename>, <filename>postrm</filename>, i <filename>prerm</filename><placeholder type="footnote" id="0"/> s'anomenen <emphasis>guions del desenvolupador</emphasis> («maintainer scripts»), i són guions que es col·loquen en l'àrea de control del paquet i són executats pel paquet <command>dpkg</command> quan el teu paquet s'instal·la, s'actualitza o és eliminat.

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>.
ca: Hauries d'evitar editar manualment els <emphasis>guions del desenvolupador</emphasis> degut a la seva complexitat.  Consulta <ulink url="&policy-mantainerscripts;">«Debian Policy Manual, 6 "Package maintainer scripts and installation procedure"»</ulink> i examina els exemples contruïts per <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>.
ca: Si malgrat les meves advertències, adaptes els <emphasis>guions del desenvolupador</emphasis> per al teu paquet, comprova el seu funcionament en la <emphasis role="strong">instal·lació</emphasis>, <emphasis role="strong">actualització</emphasis>, <emphasis role="strong">desinstal·lació</emphasis> i <emphasis role="strong">eliminació completa</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).
ca: Les actualitzacions a una nova versió cal que siguin «silencioses» i no intrusives (els usuaris només haurien de veure que s'han arreglat els errors i afegit noves funcions).

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.
ca: Quan l'actualització és necessàriament intrusiva (p.  ex.  fitxers de configuració dispersos en diversos directoris amb una estructura totalment modificada), s'haurien d'establir els valors predeterminats segurs (p.  ex.  desactivar els serveis) i facilitar la documentació apropiada establerta en les normes (fitxers <filename>README.Debian</filename> i <filename>NEWS.Debian</filename>) com a darrer recurs.  Cal evitar molestar a l'usuari amb notes <command>debconf</command> invocades pels <emphasis>guions del desenvolupador</emphasis> en les actualitzacions.

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.
ca: El paquet <systemitem role="package">ucf</systemitem> facilita el sistema <emphasis>conffile-like</emphasis> per preservar els canvis de configuració realitzats per l'usuari i per això no han de anomenar-se com <emphasis>conffiles</emphasis> els fitxers gestionats pels <emphasis>guions del desenvolupador</emphasis>.  Així es minimitzen les incidències associades amb ells.

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.
ca: Aquests <emphasis>guions del desenvolupador</emphasis> són un exemple de les característiques de Debian que expliquen <emphasis role="strong">perquè la gent elegeix Debian</emphasis>.  Has de ser acurat amb no molestar amb ells.

note: type: Content of: <book><chapter><section><title>
en: <filename><replaceable>package</replaceable>.symbols</filename>
ca: Fitxer <filename><replaceable>nom_del_paquet</replaceable>.symbols</filename>.

note: type: Content of: <book><chapter><section><title>
en: <filename>TODO</filename>
ca: Fitxer <filename>TODO</filename>.

note: type: Content of: <book><chapter><section><para>
en: The <citerefentry> <refentrytitle>dh_installdocs</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> command installs this.
ca: L'ordre <citerefentry> <refentrytitle>dh_installdocs</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> instal·la aquest arxiu.

note: type: Content of: <book><chapter><section><title>
en: <filename>watch</filename>
ca: Fitxer <filename>watch</filename>.

note: type: Content of: <book><chapter><section><para>
en: Here are its contents:
ca: Aquest és el seu contingut:

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.
ca: Amb aquest arxiu <filename>watch</filename>, l'URL <literal>&sf-net;/gentoo</literal> es descarrega i es busca els enllaços de tipus <literal>&lt;a href=...&gt;</literal>.  El nom base (just la part després del <literal>/</literal> final) d'aquests enllaços URL es comparen amb la funció «regexp» de Perl (consulta <citerefentry> <refentrytitle>perlre</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>)  amb el patró <literal>gentoo-(.+)\.tar\.gz</literal>.  Dels fitxers trobats que s'ajusten al patró, es descarrega el de la versió més recent i el programa <command>uupdate</command> s'executa per actualitzar el codi original.

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>.
ca: Si l'autor original publica la signatura criptogràfica del fitxer tarball, es recomana verificar la seva autenticitat fent servir l'opció <literal>pgpsigurlmangle</literal> descrita a  <citerefentry> <refentrytitle>uscan</refentrytitle><manvolnum>1</manvolnum> </citerefentry>.

note: type: Content of: <book><chapter><section><title>
en: <filename>source/format</filename>
ca: Fitxer <filename>source/format</filename>.

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:
ca: El fitxer <filename>debian/source/format</filename>, només conté una línia que indica el format de construcció del paquet (consulta <citerefentry> <refentrytitle>dpkg-source</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> on hi ha la llista completa).  Després de <literal>squeeze</literal> hauria de ser:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>3.0 (native)</literal> for native Debian packages or
ca: <literal>3.0 (native)</literal> per a paquets nadius de Debian o

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>3.0 (quilt)</literal> for everything else.
ca: <literal>3.0 (quilt)</literal> per als altres paquets.

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.
ca: Consulta <ulink url="&debsrc3;">DebSrc3.0</ulink> on es resumeix la informació sobre els formats <literal>3.0 (quilt)</literal> i <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.
ca: Actualment, el nou format també permet treballar amb més d'un arxiu «tar» amb les fonts originals i altres sistemes de compressió.  Aquestes funcions no s'expliquen en aquest 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"/>
ca: El nou format <literal>3.0 (quilt)</literal> registre els canvis realitzats en el paquet en fitxers de pegats <command>quilt</command> en el directori <filename>debian/patches</filename>.  Aquests canvis s'aplique automàticament en l'extracció dels fitxers originals del paquet <placeholder type="footnote" id="0"/>.  Les modificacions es desen en el fitxer <filename>debian.tar.gz</filename> que conté tots els fitxers del directori <filename>debian</filename> utilitzat en la construcció del paquet.  El nou format permet la inclusió d'arxius com els icones PNG sense necessitat de trucs <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.
ca: Quan <command>dpkg-source</command> extreu un paquet amb les fonts amb el format <literal>3.0 (quilt)</literal>, automàticament s'apliquen tots els pegats llistats en l'arxiu <filename>debian/patches/series</filename>.  Això ho pots evitar amb l'opció <literal>--skip-patches</literal>.

note: type: Content of: <book><chapter><section><title>
en: <filename>source/local-options</filename>
ca: Fitxer <filename>source/local-options</filename>.

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>).
ca: Un cop compilat el paquet, els pegats s'hauran aplicat a les fonts.  Hauràs de desfer els pegats executant <literal>dquilt pop -a</literal> abans de sincronitzar-les amb la branca <literal>master</literal>.  Pots automatitzar aquesta tasca afegint l'arxiu opcional <filename>debian/source/local-options</filename> el contingut del qual serà <literal>unapply-patches</literal>.  Aquest arxiu no s'inclou en el paquet font generat i únicament canvia l'entorn local de construcció.  Aquest fitxer també pot contenir la línia <literal>abort-on-upstream-changes</literal> (consulta <citerefentry> <refentrytitle>dpkg-source</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>).

note: type: Content of: <book><chapter><section><title>
en: <filename>source/options</filename>
ca: Fitxer <filename>source/options</filename>

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"/>.
ca: Els arxius generats automàticament a l'arbre del codi font poden ser bastant molests en la construcció de paquets ja que generen arxius grans de pegats. Hi ha mòduls personalitzats, com ara <command>dh_autoreconf</command> per alleujar aquest problema com es descriu a <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.
ca: Pots proporcionar una expressió regular en Perl per a l'opció <literal>--extend-diff-ignore</literal> de <citerefentry> <refentrytitle>dpkg-source</refentrytitle><manvolnum>1</manvolnum> </citerefentry> per fer cas omís dels canvis realitzats en els arxius generats automàticament en crear el paquet font.

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>.
ca: Pots emmagatzemar aquestes opcions de l'ordre <command>dpkg-source</command> a l'arxiu <filename>source/options</filename> de les fonts del paquet com a solució genèrica per a fer front a aquest problema dels arxius generats automàticament. A l'exemple, s'evita la creació d'arxius de pegat pels arxius <filename>config.sub</filename>, <filename>config.guess</filename> i <filename>Makefile</filename>.

note: type: Content of: <book><chapter><section><title>
en: <filename>patches/*</filename>
ca: Fitxers <filename>patches/*</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.
ca: L'antic format <literal>1.0</literal> construïa un arxiu <filename>diff.gz</filename> amb el contingut dels fitxers de construcció del paquet del directori <filename>debian</filename> i els canvis a realitzar en les fonts.  Aquest format per conservar els canvis era una mica enutjós quan es tractava d'inspeccionar i entendre cada modificació de les fonts.  Ja no és eficaç.

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.
ca: Es fan servir altres mètodes d'aplicació de pegats a Debian. El sistema <command>quilt</command> és el recomanat. Altres sistemes són <command>dpatch</command>, <command>dbs</command>, <command>cdbs</command>, etc. La majoria d'ells conserven els pegats en fitxers en el directori <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"/>
ca: El nou format <literal>3.0 (quilt)</literal> de les fonts, desa les modificacions (els pegats) a fer als fitxers en el directori <filename>debian/patches/*</filename> fent servir l'ordre <command>quilt</command>. Aquests pegats i altres dades del paquet ubicats en el directori <filename>debian</filename> es conserven en el fitxer <filename>debian.tar.gz</filename>. Des que l'ordre <command>dpkg-source</command> pot aplicar els pegats a les fonts amb el nou format <literal>3.0 (quilt)</literal> sense el paquet <systemitem role="package">quilt</systemitem>, no és necessari afegir el paquet <systemitem role="package">quilt</systemitem> en el camp <literal>Build-Depends</literal> del fitxer <filename>control</filename> <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.
ca: Si has demanat a un patrocinador que afegeixi el paquet al repositori Debian, aquest sistema de separació i documentació dels canvia és molt important per facilitar la revisió del paquet per part del patrocinador.

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"/>
ca: El funcionament de l'ordre <command>quilt</command> s'explica en <citerefentry> <refentrytitle>quilt</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.  Conserva les modificacions de les fonts en una col·lecció de fitxers de pegats <literal>-p1</literal> en el directori <filename>debian/patches</filename> i les fonts originals romanen sense modificar fora del directori <filename>debian</filename>.  L'ordre d'aplicació de les modificacions es conserva en el fitxer <filename>debian/patches/series</filename>.  Pots executar («push»), desfer («pop») i actualitzar les modificacions fàcilment <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>.
ca: A <xref linkend="modify"/>, s'han construït tres fitxers de pegats en el directori <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"/>.
ca: Com que els pegats s'ubiquen en <filename>debian/patches</filename>, comprova que has configurat correctament l'ordre <command>dquilt</command> com es descriu a <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:
ca: Quan algú (inclòs tu mateix), facilita un pegat <filename><replaceable>nom_pegat</replaceable>.patch</filename> per a les fonts, una vegada construït el paquet, la modificació del paquet amb format <literal>3.0 (quilt)</literal> és així de 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
ca: $ 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
    ... descripció de la modificació

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>.
ca: Els pegats conservats amb el nou format de fonts <literal>3.0 (quilt)</literal> han d'estar <emphasis>exempts</emphasis> de coses innecessàries. Pots comprovar-ho executant <literal>dquilt pop -a; while dquilt push; do dquilt refresh; done</literal>.

note: type: Content of: <book><chapter><title>
en: Building the package
ca: Construir el paquet.

note: type: Content of: <book><chapter><para>
en: We should now be ready to build the package.
ca: Ara hauríem d'estar preparats per construir el paquet.

note: type: Content of: <book><chapter><section><title>
en: Complete (re)build
ca: Reconstrucció completa.

note: type: Content of: <book><chapter><section><para>
en: In order to perform a complete (re)build of a package properly, you need to make sure you have installed
ca: Per realitzar correctament la construcció ( o la reconstrucció) completa d'un paquet, comprova que els següents paquets estan instal·lats:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: the <systemitem role="package">build-essential</systemitem> package,
ca: el 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
ca: els paquets llistats en el camp <literal>Build-Depends</literal> del fitxer «control» (consulta <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"/>).
ca: els paquets llistats en el camp <literal>Build-Depends-indep</literal> (també de l'arxiu «control», consulta <xref linkend="control"/>).

note: type: Content of: <book><chapter><section><para>
en: Then you issue the following command in the source directory:
ca: Accedeix al directori principal del codi font del programa i executa la següent ordre:

note: type: Content of: <book><chapter><section><para>
en: This will do everything to make full binary and source packages for you.  It will:
ca: Aquesta ordre farà totes les tasques necessàries per construir els paquets binaris i de fonts.  Més concretament:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: clean the source tree (<literal>debian/rules clean</literal>)
ca: neteja l'arbre del codi (<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>)
ca: construeix el paquet de codi font (<literal>dpkg-source -b</literal>).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: build the program (<literal>debian/rules build</literal>)
ca: compila el programa (<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>)
ca: construeix el paquet binari (<literal>fakeroot debian/rules binary</literal>)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: make the <filename>.dsc</filename> file
ca: genera el fitxer <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>
ca: genera l'arxiu <filename>.changes</filename>, fent servir l'ordre <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>.
ca: Aquesta clau GPG ha de ser signada per un desenvolupador de Debian per connectar-se a la web de confiança i cal registrar-la a <ulink url="&keyring;">l'anell de claus de Debian</ulink>. Això permet que els paquets siguin acceptats a l'arxiu de Debian. Consulta <ulink url="&keycreate;">Creating a new GPG key</ulink> i <ulink url="&keysigning; ">Debian Wiki on Keysigning</ulink>.

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:
ca: Quan acabi el procés de construcció d'un paquet no nadiu Debian (p.ex.<systemitem role="package">gentoo</systemitem>), veuràs els següents fitxers en el directori superior al directori de treball (<filename>~/gentoo/</filename>):

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>.
ca: Aquest és un sumari dels continguts del codi font.  Aquest arxiu es genera amb la informació del fitxer <filename>control</filename> i es fa servir quan es descomprimeixen les fonts amb <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>.
ca: Aquest arxiu comprimit té tots els fitxers del directori <filename>debian</filename>.  Les modificacions de les fonts originals es conserven en els fitxers de pegats <command>quilt</command> en el directori <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.
ca: Pots evitar l'aplicació automàtica dels pegats per <command>quilt</command> en els paquets amb el format <literal>3.0 (quilt)</literal> al final de l'extracció amb l'opció <literal>--skip-patches</literal>. També pots optar per desfer les modificacions, una vegada acabada l'extracció, executant <literal>dquilt pop -a</literal>.

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"/>
ca: Si una altra persona vol tornar a construir el paquet des de l'inici, pot fer-ho fàcilment fent servir aquests tres fitxers.  El procés d'extracció és trivial: només cal copiar-los en un directori i executar <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.
ca: Aquest és el paquet binari Debian.  Pots fer servir <command>dpkg</command> per instal·lar o eliminar aquest paquet o qualsevol altre.

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.
ca: Aquest arxiu conté la descripció dels canvis fets en la revisió actual del paquet, i el fan servir els programes de gestió FTP del repositori Debian per instal·lar-hi els paquets binaris i de fonts.  Se genera parcialment amb l'arxiu <filename>changelog</filename> i el fitxer <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.
ca: Amb el temps, el paquet anirà canviat i s'afegiran funcions.  Les persones que descarreguin el paquet poden llegir aquest arxiu i assabentar-se dels canvis.  Els programes de manteniment del repositori Debian també envien el contingut d'aquest arxiu a la llista de correu <ulink url="&debian-devel-changes-ldo;">debian-changes-announce@lists.debian.org</ulink>.

note: type: Content of: <book><chapter><section><screen>
en: DEBSIGN_KEYID=Your_GPG_keyID
ca: DEBSIGN_KEYID=el_teu_identificador_de_la_clau_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.
ca: Les llistes de números en els fitxers <filename>.dsc</filename> i <filename>.changes</filename> són les sumes MD5/SHA1/SHA256 dels fitxers.  Les persones que descarreguen els arxius poden comprovar-los amb <citerefentry> <refentrytitle>md5sum</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>sha1sum</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> o <citerefentry> <refentrytitle>sha256sum</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> i si els nombres no coincideixen sabran que el fitxer està corrupte o s'ha modificat.

note: type: Content of: <book><chapter><section><title>
en: Autobuilder
ca: «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.
ca: El funcionament del sistema actual de compilació automàtica és més complicat del que s'explica en aquest document.  Molts dels detalls del seu funcionament no són objectiu d'aquest 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"/>
ca: Debian manté diverses <ulink url="&ports;">adaptacions «ports»</ulink> amb la <ulink url="&buildd;">xarxa de servidors de compilació automàtica</ulink> que executa dimonis <command>buildd</command> en ordinadors d'arquitectura diferent.  Encara que tu no hauràs de fer res de tot això, has de conèixer el processament del teu paquet.  Veurem com es processa el paquet per compilar-ho en diferents arquitectures <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
ca: Els paquets del tipus <literal>Architecture: any</literal>, són construïts pel sistema de compilació automàtica.  El sistema garanteix la instal·lació de:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: the <systemitem role="package">build-essential</systemitem> package, and
ca: el paquet <systemitem role="package">build-essential</systemitem>, i

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: packages listed in the <literal>Build-Depends</literal> field (see <xref linkend="control"/>).
ca: els paquets llistats en el camp <literal>Build-Depends</literal> (consulta <xref linkend="control"/>).

note: type: Content of: <book><chapter><section><para>
en: Then it issues the following command in the source directory:
ca: A continuació s'executa la següent ordre en el directori de les fonts:

note: type: Content of: <book><chapter><section><para>
en: This will do everything to make architecture dependent binary packages on another architecture.  It will:
ca: D'aquest manera, s'executa tot el necessari per a la construcció del paquet binari depenent de l'arquitectura per a cada arquitectura.  Fa el següent:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: build architecture dependent binary packages (<literal>fakeroot debian/rules binary-arch</literal>)
ca: construeix el paquet binari per a l'arquitectura (<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>
ca: signa l'arxiu <filename>.dsc</filename> fent servir l'ordre <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>
ca: genera i signa l'arxiu <filename>.changes</filename>, fent servir les ordres <command>dpkg-genchanges</command> i <command>gpg</command>

note: type: Content of: <book><chapter><section><para>
en: This is why you see your package for other architectures.
ca: Així, el paquet estarà disponible per a altres arquitectures.

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.
ca: A diferència a com funciona el paquet <systemitem role="package">pbuilder</systemitem> (que s'explicarà més endavant), l'entorn <command>chroot</command> del paquet <systemitem role="package">sbuild</systemitem> fet servir pel sistema automàtic no té una instal·lació mínima de paquets del sistema i pot deixar molts de paquets instal·lats.

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"/>).
ca: Encara que és necessari instal·lar els paquets llistats en el camp <literal>Build-Depends-indep</literal> per a la construcció de paquets normal (consulta <xref linkend="completebuild"/>), el sistema automàtic de construcció no ho requereix degut a què només construeix paquets binaris dependents de l'arquitectura <placeholder type="footnote" id="0"/>.  Aquestes diferències entre l'empaquetament normal i l'automàtic determinen si els paquets requerits per a la compilació s'han de llistar en el camp <literal>Build-Depends</literal> o en el camp <literal>Build-Depends-indep</literal> del fitxer <filename>debian/control</filename> (consulta <xref linkend="control"/>).

note: type: Content of: <book><chapter><section><title>
en: <command>debuild</command> command
ca: L'ordre <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>.
ca: Pots automatitzar encara més el procés de construcció de paquets de <command>dpkg-buildpackage</command> seguit de l'ordre <command>debuild</command>.  Consulta <citerefentry> <refentrytitle>debuild</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.

note: type: Content of: <book><chapter><section><para>
en: Cleaning the source and rebuilding the package from your user account is as simple as:
ca: Per exemple, netejar el codi i reconstruir el paquet des d'un compte d'usuari és tan simple com:

note: type: Content of: <book><chapter><section><para>
en: You can clean the source tree as simply as:
ca: Pots eliminar els fitxers generats en la compilació executant:

note: type: Content of: <book><chapter><section><title>
en: <systemitem role="package">pbuilder</systemitem> package
ca: El 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.
ca: Com que el paquet <systemitem role="package">pbuilder</systemitem> està en evolució, comprova la configuració actual consultant la documentació.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&buildd-do;"/> for more on Debian package auto-building.
ca: Consulta <ulink url="&buildd-do;"/> per a més informació sobre el sistema de construcció automatitzada 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"/>
ca: El paquet <systemitem role="package">pbuilder</systemitem> és molt útil per aconseguir un entorn net (<command>chroot</command>) on comprovar les dependències <placeholder type="footnote" id="0"/>. Això assegura una construcció neta des del codi per a la construcció automàtica en la distribució <literal>sid</literal> per a diferents arquitectures i evita errades serioses del tipus FTBFS (Petada en la construcció des de les fonts o «Fail to Build From Source»), que són sempre de tipus RC (errades critiques per a la publicació o «release critical») <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:
ca: És possible personalitzar el funcionament del paquet <systemitem role="package">pbuilder</systemitem> en els següents aspectes:

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.
ca: permet que el teu usuari tengui permís d'escriptura en el directori <filename>/var/cache/pbuilder/result</filename>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: creating a directory, e.g.  <filename><replaceable>/var/cache/pbuilder/hooks</replaceable></filename>, writable by the user, to place hook scripts in.
ca: genera un directori, p.  ex.  <filename><replaceable>/var/cache/pbuilder/hooks</replaceable></filename>, amb permís d'escriptura per al teu usuari.  En aquest directori posaràs els guions «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.
ca: Estableix els fitxers <filename>~/.pbuilderrc</filename> o <filename>/etc/pbuilderrc</filename> amb el següent contingut:

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:
ca: Ara pots inicialitzar el sistema local <systemitem role="package">pbuilder</systemitem> <command>chroot</command> per primera vegada executant:

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:
ca: Si treballes amb un paquet font complet, executa les següents ordres en el directori on tenguis els fitxers <filename><replaceable>nom_del_paquet</replaceable>.orig.tar.gz</filename>, <filename><replaceable>nom_del_paquet</replaceable>.debian.tar.gz</filename> i <filename><replaceable>nom_del_paquet</replaceable>.dsc</filename> per actualitzar el sistema local <systemitem role="package">pbuilder</systemitem> <command>chroot</command> i, a continuació, compilar el paquet binari:

note: type: Content of: <book><chapter><section><screen>
en: $ sudo pbuilder --update
    $ sudo pbuilder --build <replaceable>foo_version</replaceable>.dsc
ca: $ sudo pbuilder --update
    $ sudo pbuilder --build <replaceable>nom_del_paquet</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.
ca: En acabar la compilació, el paquet compilat estarà en el directori <filename>/var/cache/pbuilder/result/</filename> i tu en seràs el propietari.

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:
ca: La signatura GPG dels arxius <filename>.dsc</filename> i <filename>.changes</filename> es poden generar de la següent manera:

note: type: Content of: <book><chapter><section><screen>
en: $ cd /var/cache/pbuilder/result/
    $ debsign <replaceable>foo_version_arch</replaceable>.changes
ca: $ cd /var/cache/pbuilder/result/
    $ debsign <replaceable>nom_del_paquet_versió_arquitectura</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:
ca: Si en lloc d'iniciar la construcció del paquet a partir d'un paquet ja construït, disposes d'un directori amb les fonts originals actualitzades, hauràs d'executar les següents ordres des del directori de les fonts originals (on hi haurà el directori <filename>debian</filename> amb el seu contingut):

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).
ca: Pots «connectar-te» a l'entorn <command>chroot</command> executant l'ordre <literal>pbuilder --login --save-after-login</literal> i configurar-lo per adaptar-lo a les teves necessitats.  Aquest entorn pot desar-se sortint del «shell» amb <literal>^D</literal> (Control-D).

note: type: Content of: <book><chapter><section><para><footnote><para>
en: This assumes <literal>HOOKDIR=/var/cache/pbuilder/hooks</literal>.  You can find many examples of hook scripts in the <filename>/usr/share/doc/pbuilder/examples</filename> directory.
ca: Se suposa que la variable d'entorn <literal>HOOKDIR=/var/cache/pbuilder/hooks</literal> ja està configurada.  Tens exemples a <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"/>
ca: La darrera versió de l'ordre <command>lintian</command> pot executar-se automàticament en l'entorn <literal>chroot</literal> fent servir el guió «hook» disponible a <filename><replaceable>/var/cache/pbuilder/hooks</replaceable>/B90lintian</filename> i configurat de la següent manera <placeholder type="footnote" id="0"/>:

note: type: Content of: <book><chapter><section><para>
en: You need to have access to the latest <literal>sid</literal> environment to build packages properly for <literal>sid</literal>.  In practice, <literal>sid</literal> may be experiencing issues which makes it undesirable for you to migrate your whole system.  The <systemitem role="package">pbuilder</systemitem> package can help you to cope with this kind of situation.
ca: Has de tenir un entorn <literal>sid</literal> actualitzat per construir correctament paquets per a <literal>sid</literal>.  En realitat, la versió <literal>sid</literal> pot tenir errades que no fan recomanable la migració del teu sistema en aquesta versió.  El paquet <systemitem role="package">pbuilder</systemitem> t'ajuda a fer front en aquesta situació.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: There are some restrictions for such updates of your <literal>stable</literal> package.
ca: Hi ha restriccions per a aquestes actualitzacions del teu paquet per a la versió <literal>stable</literal>.

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

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&debref-vcs;">Version control systems</ulink> for more.
ca: Consulta <ulink url="&debref-vcs;">Version control systems</ulink>.

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.
ca: Si l'autor original fa servir un sistema de gestió de versions per al codi (VCS) <placeholder type="footnote" id="0"/>  pots considerar fer-ho servir. Així facilites la coordinació i la selecció dels pegats per a les fonts. Debian disposa de diversos paquets de guions especialitzats en cada tipus de VCS:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">git-buildpackage</systemitem>: a suite to help with Debian packages in Git repositories.
ca: <systemitem role="package">git-buildpackage</systemitem>: conjunt per a la compilació de paquets en repositoris «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.
ca: <systemitem role="package">svn-buildpackage</systemitem>: programes d'ajuda per al manteniment de paquets Debian amb «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.
ca: <systemitem role="package">cvs-buildpackage</systemitem>: conjunt de paquets de guions Debian per a estructures de directoris 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.
ca: <ulink url="&debian-alioth-wiki;">Debian wiki Alioth</ulink> documenta com fer servir el servei <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:
ca: L'ús de <systemitem role="package">git-buildpackage</systemitem> està esdevenint bastant popular entre els desenvolupadors Debian per la gestió dels paquets Debian amb el servidor «Git» a <ulink url="&debian-alioth;">alioth.debian.org</ulink>. <placeholder type="footnote" id="0"/> Aquest paquet ofereix moltes ordres per <emphasis>automatitzar</emphasis> el manteniment dels paquets:

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.
ca: <citerefentry> <refentrytitle>git-buildpackage</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>: construeix els paquets Debian des del repositori «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>.
ca: <citerefentry> <refentrytitle>git-pbuilder</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>: construeix els paquets Debian des del repository «Git» fent servir <command>pbuilder</command>/<command>cowbuilder</command>.

note: type: Content of: <book><chapter><section><para>
en: These commands use 3 branches to track packaging activity:
ca: Aquestes ordres fan servir 3 branques per gestionar el procés d'empaquetat:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>main</literal> for Debian package source tree.
ca: <literal>main</literal> pels directoris de fonts del paquet Debian.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>upstream</literal> for upstream source tree.
ca: <literal>upstream</literal> pels directoris de les fonts de l'autor.

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"/>
ca: <literal>pristine-tar</literal> pel fitxer comprimit «.tar» de l'autor generat per l'opció <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.
ca: Aquí tens alguns recursos web disponibles per al públic expert.

note: type: Content of: <book><chapter><section><para><footnote><itemizedlist><listitem><para>
en: Building Debian Packages with git-buildpackage (<filename>&git-buildpackage-doc;</filename>)
ca: Construcció de paquets Debian amb 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>
ca: <ulink url="&debian-packages-git;">Paquets Debian amb «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>
ca: <ulink url="&git-debian-packaging;">Fent servir «Git» en la construcció de paquets 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>
ca: <ulink url="&git-dpm;">«git-dpm»: paquets Debian amb el gestor «Git»</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"/>
ca: Pots configurar <systemitem role="package">git-buildpackage</systemitem> amb <filename>~/.gbp.conf</filename>. Consulta <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
ca: Reconstrucció ràpida.

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"/>:
ca: Amb un paquet gran, pot ésser que no vulguis re-compilar des de l'inici cada vegada que fas algun canvi en el fitxer <filename>debian/rules</filename>. Per fer proves, pots construir un arxiu <filename>.deb</filename> sense re-compilar les fonts executant <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:
ca: O simplement pots comprovar si el paquet se compila amb:

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.
ca: Un cop has acabat la posada a punt, caldrà reconstruir el paquet amb el procediment explicat anteriorment.  No podràs enviar al repositori els fitxers <filename>.deb</filename> construïts d'aquesta manera.

note: type: Content of: <book><chapter><section><title>
en: Command hierarchy
ca: Jerarquia d'ordres

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.
ca: A continuació teniu un resum ràpid de la jerarquia de les ordres de construcció de paquets. Hi ha diversos procediments per fer el mateix.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <filename>debian/rules</filename> = maintainer script for the package building
ca: <filename>debian/rules</filename> = guió del responsable del paquet per a la compilació

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <command>dpkg-buildpackage</command> = core of the package building tool
ca: <command>dpkg-buildpackage</command> = nucli de l'eina de compilació de paquets

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)
ca: <command>debuild</command> = <command>dpkg-buildpackage</command> + <command>lintian</command> (compilació en un entorn amb les variables controlades)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <command>pbuilder</command> = core of the Debian chroot environment tool
ca: <command>pbuilder</command> = nucli de l'entorn «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)
ca: <command>pdebuild</command> = <command>pbuilder</command> + <command>dpkg-buildpackage</command> (compilació en l'entorn «chroot»)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <command>cowbuilder</command> = speed up the <command>pbuilder</command> execution
ca: <command>cowbuilder</command> = execució accelerada de <command>pbuilder</command>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <command>git-pbuilder</command> = the easy-to-use commandline syntax for <command>pdebuild</command> (used by <command>gbp buildpackage</command>)
ca: <command>git-pbuilder</command> = sintaxis fàcil de fer servir de l'ordre <command>pdebuild</command> (la fa servir <command>gbp buildpackge</command>)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <command>gbp</command> = manage the Debian source under the git repo
ca: <command>gbp</command> = gestiona els fitxers Debian en un repositori «git»

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <command>gbp buildpackage</command> = <command>pbuilder</command> + <command>dpkg-buildpackage</command> + <command>gbp</command>
ca: <command>gbp buildpackge</command> = <command>pbuilder</command> + <command>dpkg-buildpackage</command> + <command>gbp</command>

note: type: Content of: <book><chapter><section><para>
en: Although use of higher level commands such as <command>gbp buildpackage</command> and <command>pbuilder</command> ensures the perfect package building environment, it is essential to understand how lower level commands such as <filename>debian/rules</filename> and <command>dpkg-buildpackage</command> are executed under them.
ca: Tot i que fer servir ordres d'alt nivell com a <command>gbp buildpackge</command> i <command>pbuilder</command> assegura un entorn de compilació de paquets perfecte, és important entendre com funcionen les ordres de baix nivell com les executades per <filename>debian/rules</filename> i <command>dpkg-buildpackage</command> en aquest entorn.

note: type: Content of: <book><chapter><title>
en: Checking the package for errors
ca: Com comprovar el teu paquet per trobar errors.

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.
ca: Cal que coneguis els procediments per comprovar el paquet i localitzar les errades abans d'enviar-lo als repositoris públics.

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.
ca: Provar el paquet en una màquina distinta de la que has fet servir en la construcció és una magnífica idea.  Cal que posis atenció en tots els errors detectats en les proves que s'expliquen a continuació.

note: type: Content of: <book><chapter><section><title>
en: Suspicious changes
ca: Canvis sospitosos

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"/>.
ca: Si trobes un nou arxiu de pegat auto-generat com <filename>debian-changes-*</filename> en el directori <filename>debian/patches</filename> desprès de compilar el teu paquet no nadiu Debian en el format <literal>3.0 (quilt)</literal>, el més probable és que has canviat algun arxiu per accident o el guió de compilació ha modificat les fonts originals. Si és un error teu, ho corregeixes. Si l'error l'ha causat el guió, corregeix la causa de l'error amb <command>dh-autoreconf</command> com a <xref linkend="customrules"/> o bé fes proves amb els arxius <filename>source/options</filename> com s'ha explicat a <xref linkend="sourceopt"/>.

note: type: Content of: <book><chapter><section><title>
en: Verifying a package's installation
ca: Comprovació de la instal·lació del paquet

note: type: Content of: <book><chapter><section><title>
en: Verifying a package's maintainer scripts
ca: Comprovar els <emphasis>guions del desenvolupador</emphasis> («maintainer scripts»).

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"/>).
ca: Ja s'ha comentat que els <emphasis>guions del desenvolupador</emphasis> (els fitxers <filename>preinst</filename>, <filename>prerm</filename>, <filename>postinst</filename> i <filename>postrm</filename>) són complicats, excepte si s'utilitzen els generats pel paquet <systemitem role="package">debhelper</systemitem>.  No es recomana la seva utilització als desenvolupadors principiants (consulta <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:
ca: Si el paquet utilitza <emphasis>guions del desenvolupador</emphasis> modificats, has de comprovar el seu funcionament en la instal·lació, desinstal·lació, eliminació i actualització. Alguns dels problemes en aquests <emphasis>guions del desenvolupador</emphasis> només es detecten en l'eliminació o desinstal·lació. Fes servir l'ordre <command>dpkg</command> per fer la comprovació:

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
ca: $ sudo dpkg -r gentoo
    $ sudo dpkg -P gentoo
    $ sudo dpkg -i gentoo_<replaceable>versió</replaceable>-<replaceable>revisió</replaceable>_<replaceable>i386</replaceable>.deb

note: type: Content of: <book><chapter><section><para>
en: This should be done with sequences such as the following:
ca: Segueix aquesta seqüència per a la comprovació:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: install the previous version (if needed).
ca: Instal·la la versió anterior del paquet (obligatori).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: upgrade it from the previous version.
ca: Actualitza ara a la versió actual.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: downgrade it back to the previous version (optional).
ca: Torna a la versió anterior (opcional).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: purge it.
ca: Desinstal·la el paquet.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: install the new package.
ca: Instal·la la nova versió del paquet.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: remove it.
ca: Elimina'l.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: install it again.
ca: Instal·la'l de nou.

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.
ca: Si treballes en la construcció de la primera versió del paquet, construeix versions «fantasma» anteriors (és suficient canviar el número de versió)  per realitzar les proves i prevenir problemes.

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.
ca: Recorda que si hi ha versions anteriors del paquet en el repositori Debian, els usuaris actualitzaran el paquet des de la versió anterior disponible (i aquesta versió pot ésser distinta en la versió estable i de proves).  Realitza les comprovacions també amb aquestes versions.

note: type: Content of: <book><chapter><section><para>
en: Although downgrading is not officially supported, supporting it is a friendly gesture.
ca: Encara que no es garanteix la reinstal·lació d'una versió anterior, és preferible assegurar-se que és possible fer-ho sense generar problemes.

note: type: Content of: <book><chapter><section><title>
en: Using <systemitem role="package">lintian</systemitem>
ca: El paquet <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"/>.
ca: No és necessari afegir a <command>lintian</command> l'opció <literal>-i -I --show-overrides</literal> si l'has inclòs en la configuració a <filename>/etc/devscripts.conf</filename> o <filename>~/.devscripts</filename> com s'ha explicat a <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"/>
ca: Executa <citerefentry> <refentrytitle>lintian</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> amb el teu arxiu de canvis <filename>.changes</filename>.  L'ordre <command>lintian</command> executa diversos guions de comprovació del paquet per localitzar els errors més freqüents <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:
ca: Per suposat, canvia el nom de l'arxiu pel nom de l'arxiu <filename>.changes</filename> del teu paquet.  Els missatges d'error de <command>lintian</command> es codifiquen amb una lletra inicial en la línia del missatge:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>E:</literal> for error; a sure policy violation or packaging error.
ca: <literal>E:</literal> error; per indicar violacions de les normes o un error en el paquet.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>W:</literal> for warning; a possible policy violation or packaging error.
ca: <literal>W:</literal> advertència; per advertir d'una possible violació de les normes o error en el paquet (però pot ésser una falsa alarma).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>I:</literal> for info; information on certain aspects of packaging.
ca: <literal>I:</literal> informació; informació sobre algun aspecte del paquet (que tal vegada és millorable).

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>N:</literal> for note; a detailed message to help your debugging.
ca: <literal>N:</literal> nota o anotació; per a missatges detallats que poden ajudar-te en la depuració del paquet.

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.
ca: <literal>O:</literal> ignorat; per a missatges ignorats (segons la configuració dels fitxers <filename>lintian-overrides</filename>) però que s'emet degut a l'opció <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"/>.
ca: En el cas dels errors (línies amb «E:» inicial), llegeix l'explicació (línies «N:»), fes els canvis necessaris en el paquet o comprova que són avisos falsos.  En aquest cas, fes que <filename>lintian</filename> els accepti com s'ha explicat a <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>.
ca: Observa que pots construir el paquet amb <command>dpkg-buildpackage</command> i executar <command>lintian</command> només amb una ordre si fas servir <citerefentry> <refentrytitle>debuild</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> o <citerefentry> <refentrytitle>pdebuild</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.

note: type: Content of: <book><chapter><section><title>
en: The <command>debc</command> command
ca: L'ordre <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.
ca: Pots veure una llista dels fitxers del paquet binari Debian executant l'ordre <citerefentry> <refentrytitle>debc</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> així:

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

note: type: Content of: <book><chapter><section><title>
en: The <command>debdiff</command> command
ca: L'ordre <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.
ca: Pots comparar el contingut de dos paquets de fonts Debian executant l'ordre <citerefentry> <refentrytitle>debdiff</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> així:

note: type: Content of: <book><chapter><section><screen>
en: $ debdiff <replaceable>old-package</replaceable>.dsc <replaceable>new-package</replaceable>.dsc
ca: $ debdiff <replaceable>versió_anterior</replaceable>.dsc <replaceable>nova_versió</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.
ca: Pots comparar la llista de fitxers de dos paquets binaris de Debian amb l'ordre <citerefentry> <refentrytitle>debdiff</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> executant l'ordre següent:

note: type: Content of: <book><chapter><section><screen>
en: $ debdiff <replaceable>old-package</replaceable>.changes <replaceable>new-package</replaceable>.changes
ca: $ debdiff <replaceable>versió_anterior</replaceable>.changes <replaceable>nova_versió</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.
ca: Aquest programa és útil per comprovar que no hi ha fitxers canviats d'ubicació o eliminats per error, i que no s'ha realitzat cap altre canvi no desitjat en l'actualització del paquet.

note: type: Content of: <book><chapter><section><title>
en: The <command>interdiff</command> command
ca: L'ordre <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.
ca: Pots comparar dos fitxers <filename>diff.gz</filename> amb l'ordre <citerefentry> <refentrytitle>interdiff</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.  Això és útil per comprovar que el responsable del paquet no ha fet canvis inadvertits en l'actualització de paquets construïts amb el format <literal>1.0</literal>.  Executa:

note: type: Content of: <book><chapter><section><screen>
en: $ interdiff -z <replaceable>old-package</replaceable>.diff.gz <replaceable>new-package</replaceable>.diff.gz
ca: $ interdiff -z <replaceable>versió_anterior</replaceable>.diff.gz <replaceable>nova_versió</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.
ca: El nou format <literal>3.0</literal> de les fonts conserva els canvis en arxius de pegats com es descriu a <xref linkend="patches"/>. Pots veure els canvis de cada arxiu <filename>debian/patches/*</filename> fent servir l'ordre <command>interdiff</command>.

note: type: Content of: <book><chapter><section><title>
en: The <command>mc</command> command
ca: L'ordre <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.
ca: Algunes de les operacions de comprovació del paquet explicades poden realitzar-se de manera molt intuïtiva si es fa servir un gestor de fitxers com <citerefentry> <refentrytitle>mc</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, que permet visualitzar el contingut del paquet <filename>*.deb</filename>, i dels fitxers <filename>*.udeb</filename>, <filename>*.debian.tar.gz</filename>, <filename>*.diff.gz</filename> i <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.
ca: Comprova que no hi hagi fitxers innecessaris o de tamany zero, tant en el binari com en el paquet font.  De vegades, hi ha coses que no es varen netejar adequadament: caldrà ajustar el fitxer <filename>rules</filename> per arreglar això.

note: type: Content of: <book><chapter><title>
en: Updating the package
ca: Actualitzar el paquet.

note: type: Content of: <book><chapter><para>
en: After you release a package, you will soon need to update it.
ca: Després del llançament del paquet, és possible que hagis d'actualitzar-ho aviat.

note: type: Content of: <book><chapter><section><title>
en: New Debian revision
ca: Nova revisió Debian del paquet.

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:
ca: Suposem que s'ha enviat un informe d'error del teu paquet amb el número <literal>#654321</literal>, i que descriu un problema que pots solucionar.  Per construir una nova revisió del paquet, necessites:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If this is to be recorded as a new patch, do the following:
ca: Si cal aplicar una nova modificació, executa:

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;
ca: <literal>dquilt new <replaceable>nom_modificació.patch</replaceable></literal> per establir el nom de la modificació.

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;
ca: <literal>dquilt add <replaceable>arxiu_a_modificar</replaceable></literal> per establir el fitxer al qual s'aplicarà la modificació.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Correct the problem in the package source for the upstream bug;
ca: Corregir el problema en el paquet de fonts degut a un error de l'autor.

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>;
ca: <literal>dquilt refresh</literal> per desar els canvis realitzats en el fitxer del pegat <filename><replaceable>nom_modificació.patch</replaceable></filename>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt header -e</literal> to add its description;
ca: <literal>dquilt header -e</literal> per afegir la descripció;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If this is to update an existing patch, do the following:
ca: Si cal actualitzar una modificació ja existent, executa:

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>;
ca: <literal>dquilt pop <replaceable>nom_modificacio.patch</replaceable></literal> per tornar a cridar l'arxiu <filename><replaceable>nom_modificacio.patch</replaceable></filename>;

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>;
ca: Corregir el problema existent en la versió incorrecta del fitxer del pegat <filename><replaceable>nom_modificació.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>;
ca: <literal>dquilt refresh</literal> per actualitzar <filename><replaceable>nom_modificació.patch</replaceable></filename>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt header -e</literal> to update its description;
ca: <literal>dquilt header -e</literal> per actualitzar la descripció a la capçalera de l'arxiu del pegat.

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>;
ca: <literal>while dquilt push; do dquilt refresh; done</literal> per aplicar tots els pegats eliminant <emphasis>les coses innecessàries</emphasis>;

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para><footnote><para>
en: To get the date in the required format, use <literal>LANG=C date -R</literal>.
ca: Per escriure la data i hora en el format correcte, cal fer servir <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"/>
ca: Afegir la informació de la revisió a l'inici del fitxer <filename>changelog</filename> (del directori «Debian»), p.  ex.  executant <literal>dch -i</literal> o explícitament indicant el número de versió i revisió executant <literal>dch -v <replaceable>versió</replaceable>-<replaceable>revisió</replaceable></literal>, i a continuació detallar els canvis realitzats amb un editor <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.
ca: Incloure la descripció (breu) de l'error i la solució, seguida de la referència de la notificació de l'error amb <literal>(Closes: #654321)</literal>.  D'aquesta manera, l'informe d'error es «tancarà» <emphasis>automàticament</emphasis> pel sistema de manteniment del repositori de Debian quan el paquet sigui acceptat en el repositori.

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.
ca: Repeteix els passos anteriors per a cada una de les modificacions realitzades actualitzant l'arxiu Debian <filename>changelog</filename> amb <literal>dch</literal> si és necessari.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Repeat what you did in <xref linkend="completebuild"/> and <xref linkend="checkit"/>.
ca: Repeteix el que vas fer a <xref linkend="completebuild"/> i <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"/>
ca: Una vegada satisfet, canvia el valor de la distribució en el fitxer <filename>changelog</filename> de <literal>UNRELEASED</literal> al valor de la distribució objectiu <literal>unstable</literal> (o bé <literal>experimental</literal>).<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><title>
en: Inspection of the new upstream release
ca: Inspecció d'una nova versió de l'autor.

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.
ca: Comença per llegir els fitxers <filename>changelog</filename>, <filename>NEWS</filename> i qualsevol altre documentació on l'autor original expliqui els canvis realitzats en la nova versió.

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:
ca: Pots comprovar els canvis entre les fonts originals de la nova versió i de l'anterior per detectar qualsevol canvi sospitós de produir errors executant:

note: type: Content of: <book><chapter><section><screen>
en: $ diff -urN <replaceable>foo</replaceable>-<replaceable>oldversion</replaceable> <replaceable>foo</replaceable>-<replaceable>newversion</replaceable>
ca: $ diff -urN <replaceable>nom_arxiu</replaceable>-<replaceable>versió_anterior</replaceable> <replaceable>nom_arxiu</replaceable>-<replaceable>nova_versió</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.
ca: Les modificacions realitzades en els fitxers generats per «Autotools» (<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> i <filename>Makefile.in</filename>) pots ignorar-les.  Fins i tot pots eliminar-los abans d'executar <command>diff</command> en les fonts per inspeccionar-les.

note: type: Content of: <book><chapter><section><title>
en: New upstream release
ca: Nova versió del programa font.

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.
ca: Si la versió anterior del paquet està empaquetada amb l'antic format <literal>1.0</literal>, pots fer el mateix executant <literal>zcat /<replaceable>ruta</replaceable>/<replaceable>a</replaceable>/<replaceable>nom_del_paquet</replaceable>_<replaceable>versió_anterior</replaceable>.diff.gz|patch -p1</literal> des del directori de les fonts de la nova versió.

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:
ca: Si el paquet <systemitem role="package"><replaceable>nom_del_paquet</replaceable></systemitem> que examines està correctament empaquetat fent servir els nous formats <literal>3.0 (native)</literal> o <literal>3.0 (quilt)</literal>, per empaquetar una nova versió de l'autor hauria d'ésser suficient copiar el directori <filename>debian</filename> de la versió anterior a la nova, i a continuació realitzar les adaptacions necessàries. Pots copiar el directori <filename>debian</filename> de la versió anterior a la nova versió executant <literal>tar xvzf /<replaceable>ruta</replaceable>/<replaceable>a</replaceable>/<replaceable>nom_del_paquet</replaceable>_<replaceable>versió_anterior</replaceable>.debian.tar.gz</literal> des del directori de les fonts de la nova versió <placeholder type="footnote" id="0"/>. Per descomptat, caldrà fer algunes tasques òbvies:

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.
ca: Comprimir les fonts originals en el fitxer <filename>nom_del_paquet_<replaceable>número_nova_versió</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>.
ca: Actualitzar el fitxer <filename>changelog</filename> del directori «debian» executant <literal>dch -v <replaceable>número_nova_versió</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>.
ca: Afegeix una nova línia amb el text <literal>New upstream release</literal> per indicar que es tracta d'una nova versió de les fonts originals.

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>.
ca: Descriu abreujadament els canvis realitzats <emphasis>en les fonts originals per l'autor</emphasis> que solucionen errors informats i tanca els informes d'aquests errors afegint <literal>Closes: #<replaceable>número_del_informe_error</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>.
ca: Descriu abreujadament els canvis realitzats <emphasis>a les fonts originals</emphasis> pel desenvolupador (tu mateix en aquest cas) per solucionar els errors informats i tanca els informes afegint <literal>Closes: #<replaceable>número_del_informe_error</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>.
ca: Executa <literal>while dquilt push; do dquilt refresh; done</literal> per aplicar els pegats eliminat <emphasis>les coses innecessàries</emphasis>.

note: type: Content of: <book><chapter><section><para>
en: If the patch/merge did not apply cleanly, inspect the situation (clues are left in <filename>.rej</filename> files).
ca: Si les modificacions no s'executen correctament, inspecciona la situació (mira la informació dels fitxers <filename>.rej</filename>) com segueix:

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,
ca: Si un dels pegats aplicats està integrat en les fonts originals:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt delete</literal> to remove it.
ca: executa <literal>dquilt delete</literal> per eliminar-lo.

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,
ca: Si un dels pegats entra en conflicte amb els canvis realitzats per l'autor en les fonts originals:

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>.
ca: executa <literal>dquilt push -f</literal> per aplicar els pegats de la versió anterior per forçar els rebuigs (tendràs la informació dels rebuigs en els fitxers <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>.
ca: Edita els fitxers <filename><replaceable>truc</replaceable>.rej</filename> manualment per saber l'efecte que es pretén amb <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.
ca: Executa <literal>dquilt refresh</literal> per actualitzar el pegat.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Continue as usual with <literal>while dquilt push; do dquilt refresh; done</literal>.
ca: Continua fins a l'execució de <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:
ca: Pots automatitzar aquest procés fent servir l'ordre <citerefentry> <refentrytitle>uupdate</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> com segueix:

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
ca: $ apt-get source <replaceable>nom_del_paquet</replaceable>
    ...
    dpkg-source: info: extracting <replaceable>nom_del_paquet</replaceable> in <replaceable>nom_del_paquet</replaceable>-<replaceable>número_versió_anterior</replaceable>
    dpkg-source: info: unpacking <replaceable>nom_del_paquet</replaceable>_<replaceable>número_versió_anterior</replaceable>.orig.tar.gz
    dpkg-source: info: applying <replaceable>nom_del_paquet</replaceable>_<replaceable>número_versió_anterior</replaceable>-1.debian.tar.gz
    $ ls -F
    <replaceable>nom_del_paquet</replaceable>-<replaceable>número_versió_anterior</replaceable>/
    <replaceable>nom_del_paquet</replaceable>_<replaceable>número_versió_anterior</replaceable>-1.debian.tar.gz
    <replaceable>nom_del_paquet</replaceable>_<replaceable>número_versió_anterior</replaceable>-1.dsc
    <replaceable>nom_del_paquet</replaceable>_<replaceable>número_versió_anterior</replaceable>.orig.tar.gz
    $ wget http://example.org/<replaceable>nom_del_paquet</replaceable>/<replaceable>nom_del_paquet</replaceable>-<replaceable>número_versió_actual</replaceable>.tar.gz
    $ cd <replaceable>nom_del_paquet</replaceable>-<replaceable>número_versió_anterior</replaceable>
    $ uupdate -v <replaceable>número_versió_actual</replaceable> ../<replaceable>nom_del_paquet</replaceable>-<replaceable>número_versió_actual</replaceable>.tar.gz
    $ cd ../<replaceable>nom_del_paquet</replaceable>-<replaceable>número_versió_actual</replaceable>
    $ while dquilt push; do dquilt refresh; done
    $ dch
    ... documenta les modificacions realitzades

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.
ca: Si l'ordre <command>uscan</command> descarrega les fonts però no executa l'ordre <command>uupdate</command>, cal modificar l'arxiu <filename>debian/watch</filename> afegint <literal>debian uupdate</literal> al final de l'URL del fitxer.

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"/>
ca: Si has configurat el fitxer <filename>debian/watch</filename> com s'ha explicat a <xref linkend="watch"/>, no és necessari que executis l'ordre <command>wget</command>.  Simplement, executa <citerefentry> <refentrytitle>uscan</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> en el directori <filename><replaceable>nom_del_paquet</replaceable>-<replaceable>número_versió_anterior</replaceable></filename> en lloc de l'ordre <command>uupdate</command>.  Així, es buscarà <emphasis>automàticament</emphasis> el fitxer de les fonts, es descarregarà en el teu ordinador i s'executarà l'ordre <command>uupdate</command> <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><para>
en: You can release this updated source by repeating what you did in <xref linkend="completebuild"/>, <xref linkend="checkit"/>, and <xref linkend="upload"/>.
ca: Pots fer el llançament de l'actualització del paquet repetint el que s'ha explicat en <xref linkend="completebuild"/>, <xref linkend="checkit"/> <xref linkend="upload"/>.

note: type: Content of: <book><chapter><section><title>
en: Updating the packaging style
ca: Actualitzar el format del paquet.

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.
ca: Si la persona que patrocina el teu paquet o altres desenvolupadors fan objeccions a l'actualització del format del paquet, no val la pena entossudir-se a argumentar a favor.  Hi ha altres coses més importants que atendre.

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"/>
ca: Per actualitzar un paquet no és necessari actualitzar el format de construcció del paquet.  Encara així, pots aprofitar tota la funcionalitat de <systemitem role="package">debhelper</systemitem> i del format <literal>3.0</literal> fent el següent <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.
ca: Si necessites novament algun dels fitxers de plantilla eliminats, pots regenerar-los executant <command>dh_make</command> amb l'opció <literal>--addmissing</literal> des del directori de les fonts.  A continuació, fes les modificacions ja explicades.

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.
ca: Si el paquet no està actualitzat per fer servir la nova sintaxi <command>dh</command> de la versió 7+ de <systemitem role="package">debhelper</systemitem> en el fitxer <filename>debian/rules</filename>, fes-ne l'actualització per fer servir <command>dh</command>.  També hauràs d'actualitzar <filename>debian/control</filename>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If you want to update the <filename>rules</filename> file created with the <filename>Makefile</filename> inclusion mechanism of the Common Debian Build System (<systemitem role="package">cdbs</systemitem>) to the <command>dh</command> syntax, see the following to understand its <literal>DEB_*</literal> configuration variables.
ca: Si actualitzes el fitxer <filename>rules</filename> construït pel mecanisme d'inclusió <filename>Makefile</filename> del sistema de compilació Debian (<systemitem role="package">cdbs</systemitem>) a la nova sintaxi <command>dh</command>, llegeix els següents documentes per entendre les variables de configuració <literal>DEB_*</literal>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: local copy of <filename>&cdbs-doc;</filename>
ca: còpia local de <filename>&cdbs-doc;</filename>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If you have a <literal>1.0</literal> source package without the <filename><replaceable>foo</replaceable>.diff.gz</filename> file, you can update it to the newer <literal>3.0 (native)</literal> source format by creating <filename>debian/source/format</filename> with <literal>3.0 (native)</literal>.  The rest of the <filename>debian/*</filename> files can just be copied.
ca: Si treballes amb un paquet construït amb el format <literal>1.0</literal> sense l'arxiu <filename><replaceable>nom_del_paquet</replaceable>.diff.gz</filename>, pots actualitzar-lo a la nova versió <literal>3.0 (native)</literal> afegint el fitxer <filename>debian/source/format</filename> amb la línia <literal>3.0 (native)</literal>.  Copia els altres fitxers del directori <filename>debian/*</filename>.

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.
ca: Pots fragmentar el fitxer <filename>nom_del_paquet.diff</filename> en diversos fitxers de pegats fent servir l'ordre <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"/>
ca: Si treballes amb un paquet construït amb el format <literal>1.0</literal> amb el fitxer <filename><replaceable>nom_del_paquet</replaceable>.diff.gz</filename>, pots actualitzar-lo al nou format <literal>3.0 (native)</literal> afegint el fitxer <filename>debian/source/format</filename> amb la línia <literal>3.0 (native)</literal>.  Copia els altres fitxers del directori <filename>debian/*</filename>.  Importa el fitxer <filename>nom_del_paquet.diff</filename> generat amb l'ordre <literal>filterdiff -z -x '*/debian/*' <replaceable>nom_del_paquet</replaceable>.diff.gz &gt; nom_del_paquet.diff</literal> al sistema <command>quilt</command> <placeholder type="footnote" id="0"/>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If it was packaged using another patch system such as <systemitem role="package">dpatch</systemitem>, <systemitem role="package">dbs</systemitem>, or <systemitem role="package">cdbs</systemitem> with <literal>-p0</literal>, <literal>-p1</literal>, or <literal>-p2</literal>, convert it to <systemitem role="package">quilt</systemitem> using <filename>deb3</filename> at <ulink url="&deb3;"/>.
ca: Si el paquet s'ha construït amb un altre sistema de pegats com <systemitem role="package">dpatch</systemitem>, <systemitem role="package">dbs</systemitem> o <systemitem role="package">cdbs</systemitem>, fent servir les opcions <literal>-p0</literal>, <literal>-p1</literal> o <literal>-p2</literal>, pots convertir-ho al format <systemitem role="package">quilt</systemitem> fent servir el guió <filename>deb3</filename> at <ulink url="&deb3;"/>.

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If it was packaged with the <command>dh</command> command with the <literal>--with quilt</literal> option or with the <command>dh_quilt_patch</command> and <command>dh_quilt_unpatch</command> commands, remove these and make it use the newer <literal>3.0 (quilt)</literal> source format.
ca: Si el paquet s'ha construït executant l'ordre <command>dh</command> amb l'opció <literal>--with quilt</literal> o amb <command>dh_quilt_patch</command> i <command>dh_quilt_unpatch</command>, elimina tot això i fes servir el nou format font <literal>3.0 (quilt)</literal>.

note: type: Content of: <book><chapter><section><para>
en: You should check <ulink url="&dep;">DEP - Debian Enhancement Proposals</ulink> and adopt ACCEPTED proposals.
ca: Has de consultar <ulink url="&dep;">DEP - Debian Enhancement Proposals</ulink> i adoptar les propostes ACCEPTADES.

note: type: Content of: <book><chapter><section><para>
en: You need to do the other tasks described in <xref linkend="newupstream"/>, too.
ca: Repassa la secció <xref linkend="newupstream"/> per si has de repetir alguns dels passos indicats en aquesta secció

note: type: Content of: <book><chapter><section><title>
en: UTF-8 conversion
ca: Conversió a 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.
ca: Si el documents originals fan servir una codificació antiga, actualitzar-los a la codificació <ulink url="&utf8;">UTF-8</ulink> és una bona idea.

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.
ca: Fes servir <citerefentry> <refentrytitle>iconv</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> per convertir codificacions de fitxers de text sense format.

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>
ca: iconv -f latin1 -t utf8 <replaceable>fitxer_original.txt</replaceable> &gt; <replaceable>fitxer_convertit.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.
ca: Fes servir <citerefentry> <refentrytitle>w3m</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> per convertir fitxers HTML a fitxers sense format en codificació UTF-8. Quan ho facis, assegura't que la configuració local fa servir 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>
ca: LC_ALL=en_US.UTF-8 w3m -o display_charset=UTF-8 \
            -cols 70 -dump -no-graph -T text/html \
            &lt; <replaceable>fitxer_original.html</replaceable> &gt; <replaceable>fitxer_convertit.txt</replaceable>

note: type: Content of: <book><chapter><section><title>
en: Reminders for updating packages
ca: Recordatori per actualitzar 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>.)
ca: Conserva les entrades anteriors del fitxer <filename>changelog</filename> (sona a obvietat, però s'han donat casos d'executar <literal>dch</literal> en lloc 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.
ca: Reconsidera els canvis en la construcció del paquet Debian: elimina les modificacions anteriors (sigui el que sigui) i recorda't d'afegir tot el necessari, sempre que no hi hagi una bona raó per no fer-ho.

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.
ca: Si s'ha realitzat alguna modificació en la compilació (ho veuràs quan inspeccionis els canvis en les fonts originals) pot ser necessari actualitzar el fitxer <filename>debian/rules</filename> i les dependències de compilació en el fitxer <filename>debian/control</filename>.

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.
ca: Comprova si hi ha alguna comunicació de pegats del paquet en el sistema de gestió d'errors (algun usuari pot haver construït i enviat un pegat que puguis fer servir) en <ulink url="&bts;">Debian Bug Tracking System (BTS)</ulink>.

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.
ca: Comprova el contingut del fitxer <filename>.changes</filename> per assegurar-te que envies el paquet a la distribució correcta, que els informes d'errors que es tanquen amb la nova versió estan llistats en el camp <literal>Closes</literal>, que el contingut dels camps <literal>Maintainer</literal> i <literal>Changed-By</literal> són correctes, que has signat el fitxer amb la teva clau GPG, etc.

note: type: Content of: <book><chapter><title>
en: Uploading the package
ca: Enviar el 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.
ca: Ara que has comprovat el teu paquet en profunditat, pots publicar-ho a un arxiu públic per compartir-ho.

note: type: Content of: <book><chapter><section><title>
en: Uploading to the Debian archive
ca: Enviar el paquet al repositori de Debian.

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <xref linkend="socialdynamics"/>.
ca: Consulta <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.
ca: Hi ha arxius d'accés públic, com ara <ulink url="&mentors-dn;"/> que funcionen gairebé de la mateixa manera com arxiu de Debian i proporcionen un àrea de càrrega a les persones que no són DD. Pots construir un arxiu equivalent tu mateix fent servir les eines que figuren a <ulink url="&deb-archive;"/>. Així, aquesta secció també és útil per a les persones que no són 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.
ca: És possible que el paquet <systemitem role="package">dput</systemitem> ofereixi més funcionalitats i sigui més popular que <systemitem role="package">dupload</systemitem>.  Fes servir l'arxiu <filename>/etc/dput</filename> per a la configuració global i el fitxer <filename>~/.dput.cf</filename> per a la configuració pròpia de l'usuari.  També incorpora l'assistència per a 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"/>
ca: Quan siguis desenvolupador oficial Debian <placeholder type="footnote" id="0"/>, podràs carregar el paquet al repositori de Debian <placeholder type="footnote" id="1"/>.  Pots fer això manualment, però és més fàcil fer-ho amb les eines automàtiques ja disponibles com <citerefentry> <refentrytitle>dupload</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> o <citerefentry> <refentrytitle>dput</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.  A continuació descriurem com fer-ho amb <command>dupload</command> <placeholder type="footnote" id="0"/>.

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.
ca: Per començar, caldrà ajustar la configuració de <command>dupload</command>. Pots fer-ho editant el fitxer general <filename>/etc/dupload.conf</filename>, o construint el teu arxiu personalitzat <filename>~/.dupload.conf</filename> amb els paràmetres que vulguis canviar.

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.
ca: Consulta el manual de <citerefentry> <refentrytitle>dupload.conf</refentrytitle> <manvolnum>5</manvolnum> </citerefentry> per conèixer el significat de cada opció.

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"/>
ca: L'opció <literal>$default_host</literal> determina quina de les cues de càrrega es farà servir per defecte. <literal>anonymous-ftp-master</literal> és la primera però és possible que vulguis fer servir una altra més ràpida <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:
ca: Si tens connexió a Internet, pots pujar el paquet executant:

note: type: Content of: <book><chapter><section><screen>
en: $ dupload gentoo_0.9.12-1_i386.changes
ca:   dupload gentoo_0.9.12-1_i386.changes

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.
ca: <command>dupload</command> comprova que les sumes MD5/SHA1/SHA256 dels fitxers transferits coincideixen amb els llistats en el fitxer <filename>.changes</filename>, en cas contrari t'avisarà i hauràs de reconstruir el paquet com s'explica a <xref linkend="completebuild"/> per poder enviar-ho correctament.

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.
ca: Consulta <ulink url="&uploadqueue-readme;"/>. També pots fer servir l'ordre <command>dcut</command> del 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>:
ca: Si trobes algun problema amb la pujada del paquet a <ulink url="&uploadqueue;"/>, pots solucionar-ho pujant «manualment» (fent servir <command>ftp</command>) un arxiu <filename>*.commands</filename> signat amb GPG <placeholder type="footnote" id="0"/>. Per exemple, aquest <filename>hello.commands</filename>:

note: type: Content of: <book><chapter><section><title>
en: Including <filename>orig.tar.gz</filename> for upload
ca: Incloure el fitxer <filename>orig.tar.gz</filename> per a la transferència del paquet al repositori.

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>.
ca: A l'hora d'enviar per primera vegada el paquet al repositori, cal incloure l'arxiu <filename>orig.tar.gz</filename> amb les fonts originals. Si el número de revisió Debian del paquet no és <literal>1</literal> ni <literal>0</literal>, hauràs d'executar l'ordre <command>dpkg-buildpackage</command> amb l'opció <literal>-sa</literal> per forçar la inclusió de l'arxiu <filename>orig.tar.gz</filename>. Contrariament, amb l'opció <literal>-sd</literal> s'exclou l'arxiu <filename>orig.tar.gz</filename> de les fonts.

note: type: Content of: <book><chapter><section><para>
en: For the <command>dpkg-buildpackage</command> command:
ca: Per a l'ordre <command>dpkg-buildpackage</command>:

note: type: Content of: <book><chapter><section><para>
en: For the <command>debuild</command> command:
ca: Per a l'ordre <command>debuild</command>:

note: type: Content of: <book><chapter><section><para>
en: For the <command>pdebuild</command> command:
ca: Per a l'ordre <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.
ca: Per altra banda, amb l'opció <literal>-sd</literal> s'evita l'inclusió de l'arxiu <filename>orig.tar.gz</filename> de les fonts originals.

note: type: Content of: <book><chapter><section><title>
en: Skipped uploads
ca: Enviaments discontinuats.

note: type: Content of: <book><appendix><title>
en: Advanced packaging
ca: Tècniques avançades

note: type: Content of: <book><appendix><para>
en: You may need to manually edit the packaging template files generated by the <command>dh_make</command> command to address topics covered in this chapter.  The newer <command>debmake</command> command should address these topics better.
ca: Pot ésser necessari editar manualment els fitxers de plantilla per a la construcció del paquet generats per l'ordre <command>dh_make</command> per seguir els detalls tractats en aquest capítol. La nova ordre <command>debmake</command> gestiona millor aquestes etapes de la construcció de paquets.

note: type: Content of: <book><appendix><section><title>
en: Shared libraries
ca: Biblioteques compartides.

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:
ca: Abans de construir paquets de <ulink url="&library;">biblioteques</ulink> compartides, has de llegir les següents referències bàsicques en detall:

note: type: Content of: <book><appendix><section><para>
en: Here are some oversimplified hints for you to get started:
ca: Heus aquí alguns consells simplistes per a que pugis començar.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Shared libraries are <ulink url="&elf;">ELF</ulink> object files containing compiled code.
ca: Les biblioteques compartides son fitxers objecte en format <ulink url="&elf;">ELF</ulink> que contenen codi compilat.

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)
ca: Les biblioteques compartides es distribueixen com a fitxers <filename>*.so</filename> (ni fitxers <filename>*.a</filename> ni <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.
ca: Les biblioteques compartides s'utilitzen principalment per compartir codi comú entre diversos executables fent servir l'ordre <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.
ca: Les biblioteques compartides, a vegades es fan servir per proporcionar complements («plugins») a un executable mitjançant el procediment <command>dlopen</command>.

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>
ca: Alternativament: <literal>readelf -d lib<replaceable>nom_biblioteca</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"/>
ca: El <ulink url="&soname;">SONAME</ulink> (el nom lògic) de la biblioteca compartida <filename>lib<replaceable>nom_biblioteca</replaceable>.so</filename>.<replaceable>1</replaceable>: <literal>objdump -p lib<replaceable>nom_biblioteca</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).
ca: El «SONAME» (nom lògic) d'una biblioteca compartida en general coincideix amb el nom del fitxer de la biblioteca (però no sempre).

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para><footnote><para>
en: Alternatively: <literal>readelf -d lib<replaceable>foo</replaceable>.so.<replaceable>1</replaceable> | grep NEEDED</literal>
ca: Alternativament: <literal>readelf -d lib<replaceable>nom_biblioteca</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"/>
ca: El «SONAME» (nom lògic) de les biblioteques compartides enllaçades a <filename><replaceable>/usr/bin/foo</replaceable></filename>: <literal>objdump -p <replaceable>/usr/bin/foo</replaceable> | grep NEEDED</literal> <placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para><footnote><para>
en: See <ulink url="&policy-runtime;">Debian Policy Manual, 8.1 "Run-time shared libraries"</ulink>.
ca: Consulta <ulink url="&policy-runtime;">Debian Policy Manual, 8.1 "Run-time shared libraries"</ulink>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <systemitem role="package">lib<replaceable>foo</replaceable><replaceable>1</replaceable></systemitem>: the library package for the shared library <filename>lib<replaceable>foo</replaceable>.so.<replaceable>1</replaceable></filename> with the SONAME ABI version <replaceable>1</replaceable>.<placeholder type="footnote" id="0"/>
ca: <systemitem role="package">lib<replaceable>nom_biblioteca</replaceable><replaceable>1</replaceable></systemitem>: el paquet de biblioteca de la biblioteca compartida <filename>lib<replaceable>nom_biblioteca</replaceable>.so.<replaceable>1</replaceable></filename> amb la versió ABI del nom lògic («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>.
ca: Consulta <ulink url="&policy-ldconfig;">Debian Policy Manual, 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"/>
ca: Els guions del desenvolupador del paquet de la biblioteca han d'executar <command>ldconfig</command> en les circumstàncies específiques per generar els enllaços simbòlics necessaris per a «SONAME» (nom lògic).<placeholder type="footnote" id="0"/>

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>.
ca: Consulta <ulink url="&policy-static;">Debian Policy Manual, 8.3 "Static libraries"</ulink> i <ulink url="&policy-dev;">Debian Policy Manual, 8.4 "Development files"</ulink>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para><footnote><para>
en: See <ulink url="&removela;">Debian wiki ReleaseGoals/LAFileRemoval</ulink>.
ca: Consulta <ulink url="&removela;">Debian wiki ReleaseGoals/LAFileRemoval</ulink>.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para><footnote><para>
en: See <ulink url="&rpathissues;">Debian wiki RpathIssue</ulink>.
ca: Consulta <ulink url="&rpathissues;">Debian wiki RpathIssue</ulink>.

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.
ca: Encara que és una mica antiquat i és només una referència secundària, <ulink url="&debianlibrarypackagingguide;">Debian Library Packaging Guide</ulink> encara pot ésser útil.

note: type: Content of: <book><appendix><section><title>
en: Managing <filename>debian/<replaceable>package</replaceable>.symbols</filename>
ca: Gestionant <filename>debian/<replaceable>nom_del_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.
ca: Els canvis ABI incompatibles amb versions anteriors, normalment requereixen l'actualització del «SONAME» (nom lògic) de la biblioteca i del paquet de la biblioteca compartida a d'altres nous.

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.
ca: Per a biblioteques C++ i altres casos pels quals el maneig individual de símbols és difícil, es millor guiar-se per <ulink url="&policy-library-shlibs;">Debian Policy Manual, 8.6.4 "The shlibs system"</ulink>.

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.
ca: Prepara l'estructura de directoris Debian de les fonts fent servir el fitxer original de l'autor <filename>libnom_biblioteca-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.
ca: Si és la primera vegada que es construeix un paquet de <systemitem role="package">libnom_biblioteca1</systemitem>, genera el fitxer <filename>debian/libnom_biblioteca1.symbols</filename> amb el contingut buit.

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.
ca: Si la versió <literal>1.2</literal> anterior de l'autor es va empaquetar en el paquet <systemitem role="package">libnom_biblioteca1</systemitem> amb el fitxer <filename>debian/libnom_biblioteca1.symbols</filename> apropiat en el seu paquet font, fes-lo servir una altra vegada.

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>
ca: Totes les versions anteriors dels paquets Debian estan disponibles a <ulink url="&snapshot;">http://snapshot.debian.org/</ulink>. La revisió Debian del paquet segueix a la versió per facilitar el manteniment de versions anteriors («backport») del paquet: <literal>1.1</literal> &lt;&lt; <literal>1.1-1~bpo70+1</literal> &lt;&lt; <literal>1.1-1</literal> i <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><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>
ca: La revisió Debian es deriva de la versió per facilitar el manteniment de versions anteriors («backport») del paquet: <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: Build release packages with tools such as <command>debuild</command> and <command>pdebuild</command>.
ca: Construir paquets per distribuir amb eines com <command>debuild</command> i <command>pdebuild</command>.

note: type: Content of: <book><appendix><section><para><footnote><para>
en: See <ulink url="&policy-library-abi;">Debian Policy Manual, 8.6.2 "Shared library ABI changes"</ulink>.
ca: Consulta <ulink url="&policy-library-abi;">Debian Policy Manual, 8.6.2 "Shared library ABI changes"</ulink>.

note: type: Content of: <book><appendix><section><para>
en: In addition to the above examples, we need to check the ABI compatibility further and bump versions for some symbols manually as needed.  <placeholder type="footnote" id="0"/>
ca: A més a més dels exemples anteriors, cal comprovar la compatibilitat ABI amb més atenció i actualitzar manualment les versions dels símbols (si és necessari). <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.
ca: Encara que només és una referència secundària, <ulink url="&usingsymbolsfiles;">Debian wiki UsingSymbolsFiles</ulink> i els seus enllaços a altres pàgines web pot ésser d'utilitat.

note: type: Content of: <book><appendix><section><title>
en: Multiarch
ca: Multi-arquitectura

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:
ca: La nova funció multi-arquitectura introduïda a la versió «wheezy» de Debian integra el suport per a la instal·lació en més d'una arquitectura dels paquets binaris (particularment a <literal>i386</literal>&lt;-&gt;<literal>amd64</literal>, però també amb altres combinacions) en <systemitem role="package">dpkg</systemitem> i <systemitem role="package">apt</systemitem>. És convenient que llegeixis les següents referències detalladament:

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <ulink url="&multiarchspec;">Ubuntu wiki MultiarchSpec</ulink> (upstream)
ca: <ulink url="&multiarchspec;">Ubuntu wiki MultiarchSpec</ulink> (original)

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <ulink url="&multiarchimplementation;">Debian wiki Multiarch/Implementation</ulink> (Debian situation)
ca: <ulink url="&multiarchimplementation;">Debian wiki Multiarch/Implementation</ulink> (estat a Debian)

note: type: Content of: <book><appendix><section><para>
en: It uses the triplet such as <literal>i386-linux-gnu</literal> and <literal>x86_64-linux-gnu</literal> for the install path of shared libraries. The actual triplet path is dynamically set into the <literal>$(DEB_HOST_MULTIARCH)</literal> variable using the <citerefentry> <refentrytitle>dpkg-architecture</refentrytitle><manvolnum>1</manvolnum></citerefentry> command for each binary package build. For example, the path to install multiarch libraries are changed as follows:<placeholder type="footnote" id="0"/>
ca: S'utilitzen triplets com <literal>i386-linux-gnu</literal> i <literal>x86_64-linux-gnu</literal> per als directoris d'instal·lació de les biblioteques compartides. El triplet actual s'estableix de forma dinàmica al valor <literal>$(DEB_HOST_MULTIARCH)</literal> per <citerefentry> <refentrytitle>dpkg-architecture</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> a cada compilació. Per exemple, el directori d'instal·lació de les biblioteques multi-arquitectura es pot canviar de la següent manera.<placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><informaltable><tgroup><thead><row><entry>
en: Old path
ca: Directori antic

note: type: Content of: <book><appendix><section><informaltable><tgroup><thead><row><entry>
en: i386 multiarch path
ca: directori multi-arquitectura i386

note: type: Content of: <book><appendix><section><informaltable><tgroup><thead><row><entry>
en: amd64 multiarch path
ca: directori multi-arquitectura amd64

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: a library source <filename>lib<replaceable>foo</replaceable>-1.tar.gz</filename>
ca: el codi font de la biblioteca <filename>lib<replaceable>nom_biblioteca</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
ca: el codi font d'una ordre <filename><replaceable>bar</replaceable>-1.tar.gz</filename> escrit en un llenguatge compilat

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
ca: el codi font d'una ordre <filename><replaceable>baz</replaceable>-1.tar.gz</filename> escrit en un llenguatge interpretat

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

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

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

note: type: Content of: <book><appendix><section><informaltable><tgroup><thead><row><entry>
en: Package content
ca: Contingut del 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>
ca: <systemitem role="package">lib<replaceable>nom_del_paquet</replaceable><replaceable>1</replaceable></systemitem>

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the shared library, co-installable
ca: la biblioteca compartida, és co-instal·lable

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>
ca: <systemitem role="package">lib<replaceable>nom_del_paquet</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
ca: els símbols de depuració de la biblioteca compartida, són co-instal·lables

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

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the shared library header files etc., co-installable
ca: els fitxers de capçalera i d'altres d'un biblioteca compilada, co-instal·lable

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

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the run-time support programs, not co-installable
ca: els programes de suport en temps d'execució, no són co-instal·lables

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

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the shared library documentation files
ca: els fitxers de documentació de la biblioteca compartida

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the compiled program files, not co-installable
ca: els fitxers del programa compilat, no són co-instal·lables

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the documentation files for the program
ca: els fitxers de documentació del programa

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the interpreted program files
ca: els fitxers del programa interpretat

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>
ca: Cal tenir en compte que el paquet de desenvolupament ha de tenir un enllaç simbòlic a la biblioteca compartida associada <emphasis role="strong">sense el número de versió</emphasis>. P. ex.: <filename>/usr/lib/x86_64-linux-gnu/libfoo.so</filename> -&gt; <filename>libfoo.so.1</filename>

note: type: Content of: <book><appendix><section><title>
en: Building a shared library package
ca: Construint un paquet de biblioteca compartit

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Update <filename>debian/control</filename>.
ca: Actualitza <filename>debian/control</filename>.

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.
ca: Afegeix <literal>Pre-Depends: ${misc:Pre-Depends}</literal> per a cada paquet binari de biblioteca compartida.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Add <literal>Multi-Arch:</literal> stanza for each binary package section.
ca: Afegeix el camp <literal>Multi-Arch:</literal> per a cada secció de paquet binari.

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.
ca: Canvia el directori habitual <literal>/usr/lib/</literal> al directori multi-arquitectura <literal>/usr/lib/$(DEB_HOST_MULTIARCH)/</literal> per a tots els guions de la construcció del paquet.

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>.
ca: Canvia <literal>/usr/lib/</literal> per <literal>/usr/lib/$(DEB_HOST_MULTIARCH)/</literal> a <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>.
ca: Alternativament, pots afegir els arguments <literal>--libdir=\$${prefix}/lib/$(DEB_HOST_MULTIARCH)</literal> and <literal>--libexecdir=\$${prefix}/lib/$(DEB_HOST_MULTIARCH)</literal> a <literal>./configure</literal>. Fitxa't que <literal>--libexecdir</literal> especifica el directori predeterminat per instal·lar programes executables que són engegats per altres programes més que no pas pels usuaris. El valor predeterminat per «Autotools» és <filename>/usr/libexec/</filename> però a Debian és <filename>/usr/lib/</filename>.

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.
ca: Canvia cada repetició de <literal>/usr/lib/</literal> per <literal>/usr/lib/*/</literal> als fitxers <filename>debian/<replaceable>nom_del_paquet</replaceable>.install</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
ca: override_dh_auto_configure:
            dh_auto_configure
            sed 's/@DEB_HOST_MULTIARCH@/$(DEB_HOST_MULTIARCH)/g' \
                    debian/<replaceable>nom_del_paquet</replaceable>.links.in > debian/<replaceable>nom_del_paquet</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.
ca: Comprova que el paquet de biblioteca compartida conté només els fitxers que s'esperava i que el paquet «-dev» continua funcionant correctament.

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

note: type: Content of: <book><appendix><section><para>
en: If a package is maintained only for Debian or possibly only for local use, its source may contain all the <filename>debian/*</filename> files in it.  There are 2 ways to package it.
ca: Si el paquet es construeix només per a Debian o fins i tot només per fer-ho servir en local, les seves fonts poden incloure tots els fitxers de <filename>debian/*</filename>. Hi ha dos mètodes per construir el paquet.

note: type: Content of: <book><appendix><section><para>
en: The alternative is the workflow of the native Debian package.
ca: L'alternativa és seguir el model de treball pels paquets nadius Debian.

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.
ca: Genera un paquet nadiu de fonts Debian en el format <literal>3.0 (native)</literal> fent servir un únic arxiu comprimit en format «tar» afegint tots els arxius.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><literal>
en: <replaceable>package</replaceable>_<replaceable>version</replaceable>.tar.gz
ca: <replaceable>nom_del_paquet</replaceable>_<replaceable>versió</replaceable>.tar.gz

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><literal>
en: <replaceable>package</replaceable>_<replaceable>version</replaceable>.dsc
ca: <replaceable>nom_del_paquet</replaceable>_<replaceable>versió</replaceable>.dsc

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Build Debian binary packages from the native Debian source package.
ca: Construcció de paquets binaris Debian des de paquets de fonts Debian nadius.

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><literal>
en: <replaceable>package</replaceable>_<replaceable>version</replaceable>_<replaceable>arch</replaceable>.deb
ca: <replaceable>nom_del_paquet</replaceable>_<replaceable>versió</replaceable>_<replaceable>arquitectura</replaceable>.deb

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

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:
ca: Després d'executar l'ordre <command>dpkg-buildpackage</command>, veuràs els següents fitxers en el directori superior:

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <filename>mypackage_1.0.tar.gz</filename>
ca: <filename>el_meu_paquet_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>.)
ca: Aquest és el «tarball» del codi font generat a partir del directori <filename>el_meu_paquet-1.0</filename> per l'ordre <command>dpkg-source</command> (el seu sufix no és <filename>orig.tar.gz</filename>).

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <filename>mypackage_1.0.dsc</filename>
ca: <filename>el_meu_paquet_1.0.dsc</filename>

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

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <filename>mypackage_1.0_i386.changes</filename>
ca: <filename>el_meu_paquet_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.)
ca: Aquest arxiu descriu els canvis realitzats en la versió actual del paquet de la mateixa forma que en els paquets Debian no nadius (no hi ha el codi de revisió Debian).
