msgstr ""
"Project-Id-Version: best-pkging-practices\n"
"Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2009-01-23 09:48+0100\n"
+"POT-Creation-Date: 2009-06-25 22:00+0300\n"
"PO-Revision-Date: 2009-06-01 14:35+0200\n"
"Last-Translator: Christian Perrier <bubulle@debian.org>\n"
"Language-Team: French <debian-l10n-french@lists.debian.org>\n"
"X-Generator: KBabel 1.11.4\n"
# type: Content of: <chapter><title>
+#. type: Content of: <chapter><title>
#: best-pkging-practices.dbk:7
msgid "Best Packaging Practices"
msgstr "Les meilleurs pratiques pour la construction des paquets"
# type: Content of: <chapter><para>
+#. type: Content of: <chapter><para>
#: best-pkging-practices.dbk:9
msgid ""
"Debian's quality is largely due to the <ulink url=\"&url-debian-policy;"
"paquets d'excellente qualité."
# type: Content of: <chapter><para>
+#. type: Content of: <chapter><para>
#: best-pkging-practices.dbk:18
msgid ""
"This chapter provides some best practices for Debian developers. All "
"d'y choisir ce qui vous convient le mieux."
# type: Content of: <chapter><section><title>
+#. type: Content of: <chapter><section><title>
#: best-pkging-practices.dbk:24
msgid "Best practices for <filename>debian/rules</filename>"
msgstr ""
"Les meilleures pratiques pour le fichier <filename>debian/rules</filename>"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: best-pkging-practices.dbk:26
msgid ""
"The following recommendations apply to the <filename>debian/rules</filename> "
"s'occupent généralement le plus."
# type: Content of: <chapter><section><section><title>
+#. type: Content of: <chapter><section><section><title>
#: best-pkging-practices.dbk:32
msgid "Helper scripts"
msgstr "Scripts d'assistance"
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:34
msgid ""
"The rationale for using helper scripts in <filename>debian/rules</filename> "
"répertoire des menus venait à changer, chaque paquet devrait être modifié."
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:45
msgid ""
"Helper scripts take care of these issues. Assuming you comply with the "
"plus qu'à être reconstruits sans autre modification."
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:52
msgid ""
"<xref linkend=\"tools\"/> contains a couple of different helpers. The most "
"<filename>debian/rules</filename>."
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:66
msgid ""
"You can get started with <systemitem role=\"package\">debhelper</systemitem> "
"besoins et son comportement."
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:79
msgid ""
"Some people feel that vanilla <filename>debian/rules</filename> files are "
"ulink>."
# type: Content of: <chapter><section><section><title>
+#. type: Content of: <chapter><section><section><title>
#: best-pkging-practices.dbk:88
msgid "Separating your patches into multiple files"
msgstr "Séparation des modifications (« patches ») en plusieurs fichiers"
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:90
msgid ""
"Big, complex packages may have many bugs that you need to deal with. If you "
"correctifs appliqués par le mainteneur amont."
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:99
+#, fuzzy
msgid ""
"Unfortunately, the packaging system as such currently doesn't provide for "
"separating the patches into several files. Nevertheless, there are ways to "
"(<filename>.diff.gz</filename>), usually within the <filename>debian/</"
"filename> directory. The only difference is that they aren't applied "
"immediately by dpkg-source, but by the <literal>build</literal> rule of "
-"<filename>debian/rules</filename>. Conversely, they are reverted in the "
-"<literal>clean</literal> rule."
+"<filename>debian/rules</filename>, through a dependency on the "
+"<literal>patch</literal> rule. Conversely, they are reverted in the "
+"<literal>clean</literal> rule, through a dependency on the <literal>unpatch</"
+"literal> rule."
msgstr ""
"Malheureusement, le système de gestion des paquets ne permet pas "
"actuellement, tel quel, de séparer les correctif en plusieurs fichiers. "
"par la règle <literal>clean</literal>."
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:109
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:113
+#, fuzzy
msgid ""
-"<command>dbs</command> is one of the more popular approaches to this. It "
-"does all of the above, and provides a facility for creating new and updating "
-"old patches. See the package <systemitem role=\"package\">dbs</systemitem> "
-"for more information and <systemitem role=\"package\">hello-dbs</systemitem> "
-"for an example."
+"<command>quilt</command> is the recommended tool for this. It does all of "
+"the above, and also allows to manage patch series. See the <systemitem role="
+"\"package\">quilt</systemitem> package for more information."
msgstr ""
"<command>dbs</command> est une des méthodes populaires pour ce besoin. Il "
"effectue l'ensemble des actiosn mentionnées précédemment et offre la "
"pour plus d'informations et <systemitem role=\"package\">hello-dbs</"
"systemitem> pour un exemple d'utilisation."
-# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:116
+#
. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:119
msgid ""
-"<command>dpatch</command> also provides these facilities, but it's intended "
-"to be even easier to use. See the package <systemitem role=\"package"
-"\">dpatch</systemitem> for documentation and examples (in <filename>/usr/"
-"share/doc/dpatch</filename>)."
+"There are other tools to manage patches, like <command>dpatch</command>, and "
+"the patch system integrated with <systemitem role=\"package\">cdbs</"
+"systemitem>."
msgstr ""
-"<command>dpatch</command> a également le même objectif mais se veut être "
-"plus simple à utiliser. Veuillez cosulter la documentation du paquet "
-"<systemitem role=\"package\">dpatch</systemitem> ainsi que les exemples "
-"fournis (dans <filename>/usr/share/doc/dpatch</filename>)."
# type: Content of: <chapter><section><section><title>
-#: best-pkging-practices.dbk:124
+#. type: Content of: <chapter><section><section><title>
+#: best-pkging-practices.dbk:126
msgid "Multiple binary packages"
msgstr "Paquets binaires multiples"
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:126
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:128
msgid ""
"A single source package will often build several binary packages, either to "
"provide several flavors of the same software (e.g., the <systemitem role="
"nécessaires et donc préserver l'espace disque)."
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:133
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:135
msgid ""
"The second case can be easily managed in <filename>debian/rules</filename>. "
"You just need to move the appropriate files from the build directory into "
"paquets appropriées dans <filename>debian/control</filename>."
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:142
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:144
msgid ""
"The first case is a bit more difficult since it involves multiple recompiles "
"of the same software but with different configuration options. The "
"<filename>debian/rules</filename> géré manuellement."
# type: Content of: <chapter><section><title>
-#: best-pkging-practices.dbk:154
+#. type: Content of: <chapter><section><title>
+#: best-pkging-practices.dbk:156
msgid "Best practices for <filename>debian/control</filename>"
msgstr "Meilleures pratiques pour <filename>debian/control</filename>"
# type: Content of: <chapter><section><para>
-#: best-pkging-practices.dbk:156
+#. type: Content of: <chapter><section><para>
+#: best-pkging-practices.dbk:158
msgid ""
"The following practices are relevant to the <filename>debian/control</"
"filename> file. They supplement the <ulink url=\"&url-debian-policy;ch-"
"descriptions de paquets."
# type: Content of: <chapter><section><para>
-#: best-pkging-practices.dbk:162
+#. type: Content of: <chapter><section><para>
+#: best-pkging-practices.dbk:164
msgid ""
"The description of the package, as defined by the corresponding field in the "
"<filename>control</filename> file, contains both the package synopsis and "
"pkg-desc\"/> donne des indications pour la description."
# type: Content of: <chapter><section><section><title>
-#: best-pkging-practices.dbk:171
+#. type: Content of: <chapter><section><section><title>
+#: best-pkging-practices.dbk:173
msgid "General guidelines for package descriptions"
msgstr "Conseils généraux pour les descriptions de paquets"
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:173
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:175
msgid ""
"The package description should be written for the average likely user, the "
"average person who will use and benefit from the package. For instance, "
"accessible à tout utilisateur."
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:180
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:182
msgid ""
"Our review of package descriptions lead us to conclude that most package "
"descriptions are technical, that is, are not written to make sense for non-"
"spécialistes, cela doit être considéré comme un problème."
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:186
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:188
msgid ""
"How do you write for non-technical users? Avoid jargon. Avoid referring to "
"other applications or frameworks that the user might not be familiar with — "
"être expliqués."
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:193
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:195
msgid ""
"Be objective. Package descriptions are not the place for advocating your "
"package, no matter how much you love it. Remember that the reader may not "
"lecteur peut très bien ne pas avoir les mêmes centres d'intérêt que vous."
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:198
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:200
msgid ""
"References to the names of any other software packages, protocol names, "
"standards, or specifications should use their canonical forms, if one "
"« postscript »."
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:205
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:207
msgid ""
"If you are having problems writing your description, you may wish to send it "
"along to &email-debian-l10n-english; and request feedback."
"english;."
# type: Content of: <chapter><section><section><title>
-#: best-pkging-practices.dbk:211
+#. type: Content of: <chapter><section><section><title>
+#: best-pkging-practices.dbk:213
msgid "The package synopsis, or short description"
msgstr "Le résumé, ou description courte, d'un paquet"
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:213
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:215
+#, fuzzy
msgid ""
-"The synopsis line (the short description) should be concise. It must not "
-"repeat the package's name (this is policy)."
+"Policy says the synopsis line (the short description) must be concise, not "
+"repeating the package name, but also informative."
msgstr ""
"La ligne de résumé (la description courte) doit être concise. Elle ne doit "
"pas répéter le nom du paquet (cela est imposé par la Charte)."
-# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:217
+#
. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:219
msgid ""
-"It's a good idea to think of the synopsis as an appositive clause, not a "
-"full sentence. An appositive clause is defined in WordNet as a grammatical "
-"relation between a word and a noun phrase that follows, e.g., Rudolph the "
-"red-nosed reindeer. The appositive clause here is red-nosed reindeer. "
-"Since the synopsis is a clause, rather than a full sentence, we recommend "
-"that it neither start with a capital nor end with a full stop (period). It "
-"should also not begin with an article, either definite (the) or indefinite "
-"(a or an)."
+"The synopsis functions as a phrase describing the package, not a complete "
+"sentence, so sentential punctuation is inappropriate: it does not need extra "
+"capital letters or a final period (full stop). It should also omit any "
+"initial indefinite or definite article - \"a\", \"an\", or \"the\". Thus for "
+"instance:"
msgstr ""
-"Il est conseillé de voir le résumé comme un « clause appositive » (NdT : il "
-"s'agit d'un terme syntaxique en anglais) et pas comme une phrase complète. "
-"Une clause appositive est définie par WordNet comme la relation grammaticale "
-"entre un nom et une phrase nomilae qui le suit. Par exemple, « Rudolph the "
-"red-nosed reindeer ». La clause appositive ici est « red-nosed reindeer ». "
-"Comme le résumé est une telle clause et non une phrase, il ne doit donc pas "
-"commencer par une majuscule ni se terminer par un point. Il ne doit "
-"également pas commencer par un article défini (« the ») ou indéfini (« a » ou "
-"« an »)."
-# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:226
+#. type: Content of: <chapter><section><section><screen>
+#: best-pkging-practices.dbk:225
+#, no-wrap
msgid ""
-"It might help to imagine that the synopsis is combined with the package name "
-"in the following way:"
+"Package: libeg0\n"
+"Description: exemplification support library\n"
msgstr ""
-"Un moyen commode est d'imaginer que le résumé est combiné avec le nom du "
-"paquet de la façon suivante (NdT : certaines parties volontairement non "
-"traduites car ces exemples s'appliquent à la langue anglaise) :"
-# type: Content of: <chapter><section><section><screen>
+#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:229
-#, no-wrap
msgid ""
-"\n"
-"<replaceable>package-name</replaceable> is a <replaceable>synopsis</replaceable>.\n"
+"Technically this is a noun phrase minus articles, as opposed to a verb "
+"phrase. A good heuristic is that it should be possible to substitute the "
+"package name and synopsis into this formula:"
msgstr ""
-"\n"
-"<replaceable>nom-du-paquet</replaceable> is a <replaceable>résumé</replaceable>.\n"
-
-# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:233
-msgid "Alternatively, it might make sense to think of it as"
-msgstr "Il est également possible de visualiser l'ensemble sous la forme"
# type: Content of: <chapter><section><section><screen>
-#: best-pkging-practices.dbk:235
-#, no-wrap
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:234
+#, fuzzy
msgid ""
-"\n"
-"<replaceable>package-name</replaceable> is <replaceable>synopsis</replaceable>.\n"
+"The package <replaceable>name</replaceable> provides {a,an,the,some} "
+"<replaceable>synopsis</replaceable>."
msgstr ""
"\n"
-"<replaceable>nom-du-paquet</replaceable> is <replaceable>résumé</replaceable>.\n"
+"<replaceable>nom-du-paquet</replaceable> is a <replaceable>résumé</"
+"replaceable>.\n"
-# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:239
-msgid "or, if the package name itself is a plural (such as developers-tools)"
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:238
+msgid ""
+"Sets of related packages may use an alternative scheme that divides the "
+"synopsis into two parts, the first a description of the whole suite and the "
+"second a summary of the package's role within it:"
msgstr ""
-"ou, si le nom du paquet est lui-même une forme plurielle (par exemple "
-"developers-tools)"
-# type: Content of: <chapter><section><section><screen>
-#: best-pkging-practices.dbk:241
+#. type: Content of: <chapter><section><section><screen>
+#: best-pkging-practices.dbk:243
#, no-wrap
msgid ""
-"\n"
-"<replaceable>package-name</replaceable> are <replaceable>synopsis</replaceable>.\n"
+"Package: eg-tools\n"
+"Description: simple exemplification system (utilities)\n"
+"\t\t\t \n"
+"Package: eg-doc\n"
+"Description: simple exemplification system - documentation\n"
msgstr ""
-"\n"
-"<replaceable>nom du paquet</replaceable> are <replaceable>résumé</replaceable>.\n"
-# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:245
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:250
+msgid ""
+"These synopses follow a modified formula. Where a package "
+"\"<replaceable>name</replaceable>\" has a synopsis \"<replaceable>suite</"
+"replaceable> (<replaceable>role</replaceable>)\" or \"<replaceable>suite</"
+"replaceable> - <replaceable>role</replaceable>\", the elements should be "
+"phrased so that they fit into the formula:"
+msgstr ""
+
+# type: Content of: <chapter><section><section><screen>
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:257
+#, fuzzy
msgid ""
-"This way of forming a sentence from the package name and synopsis should be "
-"considered as a heuristic and not a strict rule. There are some cases where "
-"it doesn't make sense to try to form a sentence."
+"The package <replaceable>name</replaceable> provides {a,an,the} "
+"<replaceable>role</replaceable> for the <replaceable>suite</replaceable>."
msgstr ""
-"Cette méthode permettant de créer une phrase à partir du nom du paquet et de "
-"sa description courte doit être considérée comme une heuristique et non une "
-"règle stricte. Dans certains cas, former une phrase n'aura aucun sens."
+"\n"
+"<replaceable>nom du paquet</replaceable> are <replaceable>résumé</"
+"replaceable>.\n"
# type: Content of: <chapter><section><section><title>
-#: best-pkging-practices.dbk:252
+#. type: Content of: <chapter><section><section><title>
+#: best-pkging-practices.dbk:263
msgid "The long description"
msgstr "La description longue"
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:254
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:265
msgid ""
"The long description is the primary information available to the user about "
"a package before they install it. It should provide all the information "
"précédemment."
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:260
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:271
msgid "The long description should consist of full and complete sentences."
msgstr "La description longue est constituée de phrases complètes."
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:263
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:274
msgid ""
"The first paragraph of the long description should answer the following "
"questions: what does the package do? what task does it help the user "
"paquet est par définition technique."
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:269
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:280
msgid ""
"The following paragraphs should answer the following questions: Why do I as "
"a user need this package? What other features does the package have? What "
"le client destiné au serveur toto ») ?"
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:277
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:288
msgid ""
"Be careful to avoid spelling and grammar mistakes. Ensure that you spell-"
"check it. Both <command>ispell</command> and <command>aspell</command> have "
"de contrôler un fichier <filename>debian/control</filename> files :"
# type: Content of: <chapter><section><section><screen>
-#: best-pkging-practices.dbk:281
-#, no-wrap
-msgid ""
-"\n"
-"ispell -d american -g debian/control\n"
+#. type: Content of: <chapter><section><section><screen>
+#: best-pkging-practices.dbk:293
+#, fuzzy, no-wrap
+msgid "ispell -d american -g debian/control\n"
msgstr ""
"\n"
"ispell -d american -g debian/control\n"
# type: Content of: <chapter><section><section><screen>
-#: best-pkging-practices.dbk:284
-#, no-wrap
-msgid ""
-"\n"
-"aspell -d en -D -c debian/control\n"
+#. type: Content of: <chapter><section><section><screen>
+#: best-pkging-practices.dbk:296
+#, fuzzy, no-wrap
+msgid "aspell -d en -D -c debian/control\n"
msgstr ""
"\n"
"aspell -d en -D -c debian/control\n"
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:288
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:299
msgid ""
"Users usually expect these questions to be answered in the package "
"description:"
"aux questions suivantes :"
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: best-pkging-practices.dbk:293
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: best-pkging-practices.dbk:304
msgid ""
"What does the package do? If it is an add-on to another package, then the "
"short description of the package we are an add-on to should be put in here."
"description de cet autre paquet doit y être reprise."
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: best-pkging-practices.dbk:299
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: best-pkging-practices.dbk:310
msgid ""
"Why should I want this package? This is related to the above, but not the "
"same (this is a mail user agent; this is cool, fast, interfaces with PGP and "
"et les fonctionnalités X, Y ou Z."
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: best-pkging-practices.dbk:306
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: best-pkging-practices.dbk:317
msgid ""
"If this package should not be installed directly, but is pulled in by "
"another package, this should be mentioned."
"paquet, cela devrait être mentionné."
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: best-pkging-practices.dbk:312
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: best-pkging-practices.dbk:323
msgid ""
"If the package is <literal>experimental</literal>, or there are other "
"reasons it should not be used, if there are other packages that should be "
"place, cela doit également être mentionné."
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: best-pkging-practices.dbk:319
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: best-pkging-practices.dbk:330
msgid ""
"How is this package different from the competition? Is it a better "
"implementation? more features? different features? Why should I choose this "
"différentes ? Pourquoi devrais-je choisir ce paquet ?"
# type: Content of: <chapter><section><section><title>
-#: best-pkging-practices.dbk:332
+#. type: Content of: <chapter><section><section><title>
+#: best-pkging-practices.dbk:343
msgid "Upstream home page"
msgstr "Page d'accueil amont"
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:334
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:345
msgid ""
"We recommend that you add the URL for the package's home page in the "
"<literal>Homepage</literal> field of the <literal>Source</literal> section "
"comme obsolète."
# type: Content of: <chapter><section><section><title>
-#: best-pkging-practices.dbk:342
+#. type: Content of: <chapter><section><section><title>
+#: best-pkging-practices.dbk:353
msgid "Version Control System location"
msgstr "Emplacement du système de gestion de versions"
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:344
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:355
msgid ""
"There are additional fields for the location of the Version Control System "
"in <filename>debian/control</filename>."
"gestion de versions dans <filename>debian/control</filename>."
# type: Content of: <chapter><section><section><section><title>
-#: best-pkging-practices.dbk:348
+#. type: Content of: <chapter><section><section><section><title>
+#: best-pkging-practices.dbk:359
msgid "Vcs-Browser"
msgstr "Vcs-Browser"
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:350
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:361
msgid ""
"Value of this field should be a <literal>http://</literal> URL pointing to a "
"web-browsable copy of the Version Control System repository used to maintain "
"pour la maintenance du paquet, s'il est disponible."
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:355
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:366
msgid ""
"The information is meant to be useful for the final user, willing to browse "
"the latest work done on the package (e.g. when looking for the patch fixing "
"des bogues."
# type: Content of: <chapter><section><section><section><title>
-#: best-pkging-practices.dbk:362
+#. type: Content of: <chapter><section><section><section><title>
+#: best-pkging-practices.dbk:373
msgid "Vcs-*"
msgstr "Vcs-*"
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:364
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:375
msgid ""
"Value of this field should be a string identifying unequivocally the "
"location of the Version Control System repository used to maintain the given "
"paquets."
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:375
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:386
msgid ""
"The information is meant to be useful for a user knowledgeable in the given "
"Version Control System and willing to build the current version of a package "
"adresse d'accès snonyme au dépôt, plutôt qu'une version accessible par SSH."
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:386
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:397
msgid ""
"In the following example, an instance of the field for a Subversion "
"repository of the <systemitem role=\"package\">vim</systemitem> package is "
"literal>, décrits précédemments, est aussi indiquée."
# type: Content of: <chapter><section><section><section><screen>
-#: best-pkging-practices.dbk:394
-#, no-wrap
+#. type: Content of: <chapter><section><section><section><screen>
+#: best-pkging-practices.dbk:406
+#, fuzzy, no-wrap
msgid ""
-"\n"
" Source: vim\n"
" Section: editors\n"
" Priority: optional\n"
" Homepage: http://www.vim.org\n"
# type: Content of: <chapter><section><title>
-#: best-pkging-practices.dbk:410
+#. type: Content of: <chapter><section><title>
+#: best-pkging-practices.dbk:421
msgid "Best practices for <filename>debian/changelog</filename>"
msgstr "Meilleures pratiques pour <filename>debian/changelog</filename>"
# type: Content of: <chapter><section><para>
-#: best-pkging-practices.dbk:412
+#. type: Content of: <chapter><section><para>
+#: best-pkging-practices.dbk:423
msgid ""
"The following practices supplement the <ulink url=\"&url-debian-policy;ch-"
"docs.html#s-changelogs\">Policy on changelog files</ulink>."
"fichiers de journaux de changements (« changelog »)</ulink>."
# type: Content of: <chapter><section><section><title>
-#: best-pkging-practices.dbk:417
+#. type: Content of: <chapter><section><section><title>
+#: best-pkging-practices.dbk:428
msgid "Writing useful changelog entries"
msgstr "Écrire des entrées de journalisation utiles"
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:419
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:430
msgid ""
"The changelog entry for a package revision documents changes in that "
"revision, and only them. Concentrate on describing significant and user-"
"utilisateurs, réalisées depuis la version précédente."
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:424
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:435
msgid ""
"Focus on <emphasis>what</emphasis> was changed — who, how and when are "
"usually less important. Having said that, remember to politely attribute "
"ont envoyé des correctifs)."
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:430
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:441
msgid ""
"There's no need to elaborate the trivial and obvious changes. You can also "
"aggregate several changes in one entry. On the other hand, don't be overly "
"<filename>README.Debian</filename>. "
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:437
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:448
msgid ""
"Use common English so that the majority of readers can comprehend it. Avoid "
"abbreviations, tech-speak and jargon when explaining changes that close "
"à prohiber."
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:443
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:454
msgid ""
"It is sometimes desirable to prefix changelog entries with the names of the "
"files that were changed. However, there's no need to explicitly list each "
"simple ou répétitive. L'utilisation de caractères joker est possible."
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:449
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:460
msgid ""
"When referring to bugs, don't assume anything. Say what the problem was, "
"how it was fixed, and append the closes: #nnnnn string. See <xref linkend="
"pour plus d'informations."
# type: Content of: <chapter><section><section><title>
-#: best-pkging-practices.dbk:456
+#. type: Content of: <chapter><section><section><title>
+#: best-pkging-practices.dbk:467
msgid "Common misconceptions about changelog entries"
msgstr "Erreur communes pour les entrées de journaux de modifications"
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:458
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:469
msgid ""
"The changelog entries should <emphasis role=\"strong\">not</emphasis> "
"document generic packaging issues (Hey, if you're looking for foo.conf, it's "
"fichier de configuration."
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:466
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:477
msgid ""
"The only bugs closed with a changelog entry should be those that are "
"actually fixed in the same package revision. Closing unrelated bugs in the "
"\"upload-bugfix\"/> ."
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:471
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:482
msgid ""
"The changelog entries should <emphasis role=\"strong\">not</emphasis> be "
"used for random discussion with bug reporters (I don't see segfaults when "
"gestion des bogues."
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:482
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:493
msgid ""
"It is an old tradition to acknowledge bugs fixed in non-maintainer uploads "
"in the first changelog entry of the proper maintainer upload. As we have "
"propre entrée de journal des modifications."
# type: Content of: <chapter><section><section><title>
-#: best-pkging-practices.dbk:490
+#. type: Content of: <chapter><section><section><title>
+#: best-pkging-practices.dbk:501
msgid "Common errors in changelog entries"
msgstr "Erreurs usuelles dans les entrées du journal des modifications"
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:492
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:503
msgid ""
"The following examples demonstrate some common errors or examples of bad "
"style in changelog entries."
"texte est volontairement laissé non traduit)."
# type: Content of: <chapter><section><section><screen>
-#: best-pkging-practices.dbk:495
-#, no-wrap
-msgid ""
-"\n"
-" * Fixed all outstanding bugs.\n"
+#. type: Content of: <chapter><section><section><screen>
+#: best-pkging-practices.dbk:507
+#, fuzzy, no-wrap
+msgid " * Fixed all outstanding bugs.\n"
msgstr ""
"\n"
" * Fixed all outstanding bugs.\n"
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:499
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:510
msgid "This doesn't tell readers anything too useful, obviously."
msgstr "Cela ne donne évidemment aucune indication au lecteur."
# type: Content of: <chapter><section><section><screen>
-#: best-pkging-practices.dbk:501
-#, no-wrap
-msgid ""
-"\n"
-" * Applied patch from Jane Random.\n"
+#. type: Content of: <chapter><section><section><screen>
+#: best-pkging-practices.dbk:513
+#, fuzzy, no-wrap
+msgid " * Applied patch from Jane Random.\n"
msgstr ""
"\n"
" * Applied patch from Jane Random.\n"
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:505
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:516
msgid "What was the patch about?"
msgstr "Que faisait ce correctif ?"
# type: Content of: <chapter><section><section><screen>
-#: best-pkging-practices.dbk:507
-#, no-wrap
-msgid ""
-"\n"
-" * Late night install target overhaul.\n"
+#. type: Content of: <chapter><section><section><screen>
+#: best-pkging-practices.dbk:519
+#, fuzzy, no-wrap
+msgid " * Late night install target overhaul.\n"
msgstr ""
"\n"
" * Late night install target overhaul.\n"
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:511
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:522
msgid ""
"Overhaul which accomplished what? Is the mention of late night supposed to "
"remind us that we shouldn't trust that code?"
"code ?"
# type: Content of: <chapter><section><section><screen>
-#: best-pkging-practices.dbk:514
-#, no-wrap
-msgid ""
-"\n"
-" * Fix vsync FU w/ ancient CRTs.\n"
+#. type: Content of: <chapter><section><section><screen>
+#: best-pkging-practices.dbk:526
+#, fuzzy, no-wrap
+msgid " * Fix vsync FU w/ ancient CRTs.\n"
msgstr ""
"\n"
" * Fix vsync FU w/ ancient CRTs.\n"
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:518
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:529
msgid ""
"Too many acronyms, and it's not overly clear what the, uh, fsckup (oops, a "
"curse word!) was actually about, or how it was fixed."
"vulgarité à l'incompréhensibilité) ou comment il a été corrigé."
# type: Content of: <chapter><section><section><screen>
-#: best-pkging-practices.dbk:521
-#, no-wrap
-msgid ""
-"\n"
-" * This is not a bug, closes: #nnnnnn.\n"
+#. type: Content of: <chapter><section><section><screen>
+#: best-pkging-practices.dbk:533
+#, fuzzy, no-wrap
+msgid " * This is not a bug, closes: #nnnnnn.\n"
msgstr ""
"\n"
" * This is not a bug, closes: #nnnnnn.\n"
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:525
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:536
msgid ""
"First of all, there's absolutely no need to upload the package to convey "
"this information; instead, use the bug tracking system. Secondly, there's "
"que le problème n'est pas un bogue."
# type: Content of: <chapter><section><section><screen>
-#: best-pkging-practices.dbk:529
-#, no-wrap
-msgid ""
-"\n"
-" * Has been fixed for ages, but I forgot to close; closes: #54321.\n"
+#. type: Content of: <chapter><section><section><screen>
+#: best-pkging-practices.dbk:541
+#, fuzzy, no-wrap
+msgid " * Has been fixed for ages, but I forgot to close; closes: #54321.\n"
msgstr ""
"\n"
" * Has been fixed for ages, but I forgot to close; closes: #54321.\n"
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:533
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:544
msgid ""
"If for some reason you didn't mention the bug number in a previous changelog "
"entry, there's no problem, just close the bug normally in the BTS. There's "
"depuis longtemps)."
# type: Content of: <chapter><section><section><screen>
-#: best-pkging-practices.dbk:539
-#, no-wrap
-msgid ""
-"\n"
-" * Closes: #12345, #12346, #15432\n"
+#. type: Content of: <chapter><section><section><screen>
+#: best-pkging-practices.dbk:551
+#, fuzzy, no-wrap
+msgid " * Closes: #12345, #12346, #15432\n"
msgstr ""
"\n"
" * Closes: #12345, #12346, #15432\n"
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:543
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:554
msgid ""
"Where's the description? If you can't think of a descriptive message, start "
"by inserting the title of each different bug."
"explicite, vous pouvez au moins utiliser le titre du rapport de bogue."
# type: Content of: <chapter><section><section><title>
-#: best-pkging-practices.dbk:549
+#. type: Content of: <chapter><section><section><title>
+#: best-pkging-practices.dbk:560
msgid "Supplementing changelogs with NEWS.Debian files"
msgstr "Compléter les journaux de modifications avec des fichiers NEWS.Debian"
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:551
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:562
msgid ""
"Important news about changes in a package can also be put in <filename> NEWS."
"Debian</filename> files. The news will be displayed by tools like apt-"
"fichiers <filename> NEWS.Debian</filename> ne peuvent être traduits)."
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:562
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:573
msgid ""
"The file format is the same as a debian changelog file, but leave off the "
"asterisks and describe each news item with a full paragraph when necessary "
"fichier <filename>NEWS.Debian </filename> réel :"
# type: Content of: <chapter><section><section><screen>
-#: best-pkging-practices.dbk:570
-#, no-wrap
+#. type: Content of: <chapter><section><section><screen>
+#: best-pkging-practices.dbk:582
+#, fuzzy, no-wrap
msgid ""
-"\n"
"cron (3.0pl1-74) unstable; urgency=low\n"
"\n"
" The checksecurity script is no longer included with the cron package:\n"
" -- Steve Greenland <stevegr@debian.org> Sat, 6 Sep 2003 17:15:03 -0500\n"
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:581
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:592
msgid ""
"The <filename>NEWS.Debian</filename> file is installed as <filename> /usr/"
"share/doc/<replaceable>package</replaceable>/NEWS.Debian.gz</filename>. It "
"<filename>debian/NEWS</filename> automatiquement."
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:588
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:599
msgid ""
"Unlike changelog files, you need not update <filename>NEWS.Debian</filename> "
"files with every release. Only update them if you have something "
"Debian</filename> avec le paquet. Pas de nouvelles, bonnes nouvelles !"
# type: Content of: <chapter><section><title>
-#: best-pkging-practices.dbk:610
+#. type: Content of: <chapter><section><title>
+#: best-pkging-practices.dbk:621
msgid "Best practices for maintainer scripts"
msgstr "Meilleures pratiques pour les scripts du responsable"
# type: Content of: <chapter><section><para>
-#: best-pkging-practices.dbk:612
+#. type: Content of: <chapter><section><para>
+#: best-pkging-practices.dbk:623
msgid ""
"Maintainer scripts include the files <filename>debian/postinst</filename>, "
"<filename>debian/preinst</filename>, <filename>debian/prerm</filename> and "
"complètent celles de la charte Debian."
# type: Content of: <chapter><section><para>
-#: best-pkging-practices.dbk:620
+#. type: Content of: <chapter><section><para>
+#: best-pkging-practices.dbk:631
msgid ""
"Maintainer scripts must be idempotent. That means that you need to make "
"sure nothing bad will happen if the script is called twice where it would "
"deux fois au lieu d'une."
# type: Content of: <chapter><section><para>
-#: best-pkging-practices.dbk:625
+#. type: Content of: <chapter><section><para>
+#: best-pkging-practices.dbk:636
msgid ""
"Standard input and output may be redirected (e.g. into pipes) for logging "
"purposes, so don't rely on them being a tty."
"soient pas dépendants d'un terminal."
# type: Content of: <chapter><section><para>
-#: best-pkging-practices.dbk:629
+#. type: Content of: <chapter><section><para>
+#: best-pkging-practices.dbk:640
msgid ""
"All prompting or interactive configuration should be kept to a minimum. "
"When it is necessary, you should use the <systemitem role=\"package"
"literal> du script <filename>postinst</filename>."
# type: Content of: <chapter><section><para>
-#: best-pkging-practices.dbk:636
+#. type: Content of: <chapter><section><para>
+#: best-pkging-practices.dbk:647
msgid ""
"Keep the maintainer scripts as simple as possible. We suggest you use pure "
"POSIX shell scripts. Remember, if you do need any bash features, the "
"peut alors y ajouter des fonctions."
# type: Content of: <chapter><section><para>
-#: best-pkging-practices.dbk:643
+#. type: Content of: <chapter><section><para>
+#: best-pkging-practices.dbk:654
msgid ""
"If you change your maintainer scripts, be sure to test package removal, "
"double installation, and purging. Be sure that a purged package is "
"responsable."
# type: Content of: <chapter><section><para>
-#: best-pkging-practices.dbk:649
+#. type: Content of: <chapter><section><para>
+#: best-pkging-practices.dbk:660
msgid ""
"If you need to check for the existence of a command, you should use "
"something like"
"utiliser quelque chose comme"
# type: Content of: <chapter><section><programlisting>
-#: best-pkging-practices.dbk:652
+#. type: Content of: <chapter><section><programlisting>
+#: best-pkging-practices.dbk:663
#, no-wrap
msgid "if [ -x /usr/sbin/install-docs ]; then ..."
msgstr "if [ -x /usr/sbin/install-docs ]; then ..."
# type: Content of: <chapter><section><para>
-#: best-pkging-practices.dbk:654
+#. type: Content of: <chapter><section><para>
+#: best-pkging-practices.dbk:665
msgid ""
"If you don't wish to hard-code the path of a command in your maintainer "
"script, the following POSIX-compliant shell function may help:"
"de responsable, la fonction shell conforme à POSIX suivante peut vous aider :"
# type: Content of: <chapter><section><para>
-#: best-pkging-practices.dbk:659
+#. type: Content of: <chapter><section><para>
+#: best-pkging-practices.dbk:670
msgid ""
"You can use this function to search <literal>$PATH</literal> for a command "
"name, passed as an argument. It returns true (zero) if the command was "
"POSIX."
# type: Content of: <chapter><section><para>
-#: best-pkging-practices.dbk:666
+#. type: Content of: <chapter><section><para>
+#: best-pkging-practices.dbk:677
msgid ""
"While <command>which</command> is an acceptable alternative, since it is "
"from the required <systemitem role=\"package\">debianutils</systemitem> "
"cependant."
# type: Content of: <chapter><section><title>
-#: best-pkging-practices.dbk:676
+#. type: Content of: <chapter><section><title>
+#: best-pkging-practices.dbk:687
msgid ""
"Configuration management with <systemitem role=\"package\">debconf</"
"systemitem>"
"systemitem>"
# type: Content of: <chapter><section><para>
-#: best-pkging-practices.dbk:678
+#. type: Content of: <chapter><section><para>
+#: best-pkging-practices.dbk:689
msgid ""
"<systemitem role=\"package\">Debconf</systemitem> is a configuration "
"management system which can be used by all the various packaging scripts "
"installations non interactives."
# type: Content of: <chapter><section><para>
-#: best-pkging-practices.dbk:686
+#. type: Content of: <chapter><section><para>
+#: best-pkging-practices.dbk:697
msgid ""
"Debconf is a great tool but it is often poorly used. Many common mistakes "
"are listed in the <citerefentry> <refentrytitle>debconf-devel</"
"document."
# type: Content of: <chapter><section><para>
-#: best-pkging-practices.dbk:693
+#. type: Content of: <chapter><section><para>
+#: best-pkging-practices.dbk:704
msgid ""
"These guidelines include some writing style and typography recommendations, "
"general considerations about debconf usage as well as more specific "
"distribution (le système d'installation notamment)."
# type: Content of: <chapter><section><section><title>
-#: best-pkging-practices.dbk:699
+#. type: Content of: <chapter><section><section><title>
+#: best-pkging-practices.dbk:710
msgid "Do not abuse debconf"
msgstr "N'abusez pas de <systemitem role=\"package\">debconf</systemitem>"
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:701
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:712
msgid ""
"Since debconf appeared in Debian, it has been widely abused and several "
"criticisms received by the Debian distribution come from debconf abuse with "
"outil installé."
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:707
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:718
msgid ""
"Keep usage notes to what they belong: the NEWS.Debian, or README.Debian "
"file. Only use notes for important notes which may directly affect the "
"peuvent conduire à des envois de courriers électroniques aux utilisateurs."
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:713
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:724
msgid ""
"Carefully choose the questions priorities in maintainer scripts. See "
"<citerefentry> <refentrytitle>debconf-devel</refentrytitle> <manvolnum>7</"
"questions devraient utiliser les priorités « intermédiaire » ou « basse »."
# type: Content of: <chapter><section><section><title>
-#: best-pkging-practices.dbk:721
+#. type: Content of: <chapter><section><section><title>
+#: best-pkging-practices.dbk:732
msgid "General recommendations for authors and translators"
msgstr "Recommandations générales pour les auteurs et les traducteurs"
# type: Content of: <chapter><section><section><section><title>
-#: best-pkging-practices.dbk:723
+#. type: Content of: <chapter><section><section><section><title>
+#: best-pkging-practices.dbk:734
msgid "Write correct English"
msgstr "Écrivez en anglais correct"
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:725
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:736
msgid ""
"Most Debian package maintainers are not native English speakers. So, "
"writing properly phrased templates may not be easy for them."
"correctement."
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:729
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:740
msgid ""
"Please use (and abuse) &email-debian-l10n-english; mailing list. Have your "
"templates proofread."
"relire vos écrans."
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:733
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:744
msgid ""
"Badly written templates give a poor image of your package, of your work...or "
"even of Debian itself."
"votre travail ou même de Debian en général."
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:737
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:748
msgid ""
"Avoid technical jargon as much as possible. If some terms sound common to "
"you, they may be impossible to understand for others. If you cannot avoid "
"Dans ce cas, tentez de faire la part des choses entre simplicité et verbiage."
# type: Content of: <chapter><section><section><section><title>
-#: best-pkging-practices.dbk:745
+#. type: Content of: <chapter><section><section><section><title>
+#: best-pkging-practices.dbk:756
msgid "Be kind to translators"
msgstr "Pensez aux traducteurs"
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:747
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:758
msgid ""
"Debconf templates may be translated. Debconf, along with its sister package "
"<command>po-debconf</command> offers a simple framework for getting "
"traductions ou des traducteurs isolés."
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:752
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:763
msgid ""
"Please use gettext-based templates. Install <systemitem role=\"package\">po-"
"debconf</systemitem> on your development system and read its documentation "
"est un bon début)."
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:757
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:768
#, fuzzy
msgid ""
"Avoid changing templates too often. Changing templates text induces more "
"fichiers PO."
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:765
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:776
#, fuzzy
msgid ""
"If you plan to do changes to your original templates, please use the "
"fichiers PO."
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:777
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:788
msgid "A recommended use of that utility is:"
msgstr ""
# type: Content of: <chapter><section><section><section><programlisting>
-#: best-pkging-practices.dbk:779
+#. type: Content of: <chapter><section><section><section><programlisting>
+#: best-pkging-practices.dbk:790
#, no-wrap
msgid "cd debian/po && podebconf-report-po --languageteam --withtranslators --call --deadline=\"+10 days\""
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:781
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:792
msgid ""
"This command will first synchronize the PO and POT files in debian/po with "
"the templates files listed in <filename>debian/po/POTFILES.in</filename>. "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:790
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:801
msgid ""
"Giving a deadline to translators is always appreciated, so that they can "
"organize their work. Please remember that some translation teams have a "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:797
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:808
msgid ""
"If in doubt, you may also contact the translation team for a given language "
"(debian-l10n-xxxxx@&lists-host;), or the &email-debian-i18n; mailing list."
"&email-debian-i18n;."
# type: Content of: <chapter><section><section><section><title>
-#: best-pkging-practices.dbk:804
+#. type: Content of: <chapter><section><section><section><title>
+#: best-pkging-practices.dbk:815
msgid "Unfuzzy complete translations when correcting typos and spelling"
msgstr ""
"Correction (« unfuzzy ») des traductions complètes lors des corrections de "
"fautes de frappe ou d'orthographe"
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:806
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:817
#, fuzzy
msgid ""
"When the text of a debconf template is corrected and you are <emphasis role="
"traducteurs et rendez leur translations à nouveau complètes (« unfuzzy »)."
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:812
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:823
msgid ""
"If you don't do so, the whole template will not be translated as long as a "
"translator will send you an update."
"tant qu'un traducteur n'aura pas réenvoyé un fichier corrigé."
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:816
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:827
msgid ""
"To <emphasis>unfuzzy</emphasis> translations, you can use two methods. The "
"first method does <emphasis>preventive</emphasis> search and replace actions "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:822
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:833
msgid "<emphasis>Preventive unfuzzy</emphasis> method:"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:827
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
+#: best-pkging-practices.dbk:838
#, fuzzy
msgid ""
"Try finding a complete translation file <emphasis role=\"strong\"> before</"
"\">jamais</emphasis> comporter de question."
# type: Content of: <chapter><section><section><section><orderedlist><listitem><programlisting>
-#: best-pkging-practices.dbk:830 best-pkging-practices.dbk:900
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><programlisting>
+#: best-pkging-practices.dbk:841 best-pkging-practices.dbk:911
#, no-wrap
msgid ""
"for i in debian/po/*po; do echo -n $i: ; msgfmt -o /dev/null\n"
"--statistics $i; done"
# type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
-#: best-pkging-practices.dbk:833
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
+#: best-pkging-practices.dbk:844
msgid ""
"The file only showing <emphasis>translated</emphasis> items will be used as "
"the reference file. If there is none (which should not happen if you take "
msgstr ""
# type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
-#: best-pkging-practices.dbk:841
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
+#: best-pkging-practices.dbk:852
msgid ""
"Identify the needed change. In this example, let's assume the change is "
"about fixing a typo in the word <literal>typo</literal> which was "
msgstr ""
# type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
-#: best-pkging-practices.dbk:849
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
+#: best-pkging-practices.dbk:860
msgid ""
"Check that this change is only applied to the place where you really intend "
"to make it and <emphasis role=\"strong\">not</emphasis> in any other place "
msgstr ""
# type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
-#: best-pkging-practices.dbk:857
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
+#: best-pkging-practices.dbk:868
msgid ""
"Modify all PO files by using <command>sed</command>. The use of that command "
"is recommended over any text editor to guarantee that the files encoding "
"will not be broken by the edit action."
msgstr ""
-# type: Content of: <chapter><section><section><section><orderedlist><listitem><programlisting>
-#: best-pkging-practices.dbk:861
+#
. type: Content of: <chapter><section><section><section><orderedlist><listitem><programlisting>
+#: best-pkging-practices.dbk:873
#, no-wrap
msgid ""
-"\n"
"cd debian/po\n"
"for i in *.po; do sed -i 's/tpyo/typo/g' $i; done\n"
msgstr ""
# type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
-#: best-pkging-practices.dbk:868
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
+#: best-pkging-practices.dbk:879
msgid "Change the debconf template file to fix the typo."
msgstr ""
# type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
-#: best-pkging-practices.dbk:873
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
+#: best-pkging-practices.dbk:884
#, fuzzy
msgid "Run <command>debconf-updatepo</command>"
msgstr "exécutez la commande <command>debconf-updatepo</command> à nouveau"
# type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
-#: best-pkging-practices.dbk:878
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
+#: best-pkging-practices.dbk:889
msgid ""
"Check the <filename>foo.po</filename> reference file. Its statistics should "
"not be changed:"
msgstr ""
-# type: Content of: <chapter><section><section><section><orderedlist><listitem><programlisting>
-#: best-pkging-practices.dbk:881
+#
. type: Content of: <chapter><section><section><section><orderedlist><listitem><programlisting>
+#: best-pkging-practices.dbk:893
#, no-wrap
-msgid ""
-"\n"
-"msgfmt -o /dev/null --statistics debian/po/foo.po\n"
+msgid "msgfmt -o /dev/null --statistics debian/po/foo.po\n"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:891
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:902
msgid "Gettext utilities method:"
msgstr ""
# type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
-#: best-pkging-practices.dbk:896
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
+#: best-pkging-practices.dbk:907
msgid ""
"Put all incomplete PO files out of the way. You can check the completeness "
"by using (needs the <systemitem role=\"package\">gettext</systemitem> "
"l'installation du paquet <systemitem role=\"package\">gettext</systemitem>) :"
# type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
-#: best-pkging-practices.dbk:905
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
+#: best-pkging-practices.dbk:916
msgid ""
"move all files which report either fuzzy strings to a temporary place. "
"Files which report no fuzzy strings (only translated and untranslated) will "
"être laissés en place."
# type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
-#: best-pkging-practices.dbk:912
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
+#: best-pkging-practices.dbk:923
msgid ""
"now <emphasis role=\"strong\">and now only</emphasis>, modify the template "
"for the typos and check again that translation are not impacted (typos, "
"général pas de problèmes)."
# type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
-#: best-pkging-practices.dbk:919
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
+#: best-pkging-practices.dbk:930
msgid ""
"run <command>debconf-updatepo</command>. This will fuzzy all strings you "
"modified in translations. You can see this by running the above again"
"être contrôlé avec la commande ci-dessus à nouveau."
# type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
-#: best-pkging-practices.dbk:925
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
+#: best-pkging-practices.dbk:936
msgid "use the following command:"
msgstr "utilisez la commande suivante :"
# type: Content of: <chapter><section><section><section><orderedlist><listitem><programlisting>
-#: best-pkging-practices.dbk:927
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><programlisting>
+#: best-pkging-practices.dbk:938
#, no-wrap
msgid "for i in debian/po/*po; do msgattrib --output-file=$i --clear-fuzzy $i; done"
msgstr "for i in debian/po/*po; do msgattrib --output-file=$i --clear-fuzzy $i; done"
# type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
-#: best-pkging-practices.dbk:931
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
+#: best-pkging-practices.dbk:942
msgid ""
"move back to debian/po the files which showed fuzzy strings in the first step"
msgstr ""
"précédemment déplacés."
# type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
-#: best-pkging-practices.dbk:936
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
+#: best-pkging-practices.dbk:947
msgid "run <command>debconf-updatepo</command> again"
msgstr "exécutez la commande <command>debconf-updatepo</command> à nouveau"
# type: Content of: <chapter><section><section><section><title>
-#: best-pkging-practices.dbk:943
+#. type: Content of: <chapter><section><section><section><title>
+#: best-pkging-practices.dbk:954
msgid "Do not make assumptions about interfaces"
msgstr "Ne faites pas de suppositions sur les interfaces utilisateurs"
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:945
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:956
#, fuzzy
msgid ""
"Templates text should not make reference to widgets belonging to some "
"boutons radio sont utilisés pour les questions booléennes."
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:950
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:961
msgid ""
"String templates should also avoid mentioning the default values in their "
"description. First, because this is redundant with the values seen by the "
"exemple, lorsque la base de données de debconf a été pré-renseignée)."
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:956
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:967
msgid ""
"More generally speaking, try to avoid referring to user actions. Just give "
"facts."
"particulières des utilisateurs et donnez simplement des faits."
# type: Content of: <chapter><section><section><section><title>
-#: best-pkging-practices.dbk:962
+#. type: Content of: <chapter><section><section><section><title>
+#: best-pkging-practices.dbk:973
msgid "Do not use first person"
msgstr "N'utilisez pas la première personne"
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:964
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:975
#, fuzzy
msgid ""
"You should avoid the use of first person (<emphasis>I will do this...</"
"be enabled if... »."
# type: Content of: <chapter><section><section><section><title>
-#: best-pkging-practices.dbk:974
+#. type: Content of: <chapter><section><section><section><title>
+#: best-pkging-practices.dbk:985
msgid "Be gender neutral"
msgstr "Restez neutre en genre"
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:976
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:987
msgid ""
"The world is made of men and women. Please use gender-neutral constructions "
"in your writing."
"neutres en genre dans vos écrits."
# type: Content of: <chapter><section><section><title>
-#: best-pkging-practices.dbk:984
+#. type: Content of: <chapter><section><section><title>
+#: best-pkging-practices.dbk:995
msgid "Templates fields definition"
msgstr "Définition de champs des modèles (« templates »)"
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:986
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:997
msgid ""
"This part gives some information which is mostly taken from the "
"<citerefentry> <refentrytitle>debconf-devel</refentrytitle> <manvolnum>7</"
"refentrytitle> <manvolnum>7</manvolnum> </citerefentry>"
# type: Content of: <chapter><section><section><section><title>
-#: best-pkging-practices.dbk:991
+#. type: Content of: <chapter><section><section><section><title>
+#: best-pkging-practices.dbk:1002
msgid "Type"
msgstr "Type"
# type: Content of: <chapter><section><section><section><section><title>
-#: best-pkging-practices.dbk:993
+#. type: Content of: <chapter><section><section><section><section><title>
+#: best-pkging-practices.dbk:1004
msgid "string:"
msgstr "string:"
# type: Content of: <chapter><section><section><section><section><para>
-#: best-pkging-practices.dbk:995
+#. type: Content of: <chapter><section><section><section><section><para>
+#: best-pkging-practices.dbk:1006
msgid ""
"Results in a free-form input field that the user can type any string into."
msgstr ""
"chaîne de caractère."
# type: Content of: <chapter><section><section><section><section><title>
-#: best-pkging-practices.dbk:1000
+#. type: Content of: <chapter><section><section><section><section><title>
+#: best-pkging-practices.dbk:1011
msgid "password:"
msgstr "password:"
# type: Content of: <chapter><section><section><section><section><para>
-#: best-pkging-practices.dbk:1002
+#. type: Content of: <chapter><section><section><section><section><para>
+#: best-pkging-practices.dbk:1013
msgid ""
"Prompts the user for a password. Use this with caution; be aware that the "
"password the user enters will be written to debconf's database. You should "
"conseillé d'effacer cette valeur de la base de donnes dès que possible."
# type: Content of: <chapter><section><section><section><section><title>
-#: best-pkging-practices.dbk:1009
+#. type: Content of: <chapter><section><section><section><section><title>
+#: best-pkging-practices.dbk:1020
msgid "boolean:"
msgstr "boolean:"
# type: Content of: <chapter><section><section><section><section><para>
-#: best-pkging-practices.dbk:1011
+#. type: Content of: <chapter><section><section><section><section><para>
+#: best-pkging-practices.dbk:1022
msgid ""
"A true/false choice. Remember: true/false, <emphasis role=\"strong\">not "
"yes/no</emphasis>..."
"faux, <emphasis role=\"strong\">pas oui/non</emphasis>..."
# type: Content of: <chapter><section><section><section><section><title>
-#: best-pkging-practices.dbk:1017
+#. type: Content of: <chapter><section><section><section><section><title>
+#: best-pkging-practices.dbk:1028
msgid "select:"
msgstr "select:"
# type: Content of: <chapter><section><section><section><section><para>
-#: best-pkging-practices.dbk:1019
+#. type: Content of: <chapter><section><section><section><section><para>
+#: best-pkging-practices.dbk:1030
#, fuzzy
msgid ""
"A choice between one of a number of values. The choices must be specified "
"séparées par des virgules et des espace. Ainsi : yes, no, maybe"
# type: Content of: <chapter><section><section><section><section><para>
-#: best-pkging-practices.dbk:1024
+#. type: Content of: <chapter><section><section><section><section><para>
+#: best-pkging-practices.dbk:1035
msgid ""
"If choices are translatable strings, the 'Choices' field may be marked as "
"translatable by using <literal>__Choices</literal>. The double underscore "
msgstr ""
# type: Content of: <chapter><section><section><section><section><para>
-#: best-pkging-practices.dbk:1029
+#. type: Content of: <chapter><section><section><section><section><para>
+#: best-pkging-practices.dbk:1040
msgid ""
"The <command>po-debconf</command> system also offers interesting "
"possibilities to only mark <emphasis role=\"strong\">some</emphasis> choices "
"as translatable. Example:"
msgstr ""
-# type: Content of: <chapter><section><section><section><section><programlisting>
-#: best-pkging-practices.dbk:1033
+#
. type: Content of: <chapter><section><section><section><section><programlisting>
+#: best-pkging-practices.dbk:1045
#, no-wrap
msgid ""
-"\n"
"Template: foo/bar\n"
"Type: Select\n"
"#flag:translate:3\n"
msgstr ""
# type: Content of: <chapter><section><section><section><section><para>
-#: best-pkging-practices.dbk:1042
+#. type: Content of: <chapter><section><section><section><section><para>
+#: best-pkging-practices.dbk:1053
msgid ""
"In that example, only the 'Other' string is translatable while others are "
"acronyms that should not be translated. The above allows only 'Other' to be "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1047
+#. type: Content of: <chapter><section><section><section><section><para>
+#: best-pkging-practices.dbk:1058
#, fuzzy
msgid ""
"The debconf templates flag system offers many such possibilities. The "
"refentrytitle> <manvolnum>7</manvolnum> </citerefentry>"
# type: Content of: <chapter><section><section><section><section><title>
-#: best-pkging-practices.dbk:1055
+#. type: Content of: <chapter><section><section><section><section><title>
+#: best-pkging-practices.dbk:1066
msgid "multiselect:"
msgstr "multiselect:"
# type: Content of: <chapter><section><section><section><section><para>
-#: best-pkging-practices.dbk:1057
+#. type: Content of: <chapter><section><section><section><section><para>
+#: best-pkging-practices.dbk:1068
msgid ""
"Like the select data type, except the user can choose any number of items "
"from the choices list (or chose none of them)."
"valeurs parmi la liste de choix."
# type: Content of: <chapter><section><section><section><section><title>
-#: best-pkging-practices.dbk:1063
+#. type: Content of: <chapter><section><section><section><section><title>
+#: best-pkging-practices.dbk:1074
msgid "note:"
msgstr "note:"
# type: Content of: <chapter><section><section><section><section><para>
-#: best-pkging-practices.dbk:1065
+#. type: Content of: <chapter><section><section><section><section><para>
+#: best-pkging-practices.dbk:1076
msgid ""
"Rather than being a question per se, this datatype indicates a note that can "
"be displayed to the user. It should be used only for important notes that "
"dans certains cas."
# type: Content of: <chapter><section><section><section><section><title>
-#: best-pkging-practices.dbk:1074
+#. type: Content of: <chapter><section><section><section><section><title>
+#: best-pkging-practices.dbk:1085
msgid "text:"
msgstr "text:"
# type: Content of: <chapter><section><section><section><section><para>
-#: best-pkging-practices.dbk:1076
+#. type: Content of: <chapter><section><section><section><section><para>
+#: best-pkging-practices.dbk:1087
msgid "This type is now considered obsolete: don't use it."
msgstr "ce type de données est obsolète. Il ne faut pas l'utiliser."
# type: Content of: <chapter><section><section><section><section><title>
-#: best-pkging-practices.dbk:1081
+#. type: Content of: <chapter><section><section><section><section><title>
+#: best-pkging-practices.dbk:1092
msgid "error:"
msgstr "error:"
# type: Content of: <chapter><section><section><section><section><para>
-#: best-pkging-practices.dbk:1083
+#. type: Content of: <chapter><section><section><section><section><para>
+#: best-pkging-practices.dbk:1094
msgid ""
"This type is designed to handle error messages. It is mostly similar to the "
"note type. Frontends may present it differently (for instance, the dialog "
"habituel)."
# type: Content of: <chapter><section><section><section><section><para>
-#: best-pkging-practices.dbk:1088
+#. type: Content of: <chapter><section><section><section><section><para>
+#: best-pkging-practices.dbk:1099
msgid ""
"It is recommended to use this type for any message that needs user attention "
"for a correction of any kind."
"soit."
# type: Content of: <chapter><section><section><section><title>
-#: best-pkging-practices.dbk:1096
+#. type: Content of: <chapter><section><section><section><title>
+#: best-pkging-practices.dbk:1107
msgid "Description: short and extended description"
msgstr "Description: description courte et étendue"
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1098
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1109
msgid ""
"Template descriptions have two parts: short and extended. The short "
"description is in the Description: line of the template."
" «Description: » du modèle."
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1102
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1113
msgid ""
"The short description should be kept short (50 characters or so) so that it "
"may be accomodated by most debconf interfaces. Keeping it short also helps "
"général plus longues que les textes originaux."
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1108
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1119
msgid ""
"The short description should be able to stand on its own. Some interfaces "
"do not show the long description by default, or only if the user explicitely "
"comme « Que voulez-vous faire maintenant ? »"
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1114
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1125
msgid ""
"The short description does not necessarily have to be a full sentence. This "
"is part of the keep it short and efficient recommendation."
"Cela est une façon de la garder courte et efficace."
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1118
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1129
msgid ""
"The extended description should not repeat the short description word for "
"word. If you can't think up a long description, then first, think some "
"rien d'intéressant à ajouter, laissez-la vide."
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1125
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1136
msgid ""
"The extended description should use complete sentences. Paragraphs should "
"be kept short for improved readability. Do not mix two ideas in the same "
"différentes dans le même paragraphe mais séparez-les en deux paragraphes."
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1130
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1141
msgid ""
"Don't be too verbose. User tend to ignore too long screens. 20 lines are "
"by experience a border you shouldn't cross, because that means that in the "
"omis par la plupart des utilisateurs."
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1136
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1147
msgid ""
"The extended description should <emphasis role=\"strong\">never</emphasis> "
"include a question."
"\">jamais</emphasis> comporter de question."
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1140
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1151
msgid ""
"For specific rules depending on templates type (string, boolean, etc.), "
"please read below."
"certains types de modèles (string, boolean, etc.)."
# type: Content of: <chapter><section><section><section><title>
-#: best-pkging-practices.dbk:1146
+#. type: Content of: <chapter><section><section><section><title>
+#: best-pkging-practices.dbk:1157
msgid "Choices"
msgstr "Choices"
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1148
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1159
msgid ""
"This field should be used for Select and Multiselect types. It contains the "
"possible choices which will be presented to users. These choices should be "
"virgules."
# type: Content of: <chapter><section><section><section><title>
-#: best-pkging-practices.dbk:1155
+#. type: Content of: <chapter><section><section><section><title>
+#: best-pkging-practices.dbk:1166
msgid "Default"
msgstr "Default"
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1157
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1168
msgid ""
"This field is optional. It contains the default answer for string, select "
"and multiselect templates. For multiselect templates, it may contain a "
"choix multiples, séparés par des virgules."
# type: Content of: <chapter><section><section><title>
-#: best-pkging-practices.dbk:1166
+#. type: Content of: <chapter><section><section><title>
+#: best-pkging-practices.dbk:1177
msgid "Templates fields specific style guide"
msgstr "Guide de style spécifique à certains modèles"
# type: Content of: <chapter><section><section><section><title>
-#: best-pkging-practices.dbk:1168
+#. type: Content of: <chapter><section><section><section><title>
+#: best-pkging-practices.dbk:1179
msgid "Type field"
msgstr "Champ type"
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1170
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1181
msgid ""
"No specific indication except: use the appropriate type by referring to the "
"previous section."
"référant à la section précédente."
# type: Content of: <chapter><section><section><section><title>
-#: best-pkging-practices.dbk:1176
+#. type: Content of: <chapter><section><section><section><title>
+#: best-pkging-practices.dbk:1187
msgid "Description field"
msgstr "Champ Description"
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1178
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1189
msgid ""
"Below are specific instructions for properly writing the Description (short "
"and extended) depending on the template type."
"Description (parties courtes et longue) selon le type de modèle."
# type: Content of: <chapter><section><section><section><section><title>
-#: best-pkging-practices.dbk:1182
+#. type: Content of: <chapter><section><section><section><section><title>
+#: best-pkging-practices.dbk:1193
msgid "String/password templates"
msgstr "Modèles string et password"
# type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
-#: best-pkging-practices.dbk:1186
+#. type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
+#: best-pkging-practices.dbk:1197
msgid ""
"The short description is a prompt and <emphasis role=\"strong\">not</"
"emphasis> a title. Avoid question style prompts (IP Address?) in favour of "
"points » final est recommandée."
# type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
-#: best-pkging-practices.dbk:1193
+#. type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
+#: best-pkging-practices.dbk:1204
msgid ""
"The extended description is a complement to the short description. In the "
"extended part, explain what is being asked, rather than ask the same "
"complètes. Un style d'écriture abrégé est déconseillé."
# type: Content of: <chapter><section><section><section><section><title>
-#: best-pkging-practices.dbk:1203
+#. type: Content of: <chapter><section><section><section><section><title>
+#: best-pkging-practices.dbk:1214
msgid "Boolean templates"
msgstr "Modèles « boolean »"
# type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
-#: best-pkging-practices.dbk:1207
+#. type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
+#: best-pkging-practices.dbk:1218
msgid ""
"The short description should be phrased in the form of a question which "
"should be kept short and should generally end with a question mark. Terse "
"originale)."
# type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
-#: best-pkging-practices.dbk:1215
+#. type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
+#: best-pkging-practices.dbk:1226
msgid ""
"Again, please avoid referring to specific interface widgets. A common "
"mistake for such templates is if you answer Yes-type constructions."
"comme « If you answer Yes... » (« Si vous répondez Oui... »)."
# type: Content of: <chapter><section><section><section><section><title>
-#: best-pkging-practices.dbk:1223
+#. type: Content of: <chapter><section><section><section><section><title>
+#: best-pkging-practices.dbk:1234
msgid "Select/Multiselect"
msgstr "Select/Multiselect"
# type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
-#: best-pkging-practices.dbk:1227
+#. type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
+#: best-pkging-practices.dbk:1238
msgid ""
"The short description is a prompt and <emphasis role=\"strong\">not</"
"emphasis> a title. Do <emphasis role=\"strong\">not</emphasis> use useless "
"nécessaire de choisir quelque chose."
# type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
-#: best-pkging-practices.dbk:1235
+#. type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
+#: best-pkging-practices.dbk:1246
msgid ""
"The extended description will complete the short description. It may refer "
"to the available choices. It may also mention that the user may choose more "
"clair)."
# type: Content of: <chapter><section><section><section><section><title>
-#: best-pkging-practices.dbk:1245
+#. type: Content of: <chapter><section><section><section><section><title>
+#: best-pkging-practices.dbk:1256
msgid "Notes"
msgstr "Notes"
# type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
-#: best-pkging-practices.dbk:1249
+#. type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
+#: best-pkging-practices.dbk:1260
msgid "The short description should be considered to be a *title*."
msgstr "La description courte doit être considérée comme un *titre*."
# type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
-#: best-pkging-practices.dbk:1254
+#. type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
+#: best-pkging-practices.dbk:1265
msgid ""
"The extended description is what will be displayed as a more detailed "
"explanation of the note. Phrases, no terse writing style."
"la note. Il est conseillé d'éviter d'y utiliser un style abrégé."
# type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
-#: best-pkging-practices.dbk:1260
+#. type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
+#: best-pkging-practices.dbk:1271
msgid ""
"<emphasis role=\"strong\">Do not abuse debconf.</emphasis> Notes are the "
"most common way to abuse debconf. As written in debconf-devel manual page: "
"Debian, pensez à conserver d'éventuelles traductions existantes."
# type: Content of: <chapter><section><section><section><title>
-#: best-pkging-practices.dbk:1275
+#. type: Content of: <chapter><section><section><section><title>
+#: best-pkging-practices.dbk:1286
msgid "Choices field"
msgstr "Champ Choices"
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1277
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1288
msgid ""
"If the Choices are likely to change often, please consider using the "
"__Choices trick. This will split each individual choice into a single "
"traducteurs."
# type: Content of: <chapter><section><section><section><title>
-#: best-pkging-practices.dbk:1284 best-pkging-practices.dbk:1322
+#. type: Content of: <chapter><section><section><section><title>
+#: best-pkging-practices.dbk:1295 best-pkging-practices.dbk:1333
msgid "Default field"
msgstr "Champ Default"
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1286
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1297
msgid ""
"If the default value, for a select template, is likely to vary depending on "
"the user language (for instance, if the choice is a language choice), please "
"pensez à utiliser l'astuce « DefaultChoice »."
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1291
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1302
#, fuzzy
msgid ""
"This special field allow translators to put the most appropriate choice "
"en anglais."
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1297
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1308
msgid "Example, taken from the geneweb package templates:"
msgstr "Exemple, pris dans le paquet geneweb :"
# type: Content of: <chapter><section><section><section><screen>
-#: best-pkging-practices.dbk:1299
-#, no-wrap
+#. type: Content of: <chapter><section><section><section><screen>
+#: best-pkging-practices.dbk:1311
+#, fuzzy, no-wrap
msgid ""
-"\n"
"Template: geneweb/lang\n"
"Type: select\n"
"__Choices: Afrikaans (af), Bulgarian (bg), Catalan (ca), Chinese (zh), Czech (cs), Danish (da), Dutch (nl), English (en), Esperanto (eo), Estonian (et), Finnish (fi), French (fr), German (de), Hebrew (he), Icelandic (is), Italian (it), Latvian (lv), Norwegian (no), Polish (pl), Portuguese (pt), Romanian (ro), Russian (ru), Spanish (es), Swedish (sv)\n"
"_Description: Geneweb default language:\n"
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1311
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1322
msgid ""
"Note the use of brackets which allow internal comments in debconf fields. "
"Also note the use of comments which will show up in files the translators "
"commentaires qui apparaîtront dans les fichiers de travail des traducteurs."
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1316
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1327
msgid ""
"The comments are needed as the DefaultChoice trick is a bit confusing: the "
"translators may put their own choice"
"non une simple traduction."
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1324
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1335
msgid ""
"Do NOT use empty default field. If you don't want to use default values, do "
"not use Default at all."
"valeur par défaut, n'utilisez pas du tout ce champ."
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1328
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1339
msgid ""
"If you use po-debconf (and you <emphasis role=\"strong\">should</emphasis>, "
"see 2.2), consider making this field translatable, if you think it may be "
"pensez qu'il peut l'être."
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1333
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1344
msgid ""
"If the default value may vary depending on language/country (for instance "
"the default value for a language choice), consider using the special "
"citerefentry>."
# type: Content of: <chapter><section><title>
-#: best-pkging-practices.dbk:1345
+#. type: Content of: <chapter><section><title>
+#: best-pkging-practices.dbk:1356
msgid "Internationalization"
msgstr "Internationalisation"
# type: Content of: <chapter><section><section><title>
-#: best-pkging-practices.dbk:1347
+#. type: Content of: <chapter><section><section><title>
+#: best-pkging-practices.dbk:1358
msgid "Handling debconf translations"
msgstr "Gestion des traductions debconf"
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1349
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1360
msgid ""
"Like porters, translators have a difficult task. They work on many packages "
"and must collaborate with many different maintainers. Moreover, most of the "
"eux."
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1355
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1366
msgid ""
"The goal of <systemitem role=\"package\">debconf</systemitem> was to make "
"packages configuration easier for maintainers and for users. Originally, "
"responsables et des scripts de transition sont fournis."
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1365
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1376
msgid ""
"Using <systemitem role=\"package\">po-debconf</systemitem>, the translation "
"is stored in <filename>po</filename> files (drawing from <command>gettext</"
"citerefentry> pour plus d'informations."
# type: Content of: <chapter><section><section><title>
-#: best-pkging-practices.dbk:1381
+#. type: Content of: <chapter><section><section><title>
+#: best-pkging-practices.dbk:1392
msgid "Internationalized documentation"
msgstr "Documentation internatonalisée"
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1383
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1394
msgid ""
"Internationalizing documentation is crucial for users, but a lot of labor. "
"There's no way to eliminate all that work, but you can make things easier "
"faciliter le travail des traducteurs."
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1388
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1399
msgid ""
"If you maintain documentation of any size, its easier for translators if "
"they have access to a source control system. That lets translators see the "
"votre propre dépôt CVS."
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1402
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1413
msgid ""
"If you maintain XML or SGML documentation, we suggest that you isolate any "
"language-independent information and define those as entities in a separate "
"nombreux fichiers."
# type: Content of: <chapter><section><title>
-#: best-pkging-practices.dbk:1412
+#. type: Content of: <chapter><section><title>
+#: best-pkging-practices.dbk:1423
msgid "Common packaging situations"
msgstr "Situation usuelle de gestion de paquets"
# type: Content of: <chapter><section><section><title>
-#: best-pkging-practices.dbk:1423
+#. type: Content of: <chapter><section><section><title>
+#: best-pkging-practices.dbk:1434
msgid "Packages using <command>autoconf</command>/<command>automake</command>"
msgstr ""
"Paquets qui utilisent <command>autoconf</command>/<command>automake</command>"
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1425
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1436
msgid ""
"Keeping <command>autoconf</command>'s <filename>config.sub</filename> and "
"<filename>config.guess</filename> files up to date is critical for porters, "
"les recommandations."
# type: Content of: <chapter><section><section><title>
-#: best-pkging-practices.dbk:1437
+#. type: Content of: <chapter><section><section><title>
+#: best-pkging-practices.dbk:1448
msgid "Libraries"
msgstr "Bibliothèques"
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1439
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1450
msgid ""
"Libraries are always difficult to package for various reasons. The policy "
"imposes many constraints to ease their maintenance and to make sure upgrades "
"très nombreux paquets."
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1445
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1456
msgid ""
"Good practices for library packaging have been grouped in <ulink url=\"&url-"
"libpkg-guide;\">the library packaging guide</ulink>."
"guide de gestion des paquets de bibliothèques</ulink>."
# type: Content of: <chapter><section><section><title>
-#: best-pkging-practices.dbk:1452
+#. type: Content of: <chapter><section><section><title>
+#: best-pkging-practices.dbk:1463
msgid "Documentation"
msgstr "Documentation"
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1454
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1465
msgid ""
"Be sure to follow the <ulink url=\"&url-debian-policy;ch-docs.html\">Policy "
"on documentation</ulink>."
"docs.html\">charte de documentation</ulink>."
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1459
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1470
msgid ""
"If your package contains documentation built from XML or SGML, we recommend "
"you not ship the XML or SGML source in the binary package(s). If users want "
"sources de la documentation peuvent alors récupérer le paquet source."
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1464
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1475
msgid ""
"Policy specifies that documentation should be shipped in HTML format. We "
"also recommend shipping documentation in PDF and plain text format if "
"simple des versions de documentations dont le format source est HTML."
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1471
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1482
msgid ""
"Major shipped manuals should register themselves with <systemitem role="
"\"package\">doc-base</systemitem> on installation. See the <systemitem role="
"\"package\">doc-base</systemitem> pour plus d'informations."
# type: Content of: <chapter><section><section><title>
-#: best-pkging-practices.dbk:1479
+#. type: Content of: <chapter><section><section><title>
+#: best-pkging-practices.dbk:1490
msgid "Specific types of packages"
msgstr "Type particuliers de paquets"
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1481
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1492
msgid ""
"Several specific types of packages have special sub-policies and "
"corresponding packaging rules and practices:"
"avec les règles et de bonnes pratiques particulières."
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: best-pkging-practices.dbk:1487
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: best-pkging-practices.dbk:1498
msgid ""
"Perl related packages have a <ulink url=\"&url-perl-policy;\">Perl policy</"
"ulink>, some examples of packages following that policy are <systemitem role="
"perl</systemitem> (module Perl indépendant de l'architecture)."
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: best-pkging-practices.dbk:1496
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: best-pkging-practices.dbk:1507
msgid ""
"Python related packages have their python policy; see &file-python-policy; "
"in the <systemitem role=\"package\">python</systemitem> package."
"systemitem> pour plus d'informations."
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: best-pkging-practices.dbk:1503
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: best-pkging-practices.dbk:1514
msgid ""
"Emacs related packages have the <ulink url=\"&url-emacs-policy;\">emacs "
"policy</ulink>."
"\">charte Emacs</ulink>."
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: best-pkging-practices.dbk:1510
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: best-pkging-practices.dbk:1521
msgid ""
"Java related packages have their <ulink url=\"&url-java-policy;\">java "
"policy</ulink>."
"\">charte Java</ulink>."
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: best-pkging-practices.dbk:1517
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: best-pkging-practices.dbk:1528
msgid ""
"Ocaml related packages have their own policy, found in &file-ocaml-policy; "
"from the <systemitem role=\"package\">ocaml</systemitem> package. A good "
"<systemitem role=\"package\">camlzip</systemitem>."
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: best-pkging-practices.dbk:1525
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: best-pkging-practices.dbk:1536
msgid ""
"Packages providing XML or SGML DTDs should conform to the recommendations "
"found in the <systemitem role=\"package\">sgml-base-doc</systemitem> package."
"base-doc</systemitem>."
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: best-pkging-practices.dbk:1531
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: best-pkging-practices.dbk:1542
msgid ""
"Lisp packages should register themselves with <systemitem role=\"package"
"\">common-lisp-controller</systemitem>, about which see &file-lisp-"
"disponible dans &file-lisp-controller;."
# type: Content of: <chapter><section><section><title>
-#: best-pkging-practices.dbk:1561
+#. type: Content of: <chapter><section><section><title>
+#: best-pkging-practices.dbk:1572
msgid "Architecture-independent data"
msgstr "Données indépendantes de l'architecture"
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1563
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1574
msgid ""
"It is not uncommon to have a large amount of architecture-independent data "
"packaged with a program. For example, audio files, a collection of icons, "
"de laisser l'ensemble dans un seul paquet."
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1570
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1581
msgid ""
"However, if the size of the data is considerable, consider splitting it out "
"into a separate, architecture-independent package (_all.deb). By doing "
"est utilisé sur l'archive Debian en entier."
# type: Content of: <chapter><section><section><title>
-#: best-pkging-practices.dbk:1582
+#. type: Content of: <chapter><section><section><title>
+#: best-pkging-practices.dbk:1593
msgid "Needing a certain locale during build"
msgstr ""
"Nécessitant des paramètres régionaux spécifiques lors de la construction"
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1584
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1595
msgid ""
"If you need a certain locale during build, you can create a temporary file "
"via this trick:"
"astuce :"
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1588
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1599
msgid ""
"If you set <varname>LOCPATH</varname> to the equivalent of <filename>/usr/"
"lib/locale</filename>, and <varname>LC_ALL</varname> to the name of the "
"ressemblera alors à :"
# type: Content of: <chapter><section><section><screen>
-#: best-pkging-practices.dbk:1592
-#, no-wrap
+#. type: Content of: <chapter><section><section><screen>
+#: best-pkging-practices.dbk:1604
+#, fuzzy, no-wrap
msgid ""
-"\n"
"LOCALE_PATH=debian/tmpdir/usr/lib/locale\n"
"LOCALE_NAME=en_IN\n"
"LOCALE_CHARSET=UTF-8\n"
"LOCPATH=$LOCALE_PATH LC_ALL=$LOCALE_NAME.$LOCALE_CHARSET date\n"
# type: Content of: <chapter><section><section><title>
-#: best-pkging-practices.dbk:1606
+#. type: Content of: <chapter><section><section><title>
+#: best-pkging-practices.dbk:1617
msgid "Make transition packages deborphan compliant"
msgstr "Rendre les paquets de transition conformes à deborphan"
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1608
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1619
msgid ""
"Deborphan is a program for helping users to detect which packages can safely "
"be removed from the system, i.e. the ones that have no packages depending "
"le paramètre approprié, il peut rechercher d'autres paquets inutiles."
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1615
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1626
msgid ""
"For example, with <literal>--guess-dummy</literal>, <command>deborphan</"
"command> tries to search all transitional packages which were needed for "
"dans leur description courte."
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1622
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1633
msgid ""
"So, when you are creating such a package, please make sure to add this text "
"to your short description. If you are looking for examples, just run: "
"command> ou <command>apt-cache search .|grep transitional</command>."
# type: Content of: <chapter><section><section><title>
-#: best-pkging-practices.dbk:1630
+#. type: Content of: <chapter><section><section><title>
+#: best-pkging-practices.dbk:1641
msgid "Best practices for <filename>orig.tar.gz</filename> files"
msgstr ""
"Les meilleures pratiques pour les fichiers <filename>orig.tar.gz</filename>"
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1632
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1643
msgid ""
"There are two kinds of original source tarballs: Pristine source and "
"repackaged upstream source."
"originelles (« pristine ») et les sources reconstruites (« repackaged »)."
# type: Content of: <chapter><section><section><section><title>
-#: best-pkging-practices.dbk:1636
+#. type: Content of: <chapter><section><section><section><title>
+#: best-pkging-practices.dbk:1647
msgid "Pristine source"
msgstr "Sources originelles (« pristine »)"
-# type: Content of: <chapter><section><section><section><para><footnote>
-#: best-pkging-practices.dbk:1638
-msgid ""
-"The defining characteristic of a pristine source tarball is that the "
-"<literal>.orig.tar.gz</literal> file is byte-for-byte identical to a tarball "
-"officially distributed by the upstream author. <footnote>"
-msgstr ""
-"La caractéristique principale d'une archive source originelle est que le "
-"fichier <literal>.orig.tar.gz</literal> est identique octet pour octet à "
-"l'archive distribuée par l'auteur amont. <footnote>"
-
# type: Content of: <chapter><section><section><section><para><footnote><para>
-#: best-pkging-practices.dbk:1640
+#. type: Content of: <chapter><section><section><section><para><footnote><para>
+#: best-pkging-practices.dbk:1651
#, fuzzy
msgid ""
"We cannot prevent upstream authors from changing the tarball they distribute "
"situation comme un bogue."
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1650
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1649
+#, fuzzy
msgid ""
-"</footnote> This makes it possible to use checksums to easily verify that "
+"The defining characteristic of a pristine source tarball is that the "
+"<literal>.orig.tar.gz</literal> file is byte-for-byte identical to a tarball "
+"officially distributed by the upstream author. <placeholder type=\"footnote"
+"\" id=\"0\"/> This makes it possible to use checksums to easily verify that "
"all changes between Debian's version and upstream's are contained in the "
"Debian diff. Also, if the original source is huge, upstream authors and "
"others who already have the upstream tarball can save download time if they "
"téléchargement s'ils souhaitent contrôler le paquet en détail."
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1658
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1669
msgid ""
"There is no universally accepted guidelines that upstream authors follow "
"regarding to the directory structure inside their tarball, but <command>dpkg-"
"cette commande est la suivante :"
# type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
-#: best-pkging-practices.dbk:1666
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
+#: best-pkging-practices.dbk:1677
msgid "It unpacks the tarball in an empty temporary directory by doing"
msgstr "Elle extrait l'archive dans un répertoire temporaire :"
# type: Content of: <chapter><section><section><section><orderedlist><listitem><screen>
-#: best-pkging-practices.dbk:1668
-#, no-wrap
-msgid ""
-"\n"
-"zcat path/to/<packagename>_<upstream-version>.orig.tar.gz | tar xf -\n"
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><screen>
+#: best-pkging-practices.dbk:1680
+#, fuzzy, no-wrap
+msgid "zcat path/to/<packagename>_<upstream-version>.orig.tar.gz | tar xf -\n"
msgstr ""
"\n"
"zcat chemon/vers/<nompaquet>_<version-amont>.orig.tar.gz | tar xf -\n"
# type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
-#: best-pkging-practices.dbk:1674
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
+#: best-pkging-practices.dbk:1685
msgid ""
"If, after this, the temporary directory contains nothing but one directory "
"and no other files, <command>dpkg-source</command> renames that directory to "
"du répertoire parent de l'archive tar n'a pas d'importance et est oublié;"
# type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
-#: best-pkging-practices.dbk:1683
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
+#: best-pkging-practices.dbk:1694
msgid ""
"Otherwise, the upstream tarball must have been packaged without a common top-"
"level directory (shame on the upstream author!). In this case, "
"<version-amont>(.orig)</literal>."
# type: Content of: <chapter><section><section><section><title>
-#: best-pkging-practices.dbk:1694
+#. type: Content of: <chapter><section><section><section><title>
+#: best-pkging-practices.dbk:1705
msgid "Repackaged upstream source"
msgstr "Source amont reconstruite"
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1696
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1707
msgid ""
"You <emphasis role=\"strong\">should</emphasis> upload packages with a "
"pristine source tarball if possible, but there are various reasons why it "
"avant l'envoi."
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1703
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1714
msgid ""
"In these cases the developer must construct a suitable <literal>.orig.tar.gz "
"</literal> file himself. We refer to such a tarball as a repackaged "
"amont></literal> et <literal><révision-debian></literal>."
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1712
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1723
msgid ""
"There may be cases where it is desirable to repackage the source even though "
"upstream distributes a <literal>.tar.gz</literal> that could in principle be "
"aurait pu être fournie telle quelle."
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1721
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1732
msgid "A repackaged <literal>.orig.tar.gz</literal>"
msgstr "Un fichier <literal>.orig.tar.gz</literal> reconstruit"
# type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
-#: best-pkging-practices.dbk:1726
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
+#: best-pkging-practices.dbk:1737
#, fuzzy
msgid ""
"<emphasis role=\"strong\">must</emphasis> be documented in the resulting "
"Charte Debian, <ulink url=\"&url-debian-policy;ch-source.html#s-debianrules"
"\">Le script de construction principal : debian/rules</ulink>."
-# type: Content of: <chapter><section><section><section><orderedlist><listitem><para><footnote>
-#: best-pkging-practices.dbk:1739
-msgid ""
-"<emphasis role=\"strong\">should not</emphasis> contain any file that does "
-"not come from the upstream author(s), or whose contents has been changed by "
-"you. <footnote>"
-msgstr ""
-
# type: Content of: <chapter><section><section><section><orderedlist><listitem><para><footnote><para>
#. or similarly named
-#: best-pkging-practices.dbk:1741
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para><footnote><para>
+#: best-pkging-practices.dbk:1752
msgid ""
"As a special exception, if the omission of non-free files would lead to the "
"source failing to build without assistance from the Debian diff, it might be "
"source."
msgstr ""
-# type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
-#: best-pkging-practices.dbk:1748
-msgid "</footnote>"
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
+#: best-pkging-practices.dbk:1750
+msgid ""
+"<emphasis role=\"strong\">should not</emphasis> contain any file that does "
+"not come from the upstream author(s), or whose contents has been changed by "
+"you. <placeholder type=\"footnote\" id=\"0\"/>"
msgstr ""
# type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
-#: best-pkging-practices.dbk:1753
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
+#: best-pkging-practices.dbk:1764
msgid ""
"<emphasis role=\"strong\">should</emphasis>, except where impossible for "
"legal reasons, preserve the entire building and portablility infrastructure "
msgstr ""
# type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
-#: best-pkging-practices.dbk:1762
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
+#: best-pkging-practices.dbk:1773
msgid ""
"(<emphasis>Rationale:</emphasis> It is common for Debian users who need to "
"build software for non-Debian platforms to fetch the source from a Debian "
msgstr ""
# type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
-#: best-pkging-practices.dbk:1769
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
+#: best-pkging-practices.dbk:1780
msgid ""
"<emphasis role=\"strong\">should</emphasis> use <literal><packagename>-"
"<upstream-version>.orig</literal> as the name of the top-level "
msgstr ""
# type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
-#: best-pkging-practices.dbk:1777
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
+#: best-pkging-practices.dbk:1788
msgid ""
"<emphasis role=\"strong\">should</emphasis> be gzipped with maximal "
"compression."
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1782
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1793
msgid ""
"The canonical way to meet the latter two points is to let <literal>dpkg-"
"source -b</literal> construct the repackaged tarball from an unpacked "
msgstr ""
# type: Content of: <chapter><section><section><section><title>
-#: best-pkging-practices.dbk:1788
+#. type: Content of: <chapter><section><section><section><title>
+#: best-pkging-practices.dbk:1799
msgid "Changing binary files in <literal>diff.gz</literal>"
msgstr ""
-# type: Content of: <chapter><section><section><section><para><footnote>
-#: best-pkging-practices.dbk:1790
-msgid ""
-"Sometimes it is necessary to change binary files contained in the original "
-"tarball, or to add binary files that are not in it. If this is done by "
-"simply copying the files into the debianized source tree, <command>dpkg-"
-"source</command> will not be able to handle this. On the other hand, "
-"according to the guidelines given above, you cannot include such a changed "
-"binary file in a repackaged <filename>orig.tar.gz</filename>. Instead, "
-"include the file in the <filename>debian</filename> directory in "
-"<command>uuencode</command>d (or similar) form <footnote>"
-msgstr ""
-
# type: Content of: <chapter><section><section><section><para><footnote><para>
-#: best-pkging-practices.dbk:1797
+#. type: Content of: <chapter><section><section><section><para><footnote><para>
+#: best-pkging-practices.dbk:1808
msgid ""
"The file should have a name that makes it clear which binary file it "
"encodes. Usually, some postfix indicating the encoding should be appended "
"literal> function. The code could look like"
msgstr ""
-# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1805
+#. type: Content of: <chapter><section><section><section><para><footnote>
+#: best-pkging-practices.dbk:1816
+msgid "&example-uu;"
+msgstr ""
+
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1801
msgid ""
-"&example-uu; </footnote>. The file would then be decoded and copied to its "
-"place during the build process. Thus the change will be visible quite easy."
+"Sometimes it is necessary to change binary files contained in the original "
+"tarball, or to add binary files that are not in it. If this is done by "
+"simply copying the files into the debianized source tree, <command>dpkg-"
+"source</command> will not be able to handle this. On the other hand, "
+"according to the guidelines given above, you cannot include such a changed "
+"binary file in a repackaged <filename>orig.tar.gz</filename>. Instead, "
+"include the file in the <filename>debian</filename> directory in "
+"<command>uuencode</command>d (or similar) form <placeholder type=\"footnote"
+"\" id=\"0\"/>. The file would then be decoded and copied to its place "
+"during the build process. Thus the change will be visible quite easy."
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1811
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1822
msgid ""
"Some packages use <command>dbs</command> to manage patches to their upstream "
"source, and always create a new <literal>orig.tar.gz</literal> file that "
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: best-pkging-practices.dbk:1824
+#. type: Content of: <chapter><section><section><title>
+#: best-pkging-practices.dbk:1835
msgid "Best practices for debug packages"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1826
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1837
msgid ""
"A debug package is a package with a name ending in -dbg, that contains "
"additional information that gdb can use. Since Debian binaries are stripped "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1834
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1845
msgid ""
"It is up to a package's maintainer whether to create a debug package or "
"not. Maintainers are encouraged to create debug packages for library "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1844
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1855
msgid ""
"Some debug packages may contain an entire special debugging build of a "
"library or other binary, but most of them can save space and build time by "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1856
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1867
msgid ""
"The debugging symbols can be extracted from an object file using <command> "
"objcopy --only-keep-debug</command>. Then the object file can be stripped, "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1864
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1875
msgid ""
"The <command>dh_strip</command> command in debhelper supports creating debug "
"packages, and can take care of using <command>objcopy</command> to separate "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1871
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1882
msgid ""
"Note that the debug package should depend on the package that it provides "
"debugging symbols for, and this dependency should be versioned. For example:"
msgstr ""
-# type: Content of: <chapter><section><section><screen>
-#: best-pkging-practices.dbk:1874
+#. type: Content of: <chapter><section><section><screen>
+#: best-pkging-practices.dbk:1886
#, no-wrap
-msgid ""
-"\n"
-"Depends: libfoo (= ${binary:Version})\n"
+msgid "Depends: libfoo (= ${binary:Version})\n"
msgstr ""
+# type: Content of: <chapter><section><section><para>
+#~ msgid ""
+#~ "<command>dpatch</command> also provides these facilities, but it's "
+#~ "intended to be even easier to use. See the package <systemitem role="
+#~ "\"package\">dpatch</systemitem> for documentation and examples (in "
+#~ "<filename>/usr/share/doc/dpatch</filename>)."
+#~ msgstr ""
+#~ "<command>dpatch</command> a également le même objectif mais se veut être "
+#~ "plus simple à utiliser. Veuillez cosulter la documentation du paquet "
+#~ "<systemitem role=\"package\">dpatch</systemitem> ainsi que les exemples "
+#~ "fournis (dans <filename>/usr/share/doc/dpatch</filename>)."
+
+# type: Content of: <chapter><section><section><para>
+#~ msgid ""
+#~ "It's a good idea to think of the synopsis as an appositive clause, not a "
+#~ "full sentence. An appositive clause is defined in WordNet as a "
+#~ "grammatical relation between a word and a noun phrase that follows, e.g., "
+#~ "Rudolph the red-nosed reindeer. The appositive clause here is red-nosed "
+#~ "reindeer. Since the synopsis is a clause, rather than a full sentence, "
+#~ "we recommend that it neither start with a capital nor end with a full "
+#~ "stop (period). It should also not begin with an article, either definite "
+#~ "(the) or indefinite (a or an)."
+#~ msgstr ""
+#~ "Il est conseillé de voir le résumé comme un « clause "
+#~ "appositive » (NdT : il s'agit d'un terme syntaxique en anglais) et pas "
+#~ "comme une phrase complète. Une clause appositive est définie par WordNet "
+#~ "comme la relation grammaticale entre un nom et une phrase nomilae qui le "
+#~ "suit. Par exemple, « Rudolph the red-nosed reindeer ». La clause "
+#~ "appositive ici est « red-nosed reindeer ». Comme le résumé est une telle "
+#~ "clause et non une phrase, il ne doit donc pas commencer par une majuscule "
+#~ "ni se terminer par un point. Il ne doit également pas commencer par un "
+#~ "article défini (« the ») ou indéfini (« a » ou « an »)."
+
+# type: Content of: <chapter><section><section><para>
+#~ msgid ""
+#~ "It might help to imagine that the synopsis is combined with the package "
+#~ "name in the following way:"
+#~ msgstr ""
+#~ "Un moyen commode est d'imaginer que le résumé est combiné avec le nom du "
+#~ "paquet de la façon suivante (NdT : certaines parties volontairement non "
+#~ "traduites car ces exemples s'appliquent à la langue anglaise) :"
+
+# type: Content of: <chapter><section><section><para>
+#~ msgid "Alternatively, it might make sense to think of it as"
+#~ msgstr "Il est également possible de visualiser l'ensemble sous la forme"
+
+# type: Content of: <chapter><section><section><screen>
+#~ msgid ""
+#~ "\n"
+#~ "<replaceable>package-name</replaceable> is <replaceable>synopsis</replaceable>.\n"
+#~ msgstr ""
+#~ "\n"
+#~ "<replaceable>nom-du-paquet</replaceable> is <replaceable>résumé</replaceable>.\n"
+
+# type: Content of: <chapter><section><section><para>
+#~ msgid ""
+#~ "or, if the package name itself is a plural (such as developers-tools)"
+#~ msgstr ""
+#~ "ou, si le nom du paquet est lui-même une forme plurielle (par exemple "
+#~ "developers-tools)"
+
+# type: Content of: <chapter><section><section><para>
+#~ msgid ""
+#~ "This way of forming a sentence from the package name and synopsis should "
+#~ "be considered as a heuristic and not a strict rule. There are some cases "
+#~ "where it doesn't make sense to try to form a sentence."
+#~ msgstr ""
+#~ "Cette méthode permettant de créer une phrase à partir du nom du paquet et "
+#~ "de sa description courte doit être considérée comme une heuristique et "
+#~ "non une règle stricte. Dans certains cas, former une phrase n'aura aucun "
+#~ "sens."
+
+# type: Content of: <chapter><section><section><section><para><footnote>
+#~ msgid ""
+#~ "The defining characteristic of a pristine source tarball is that the "
+#~ "<literal>.orig.tar.gz</literal> file is byte-for-byte identical to a "
+#~ "tarball officially distributed by the upstream author. <footnote>"
+#~ msgstr ""
+#~ "La caractéristique principale d'une archive source originelle est que le "
+#~ "fichier <literal>.orig.tar.gz</literal> est identique octet pour octet à "
+#~ "l'archive distribuée par l'auteur amont. <footnote>"
+
# type: Content of: <chapter><section><section><section><para>
#~ msgid ""
#~ "The use of the <command>podebconf-report-po</command> from the "
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2008-08-08 11:36-0300\n"
+"POT-Creation-Date: 2009-06-25 22:00+0300\n"
"PO-Revision-Date: 2007-07-01 23:10+0000\n"
"Last-Translator: <>\n"
"Language-Team: \n"
"Content-Transfer-Encoding: \n"
# type: Content of: <chapter><title>
+#. type: Content of: <chapter><title>
#: developer-duties.dbk:7
msgid "Debian Developer's Duties"
msgstr "Les charges du responsable Debian"
# type: Content of: <chapter><section><title>
+#. type: Content of: <chapter><section><title>
#: developer-duties.dbk:9
msgid "Maintaining your Debian information"
msgstr "Mise à jour de vos références Debian"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: developer-duties.dbk:11
msgid ""
"There's a LDAP database containing information about Debian developers at "
msgstr ""
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: developer-duties.dbk:19
msgid ""
"For more information about the database, please see <xref linkend=\"devel-db"
msgstr ""
# type: Content of: <chapter><section><title>
+#. type: Content of: <chapter><section><title>
#: developer-duties.dbk:25
msgid "Maintaining your public key"
msgstr "Gérer votre clé publique"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: developer-duties.dbk:27
msgid ""
"Be very careful with your private keys. Do not place them on any public "
msgstr ""
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: developer-duties.dbk:34
msgid ""
"You need to ensure not only that your key is secure against being stolen, "
msgstr ""
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: developer-duties.dbk:40
msgid ""
"If you add signatures to your public key, or add user identities, you can "
msgstr ""
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: developer-duties.dbk:45
msgid ""
"If you need to add a completely new key or remove an old key, you need to "
msgstr ""
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: developer-duties.dbk:53
msgid ""
"The same key extraction routines discussed in <xref linkend=\"registering\"/"
msgstr ""
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: developer-duties.dbk:57
msgid ""
"You can find a more in-depth discussion of Debian key maintenance in the "
msgstr ""
# type: Content of: <chapter><section><title>
+#. type: Content of: <chapter><section><title>
#: developer-duties.dbk:64
msgid "Voting"
msgstr ""
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: developer-duties.dbk:66
msgid ""
"Even though Debian isn't really a democracy, we use a democratic process to "
msgstr ""
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: developer-duties.dbk:72
msgid ""
"Other than the yearly leader election, votes are not routinely held, and "
msgstr ""
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: developer-duties.dbk:78
msgid ""
"You don't have to track the pre-vote discussions, as the secretary will "
msgstr ""
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: developer-duties.dbk:86
msgid ""
"The list of all proposals (past and current) is available on the <ulink url="
msgstr ""
# type: Content of: <chapter><section><title>
+#. type: Content of: <chapter><section><title>
#: developer-duties.dbk:93
msgid "Going on vacation gracefully"
msgstr ""
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: developer-duties.dbk:95
msgid ""
"It is common for developers to have periods of absence, whether those are "
msgstr ""
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: developer-duties.dbk:102
msgid ""
"Usually this means that other developers are allowed to NMU (see <xref "
"that you're unavailable."
msgstr ""
-# type: Content of: <chapter><section><para><footnote>
-#: developer-duties.dbk:109
-msgid ""
-"In order to inform the other developers, there are two things that you "
-"should do. First send a mail to <email>debian-private@&lists-host;</email> "
-"with [VAC] prepended to the subject of your message<footnote>"
-msgstr ""
-
# type: Content of: <chapter><section><para><footnote><para>
+#. type: Content of: <chapter><section><para><footnote><para>
#: developer-duties.dbk:111
msgid ""
"This is so that the message can be easily filtered by people who don't want "
"to read vacation notices."
msgstr ""
-# type: Content of: <chapter><section><para>
-#: developer-duties.dbk:113
+#
. type: Content of: <chapter><section><para>
+#: developer-duties.dbk:109
msgid ""
-"</footnote> and state the period of time when you will be on vacation. You "
-"can also give some special instructions on what to do if a problem occurs."
+"In order to inform the other developers, there are two things that you "
+"should do. First send a mail to <email>debian-private@&lists-host;</email> "
+"with [VAC] prepended to the subject of your message<placeholder type="
+"\"footnote\" id=\"0\"/> and state the period of time when you will be on "
+"vacation. You can also give some special instructions on what to do if a "
+"problem occurs."
msgstr ""
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: developer-duties.dbk:118
msgid ""
"The other thing to do is to mark yourself as on vacation in the <link "
msgstr ""
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: developer-duties.dbk:124
msgid ""
"Ideally, you should sign up at the <ulink url=\"&url-newmaint-db;gpg.php"
msgstr ""
# type: Content of: <chapter><section><title>
+#. type: Content of: <chapter><section><title>
#: developer-duties.dbk:133
msgid "Coordination with upstream developers"
msgstr ""
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: developer-duties.dbk:135
msgid ""
"A big part of your job as Debian maintainer will be to stay in contact with "
msgstr ""
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: developer-duties.dbk:142
msgid ""
"While it's not your job to fix non-Debian specific bugs, you may freely do "
msgstr ""
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: developer-duties.dbk:149
msgid ""
"If you need to modify the upstream sources in order to build a policy "
"not to fork from the upstream sources."
msgstr ""
+#. type: Content of: <chapter><section><para>
+#: developer-duties.dbk:156
+msgid ""
+"If you find that the upstream developers are or become hostile towards "
+"Debian or the free software community, you may want to re-consider the need "
+"to include the software in Debian. Sometimes the social cost to the Debian "
+"community is not worth the benefits the software may bring."
+msgstr ""
+
# type: Content of: <chapter><section><title>
-#: developer-duties.dbk:158
+#. type: Content of: <chapter><section><title>
+#: developer-duties.dbk:164
msgid "Managing release-critical bugs"
msgstr ""
# type: Content of: <chapter><section><para>
-#: developer-duties.dbk:160
+#. type: Content of: <chapter><section><para>
+#: developer-duties.dbk:166
msgid ""
"Generally you should deal with bug reports on your packages as described in "
"<xref linkend=\"bug-handling\"/> . However, there's a special category of "
msgstr ""
# type: Content of: <chapter><section><para>
-#: developer-duties.dbk:171
+#. type: Content of: <chapter><section><para>
+#: developer-duties.dbk:177
msgid ""
"Developers who are part of the <ulink url=\"&url-debian-qa;\">Quality "
"Assurance</ulink> group are following all such bugs, and trying to help "
msgstr ""
# type: Content of: <chapter><section><title>
-#: developer-duties.dbk:186
+#. type: Content of: <chapter><section><title>
+#: developer-duties.dbk:192
msgid "Retiring"
msgstr ""
# type: Content of: <chapter><section><para>
-#: developer-duties.dbk:188
+#. type: Content of: <chapter><section><para>
+#: developer-duties.dbk:194
msgid ""
"If you choose to leave the Debian project, you should make sure you do the "
"following steps:"
msgstr ""
# type: Content of: <chapter><section><orderedlist><listitem><para>
-#: developer-duties.dbk:194
+#. type: Content of: <chapter><section><orderedlist><listitem><para>
+#: developer-duties.dbk:200
msgid ""
"Orphan all your packages, as described in <xref linkend=\"orphaning\"/> ."
msgstr ""
# type: Content of: <chapter><section><orderedlist><listitem><para>
-#: developer-duties.dbk:199
+#. type: Content of: <chapter><section><orderedlist><listitem><para>
+#: developer-duties.dbk:205
msgid ""
"Send an gpg-signed email about why you are leaving the project to "
"<email>debian-private@&lists-host;</email>."
msgstr ""
# type: Content of: <chapter><section><orderedlist><listitem><para>
-#: developer-duties.dbk:205
+#. type: Content of: <chapter><section><orderedlist><listitem><para>
+#: developer-duties.dbk:211
msgid ""
"Notify the Debian key ring maintainers that you are leaving by opening a "
"ticket in Debian RT by sending a mail to keyring@rt.debian.org with the "
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2009-01-23 09:48+0100\n"
+"POT-Creation-Date: 2009-06-25 22:00+0300\n"
"PO-Revision-Date: 2007-07-01 23:15+0000\n"
"Last-Translator: <>\n"
"Language-Team: \n"
"Content-Transfer-Encoding: \n"
# type: Content of: <chapter><title>
+#. type: Content of: <chapter><title>
#: pkgs.dbk:7
msgid "Managing Packages"
msgstr "Gestion des paquets"
# type: Content of: <chapter><para>
+#. type: Content of: <chapter><para>
#: pkgs.dbk:9
msgid ""
"This chapter contains information related to creating, uploading, "
"maintenance et le portage des paquets."
# type: Content of: <chapter><section><title>
+#. type: Content of: <chapter><section><title>
#: pkgs.dbk:13
msgid "New packages"
msgstr "Nouveaux paquets"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: pkgs.dbk:15
msgid ""
"If you want to create a new package for the Debian distribution, you should "
msgstr ""
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: pkgs.dbk:23
msgid ""
"Assuming no one else is already working on your prospective package, you "
msgstr ""
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: pkgs.dbk:31
msgid ""
"You should set the subject of the bug to <literal>ITP: <replaceable>foo</"
msgstr ""
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: pkgs.dbk:45
msgid ""
"Please include a <literal>Closes: bug#<replaceable>nnnnn</replaceable></"
"archive (see <xref linkend=\"upload-bugfix\"/> )."
msgstr ""
-# type: Content of: <chapter><section><para>
+#
. type: Content of: <chapter><section><para>
#: pkgs.dbk:51
msgid ""
+"If you think your package needs some explanations for the administrators of "
+"the NEW package queue, include them in your changelog, send to "
+"ftpmaster@debian.org a reply to the email you receive as a maintainer after "
+"your upload, or reply to the rejection email in case you are already re-"
+"uploading."
+msgstr ""
+
+# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:57
+msgid ""
"When closing security bugs include CVE numbers as well as the Closes: "
"#nnnnn. This is useful for the security team to track vulnerabilities. If "
"an upload is made to fix the bug before the advisory ID is known, it is "
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:59
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:65
msgid ""
"There are a number of reasons why we ask maintainers to announce their "
"intentions:"
msgstr ""
# type: Content of: <chapter><section><itemizedlist><listitem><para>
-#: pkgs.dbk:65
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
+#: pkgs.dbk:71
msgid ""
"It helps the (potentially new) maintainer to tap into the experience of "
"people on the list, and lets them know if anyone else is working on it "
msgstr ""
# type: Content of: <chapter><section><itemizedlist><listitem><para>
-#: pkgs.dbk:71
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
+#: pkgs.dbk:77
msgid ""
"It lets other people thinking about working on the package know that there "
"already is a volunteer, so efforts may be shared."
msgstr ""
# type: Content of: <chapter><section><itemizedlist><listitem><para>
-#: pkgs.dbk:77
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
+#: pkgs.dbk:83
msgid ""
"It lets the rest of the maintainers know more about the package than the one "
"line description and the usual changelog entry ``Initial release'' that gets "
msgstr ""
# type: Content of: <chapter><section><itemizedlist><listitem><para>
-#: pkgs.dbk:84
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
+#: pkgs.dbk:90
msgid ""
"It is helpful to the people who live off <literal>unstable</literal> (and "
"form our first line of testers). We should encourage these people."
msgstr ""
# type: Content of: <chapter><section><itemizedlist><listitem><para>
-#: pkgs.dbk:90
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
+#: pkgs.dbk:96
msgid ""
"The announcements give maintainers and other interested parties a better "
"feel of what is going on, and what is new, in the project."
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:96
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:102
msgid ""
"Please see <ulink url=\"http://&ftp-master-host;/REJECT-FAQ.html\"></ulink> "
"for common rejection reasons for a new package."
msgstr ""
# type: Content of: <chapter><section><title>
-#: pkgs.dbk:102
+#. type: Content of: <chapter><section><title>
+#: pkgs.dbk:108
msgid "Recording changes in the package"
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:104
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:110
msgid ""
"Changes that you make to the package need to be recorded in the "
"<filename>debian/changelog</filename>. These changes should provide a "
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:115
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:121
msgid ""
"The <filename>debian/changelog</filename> file conforms to a certain "
"structure, with a number of different fields. One field of note, the "
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:123
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:129
msgid ""
"Changelog entries can be used to automatically close Debian bugs when the "
"package is installed into the archive. See <xref linkend=\"upload-bugfix\"/"
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:127
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:133
msgid ""
"It is conventional that the changelog entry of a package that contains a new "
"upstream version of the software looks like this:"
msgstr ""
-# type: Content of: <chapter><section><screen>
-#: pkgs.dbk:130
+#. type: Content of: <chapter><section><screen>
+#: pkgs.dbk:137
#, no-wrap
-msgid ""
-"\n"
-" * new upstream version\n"
+msgid " * new upstream version\n"
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:134
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:140
msgid ""
"There are tools to help you create entries and finalize the "
"<filename>changelog</filename> for release — see <xref linkend=\"devscripts"
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:139
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:145
msgid "See also <xref linkend=\"bpp-debian-changelog\"/> ."
msgstr ""
# type: Content of: <chapter><section><title>
-#: pkgs.dbk:144
+#. type: Content of: <chapter><section><title>
+#: pkgs.dbk:150
msgid "Testing the package"
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:146
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:152
msgid ""
"Before you upload your package, you should do basic testing on it. At a "
"minimum, you should try the following activities (you'll need to have an "
msgstr ""
# type: Content of: <chapter><section><itemizedlist><listitem><para>
-#: pkgs.dbk:153
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
+#: pkgs.dbk:159
msgid ""
"Install the package and make sure the software works, or upgrade the package "
"from an older version to your new version if a Debian package for it already "
msgstr ""
# type: Content of: <chapter><section><itemizedlist><listitem><para>
-#: pkgs.dbk:160
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
+#: pkgs.dbk:166
msgid ""
"Run <command>lintian</command> over the package. You can run "
"<command>lintian</command> as follows: <literal>lintian -v "
msgstr ""
# type: Content of: <chapter><section><itemizedlist><listitem><para>
-#: pkgs.dbk:169
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
+#: pkgs.dbk:175
msgid ""
"Normally, a package should <emphasis>not</emphasis> be uploaded if it causes "
"lintian to emit errors (they will start with <literal>E</literal>)."
msgstr ""
# type: Content of: <chapter><section><itemizedlist><listitem><para>
-#: pkgs.dbk:173
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
+#: pkgs.dbk:179
msgid ""
"For more information on <command>lintian</command>, see <xref linkend="
"\"lintian\"/> ."
msgstr ""
# type: Content of: <chapter><section><itemizedlist><listitem><para>
-#: pkgs.dbk:179
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
+#: pkgs.dbk:185
msgid ""
"Optionally run <xref linkend=\"debdiff\"/> to analyze changes from an older "
"version, if one exists."
msgstr ""
# type: Content of: <chapter><section><itemizedlist><listitem><para>
-#: pkgs.dbk:185
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
+#: pkgs.dbk:191
msgid ""
"Downgrade the package to the previous version (if one exists) — this tests "
"the <filename>postrm</filename> and <filename>prerm</filename> scripts."
msgstr ""
# type: Content of: <chapter><section><itemizedlist><listitem><para>
-#: pkgs.dbk:191
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
+#: pkgs.dbk:197
msgid "Remove the package, then reinstall it."
msgstr ""
# type: Content of: <chapter><section><itemizedlist><listitem><para>
-#: pkgs.dbk:196
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
+#: pkgs.dbk:202
msgid ""
"Copy the source package in a different directory and try unpacking it and "
"rebuilding it. This tests if the package relies on existing files outside "
msgstr ""
# type: Content of: <chapter><section><title>
-#: pkgs.dbk:206
+#. type: Content of: <chapter><section><title>
+#: pkgs.dbk:212
msgid "Layout of the source package"
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:208
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:214
msgid "There are two types of Debian source packages:"
msgstr ""
# type: Content of: <chapter><section><itemizedlist><listitem><para>
-#: pkgs.dbk:213
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
+#: pkgs.dbk:219
msgid ""
"the so-called <literal>native</literal> packages, where there is no "
"distinction between the original sources and the patches applied for Debian"
msgstr ""
# type: Content of: <chapter><section><itemizedlist><listitem><para>
-#: pkgs.dbk:219
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
+#: pkgs.dbk:225
msgid ""
"the (more common) packages where there's an original source tarball file "
"accompanied by another file that contains the patches applied for Debian"
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:225
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:231
msgid ""
"For the native packages, the source package includes a Debian source control "
"file (<literal>.dsc</literal>) and the source tarball (<literal>.tar.gz</"
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:233
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:239
msgid ""
"Whether a package is native or not is determined when it is built by "
"<citerefentry> <refentrytitle>dpkg-buildpackage</refentrytitle> "
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:239
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:245
msgid ""
"The first time a version is uploaded which corresponds to a particular "
"upstream version, the original source tar file should be uploaded and "
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:246
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:252
msgid ""
"By default, <command>dpkg-genchanges</command> and <command>dpkg-"
"buildpackage</command> will include the original source tar file if and only "
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:254
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:260
msgid ""
"If no original source is included in the upload, the original source tar-"
"file used by <command>dpkg-source</command> when constructing the <filename>."
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:261
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:267
msgid ""
"Please notice that, in non-native packages, permissions on files that are "
"not present in the .orig.tar.gz will not be preserved, as diff does not "
msgstr ""
# type: Content of: <chapter><section><title>
-#: pkgs.dbk:268
+#. type: Content of: <chapter><section><title>
+#: pkgs.dbk:274
msgid "Picking a distribution"
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:270
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:276
msgid ""
"Each upload needs to specify which distribution the package is intended "
"for. The package build process extracts this information from the first "
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:276
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:282
msgid ""
"There are several possible values for this field: <literal>stable</literal>, "
"<literal>unstable</literal>, <literal>testing-proposed-updates</literal> and "
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:282
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:288
msgid ""
"Actually, there are two other possible distributions: <literal>stable-"
"security </literal> and <literal>testing-security</literal>, but read <xref "
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:287
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:293
msgid ""
"It is not possible to upload a package into several distributions at the "
"same time."
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:291
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:297
msgid ""
"Special case: uploads to the <literal>stable</literal> and "
"<literal>oldstable</literal> distributions"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:294
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:300
msgid ""
"Uploading to <literal>stable</literal> means that the package will "
"transfered to the <literal>proposed-updates-new</literal> queue for review "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:302
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:308
msgid ""
"To ensure that your upload will be accepted, you should discuss the changes "
"with the stable release team before you upload. For that, send a mail to the "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:310
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:316
msgid ""
"Extra care should be taken when uploading to <literal>stable</literal>. "
"Basically, a package should only be uploaded to <literal>stable</literal> if "
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:317
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:323
msgid "a truly critical functionality problem"
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:322
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:328
msgid "the package becomes uninstallable"
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:327
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:333
msgid "a released architecture lacks the package"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:332
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:338
msgid ""
"In the past, uploads to <literal>stable</literal> were used to address "
"security problems as well. However, this practice is deprecated, as uploads "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:343
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:349
msgid ""
"Changing anything else in the package that isn't important is discouraged, "
"because even trivial fixes can cause bugs later on."
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:347
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:353
msgid ""
"Packages uploaded to <literal>stable</literal> need to be compiled on "
"systems running <literal>stable</literal>, so that their dependencies are "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:357
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:363
msgid ""
"Uploads to the <literal>oldstable</literal> distributions are possible as "
"long as it hasn't been archived. The same rules as for <literal>stable </"
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:364
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:370
msgid ""
"Special case: uploads to <literal>testing/testing-proposed-updates</literal>"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:366
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:372
msgid ""
"Please see the information in the <link linkend=\"t-p-u\">testing section</"
"link> for details."
msgstr ""
# type: Content of: <chapter><section><title>
-#: pkgs.dbk:374
+#. type: Content of: <chapter><section><title>
+#: pkgs.dbk:380
msgid "Uploading a package"
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:376
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:382
msgid "Uploading to <literal>ftp-master</literal>"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:378
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:384
msgid ""
"To upload a package, you should upload the files (including the signed "
"changes and dsc-file) with anonymous ftp to <literal>&ftp-master-host;</"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:387
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:393
msgid ""
"Please note that you should transfer the changes file last. Otherwise, your "
"upload may be rejected because the archive maintenance software will parse "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:392
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:398
msgid ""
"You may also find the Debian packages <xref linkend=\"dupload\"/> or <xref "
"linkend=\"dput\"/> useful when uploading packages. These handy programs "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:397
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:403
msgid ""
"For removing packages, please see the README file in that ftp directory, and "
"the Debian package <xref linkend=\"dcut\"/> ."
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:403
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:409
msgid "Delayed uploads"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:406
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:412
msgid ""
"It is sometimes useful to upload a package immediately, but to want this "
"package to arrive in the archive only a few days later. For example, when "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:413
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:419
msgid ""
"An upload to the delayed directory keeps the package in <ulink url=\"http://"
"ftp-master.debian.org/deferred.html\"> the deferred uploads queue\"</"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:424
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:430
msgid ""
"With dput, you can use the <literal>--delayed <replaceable>DELAY</"
"replaceable></literal> parameter to put the package into one of the queues."
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:430
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:436
msgid "Security uploads"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:432
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:438
msgid ""
"Do <emphasis role=\"strong\">NOT</emphasis> upload a package to the security "
"upload queue (<literal>oldstable-security</literal>, <literal>stable-"
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:442
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:448
msgid "Other upload queues"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:444
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:450
msgid ""
"The scp queues on <literal>&ftp-master-host;</literal>, and <literal> "
"security.debian.org</literal> are mostly unusable due to the login "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:449
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:455
msgid ""
"The anonymous queues on ftp.uni-erlangen.de and ftp.uk.debian.org are "
"currently down. Work is underway to resurrect them."
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:453
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:459
msgid ""
"The queues on master.debian.org, samosa.debian.org, master.debian.or.jp, and "
"ftp.chiark.greenend.org.uk are down permanently, and will not be "
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:461
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:467
msgid "Notification that a new package has been installed"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:463
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:469
msgid ""
"The Debian archive maintainers are responsible for handling package "
"uploads. For the most part, uploads are automatically handled on a daily "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:473
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:479
msgid ""
"In any case, you will receive an email notification indicating that the "
"package has been added to the archive, which also indicates which bugs will "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:479
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:485
msgid ""
"The installation notification also includes information on what section the "
"package was inserted into. If there is a disparity, you will receive a "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:484
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:490
msgid ""
"Note that if you upload via queues, the queue daemon software will also send "
"you a notification by email."
msgstr ""
# type: Content of: <chapter><section><title>
-#: pkgs.dbk:492
+#. type: Content of: <chapter><section><title>
+#: pkgs.dbk:498
msgid "Specifying the package section, subsection and priority"
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:494
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:500
msgid ""
"The <filename>debian/control</filename> file's <literal>Section</literal> "
"and <literal>Priority</literal> fields do not actually specify where the "
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:502
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:508
msgid ""
"The archive maintainers keep track of the canonical sections and priorities "
"for packages in the <literal>override file</literal>. If there is a "
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:512
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:518
msgid ""
"To alter the actual section that a package is put in, you need to first make "
"sure that the <filename>debian/control</filename> file in your package is "
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:520
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:526
msgid ""
"For more information about <literal>override files</literal>, see "
"<citerefentry> <refentrytitle>dpkg-scanpackages</refentrytitle> "
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:526
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:532
msgid ""
"Note that the <literal>Section</literal> field describes both the section as "
"well as the subsection, which are described in <xref linkend=\"archive-"
msgstr ""
# type: Content of: <chapter><section><title>
-#: pkgs.dbk:535
+#. type: Content of: <chapter><section><title>
+#: pkgs.dbk:541
msgid "Handling bugs"
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:537
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:543
msgid ""
"Every developer has to be able to work with the Debian <ulink url=\"&url-bts;"
"\">bug tracking system</ulink>. This includes knowing how to file bug "
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:543
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:549
msgid ""
"The bug tracking system's features are described in the <ulink url=\"&url-"
"bts-devel;\">BTS documentation for developers</ulink>. This includes "
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:549
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:555
msgid ""
"Operations such as reassigning bugs to other packages, merging separate bug "
"reports about the same issue, or reopening bugs when they are prematurely "
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:557
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:563
msgid "Monitoring bugs"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:559
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:565
msgid ""
"If you want to be a good maintainer, you should periodically check the "
"<ulink url=\"&url-bts;\">Debian bug tracking system (BTS)</ulink> for your "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:566
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:572
msgid ""
"Maintainers interact with the BTS via email addresses at <literal>&bugs-host;"
"</literal>. Documentation on available commands can be found at <ulink url="
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:573
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:579
msgid ""
"Some find it useful to get periodic reports on open bugs. You can add a "
"cron job such as the following if you want to get a weekly email outlining "
"all the open bugs against your packages:"
msgstr ""
-# type: Content of: <chapter><section><section><screen>
-#: pkgs.dbk:577
+#. type: Content of: <chapter><section><section><screen>
+#: pkgs.dbk:584
#, no-wrap
msgid ""
-"\n"
"# ask for weekly reports of bugs in my packages\n"
"&cron-bug-report;\n"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:582
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:588
msgid ""
"Replace <replaceable>address</replaceable> with your official Debian "
"maintainer address."
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:588
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:594
msgid "Responding to bugs"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:590
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:596
msgid ""
"When responding to bugs, make sure that any discussion you have about bugs "
"is sent both to the original submitter of the bug, and to the bug itself (e."
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:599
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:605
msgid ""
"If you get a bug which mentions FTBFS, this means Fails to build from "
"source. Porters frequently use this acronym."
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:603
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:609
msgid ""
"Once you've dealt with a bug report (e.g. fixed it), mark it as "
"<literal>done</literal> (close it) by sending an explanation message to "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:610
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:616
msgid ""
"You should <emphasis>never</emphasis> close bugs via the bug server "
"<literal>close</literal> command sent to &email-bts-control;. If you do so, "
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:618
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:624
msgid "Bug housekeeping"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:620
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:626
msgid ""
"As a package maintainer, you will often find bugs in other packages or have "
"bugs reported against your packages which are actually bugs in other "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:631
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:637
msgid ""
"Filing bugs for problems that you find in other packages is one of the civic "
"obligations of maintainership, see <xref linkend=\"submit-bug\"/> for "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:636
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:642
msgid "Here's a list of steps that you may follow to handle a bug report:"
msgstr ""
# type: Content of: <chapter><section><section><orderedlist><listitem><para>
-#: pkgs.dbk:641
+#. type: Content of: <chapter><section><section><orderedlist><listitem><para>
+#: pkgs.dbk:647
msgid ""
"Decide whether the report corresponds to a real bug or not. Sometimes users "
"are just calling a program in the wrong way because they haven't read the "
msgstr ""
# type: Content of: <chapter><section><section><orderedlist><listitem><para>
-#: pkgs.dbk:651
+#. type: Content of: <chapter><section><section><orderedlist><listitem><para>
+#: pkgs.dbk:657
msgid ""
"If the bug submitter disagrees with your decision to close the bug, they may "
"reopen it until you find an agreement on how to handle it. If you don't "
msgstr ""
# type: Content of: <chapter><section><section><orderedlist><listitem><para>
-#: pkgs.dbk:665
+#. type: Content of: <chapter><section><section><orderedlist><listitem><para>
+#: pkgs.dbk:671
msgid ""
"If the bug is real but it's caused by another package, just reassign the bug "
"to the right package. If you don't know which package it should be "
msgstr ""
# type: Content of: <chapter><section><section><orderedlist><listitem><para>
-#: pkgs.dbk:677
+#. type: Content of: <chapter><section><section><orderedlist><listitem><para>
+#: pkgs.dbk:683
msgid ""
"If the bug affects the operation of your package, please consider cloning "
"the bug and reassigning the clone to the package that really causes the "
msgstr ""
# type: Content of: <chapter><section><section><orderedlist><listitem><para>
-#: pkgs.dbk:687
+#. type: Content of: <chapter><section><section><orderedlist><listitem><para>
+#: pkgs.dbk:693
msgid ""
"Sometimes you also have to adjust the severity of the bug so that it matches "
"our definition of the severity. That's because people tend to inflate the "
msgstr ""
# type: Content of: <chapter><section><section><orderedlist><listitem><para>
-#: pkgs.dbk:695
+#. type: Content of: <chapter><section><section><orderedlist><listitem><para>
+#: pkgs.dbk:701
msgid ""
"If the bug is real but the same problem has already been reported by someone "
"else, then the two relevant bug reports should be merged into one using the "
msgstr ""
# type: Content of: <chapter><section><section><orderedlist><listitem><para>
-#: pkgs.dbk:706
+#. type: Content of: <chapter><section><section><orderedlist><listitem><para>
+#: pkgs.dbk:712
msgid ""
"The bug submitter may have forgotten to provide some information, in which "
"case you have to ask them for the required information. You may use the "
msgstr ""
# type: Content of: <chapter><section><section><orderedlist><listitem><para>
-#: pkgs.dbk:717
+#. type: Content of: <chapter><section><section><orderedlist><listitem><para>
+#: pkgs.dbk:723
msgid ""
"If the bug is related to the packaging, you just fix it. If you are not "
"able to fix it yourself, then tag the bug as <literal>help</literal>. You "
msgstr ""
# type: Content of: <chapter><section><section><orderedlist><listitem><para>
-#: pkgs.dbk:731
+#. type: Content of: <chapter><section><section><orderedlist><listitem><para>
+#: pkgs.dbk:737
msgid ""
"If you have fixed a bug in your local copy, or if a fix has been committed "
"to the CVS repository, you may tag the bug as <literal>pending</literal> to "
msgstr ""
# type: Content of: <chapter><section><section><orderedlist><listitem><para>
-#: pkgs.dbk:741
+#. type: Content of: <chapter><section><section><orderedlist><listitem><para>
+#: pkgs.dbk:747
msgid ""
"Once a corrected package is available in the archive, the bug should be "
"closed indicating the version in which it was fixed. This can be done "
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:750
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:756
msgid "When bugs are closed by new uploads"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:752
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:758
msgid ""
"As bugs and problems are fixed in your packages, it is your responsibility "
"as the package maintainer to close these bugs. However, you should not "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:760
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:766
msgid ""
"However, it's possible to avoid having to manually close bugs after the "
"upload — just list the fixed bugs in your <filename>debian/changelog</"
"software will close the bugs for you. For example:"
msgstr ""
-# type: Content of: <chapter><section><section><screen>
-#: pkgs.dbk:765
+#. type: Content of: <chapter><section><section><screen>
+#: pkgs.dbk:772
#, no-wrap
msgid ""
-"\n"
"acme-cannon (3.1415) unstable; urgency=low\n"
"\n"
" * Frobbed with options (closes: Bug#98339)\n"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:774
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:780
msgid ""
"Technically speaking, the following Perl regular expression describes how "
"bug closing changelogs are identified:"
msgstr ""
-# type: Content of: <chapter><section><section><screen>
-#: pkgs.dbk:777
+#. type: Content of: <chapter><section><section><screen>
+#: pkgs.dbk:784
#, no-wrap
-msgid ""
-"\n"
-" /closes:\\s*(?:bug)?\\#\\s*\\d+(?:,\\s*(?:bug)?\\#\\s*\\d+)*/ig\n"
+msgid " /closes:\\s*(?:bug)?\\#\\s*\\d+(?:,\\s*(?:bug)?\\#\\s*\\d+)*/ig\n"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:781
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:787
msgid ""
"We prefer the <literal>closes: #<replaceable>XXX</replaceable></literal> "
"syntax, as it is the most concise entry and the easiest to integrate with "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:790
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:796
msgid ""
"Historically, uploads identified as <link linkend=\"nmu\">Non-maintainer "
"upload (NMU)</link> were tagged <literal>fixed</literal> instead of being "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:796
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:802
msgid ""
"If you happen to mistype a bug number or forget a bug in the changelog "
"entries, don't hesitate to undo any damage the error caused. To reopen "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:808
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:814
msgid ""
"Bear in mind that it is not obligatory to close bugs using the changelog as "
"described above. If you simply want to close bugs that don't have anything "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:816
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:822
msgid ""
"For general information on how to write your changelog entries, see <xref "
"linkend=\"bpp-debian-changelog\"/> ."
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:822
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:828
msgid "Handling security-related bugs"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:824
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:830
msgid ""
"Due to their sensitive nature, security-related bugs must be handled "
"carefully. The Debian Security Team exists to coordinate this activity, "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:831
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:837
msgid ""
"When you become aware of a security-related bug in a Debian package, whether "
"or not you are the maintainer, collect pertinent information about the "
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:841
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:847
msgid ""
"Which versions of the package are known to be affected by the bug. Check "
"each version that is present in a supported Debian release, as well as "
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:848
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:854
msgid ""
"The nature of the fix, if any is available (patches are especially helpful)"
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:853
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:859
msgid ""
"Any fixed packages that you have prepared yourself (send only the <literal>."
"diff.gz</literal> and <literal>.dsc</literal> files and read <xref linkend="
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:860
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:866
msgid ""
"Any assistance you can provide to help with testing (exploits, regression "
"testing, etc.)"
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:866
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:872
msgid ""
"Any information needed for the advisory (see <xref linkend=\"bug-security-"
"advisories\"/> )"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:871
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:877
msgid ""
"As the maintainer of the package, you have the responsibility to maintain "
"it, even in the stable release. You are in the best position to evaluate "
msgstr ""
# type: Content of: <chapter><section><section><section><title>
-#: pkgs.dbk:877
+#. type: Content of: <chapter><section><section><section><title>
+#: pkgs.dbk:883
msgid "The Security Tracker"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:879
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:885
msgid ""
"The security team maintains a central database, the <ulink url=\"http://"
"security-tracker.debian.net/\">Debian Security Tracker</ulink>. This "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:887
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:893
msgid ""
"You can search it for a specific issue, but also on package name. Look for "
"your package to see which issues are still open. If you can, please provide "
msgstr ""
# type: Content of: <chapter><section><section><section><title>
-#: pkgs.dbk:895
+#. type: Content of: <chapter><section><section><section><title>
+#: pkgs.dbk:901
msgid "Confidentiality"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:897
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:903
msgid ""
"Unlike most other activities within Debian, information about security "
"issues must sometimes be kept private for a time. This allows software "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:904
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:910
msgid "There are several ways developers can learn of a security problem:"
msgstr ""
# type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:909
+#. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:915
msgid "they notice it on a public forum (mailing list, web site, etc.)"
msgstr ""
# type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:914
+#. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:920
msgid "someone files a bug report"
msgstr ""
# type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:919
+#. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:925
msgid "someone informs them via private email"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:924
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:930
msgid ""
"In the first two cases, the information is public and it is important to "
"have a fix as soon as possible. In the last case, however, it might not be "
msgstr ""
# type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:932
+#. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:938
msgid ""
"If the security exposure is minor, there is sometimes no need to keep the "
"problem a secret and a fix should be made and released."
msgstr ""
# type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:938
+#. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:944
msgid ""
"If the problem is severe, it is preferable to share the information with "
"other vendors and coordinate a release. The security team keeps in contact "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:945
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:951
msgid ""
"In all cases if the person who reports the problem asks that it not be "
"disclosed, such requests should be honored, with the obvious exception of "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:952
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:958
msgid ""
"Please note that if secrecy is needed you may not upload a fix to "
"<literal>unstable</literal> (or anywhere else, such as a public CVS "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:959
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:965
msgid ""
"There are two reasons for releasing information even though secrecy is "
"requested: the problem has been known for a while, or the problem or exploit "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:964
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:970
msgid ""
"The Security Team has a PGP-key to enable encrypted communication about "
"sensitive issues. See the <ulink url=\"http://www.debian.org/security/faq.en."
msgstr ""
# type: Content of: <chapter><section><section><section><title>
-#: pkgs.dbk:970
+#. type: Content of: <chapter><section><section><section><title>
+#: pkgs.dbk:976
msgid "Security Advisories"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:972
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:978
msgid ""
"Security advisories are only issued for the current, released stable "
"distribution, and <emphasis>not</emphasis> for <literal>testing</literal> or "
msgstr ""
# type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:985
+#. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:991
msgid "A description of the problem and its scope, including:"
msgstr ""
# type: Content of: <chapter><section><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
-#: pkgs.dbk:990
+#. type: Content of: <chapter><section><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
+#: pkgs.dbk:996
msgid "The type of problem (privilege escalation, denial of service, etc.)"
msgstr ""
# type: Content of: <chapter><section><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
-#: pkgs.dbk:995
+#. type: Content of: <chapter><section><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
+#: pkgs.dbk:1001
msgid "What privileges may be gained, and by whom (if any)"
msgstr ""
# type: Content of: <chapter><section><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
-#: pkgs.dbk:1000
+#. type: Content of: <chapter><section><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
+#: pkgs.dbk:1006
msgid "How it can be exploited"
msgstr ""
# type: Content of: <chapter><section><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
-#: pkgs.dbk:1005
+#. type: Content of: <chapter><section><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
+#: pkgs.dbk:1011
msgid "Whether it is remotely or locally exploitable"
msgstr ""
# type: Content of: <chapter><section><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
-#: pkgs.dbk:1010
+#. type: Content of: <chapter><section><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
+#: pkgs.dbk:1016
msgid "How the problem was fixed"
msgstr ""
# type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:1015
+#. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:1021
msgid "This information allows users to assess the threat to their systems."
msgstr ""
# type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:1020
+#. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:1026
msgid "Version numbers of affected packages"
msgstr ""
# type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:1025
+#. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:1031
msgid "Version numbers of fixed packages"
msgstr ""
# type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:1030
+#. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:1036
msgid ""
"Information on where to obtain the updated packages (usually from the Debian "
"security archive)"
msgstr ""
# type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:1036
+#. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:1042
msgid ""
"References to upstream advisories, <ulink url=\"http://cve.mitre.org\">CVE</"
"ulink> identifiers, and any other information useful in cross-referencing "
msgstr ""
# type: Content of: <chapter><section><section><section><title>
-#: pkgs.dbk:1045
+#. type: Content of: <chapter><section><section><section><title>
+#: pkgs.dbk:1051
msgid "Preparing packages to address security issues"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1047
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1053
msgid ""
"One way that you can assist the security team in their duties is to provide "
"them with fixed packages suitable for a security advisory for the stable "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1052
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1058
msgid ""
"When an update is made to the stable release, care must be taken to avoid "
"changing system behavior or introducing new bugs. In order to do this, make "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1060
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1066
msgid ""
"This means that moving to a new upstream version is not a good solution. "
"Instead, the relevant changes should be back-ported to the version present "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1066
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1072
msgid ""
"In some cases, it is not possible to back-port a security fix, for example "
"when large amounts of source code need to be modified or rewritten. If this "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1073
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1079
msgid ""
"Related to this is another important guideline: always test your changes. "
"If you have an exploit available, try it and see if it indeed succeeds on "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1080
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1086
msgid ""
"Do <emphasis role=\"strong\">NOT</emphasis> include any changes in your "
"package which are not directly related to fixing the vulnerability. These "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1090
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1096
msgid ""
"Review and test your changes as much as possible. Check the differences "
"from the previous version repeatedly (<command>interdiff</command> from the "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1098
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1104
msgid "Be sure to verify the following items:"
msgstr ""
# type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:1103
+#. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:1109
msgid ""
"<emphasis role=\"strong\">Target the right distribution</emphasis> in your "
"<filename>debian/changelog</filename>. For <literal>stable</literal> this "
msgstr ""
# type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:1114
+#. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:1120
msgid ""
"The upload should have <emphasis role=\"strong\">urgency=high</emphasis>."
msgstr ""
# type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:1119
+#. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:1125
msgid ""
"Make descriptive, meaningful changelog entries. Others will rely on them to "
"determine whether a particular bug was fixed. Add <literal>closes:</"
msgstr ""
# type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:1130
+#. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:1136
msgid ""
"Make sure the <emphasis role=\"strong\">version number</emphasis> is "
"proper. It must be greater than the current package, but less than package "
msgstr ""
# type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:1143
+#. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:1149
msgid ""
"Unless the upstream source has been uploaded to <literal>security.debian.org "
"</literal> before (by a previous security update), build the upload "
msgstr ""
# type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:1153
+#. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:1159
msgid ""
"Be sure to use the <emphasis role=\"strong\">exact same <filename>*.orig.tar."
"gz</filename></emphasis> as used in the normal archive, otherwise it is not "
msgstr ""
# type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:1161
+#. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:1167
msgid ""
"Build the package on a <emphasis role=\"strong\">clean system</emphasis> "
"which only has packages installed from the distribution you are building "
msgstr ""
# type: Content of: <chapter><section><section><section><title>
-#: pkgs.dbk:1172
+#. type: Content of: <chapter><section><section><section><title>
+#: pkgs.dbk:1178
msgid "Uploading the fixed package"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1174
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1180
msgid ""
"Do <emphasis role=\"strong\">NOT</emphasis> upload a package to the security "
"upload queue (<literal>oldstable-security</literal>, <literal>stable-"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1181
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1187
msgid ""
"Do <emphasis role=\"strong\">NOT</emphasis> upload your fix to <literal> "
"proposed-updates</literal> without coordinating with the security team. "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1191
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1197
msgid ""
"Once you have created and tested the new package and it has been approved by "
"the security team, it needs to be uploaded so that it can be installed in "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1197
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1203
msgid ""
"Once an upload to the security queue has been accepted, the package will "
"automatically be built for all architectures and stored for verification by "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1202
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1208
msgid ""
"Uploads which are waiting for acceptance or verification are only accessible "
"by the security team. This is necessary since there might be fixes for "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1207
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1213
msgid ""
"If a member of the security team accepts a package, it will be installed on "
"<literal>security.debian.org</literal> as well as proposed for the proper "
msgstr ""
# type: Content of: <chapter><section><title>
-#: pkgs.dbk:1219
+#. type: Content of: <chapter><section><title>
+#: pkgs.dbk:1225
msgid "Moving, removing, renaming, adopting, and orphaning packages"
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:1221
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:1227
msgid ""
"Some archive manipulation operations are not automated in the Debian upload "
"process. These procedures should be manually followed by maintainers. This "
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:1226
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:1232
msgid "Moving packages"
msgstr ""
-# type: Content of: <chapter><section><section><para><footnote>
-#: pkgs.dbk:1228
-msgid ""
-"Sometimes a package will change its section. For instance, a package from "
-"the `non-free' section might be GPL'd in a later version, in which case the "
-"package should be moved to `main' or `contrib'.<footnote>"
-msgstr ""
-
# type: Content of: <chapter><section><section><para><footnote><para>
-#: pkgs.dbk:1230
+#. type: Content of: <chapter><section><section><para><footnote><para>
+#: pkgs.dbk:1236
msgid ""
"See the <ulink url=\"&url-debian-policy;\">Debian Policy Manual</ulink> for "
"guidelines on what section a package belongs in."
msgstr ""
-# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1232 pkgs.dbk:1664
-msgid "</footnote>"
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1234
+msgid ""
+"Sometimes a package will change its section. For instance, a package from "
+"the `non-free' section might be GPL'd in a later version, in which case the "
+"package should be moved to `main' or `contrib'.<placeholder type=\"footnote"
+"\" id=\"0\"/>"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1235
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1241
msgid ""
"If you need to change the section for one of your packages, change the "
"package control information to place the package in the desired section, and "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1247
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1253
msgid ""
"If, on the other hand, you need to change the <literal>subsection</literal> "
"of one of your packages (e.g., ``devel'', ``admin''), the procedure is "
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:1256
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:1262
msgid "Removing packages"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1258
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1264
msgid ""
"If for some reason you want to completely remove a package (say, if it is an "
"old compatibility library which is no longer required), you need to file a "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1275
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1281
msgid ""
"If you want to remove a package you maintain, you should note this in the "
"bug title by prepending <literal>ROM</literal> (Request Of Maintainer). "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1284
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1290
msgid ""
"Note that removals can only be done for the <literal>unstable </literal>, "
"<literal>experimental</literal> and <literal>stable </literal> "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1293
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1299
msgid ""
"There is one exception when an explicit removal request is not necessary: If "
"a (source or binary) package is an orphan, it will be removed semi-"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1302
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1308
msgid ""
"In your removal request, you have to detail the reasons justifying the "
"request. This is to avoid unwanted removals and to keep a trace of why a "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1308
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1314
msgid ""
"Usually you only ask for the removal of a package maintained by yourself. "
"If you want to remove another package, you have to get the approval of its "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1318
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1324
msgid ""
"Further information relating to these and other package removal related "
"topics may be found at <ulink url=\"http://wiki.debian.org/ftpmaster_Removals"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1323
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1329
msgid ""
"If in doubt concerning whether a package is disposable, email &email-debian-"
"devel; asking for opinions. Also of interest is the <command>apt-cache</"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1336
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1342
msgid ""
"Once the package has been removed, the package's bugs should be handled. "
"They should either be reassigned to another package in the case where the "
msgstr ""
# type: Content of: <chapter><section><section><section><title>
-#: pkgs.dbk:1343
+#. type: Content of: <chapter><section><section><section><title>
+#: pkgs.dbk:1349
msgid "Removing packages from <filename>Incoming</filename>"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1345
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1351
msgid ""
"In the past, it was possible to remove packages from <filename>incoming</"
"filename>. However, with the introduction of the new incoming system, this "
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:1360
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:1366
msgid "Replacing or renaming packages"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1362
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1368
msgid ""
"When the upstream maintainers for one of your packages chose to rename their "
"software (or you made a mistake naming your package), you should follow a "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1378
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1384
msgid ""
"At other times, you may make a mistake in constructing your package and wish "
"to replace it. The only way to do this is to increase the version number "
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:1392
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:1398
msgid "Orphaning a package"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1394
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1400
msgid ""
"If you can no longer maintain a package, you need to inform others, and see "
"that the package is marked as orphaned. You should set the package "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1409
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1415
msgid ""
"If you just intend to give the package away, but you can keep maintainership "
"for the moment, then you should instead submit a bug against <systemitem "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1417
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1423
msgid ""
"More information is on the <ulink url=\"&url-wnpp;\">WNPP web pages</ulink>."
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:1423
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:1429
msgid "Adopting a package"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1425
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1431
msgid ""
"A list of packages in need of a new maintainer is available in the <ulink "
"url=\"&url-wnpp;\">Work-Needing and Prospective Packages list (WNPP)</"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1432
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1438
msgid ""
"It is not OK to simply take over a package that you feel is neglected — that "
"would be package hijacking. You can, of course, contact the current "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1438
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1444
msgid ""
"Generally, you may not take over the package without the assent of the "
"current maintainer. Even if they ignore you, that is still not grounds to "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1448
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1454
msgid ""
"If you take over an old package, you probably want to be listed as the "
"package's official maintainer in the bug system. This will happen "
msgstr ""
# type: Content of: <chapter><section><title>
-#: pkgs.dbk:1462
+#. type: Content of: <chapter><section><title>
+#: pkgs.dbk:1468
msgid "Porting and being ported"
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:1464
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:1470
msgid ""
"Debian supports an ever-increasing number of architectures. Even if you are "
"not a porter, and you don't use any architecture but one, it is part of your "
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:1470
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:1476
msgid ""
"Porting is the act of building Debian packages for architectures that are "
"different from the original architecture of the package maintainer's binary "
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:1479
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:1485
msgid "Being kind to porters"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1481
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1487
msgid ""
"Porters have a difficult and unique task, since they are required to deal "
"with a large volume of packages. Ideally, every source package should build "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1489
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1495
msgid ""
"The first and most important thing is to respond quickly to bug or issues "
"raised by porters. Please treat porters with courtesy, as if they were in "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1496
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1502
msgid ""
"By far, most of the problems encountered by porters are caused by "
"<emphasis>packaging bugs</emphasis> in the source packages. Here is a "
msgstr ""
# type: Content of: <chapter><section><section><orderedlist><listitem><para>
-#: pkgs.dbk:1503
+#. type: Content of: <chapter><section><section><orderedlist><listitem><para>
+#: pkgs.dbk:1509
msgid ""
"Make sure that your <literal>Build-Depends</literal> and <literal>Build-"
"Depends-Indep</literal> settings in <filename>debian/control</filename> are "
msgstr ""
# type: Content of: <chapter><section><section><orderedlist><listitem><para>
-#: pkgs.dbk:1518
+#. type: Content of: <chapter><section><section><orderedlist><listitem><para>
+#: pkgs.dbk:1524
msgid ""
"If you can't set up a proper chroot, <command>dpkg-depcheck</command> may be "
"of assistance (see <xref linkend=\"dpkg-depcheck\"/> )."
msgstr ""
# type: Content of: <chapter><section><section><orderedlist><listitem><para>
-#: pkgs.dbk:1522
+#. type: Content of: <chapter><section><section><orderedlist><listitem><para>
+#: pkgs.dbk:1528
msgid ""
"See the <ulink url=\"&url-debian-policy;\">Debian Policy Manual</ulink> for "
"instructions on setting build dependencies."
msgstr ""
# type: Content of: <chapter><section><section><orderedlist><listitem><para>
-#: pkgs.dbk:1528
+#. type: Content of: <chapter><section><section><orderedlist><listitem><para>
+#: pkgs.dbk:1534
msgid ""
"Don't set architecture to a value other than <literal>all</literal> or "
"<literal>any</literal> unless you really mean it. In too many cases, "
msgstr ""
# type: Content of: <chapter><section><section><orderedlist><listitem><para>
-#: pkgs.dbk:1538
+#. type: Content of: <chapter><section><section><orderedlist><listitem><para>
+#: pkgs.dbk:1544
msgid ""
"Make sure your source package is correct. Do <literal>dpkg-source -x "
"<replaceable>package</replaceable>.dsc</literal> to make sure your source "
msgstr ""
# type: Content of: <chapter><section><section><orderedlist><listitem><para>
-#: pkgs.dbk:1546
+#. type: Content of: <chapter><section><section><orderedlist><listitem><para>
+#: pkgs.dbk:1552
msgid ""
"Make sure you don't ship your source package with the <filename>debian/"
"files</filename> or <filename>debian/substvars</filename> files. They "
msgstr ""
# type: Content of: <chapter><section><section><orderedlist><listitem><para>
-#: pkgs.dbk:1554
+#. type: Content of: <chapter><section><section><orderedlist><listitem><para>
+#: pkgs.dbk:1560
msgid ""
"Make sure you don't rely on locally installed or hacked configurations or "
"programs. For instance, you should never be calling programs in <filename>/"
msgstr ""
# type: Content of: <chapter><section><section><orderedlist><listitem><para>
-#: pkgs.dbk:1563
+#. type: Content of: <chapter><section><section><orderedlist><listitem><para>
+#: pkgs.dbk:1569
msgid ""
"Don't depend on the package you're building being installed already (a sub-"
"case of the above issue). There are, of course, exceptions to this rule, but "
msgstr ""
# type: Content of: <chapter><section><section><orderedlist><listitem><para>
-#: pkgs.dbk:1571
+#. type: Content of: <chapter><section><section><orderedlist><listitem><para>
+#: pkgs.dbk:1577
msgid ""
"Don't rely on the compiler being a certain version, if possible. If not, "
"then make sure your build dependencies reflect the restrictions, although "
msgstr ""
# type: Content of: <chapter><section><section><orderedlist><listitem><para>
-#: pkgs.dbk:1579
+#. type: Content of: <chapter><section><section><orderedlist><listitem><para>
+#: pkgs.dbk:1585
msgid ""
"Make sure your debian/rules contains separate <literal>binary-arch</literal> "
"and <literal>binary-indep</literal> targets, as the Debian Policy Manual "
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:1590
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:1596
msgid "Guidelines for porter uploads"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1592
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1598
msgid ""
"If the package builds out of the box for the architecture to be ported to, "
"you are in luck and your job is easy. This section applies to that case; it "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1600
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1606
msgid ""
"For a porter upload, no changes are being made to the source. You do not "
"need to touch any of the files in the source package. This includes "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1605
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1611
msgid ""
"The way to invoke <command>dpkg-buildpackage</command> is as <literal>dpkg-"
"buildpackage -B -m<replaceable>porter-email</replaceable></literal>. Of "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1614
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1620
msgid ""
"If you are working on a Debian machine for your porting efforts and you need "
"to sign your upload locally for its acceptance in the archive, you can run "
msgstr ""
# type: Content of: <chapter><section><section><section><title>
-#: pkgs.dbk:1621
+#. type: Content of: <chapter><section><section><section><title>
+#: pkgs.dbk:1627
msgid "Recompilation or binary-only NMU"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1623
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1629
msgid ""
"Sometimes the initial porter upload is problematic because the environment "
"in which the package was built was not good enough (outdated or obsolete "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1632
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1638
msgid ""
"You have to make sure that your binary-only NMU doesn't render the package "
"uninstallable. This could happen when a source package generates arch-"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1639
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1645
msgid ""
"Despite the required modification of the changelog, these are called binary-"
"only NMUs — there is no need in this case to trigger all other architectures "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1644
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1650
msgid ""
"Such recompilations require special ``magic'' version numbering, so that the "
"archive maintenance tools recognize that, even though there is a new Debian "
"corresponding source code)."
msgstr ""
-# type: Content of: <chapter><section><section><section><para><footnote>
-#: pkgs.dbk:1651
+# type: Content of: <chapter><section><section><section><para><footnote><para>
+#. type: Content of: <chapter><section><section><section><para><footnote><para>
+#: pkgs.dbk:1665
+msgid ""
+"In the past, such NMUs used the third-level number on the Debian part of the "
+"revision to denote their recompilation-only status; however, this syntax was "
+"ambiguous with native packages and did not allow proper ordering of "
+"recompile-only NMUs, source NMUs, and security NMUs on the same package, and "
+"has therefore been abandoned in favor of this new syntax."
+msgstr ""
+
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1657
msgid ""
"The ``magic'' for a recompilation-only NMU is triggered by using a suffix "
"appended to the package version number, following the form <literal> "
"your binary-only NMU should carry a version of <literal>2.9-3+b1</literal>. "
"If the latest version was <literal>3.4+b1 </literal> (i.e, a native package "
"with a previous recompilation NMU), your binary-only NMU should have a "
-"version number of <literal>3.4+b2</literal>. <footnote>"
-msgstr ""
-
-# type: Content of: <chapter><section><section><section><para><footnote><para>
-#: pkgs.dbk:1659
-msgid ""
-"In the past, such NMUs used the third-level number on the Debian part of the "
-"revision to denote their recompilation-only status; however, this syntax was "
-"ambiguous with native packages and did not allow proper ordering of "
-"recompile-only NMUs, source NMUs, and security NMUs on the same package, and "
-"has therefore been abandoned in favor of this new syntax."
+"version number of <literal>3.4+b2</literal>. <placeholder type=\"footnote\" "
+"id=\"0\"/>"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1667
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1673
msgid ""
"Similar to initial porter uploads, the correct way of invoking <command>dpkg-"
"buildpackage</command> is <literal>dpkg-buildpackage -B</literal> to only "
msgstr ""
# type: Content of: <chapter><section><section><section><title>
-#: pkgs.dbk:1674
+#. type: Content of: <chapter><section><section><section><title>
+#: pkgs.dbk:1680
msgid "When to do a source NMU if you are a porter"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1676
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1682
msgid ""
"Porters doing a source NMU generally follow the guidelines found in <xref "
"linkend=\"nmu\"/> , just like non-porters. However, it is expected that the "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1685
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1691
msgid ""
"If you are a porter doing an NMU for <literal>unstable</literal>, the above "
"guidelines for porting should be followed, with two variations. Firstly, "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1697
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1703
msgid ""
"Secondly, porters doing source NMUs should make sure that the bug they "
"submit to the BTS should be of severity <literal>serious</literal> or "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1705
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1711
msgid ""
"Porters should try to avoid patches which simply kludge around bugs in the "
"current version of the compile environment, kernel, or libc. Sometimes such "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1713
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1719
msgid ""
"Porters may also have an unofficial location where they can put the results "
"of their work during the waiting period. This helps others running the port "
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:1723
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:1729
msgid "Porting infrastructure and automation"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1725
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1731
msgid ""
"There is infrastructure and several tools to help automate package porting. "
"This section contains a brief overview of this automation and porting to "
msgstr ""
# type: Content of: <chapter><section><section><section><title>
-#: pkgs.dbk:1730
+#. type: Content of: <chapter><section><section><section><title>
+#: pkgs.dbk:1736
msgid "Mailing lists and web pages"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1732
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1738
msgid ""
"Web pages containing the status of each port can be found at <ulink url="
"\"&url-debian-ports;\"></ulink>."
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1736
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1742
msgid ""
"Each port of Debian has a mailing list. The list of porting mailing lists "
"can be found at <ulink url=\"&url-debian-port-lists;\"></ulink>. These "
msgstr ""
# type: Content of: <chapter><section><section><section><title>
-#: pkgs.dbk:1744
+#. type: Content of: <chapter><section><section><section><title>
+#: pkgs.dbk:1750
msgid "Porter tools"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1746
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1752
msgid ""
"Descriptions of several porting tools can be found in <xref linkend=\"tools-"
"porting\"/> ."
msgstr ""
# type: Content of: <chapter><section><section><section><title>
-#: pkgs.dbk:1752
+#. type: Content of: <chapter><section><section><section><title>
+#: pkgs.dbk:1758
msgid "<systemitem role=\"package\">wanna-build</systemitem>"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1754
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1760
msgid ""
"The <systemitem role=\"package\">wanna-build</systemitem> system is used as "
"a distributed, client-server build distribution system. It is usually used "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1762
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1768
msgid ""
"<systemitem role=\"package\">wanna-build</systemitem> is not yet available "
"as a package; however, all Debian porting efforts are using it for automated "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1771
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1777
msgid ""
"Most of the data produced by <systemitem role=\"package\">wanna-build </"
"systemitem> which is generally useful to porters is available on the web at "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1777
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1783
msgid ""
"We are quite proud of this system, since it has so many possible uses. "
"Independent development groups can use the system for different sub-flavors "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1784
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1790
msgid ""
"The buildds admins of each arch can be contacted at the mail address "
"<literal><replaceable>arch</replaceable>@buildd.debian.org</literal>."
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:1792
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:1798
msgid "When your package is <emphasis>not</emphasis> portable"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1794
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1800
msgid ""
"Some packages still have issues with building and/or working on some of the "
"architectures supported by Debian, and cannot be ported at all, or not "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1801
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1807
msgid ""
"In order to prevent broken packages from being uploaded to the archive, and "
"wasting buildd time, you need to do a few things:"
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:1807
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:1813
msgid ""
"First, make sure your package <emphasis>does</emphasis> fail to build on "
"architectures that it cannot support. There are a few ways to achieve "
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:1815
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:1821
msgid ""
"Additionally, if you believe the list of supported architectures is pretty "
"constant, you should change <literal>any</literal> to a list of supported "
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:1823
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:1829
msgid ""
"In order to prevent autobuilders from needlessly trying to build your "
"package, it must be included in <filename>packages-arch-specific</filename>, "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1833
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1839
msgid ""
"Please note that it is insufficient to only add your package to Packages-"
"arch-specific without making it fail to build on unsupported architectures: "
msgstr ""
# type: Content of: <chapter><section><title>
-#: pkgs.dbk:1846
+#. type: Content of: <chapter><section><title>
+#: pkgs.dbk:1852
msgid "Non-Maintainer Uploads (NMUs)"
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:1848
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:1854
msgid ""
"Every package has one or more maintainers. Normally, these are the people "
"who work on and upload new versions of the package. In some situations, it "
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:1857
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:1863
msgid "When and how to do an NMU"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1860
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1866
msgid "Before doing an NMU, consider the following questions:"
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:1865
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:1871
msgid ""
"Does your NMU really fix bugs? Fixing cosmetic issues or changing the "
"packaging style in NMUs is discouraged."
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:1871
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:1877
msgid ""
"Did you give enough time to the maintainer? When was the bug reported to the "
"BTS? Being busy for a week or two isn't unusual. Is the bug so severe that "
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:1878
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:1884
msgid ""
"How confident are you about your changes? Please remember the Hippocratic "
"Oath: \"Above all, do no harm.\" It is better to leave a package with an "
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:1888
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:1894
msgid ""
"Have you clearly expressed your intention to NMU, at least in the BTS? It is "
"also a good idea to try to contact the maintainer by other means (private "
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:1895
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:1901
msgid ""
"If the maintainer is usually active and responsive, have you tried to "
"contact him? In general it should be considered preferable that a maintainer "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1905
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1911
msgid ""
"When doing an NMU, you must first make sure that your intention to NMU is "
"clear. Then, you must send a patch with the differences between the current "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1912
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1918
msgid ""
"While preparing the patch, you should better be aware of any package-"
"specific practices that the maintainer might be using. Taking them into "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1920
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1926
msgid ""
"Unless you have an excellent reason not to do so, you must then give some "
"time to the maintainer to react (for example, by uploading to the "
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:1927
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:1933
msgid "Upload fixing only release-critical bugs older than 7 days: 2 days"
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:1932
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:1938
msgid "Upload fixing only release-critical and important bugs: 5 days"
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:1937
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:1943
msgid "Other NMUs: 10 days"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1943
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1949
msgid ""
"Those delays are only examples. In some cases, such as uploads fixing "
"security issues, or fixes for trivial bugs that blocking a transition, it is "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1949
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1955
msgid ""
"Sometimes, release managers decide to allow NMUs with shorter delays for a "
"subset of bugs (e.g release-critical bugs older than 7 days). Also, some "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1959
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1965
msgid ""
"After you upload an NMU, you are responsible for the possible problems that "
"you might have introduced. You must keep an eye on the package (subscribing "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1965
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1971
msgid ""
"This is not a license to perform NMUs thoughtlessly. If you NMU when it is "
"clear that the maintainers are active and would have acknowledged a patch in "
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:1975
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:1981
msgid "NMUs and debian/changelog"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1977
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1983
msgid ""
"Just like any other (source) upload, NMUs must add an entry to "
"<literal>debian/changelog</literal>, telling what has changed with this "
"upload is an NMU, e.g.:"
msgstr ""
-# type: Content of: <chapter><section><section><screen>
-#: pkgs.dbk:1981
+#. type: Content of: <chapter><section><section><screen>
+#: pkgs.dbk:1988
#, no-wrap
-msgid ""
-"\n"
-" * Non-maintainer upload.\n"
+msgid " * Non-maintainer upload.\n"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1986
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1992
msgid ""
"The version must be the version of the last maintainer upload, plus <literal>"
"+nmu<replaceable>X</replaceable></literal>, where <replaceable>X</"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1999
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2005
msgid ""
"A special versioning scheme is needed to avoid disrupting the maintainer's "
"work, since using an integer for the Debian revision will potentially "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2009
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2015
msgid ""
"If you upload a package to testing or stable, you sometimes need to \"fork\" "
"the version number tree. This is the case for security uploads, for "
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:2031
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:2037
msgid "Using the <literal>DELAYED/</literal> queue"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2034
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2040
msgid ""
"Having to wait for a response after you request permission to NMU is "
"inefficient, because it costs the NMUer a context switch to come back to the "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2048
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2054
msgid ""
"The <literal>DELAYED</literal> queue should not be used to put additional "
"pressure on the maintainer. In particular, it's important that you are "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2055
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2061
msgid ""
"If you make an NMU to <literal>DELAYED</literal> and the maintainer updates "
"his package before the delay expires, your upload will be rejected because a "
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:2065
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:2071
msgid "NMUs from the maintainer's point of view"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2068
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2074
msgid ""
"When someone NMUs your package, this means they want to help you to keep it "
"in good shape. This gives users fixed packages faster. You can consider "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2077
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2083
msgid ""
"To acknowledge an NMU, include its changes and changelog entry in your next "
"maintainer upload. If you do not acknowledge the NMU by including the NMU "
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:2086
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:2092
msgid "Source NMUs vs Binary-only NMUs (binNMUs)"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2089
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2095
msgid ""
"The full name of an NMU is <emphasis>source NMU</emphasis>. There is also "
"another type, namely the <emphasis>binary-only NMU</emphasis>, or "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2096
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2102
msgid ""
"When a library (or other dependency) is updated, the packages using it may "
"need to be rebuilt. Since no changes to the source are needed, the same "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2102
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2108
msgid ""
"BinNMUs are usually triggered on the buildds by wanna-build. An entry is "
"added to debian/changelog, explaining why the upload was needed and "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2110
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2116
msgid ""
"Buildds upload packages for their architecture to the archive as binary-only "
"uploads. Strictly speaking, these are binNMUs. However, they are not "
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:2118
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:2124
msgid "NMUs vs QA uploads"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2121
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2127
msgid ""
"NMUs are uploads of packages by somebody else than their assigned "
"maintainer. There is another type of upload where the uploaded package is "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2128
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2134
msgid ""
"QA uploads are very much like normal maintainer uploads: they may fix "
"anything, even minor issues; the version numbering is normal, and there is "
"a QA upload has a special first line:"
msgstr ""
-# type: Content of: <chapter><section><section><screen>
-#: pkgs.dbk:2135
+#. type: Content of: <chapter><section><section><screen>
+#: pkgs.dbk:2142
#, no-wrap
-msgid ""
-"\n"
-" * QA upload.\n"
+msgid " * QA upload.\n"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2140
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2146
msgid ""
"If you want to do an NMU, and it seems that the maintainer is not active, it "
"is wise to check if the package is orphaned (this information is displayed "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2151
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2157
msgid ""
"Instead of doing a QA upload, you can also consider adopting the package by "
"making yourself the maintainer. You don't need permission from anybody to "
msgstr ""
# type: Content of: <chapter><section><title>
-#: pkgs.dbk:2162
+#. type: Content of: <chapter><section><title>
+#: pkgs.dbk:2168
msgid "Collaborative maintenance"
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:2164
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:2170
msgid ""
"Collaborative maintenance is a term describing the sharing of Debian package "
"maintenance duties by several people. This collaboration is almost always a "
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:2172
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:2178
msgid ""
"Generally there is a primary maintainer and one or more co-maintainers. The "
"primary maintainer is the person whose name is listed in the "
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:2180
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:2186
msgid ""
"In its most basic form, the process of adding a new co-maintainer is quite "
"easy:"
msgstr ""
# type: Content of: <chapter><section><itemizedlist><listitem><para>
-#: pkgs.dbk:2186
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
+#: pkgs.dbk:2192
msgid ""
"Setup the co-maintainer with access to the sources you build the package "
"from. Generally this implies you are using a network-capable version "
msgstr ""
# type: Content of: <chapter><section><itemizedlist><listitem><para>
-#: pkgs.dbk:2194
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
+#: pkgs.dbk:2200
msgid ""
"Add the co-maintainer's correct maintainer name and address to the "
"<literal>Uploaders</literal> field in the first paragraph of the "
"<filename>debian/control</filename> file."
msgstr ""
-# type: Content of: <chapter><section><itemizedlist><listitem><screen>
-#: pkgs.dbk:2198
+#. type: Content of: <chapter><section><itemizedlist><listitem><screen>
+#: pkgs.dbk:2205
#, no-wrap
-msgid ""
-"\n"
-"Uploaders: John Buzz <jbuzz@debian.org>, Adam Rex <arex@debian.org>\n"
+msgid "Uploaders: John Buzz <jbuzz@debian.org>, Adam Rex <arex@debian.org>\n"
msgstr ""
# type: Content of: <chapter><section><itemizedlist><listitem><para>
-#: pkgs.dbk:2204
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
+#: pkgs.dbk:2210
msgid ""
"Using the PTS (<xref linkend=\"pkg-tracking-system\"/> ), the co-maintainers "
"should subscribe themselves to the appropriate source package."
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:2210
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:2216
msgid ""
"Another form of collaborative maintenance is team maintenance, which is "
"recommended if you maintain several packages with the same group of "
msgstr ""
# type: Content of: <chapter><section><orderedlist><listitem><para>
-#: pkgs.dbk:2219
+#. type: Content of: <chapter><section><orderedlist><listitem><para>
+#: pkgs.dbk:2225
msgid ""
"Put the team member mainly responsible for the package in the Maintainer "
"field. In the Uploaders, put the mailing list address, and the team members "
msgstr ""
# type: Content of: <chapter><section><orderedlist><listitem><para>
-#: pkgs.dbk:2226
+#. type: Content of: <chapter><section><orderedlist><listitem><para>
+#: pkgs.dbk:2232
msgid ""
"Put the mailing list address in the Maintainer field. In the Uploaders "
"field, put the team members who care for the package. In this case, you "
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:2234
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:2240
msgid ""
"In any case, it is a bad idea to automatically put all team members in the "
"Uploaders field. It clutters the Developer's Package Overview listing (see "
msgstr ""
# type: Content of: <chapter><section><title>
-#: pkgs.dbk:2242
+#. type: Content of: <chapter><section><title>
+#: pkgs.dbk:2248
msgid "The testing distribution"
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:2244
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:2250
msgid "Basics"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2246
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2252
msgid ""
"Packages are usually installed into the <literal>testing</literal> "
"distribution after they have undergone some degree of <literal>testing</"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2251
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2257
msgid ""
"They must be in sync on all architectures and mustn't have dependencies that "
"make them uninstallable; they also have to have generally no known release-"
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:2260
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:2266
msgid "Updates from unstable"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2262
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2268
msgid ""
"The scripts that update the <literal>testing</literal> distribution are run "
"twice each day, right after the installation of the updated packages; these "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2270
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2276
msgid ""
"The inclusion of a package from <literal>unstable</literal> is conditional "
"on the following:"
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:2276
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:2282
msgid ""
"The package must have been available in <literal>unstable</literal> for 2, 5 "
"or 10 days, depending on the urgency (high, medium or low). Please note "
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:2286
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:2292
msgid ""
"It must not have new release-critical bugs (RC bugs affecting the version "
"available in <literal>unstable</literal>, but not affecting the version in "
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:2293
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:2299
msgid ""
"It must be available on all architectures on which it has previously been "
"built in <literal>unstable</literal>. <xref linkend=\"dak-ls\"/> may be of "
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:2300
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:2306
msgid ""
"It must not break any dependency of a package which is already available in "
"<literal>testing</literal>;"
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:2306
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:2312
msgid ""
"The packages on which it depends must either be available in "
"<literal>testing</literal> or they must be accepted into <literal>testing</"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2314
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2320
msgid ""
"To find out whether a package is progressing into <literal>testing</literal> "
"or not, see the <literal>testing</literal> script output on the <ulink url="
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2325
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2331
msgid ""
"The <filename>update_excuses</filename> file does not always give the "
"precise reason why the package is refused; you may have to find it on your "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2332
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2338
msgid ""
"Sometimes, some packages never enter <literal>testing</literal> because the "
"set of inter-relationship is too complicated and cannot be sorted out by the "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2337
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2343
msgid ""
"Some further dependency analysis is shown on <ulink url=\"http://release."
"debian.org/migration/\"></ulink> — but be warned, this page also shows build "
msgstr ""
# type: Content of: <chapter><section><section><section><title>
-#: pkgs.dbk:2342
+#. type: Content of: <chapter><section><section><section><title>
+#: pkgs.dbk:2348
msgid "out-of-date"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
#. FIXME: better rename this file than document rampant professionalism?
-#: pkgs.dbk:2345
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2351
msgid ""
"For the <literal>testing</literal> migration script, outdated means: There "
"are different versions in <literal>unstable</literal> for the release "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2353
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2359
msgid "Consider this example:"
msgstr ""
# type: Content of: <chapter><section><section><section><informaltable><tgroup><thead><row><entry>
-#: pkgs.dbk:2360 pkgs.dbk:2393
+#. type: Content of: <chapter><section><section><section><informaltable><tgroup><thead><row><entry>
+#: pkgs.dbk:2366 pkgs.dbk:2399
msgid "alpha"
msgstr ""
# type: Content of: <chapter><section><section><section><informaltable><tgroup><thead><row><entry>
-#: pkgs.dbk:2361 pkgs.dbk:2394
+#. type: Content of: <chapter><section><section><section><informaltable><tgroup><thead><row><entry>
+#: pkgs.dbk:2367 pkgs.dbk:2400
msgid "arm"
msgstr ""
# type: Content of: <chapter><section><section><section><informaltable><tgroup><thead><row><entry>
-#: pkgs.dbk:2366 pkgs.dbk:2400 pkgs.dbk:2462
+#. type: Content of: <chapter><section><section><section><informaltable><tgroup><thead><row><entry>
+#: pkgs.dbk:2372 pkgs.dbk:2406 pkgs.dbk:2468
msgid "testing"
msgstr ""
# type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
-#: pkgs.dbk:2367 pkgs.dbk:2372 pkgs.dbk:2401 pkgs.dbk:2402 pkgs.dbk:2409
+#. type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
+#: pkgs.dbk:2373 pkgs.dbk:2378 pkgs.dbk:2407 pkgs.dbk:2408 pkgs.dbk:2415
msgid "1"
msgstr ""
# type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
-#: pkgs.dbk:2368 pkgs.dbk:2403 pkgs.dbk:2408
+#. type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
+#: pkgs.dbk:2374 pkgs.dbk:2409 pkgs.dbk:2414
msgid "-"
msgstr ""
# type: Content of: <chapter><section><section><section><informaltable><tgroup><thead><row><entry>
-#: pkgs.dbk:2371 pkgs.dbk:2406 pkgs.dbk:2463
+#. type: Content of: <chapter><section><section><section><informaltable><tgroup><thead><row><entry>
+#: pkgs.dbk:2377 pkgs.dbk:2412 pkgs.dbk:2469
msgid "unstable"
msgstr ""
# type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
-#: pkgs.dbk:2373 pkgs.dbk:2407
+#. type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
+#: pkgs.dbk:2379 pkgs.dbk:2413
msgid "2"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2379
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2385
msgid ""
"The package is out of date on alpha in <literal>unstable</literal>, and will "
"not go to <literal>testing</literal>. Removing the package would not help at "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2385
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2391
msgid ""
"However, if ftp-master removes a package in <literal>unstable</literal> "
"(here on <literal>arm</literal>):"
msgstr ""
# type: Content of: <chapter><section><section><section><informaltable><tgroup><thead><row><entry>
-#: pkgs.dbk:2395
+#. type: Content of: <chapter><section><section><section><informaltable><tgroup><thead><row><entry>
+#: pkgs.dbk:2401
msgid "hurd-i386"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2415
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2421
msgid ""
"In this case, the package is up to date on all release architectures in "
"<literal>unstable</literal> (and the extra <literal>hurd-i386</literal> "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2420
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2426
msgid ""
"Sometimes, the question is raised if it is possible to allow packages in "
"that are not yet built on all architectures: No. Just plainly no. (Except "
msgstr ""
# type: Content of: <chapter><section><section><section><title>
-#: pkgs.dbk:2427
+#. type: Content of: <chapter><section><section><section><title>
+#: pkgs.dbk:2433
msgid "Removals from testing"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2429
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2435
msgid ""
"Sometimes, a package is removed to allow another package in: This happens "
"only to allow <emphasis>another</emphasis> package to go in if it's ready in "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2436
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2442
msgid ""
"Of course, there is another reason to remove a package from <literal>testing "
"</literal>: It's just too buggy (and having a single RC-bug is enough to be "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2441
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2447
msgid ""
"Furthermore, if a package has been removed from <literal>unstable</literal>, "
"and no package in <literal>testing</literal> depends on it any more, then it "
msgstr ""
# type: Content of: <chapter><section><section><section><title>
-#: pkgs.dbk:2448
+#. type: Content of: <chapter><section><section><section><title>
+#: pkgs.dbk:2454
msgid "circular dependencies"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2450
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2456
msgid ""
"A situation which is not handled very well by britney is if package "
"<literal>a</literal> depends on the new version of package <literal>b</"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2455
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2461
msgid "An example of this is:"
msgstr ""
# type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
-#: pkgs.dbk:2468
+#. type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
+#: pkgs.dbk:2474
msgid "a"
msgstr ""
# type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
-#: pkgs.dbk:2469
+#. type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
+#: pkgs.dbk:2475
msgid "1; depends: b=1"
msgstr ""
# type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
-#: pkgs.dbk:2470
+#. type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
+#: pkgs.dbk:2476
msgid "2; depends: b=2"
msgstr ""
# type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
-#: pkgs.dbk:2473
+#. type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
+#: pkgs.dbk:2479
msgid "b"
msgstr ""
# type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
-#: pkgs.dbk:2474
+#. type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
+#: pkgs.dbk:2480
msgid "1; depends: a=1"
msgstr ""
# type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
-#: pkgs.dbk:2475
+#. type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
+#: pkgs.dbk:2481
msgid "2; depends: a=2"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2481
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2487
msgid ""
"Neither package <literal>a</literal> nor package <literal>b</literal> is "
"considered for update."
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2485
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2491
msgid ""
"Currently, this requires some manual hinting from the release team. Please "
"contact them by sending mail to &email-debian-release; if this happens to "
msgstr ""
# type: Content of: <chapter><section><section><section><title>
-#: pkgs.dbk:2492
+#. type: Content of: <chapter><section><section><section><title>
+#: pkgs.dbk:2498
msgid "influence of package in testing"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2494
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2500
msgid ""
"Generally, there is nothing that the status of a package in <literal>testing "
"</literal> means for transition of the next version from <literal>unstable </"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2506
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2512
msgid ""
"In summary this means: The only influence that a package being in <literal> "
"testing</literal> has on a new version of the same package is that the new "
msgstr ""
# type: Content of: <chapter><section><section><section><title>
-#: pkgs.dbk:2513
+#. type: Content of: <chapter><section><section><section><title>
+#: pkgs.dbk:2519
msgid "details"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2515
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2521
msgid "If you are interested in details, this is how britney works:"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2518
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2524
msgid ""
"The packages are looked at to determine whether they are valid candidates. "
"This gives the update excuses. The most common reasons why a package is not "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2527
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2533
msgid ""
"Now, the more complex part happens: Britney tries to update <literal>testing "
"</literal> with the valid candidates. For that, britney tries to add each "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2537
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2543
msgid ""
"If you want to see more details, you can look it up on <filename>merkel:/org/"
"&ftp-debian-org;/testing/update_out/</filename> (or in <filename>merkel:~aba/"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2544
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2550
msgid ""
"The hints are available via <ulink url=\"http://&ftp-master-host;/testing/"
"hints/\"></ulink>."
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:2552
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:2558
msgid "Direct updates to testing"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2554
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2560
msgid ""
"The <literal>testing</literal> distribution is fed with packages from "
"<literal>unstable</literal> according to the rules explained above. "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2561
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2567
msgid ""
"Keep in mind that packages uploaded there are not automatically processed, "
"they have to go through the hands of the release manager. So you'd better "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2568
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2574
msgid ""
"You should not upload to <literal>testing-proposed-updates</literal> when "
"you can update your packages through <literal>unstable</literal>. If you "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2577
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2583
msgid ""
"Version numbers are usually selected by adding the codename of the "
"<literal>testing</literal> distribution and a running number, like "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2584
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2590
msgid "Please make sure you didn't miss any of these items in your upload:"
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:2589
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:2595
msgid ""
"Make sure that your package really needs to go through <literal>testing-"
"proposed-updates</literal>, and can't go through <literal> unstable</"
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:2596
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:2602
msgid "Make sure that you included only the minimal amount of changes;"
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:2601
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:2607
msgid ""
"Make sure that you included an appropriate explanation in the changelog;"
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:2606
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:2612
msgid ""
"Make sure that you've written <literal>testing</literal> or <literal>testing-"
"proposed-updates</literal> into your target distribution;"
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:2612
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:2618
msgid ""
"Make sure that you've built and tested your package in <literal>testing</"
"literal>, not in <literal>unstable</literal>;"
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:2618
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:2624
msgid ""
"Make sure that your version number is higher than the version in "
"<literal>testing</literal> and <literal>testing-proposed-updates</literal>, "
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:2625
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:2631
msgid ""
"After uploading and successful build on all platforms, contact the release "
"team at &email-debian-release; and ask them to approve your upload."
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:2633
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:2639
msgid "Frequently asked questions"
msgstr ""
# type: Content of: <chapter><section><section><section><title>
-#: pkgs.dbk:2635
+#. type: Content of: <chapter><section><section><section><title>
+#: pkgs.dbk:2641
msgid "What are release-critical bugs, and how do they get counted?"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2637
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2643
msgid ""
"All bugs of some higher severities are by default considered release-"
"critical; currently, these are <literal>critical</literal>, <literal>grave</"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2642
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2648
msgid ""
"Such bugs are presumed to have an impact on the chances that the package "
"will be released with the <literal>stable</literal> release of Debian: in "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2649
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2655
msgid ""
"The <literal>unstable</literal> bug count are all release-critical bugs "
"which are marked to apply to <replaceable>package</replaceable>/"
msgstr ""
# type: Content of: <chapter><section><section><section><title>
-#: pkgs.dbk:2657
+#. type: Content of: <chapter><section><section><section><title>
+#: pkgs.dbk:2663
msgid ""
"How could installing a package into <literal>testing</literal> possibly "
"break other packages?"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2660
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2666
msgid ""
"The structure of the distribution archives is such that they can only "
"contain one version of a package; a package is defined by its name. So when "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2668
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2674
msgid ""
"However, the old version may have provided a binary package with an old "
"soname of a library, such as <literal>libacme-foo0</literal>. Removing the "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2674
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2680
msgid ""
"Evidently, this mainly affects packages which provide changing sets of "
"binary packages in different versions (in turn, mainly libraries). However, "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2680
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2686
msgid ""
"When the set of binary packages provided by a source package change in this "
"way, all the packages that depended on the old binaries will have to be "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2691
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2697
msgid ""
"If you are having problems with complicated groups of packages like this, "
"contact &email-debian-devel; or &email-debian-release; for help."
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2008-08-08 11:36-0300\n"
+"POT-Creation-Date: 2009-06-25 22:00+0300\n"
"PO-Revision-Date: 2007-07-01 23:16+0000\n"
"Last-Translator: <>\n"
"Language-Team: \n"
"Content-Transfer-Encoding: \n"
# type: Content of: <chapter><title>
+#. type: Content of: <chapter><title>
#: resources.dbk:7
msgid "Resources for Debian Developers"
msgstr "Ressources pour le responsable Debian"
# type: Content of: <chapter><para>
+#. type: Content of: <chapter><para>
#: resources.dbk:9
msgid ""
"In this chapter you will find a very brief road map of the Debian mailing "
"pour vous aider dans votre travail de responsable."
# type: Content of: <chapter><section><title>
+#. type: Content of: <chapter><section><title>
#: resources.dbk:14
msgid "Mailing lists"
msgstr "Les listes de diffusion"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:16
msgid ""
"Much of the conversation between Debian developers (and users) is managed "
msgstr ""
# type: Content of: <chapter><section><section><title>
+#. type: Content of: <chapter><section><section><title>
#: resources.dbk:27
msgid "Basic rules for use"
msgstr ""
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:29
msgid ""
"When replying to messages on the mailing list, please do not send a carbon "
msgstr ""
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:35
msgid ""
"Cross-posting (sending the same message to multiple lists) is discouraged. "
msgstr ""
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:40
msgid ""
"Please read the <ulink url=\"&url-debian-lists;#codeofconduct\">code of "
msgstr ""
# type: Content of: <chapter><section><section><title>
+#. type: Content of: <chapter><section><section><title>
#: resources.dbk:48
msgid "Core development mailing lists"
msgstr ""
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:50
msgid "The core Debian mailing lists that developers should use are:"
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
#: resources.dbk:55
msgid ""
"&email-debian-devel-announce;, used to announce important things to "
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
#: resources.dbk:62
msgid ""
"&email-debian-devel;, used to discuss various development related technical "
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
#: resources.dbk:68
msgid ""
"&email-debian-policy;, where the Debian Policy is discussed and voted on."
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
#: resources.dbk:74
msgid ""
"&email-debian-project;, used to discuss various non-technical issues related "
msgstr ""
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:80
msgid ""
"There are other mailing lists available for a variety of special topics; see "
msgstr ""
# type: Content of: <chapter><section><section><title>
+#. type: Content of: <chapter><section><section><title>
#: resources.dbk:86
msgid "Special lists"
msgstr ""
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:88
msgid ""
"&email-debian-private; is a special mailing list for private discussions "
msgstr ""
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:100
msgid ""
"&email-debian-email; is a special mailing list used as a grab-bag for Debian "
msgstr ""
# type: Content of: <chapter><section><section><title>
+#. type: Content of: <chapter><section><section><title>
#: resources.dbk:108
msgid "Requesting new development-related lists"
msgstr ""
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:110
msgid ""
"Before requesting a mailing list that relates to the development of a "
msgstr ""
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:118
msgid ""
"If you decide that a regular mailing list on &lists-host; is really what you "
msgstr ""
# type: Content of: <chapter><section><title>
+#. type: Content of: <chapter><section><title>
#: resources.dbk:127
msgid "IRC channels"
msgstr ""
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:129
msgid ""
"Several IRC channels are dedicated to Debian's development. They are mainly "
msgstr ""
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:135
msgid ""
"The main channel for Debian in general is <literal>#debian</literal>. This "
msgstr ""
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:143
msgid ""
"The main channel for Debian development is <literal>#debian-devel</"
msgstr ""
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:151
msgid ""
"Since <literal>#debian-devel</literal> is an open channel, you should not "
msgstr ""
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:161
msgid ""
"There are other additional channels dedicated to specific subjects. "
msgstr ""
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:172
msgid ""
"Some non-English developers' channels exist as well, for example "
msgstr ""
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:177
msgid ""
"Channels dedicated to Debian also exist on other IRC networks, notably on "
msgstr ""
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:183
msgid ""
"To get a cloak on freenode, you send Jörg Jaspert <joerg@debian.org> a "
msgstr ""
# type: Content of: <chapter><section><title>
+#. type: Content of: <chapter><section><title>
#: resources.dbk:194
msgid "Documentation"
msgstr ""
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:196
msgid ""
"This document contains a lot of information which is useful to Debian "
msgstr ""
# type: Content of: <chapter><section><title>
+#. type: Content of: <chapter><section><title>
#: resources.dbk:205
msgid "Debian machines"
msgstr ""
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:207
msgid ""
"Debian has several computers working as servers, most of which serve "
msgstr ""
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:212
msgid ""
"Some of the machines are available for individual developers to use, as long "
msgstr ""
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:217
msgid ""
"Generally speaking, you can use these machines for Debian-related purposes "
msgstr ""
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:224
msgid ""
"Please take care to protect your Debian passwords and SSH keys installed on "
msgstr ""
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:229
msgid ""
"Please do not put any material that doesn't relate to Debian on the Debian "
msgstr ""
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:233
msgid ""
"The current list of Debian machines is available at <ulink url=\"&url-devel-"
msgstr ""
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:239
msgid ""
"If you have a problem with the operation of a Debian server, and you think "
msgstr ""
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:247
msgid ""
"If you have a problem with a certain service, not related to the system "
msgstr ""
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:254
msgid ""
"Some of the core servers are restricted, but the information from there is "
msgstr ""
# type: Content of: <chapter><section><section><title>
+#. type: Content of: <chapter><section><section><title>
#: resources.dbk:258
msgid "The bugs server"
msgstr ""
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:260
msgid ""
"<literal>&bugs-host;</literal> is the canonical location for the Bug "
msgstr ""
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:264 resources.dbk:282
msgid "It is restricted; a mirror is available on <literal>merkel</literal>."
msgstr ""
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:267
msgid ""
"If you plan on doing some statistical analysis or processing of Debian bugs, "
msgstr ""
# type: Content of: <chapter><section><section><title>
+#. type: Content of: <chapter><section><section><title>
#: resources.dbk:275
msgid "The ftp-master server"
msgstr ""
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:277
msgid ""
"The <literal>&ftp-master-host;</literal> server holds the canonical copy of "
msgstr ""
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:285
msgid ""
"Problems with the Debian FTP archive generally need to be reported as bugs "
msgstr ""
# type: Content of: <chapter><section><section><title>
+#. type: Content of: <chapter><section><section><title>
#: resources.dbk:293
msgid "The www-master server"
msgstr ""
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:295
msgid ""
"The main web server is <literal>www-master.debian.org</literal>. It holds "
msgstr ""
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:299
msgid ""
"If you find a problem with the Debian web server, you should generally "
msgstr ""
# type: Content of: <chapter><section><section><title>
+#. type: Content of: <chapter><section><section><title>
#: resources.dbk:308
msgid "The people web server"
msgstr ""
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:310
msgid ""
"<literal>people.debian.org</literal> is the server used for developers' own "
msgstr ""
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:314
msgid ""
"If you have some Debian-specific information which you want to serve on the "
msgstr ""
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:321
msgid ""
"You should only use this particular location because it will be backed up, "
msgstr ""
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:325
msgid ""
"Usually the only reason to use a different host is when you need to publish "
msgstr ""
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:330
msgid "Send mail to &email-debian-devel; if you have any questions."
msgstr ""
# type: Content of: <chapter><section><section><title>
+#. type: Content of: <chapter><section><section><title>
#: resources.dbk:335
msgid "The VCS servers"
msgstr ""
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:337
msgid ""
"If you need to use a Version Control System for any of your Debian work, you "
msgstr ""
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:348
msgid ""
"Historically, Debian first used <literal>cvs.debian.org</literal> to host "
msgstr ""
# type: Content of: <chapter><section><section><title>
+#. type: Content of: <chapter><section><section><title>
#: resources.dbk:355
msgid "chroots to different distributions"
msgstr ""
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:357
msgid ""
"On some machines, there are chroots to different distributions available. "
"You can use them like this:"
msgstr ""
-# type: Content of: <chapter><section><section><screen>
-#: resources.dbk:360
+#. type: Content of: <chapter><section><section><screen>
+#: resources.dbk:361
#, no-wrap
msgid ""
-"\n"
"vore$ dchroot unstable\n"
"Executing shell in chroot: /org/vore.debian.org/chroots/user/unstable\n"
msgstr ""
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:365
msgid ""
"In all chroots, the normal user home directories are available. You can "
msgstr ""
# type: Content of: <chapter><section><title>
+#. type: Content of: <chapter><section><title>
#: resources.dbk:374
msgid "The Developers Database"
msgstr ""
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:376
msgid ""
"The Developers Database, at <ulink url=\"&url-debian-db;\"></ulink>, is an "
msgstr ""
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:384
msgid ""
"Developers can <ulink url=\"&url-debian-db-login;\">log into the database</"
msgstr ""
# type: Content of: <chapter><section><itemizedlist><listitem><para>
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
#: resources.dbk:390
msgid "forwarding address for your debian.org email"
msgstr ""
# type: Content of: <chapter><section><itemizedlist><listitem><para>
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
#: resources.dbk:395
msgid "subscription to debian-private"
msgstr ""
# type: Content of: <chapter><section><itemizedlist><listitem><para>
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
#: resources.dbk:400
msgid "whether you are on vacation"
msgstr ""
# type: Content of: <chapter><section><itemizedlist><listitem><para>
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
#: resources.dbk:405
msgid ""
"personal information such as your address, country, the latitude and "
msgstr ""
# type: Content of: <chapter><section><itemizedlist><listitem><para>
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
#: resources.dbk:413
msgid "password and preferred shell on Debian Project machines"
msgstr ""
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:418
msgid ""
"Most of the information is not accessible to the public, naturally. For "
msgstr ""
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:423
msgid ""
"Developers can also submit their SSH keys to be used for authorization on "
msgstr ""
# type: Content of: <chapter><section><title>
+#. type: Content of: <chapter><section><title>
#: resources.dbk:431
msgid "The Debian archive"
msgstr ""
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:433
msgid ""
"The &debian-formal; distribution consists of a lot of packages (<filename>."
msgstr ""
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:439
msgid "Here is an example directory tree of a complete Debian archive:"
msgstr ""
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:443
msgid ""
"As you can see, the top-level directory contains two directories, "
msgstr ""
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:457
msgid ""
"<filename>dists/stable</filename> contains three directories, namely "
msgstr ""
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:462
msgid ""
"In each of the areas, there is a directory for the source packages "
msgstr ""
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:467
msgid ""
"The <filename>main</filename> area contains additional directories which "
msgstr ""
# type: Content of: <chapter><section><section><title>
+#. type: Content of: <chapter><section><section><title>
#: resources.dbk:473
msgid "Sections"
msgstr ""
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:475
msgid ""
"The <literal>main</literal> section of the Debian archive is what makes up "
msgstr ""
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:483
msgid ""
"Every package in the main section must fully comply with the <ulink url="
msgstr ""
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:491
msgid ""
"Packages in the <literal>contrib</literal> section have to comply with the "
msgstr ""
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:496
msgid ""
"Packages which do not conform to the DFSG are placed in the <literal>non-"
msgstr ""
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:503
msgid ""
"The <ulink url=\"&url-debian-policy;\">Debian Policy Manual</ulink> contains "
msgstr ""
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:508
msgid ""
"The separation of the three sections at the top-level of the archive is "
msgstr ""
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:516
msgid ""
"On the other hand, a CD-ROM vendor could easily check the individual package "
msgstr ""
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:522
msgid ""
"Note that the term section is also used to refer to categories which "
msgstr ""
# type: Content of: <chapter><section><section><title>
+#. type: Content of: <chapter><section><section><title>
#: resources.dbk:532
msgid "Architectures"
msgstr ""
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:534
msgid ""
"In the first days, the Linux kernel was only available for Intel i386 (or "
msgstr ""
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:539
msgid ""
"The Linux 2.0 kernel supports Intel x86, DEC Alpha, SPARC, Motorola 680x0 "
msgstr ""
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:553
msgid ""
"&debian-formal; 1.3 is only available as <literal>i386</literal>. Debian "
msgstr ""
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:564
msgid ""
"Information for developers and users about the specific ports are available "
msgstr ""
# type: Content of: <chapter><section><section><title>
+#. type: Content of: <chapter><section><section><title>
#: resources.dbk:570
msgid "Packages"
msgstr ""
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:572
msgid ""
"There are two types of Debian packages, namely <literal>source</literal> and "
msgstr ""
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:576
msgid ""
"Source packages consist of either two or three files: a <filename>.dsc</"
msgstr ""
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:582
msgid ""
"If a package is developed specially for Debian and is not distributed "
msgstr ""
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:592
msgid ""
"The <filename>.dsc</filename> file lists all the files in the source package "
msgstr ""
# type: Content of: <chapter><section><section><title>
+#. type: Content of: <chapter><section><section><title>
#: resources.dbk:599
msgid "Distributions"
msgstr ""
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:601
msgid ""
"The directory system described in the previous chapter is itself contained "
msgstr ""
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:607
msgid ""
"To summarize, the Debian archive has a root directory within an FTP server. "
msgstr ""
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:614
msgid ""
"A distribution comprises Debian source and binary packages, and the "
msgstr ""
# type: Content of: <chapter><section><section><section><title>
+#. type: Content of: <chapter><section><section><section><title>
#: resources.dbk:622
msgid "Stable, testing, and unstable"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
+#. type: Content of: <chapter><section><section><section><para>
#: resources.dbk:624
msgid ""
"There are always distributions called <literal>stable</literal> (residing in "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
+#. type: Content of: <chapter><section><section><section><para>
#: resources.dbk:631
msgid ""
"Active development is done in the <literal>unstable</literal> distribution "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
+#. type: Content of: <chapter><section><section><section><para>
#: resources.dbk:640
msgid ""
"The <link linkend=\"testing\">testing</link> distribution is generated "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
+#. type: Content of: <chapter><section><section><section><para>
#: resources.dbk:648
msgid ""
"After a period of development, once the release manager deems fit, the "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
+#. type: Content of: <chapter><section><section><section><para>
#: resources.dbk:665
msgid ""
"This development cycle is based on the assumption that the "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
+#. type: Content of: <chapter><section><section><section><para>
#: resources.dbk:682
msgid ""
"Note that development under <literal>unstable</literal> continues during the "
msgstr ""
# type: Content of: <chapter><section><section><section><title>
+#. type: Content of: <chapter><section><section><section><title>
#: resources.dbk:689
msgid "More information about the testing distribution"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
+#. type: Content of: <chapter><section><section><section><para>
#: resources.dbk:691
msgid ""
"Packages are usually installed into the <literal>testing</literal> "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
+#. type: Content of: <chapter><section><section><section><para>
#: resources.dbk:695
msgid ""
"For more details, please see the <link linkend=\"testing\">information about "
msgstr ""
# type: Content of: <chapter><section><section><section><title>
+#. type: Content of: <chapter><section><section><section><title>
#: resources.dbk:701
msgid "Experimental"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
+#. type: Content of: <chapter><section><section><section><para>
#: resources.dbk:703
msgid ""
"The <literal>experimental</literal> distribution is a special distribution. "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
+#. type: Content of: <chapter><section><section><section><para>
#: resources.dbk:715
msgid ""
"These are the <citerefentry> <refentrytitle>sources.list</refentrytitle> "
"literal>:"
msgstr ""
-# type: Content of: <chapter><section><section><section><programlisting>
-#: resources.dbk:719
+#
. type: Content of: <chapter><section><section><section><programlisting>
+#: resources.dbk:720
#, no-wrap
msgid ""
-"\n"
"deb http://ftp.<replaceable>xy</replaceable>.debian.org/debian/ experimental main\n"
"deb-src http://ftp.<replaceable>xy</replaceable>.debian.org/debian/ experimental main\n"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
+#. type: Content of: <chapter><section><section><section><para>
#: resources.dbk:724
msgid ""
"If there is a chance that the software could do grave damage to a system, it "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
+#. type: Content of: <chapter><section><section><section><para>
#: resources.dbk:730
msgid ""
"Whenever there is a new upstream version of a package that introduces new "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
+#. type: Content of: <chapter><section><section><section><para>
#: resources.dbk:740
msgid ""
"Some experimental software can still go into <literal>unstable</literal>, "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
+#. type: Content of: <chapter><section><section><section><para>
#: resources.dbk:750
msgid ""
"New software which isn't likely to damage your system can go directly into "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
+#. type: Content of: <chapter><section><section><section><para>
#: resources.dbk:754
msgid ""
"An alternative to <literal>experimental</literal> is to use your personal "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
+#. type: Content of: <chapter><section><section><section><para>
#: resources.dbk:758
msgid ""
"When uploading to <literal>unstable</literal> a package which had bugs fixed "
msgstr ""
# type: Content of: <chapter><section><section><title>
+#. type: Content of: <chapter><section><section><title>
#: resources.dbk:768
msgid "Release code names"
msgstr ""
-# type: Content of: <chapter><section><section><para>
+#
. type: Content of: <chapter><section><section><para>
#: resources.dbk:770
msgid ""
"Every released Debian distribution has a <literal>code name</literal>: "
"literal>; Debian 1.3, <literal>bo</literal>; Debian 2.0, <literal>hamm</"
"literal>; Debian 2.1, <literal>slink</literal>; Debian 2.2, <literal>potato</"
"literal>; Debian 3.0, <literal>woody</literal>; Debian 3.1, <literal>sarge</"
-"literal>; Debian 4.0, <literal>etch</literal> and Debian 5.0 will be called "
-"<literal> lenny</literal>. There is also a ``pseudo-distribution'', called "
-"<literal>sid</literal>, which is the current <literal>unstable</literal> "
-"distribution; since packages are moved from <literal>unstable</literal> to "
-"<literal>testing</literal> as they approach stability, <literal>sid</"
-"literal> itself is never released. As well as the usual contents of a "
-"Debian distribution, <literal>sid</literal> contains packages for "
-"architectures which are not yet officially supported or released by Debian. "
-"These architectures are planned to be integrated into the mainstream "
-"distribution at some future date."
+"literal>; Debian 4.0, <literal>etch</literal>; Debian 5.0, <literal>lenny</"
+"literal> and the next release will be called <literal>squeeze</literal>. "
+"There is also a ``pseudo-distribution'', called <literal>sid</literal>, "
+"which is the current <literal>unstable</literal> distribution; since "
+"packages are moved from <literal>unstable</literal> to <literal>testing</"
+"literal> as they approach stability, <literal>sid</literal> itself is never "
+"released. As well as the usual contents of a Debian distribution, "
+"<literal>sid</literal> contains packages for architectures which are not yet "
+"officially supported or released by Debian. These architectures are planned "
+"to be integrated into the mainstream distribution at some future date."
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: resources.dbk:787
+#. type: Content of: <chapter><section><section><para>
+#: resources.dbk:788
msgid ""
"Since Debian has an open development model (i.e., everyone can participate "
"and follow the development) even the <literal>unstable</literal> and "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: resources.dbk:797
+#. type: Content of: <chapter><section><section><para>
+#: resources.dbk:798
msgid ""
"On the other hand, if we called the distribution directories <literal>Debian-"
"x.y</literal> from the beginning, people would think that Debian release "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: resources.dbk:805
+#. type: Content of: <chapter><section><section><para>
+#: resources.dbk:806
msgid ""
"Thus, the names of the distribution directories in the archive are "
"determined by their code names and not their release status (e.g., "
msgstr ""
# type: Content of: <chapter><section><title>
-#: resources.dbk:819
+#. type: Content of: <chapter><section><title>
+#: resources.dbk:820
msgid "Debian mirrors"
msgstr ""
# type: Content of: <chapter><section><para>
-#: resources.dbk:821
+#. type: Content of: <chapter><section><para>
+#: resources.dbk:822
msgid ""
"The various download archives and the web site have several mirrors "
"available in order to relieve our canonical servers from heavy load. In "
msgstr ""
# type: Content of: <chapter><section><para>
-#: resources.dbk:832
+#. type: Content of: <chapter><section><para>
+#: resources.dbk:833
msgid ""
"All the information on Debian mirrors, including a list of the available "
"public FTP/HTTP servers, can be found at <ulink url=\"&url-debian-mirrors;"
msgstr ""
# type: Content of: <chapter><section><para>
-#: resources.dbk:839
+#. type: Content of: <chapter><section><para>
+#: resources.dbk:840
msgid ""
"Note that mirrors are generally run by third-parties who are interested in "
"helping Debian. As such, developers generally do not have accounts on these "
msgstr ""
# type: Content of: <chapter><section><title>
-#: resources.dbk:846
+#. type: Content of: <chapter><section><title>
+#: resources.dbk:847
msgid "The Incoming system"
msgstr ""
# type: Content of: <chapter><section><para>
-#: resources.dbk:848
+#. type: Content of: <chapter><section><para>
+#: resources.dbk:849
msgid ""
"The Incoming system is responsible for collecting updated packages and "
"installing them in the Debian archive. It consists of a set of directories "
msgstr ""
# type: Content of: <chapter><section><para>
-#: resources.dbk:853
+#. type: Content of: <chapter><section><para>
+#: resources.dbk:854
msgid ""
"Packages are uploaded by all the maintainers into a directory called "
"<filename>UploadQueue</filename>. This directory is scanned every few "
msgstr ""
# type: Content of: <chapter><section><para>
-#: resources.dbk:872
+#. type: Content of: <chapter><section><para>
+#: resources.dbk:873
msgid ""
"Once the package is accepted, the system sends a confirmation mail to the "
"maintainer and closes all the bugs marked as fixed by the upload, and the "
msgstr ""
# type: Content of: <chapter><section><para>
-#: resources.dbk:884
+#. type: Content of: <chapter><section><para>
+#: resources.dbk:885
msgid ""
"The archive maintenance software will also send the OpenPGP/GnuPG signed "
"<filename>.changes</filename> file that you uploaded to the appropriate "
msgstr ""
# type: Content of: <chapter><section><para>
-#: resources.dbk:894
+#. type: Content of: <chapter><section><para>
+#: resources.dbk:895
msgid ""
"Though ftp-master is restricted, a copy of the installation is available to "
"all developers on <literal>&ftp-master-mirror;</literal>."
msgstr ""
# type: Content of: <chapter><section><title>
-#: resources.dbk:957
+#. type: Content of: <chapter><section><title>
+#: resources.dbk:958
msgid "Package information"
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: resources.dbk:959
+#. type: Content of: <chapter><section><section><title>
+#: resources.dbk:960
msgid "On the web"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: resources.dbk:961
+#. type: Content of: <chapter><section><section><para>
+#: resources.dbk:962
msgid ""
"Each package has several dedicated web pages. <literal>http://&packages-"
"host;/<replaceable>package-name</replaceable></literal> displays each "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: resources.dbk:968
+#. type: Content of: <chapter><section><section><para>
+#: resources.dbk:969
msgid ""
"The bug tracking system tracks bugs for each package. You can view the bugs "
"of a given package at the URL <literal>http://&bugs-host;/"
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: resources.dbk:975
+#. type: Content of: <chapter><section><section><title>
+#: resources.dbk:976
msgid "The <command>dak ls</command> utility"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: resources.dbk:977
+#. type: Content of: <chapter><section><section><para>
+#: resources.dbk:978
msgid ""
"<command>dak ls</command> is part of the dak suite of tools, listing "
"available package versions for all known distributions and architectures. "
"explain it better:"
msgstr ""
-# type: Content of: <chapter><section><section><screen>
-#: resources.dbk:984
+#. type: Content of: <chapter><section><section><screen>
+#: resources.dbk:986
#, no-wrap
msgid ""
-"\n"
"$ dak ls evince\n"
"evince | 0.1.5-2sarge1 | oldstable | source, alpha, arm, hppa, i386, ia64, m68k, mips, mipsel, powerpc, s390, sparc\n"
"evince | 0.4.0-5 | etch-m68k | source, m68k\n"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: resources.dbk:994
+#. type: Content of: <chapter><section><section><para>
+#: resources.dbk:995
msgid ""
"In this example, you can see that the version in <literal>unstable</literal> "
"differs from the version in <literal>testing</literal> and that there has "
msgstr ""
# type: Content of: <chapter><section><title>
-#: resources.dbk:1004
+#. type: Content of: <chapter><section><title>
+#: resources.dbk:1005
msgid "The Package Tracking System"
msgstr ""
# type: Content of: <chapter><section><para>
-#: resources.dbk:1006
+#. type: Content of: <chapter><section><para>
+#: resources.dbk:1007
msgid ""
"The Package Tracking System (PTS) is an email-based tool to track the "
"activity of a source package. This really means that you can get the same "
msgstr ""
# type: Content of: <chapter><section><para>
-#: resources.dbk:1011
+#. type: Content of: <chapter><section><para>
+#: resources.dbk:1012
msgid ""
"Each email sent through the PTS is classified under one of the keywords "
"listed below. This will let you select the mails that you want to receive."
msgstr ""
# type: Content of: <chapter><section><para>
-#: resources.dbk:1015
+#. type: Content of: <chapter><section><para>
+#: resources.dbk:1016
msgid "By default you will get:"
msgstr ""
# type: Content of: <chapter><section><variablelist><varlistentry><term>
-#: resources.dbk:1019
+#. type: Content of: <chapter><section><variablelist><varlistentry><term>
+#: resources.dbk:1020
msgid "<literal>bts</literal>"
msgstr ""
# type: Content of: <chapter><section><variablelist><varlistentry><listitem><para>
-#: resources.dbk:1022
+#. type: Content of: <chapter><section><variablelist><varlistentry><listitem><para>
+#: resources.dbk:1023
msgid "All the bug reports and following discussions."
msgstr ""
# type: Content of: <chapter><section><variablelist><varlistentry><term>
-#: resources.dbk:1027
+#. type: Content of: <chapter><section><variablelist><varlistentry><term>
+#: resources.dbk:1028
msgid "<literal>bts-control</literal>"
msgstr ""
# type: Content of: <chapter><section><variablelist><varlistentry><listitem><para>
-#: resources.dbk:1030
+#. type: Content of: <chapter><section><variablelist><varlistentry><listitem><para>
+#: resources.dbk:1031
msgid ""
"The email notifications from <email>control@&bugs-host;</email> about bug "
"report status changes."
msgstr ""
# type: Content of: <chapter><section><variablelist><varlistentry><term>
-#: resources.dbk:1036
+#. type: Content of: <chapter><section><variablelist><varlistentry><term>
+#: resources.dbk:1037
msgid "<literal>upload-source</literal>"
msgstr ""
# type: Content of: <chapter><section><variablelist><varlistentry><listitem><para>
-#: resources.dbk:1039
+#. type: Content of: <chapter><section><variablelist><varlistentry><listitem><para>
+#: resources.dbk:1040
msgid ""
"The email notification from <command>katie</command> when an uploaded source "
"package is accepted."
msgstr ""
# type: Content of: <chapter><section><variablelist><varlistentry><term>
-#: resources.dbk:1045
+#. type: Content of: <chapter><section><variablelist><varlistentry><term>
+#: resources.dbk:1046
msgid "<literal>katie-other</literal>"
msgstr ""
# type: Content of: <chapter><section><variablelist><varlistentry><listitem><para>
-#: resources.dbk:1048
+#. type: Content of: <chapter><section><variablelist><varlistentry><listitem><para>
+#: resources.dbk:1049
msgid ""
"Other warning and error emails from <command>katie</command> (such as an "
"override disparity for the section and/or the priority field)."
msgstr ""
# type: Content of: <chapter><section><variablelist><varlistentry><term>
-#: resources.dbk:1054
+#. type: Content of: <chapter><section><variablelist><varlistentry><term>
+#: resources.dbk:1055
msgid "<literal>default</literal>"
msgstr ""
# type: Content of: <chapter><section><variablelist><varlistentry><listitem><para>
-#: resources.dbk:1057
+#. type: Content of: <chapter><section><variablelist><varlistentry><listitem><para>
+#: resources.dbk:1058
msgid ""
"Any non-automatic email sent to the PTS by people who wanted to contact the "
"subscribers of the package. This can be done by sending mail to "
msgstr ""
# type: Content of: <chapter><section><variablelist><varlistentry><term>
-#: resources.dbk:1066
+#. type: Content of: <chapter><section><variablelist><varlistentry><term>
+#: resources.dbk:1067
msgid "<literal>contact</literal>"
msgstr ""
# type: Content of: <chapter><section><variablelist><varlistentry><listitem><para>
-#: resources.dbk:1069
+#. type: Content of: <chapter><section><variablelist><varlistentry><listitem><para>
+#: resources.dbk:1070
msgid ""
"Mails sent to the maintainer through the *@packages.debian.org email aliases."
msgstr ""
# type: Content of: <chapter><section><variablelist><varlistentry><term>
-#: resources.dbk:1075
+#. type: Content of: <chapter><section><variablelist><varlistentry><term>
+#: resources.dbk:1076
msgid "<literal>summary</literal>"
msgstr ""
# type: Content of: <chapter><section><variablelist><varlistentry><listitem><para>
-#: resources.dbk:1078
+#. type: Content of: <chapter><section><variablelist><varlistentry><listitem><para>
+#: resources.dbk:1079
msgid ""
"Regular summary emails about the package's status. Currently, only "
"progression in <literal>testing</literal> is sent."
msgstr ""
# type: Content of: <chapter><section><para>
-#: resources.dbk:1085
+#. type: Content of: <chapter><section><para>
+#: resources.dbk:1086
msgid "You can also decide to receive additional information:"
msgstr ""
# type: Content of: <chapter><section><variablelist><varlistentry><term>
-#: resources.dbk:1089
+#. type: Content of: <chapter><section><variablelist><varlistentry><term>
+#: resources.dbk:1090
msgid "<literal>upload-binary</literal>"
msgstr ""
# type: Content of: <chapter><section><variablelist><varlistentry><listitem><para>
-#: resources.dbk:1092
+#. type: Content of: <chapter><section><variablelist><varlistentry><listitem><para>
+#: resources.dbk:1093
msgid ""
"The email notification from <command>katie</command> when an uploaded binary "
"package is accepted. In other words, whenever a build daemon or a porter "
msgstr ""
# type: Content of: <chapter><section><variablelist><varlistentry><term>
-#: resources.dbk:1100
+#. type: Content of: <chapter><section><variablelist><varlistentry><term>
+#: resources.dbk:1101
msgid "<literal>cvs</literal>"
msgstr ""
# type: Content of: <chapter><section><variablelist><varlistentry><listitem><para>
-#: resources.dbk:1103
+#. type: Content of: <chapter><section><variablelist><varlistentry><listitem><para>
+#: resources.dbk:1104
msgid ""
"VCS commit notifications, if the package has a VCS repository and the "
"maintainer has set up forwarding of commit notifications to the PTS. The "
msgstr ""
# type: Content of: <chapter><section><variablelist><varlistentry><term>
-#: resources.dbk:1111
+#. type: Content of: <chapter><section><variablelist><varlistentry><term>
+#: resources.dbk:1112
msgid "<literal>ddtp</literal>"
msgstr ""
# type: Content of: <chapter><section><variablelist><varlistentry><listitem><para>
-#: resources.dbk:1114
+#. type: Content of: <chapter><section><variablelist><varlistentry><listitem><para>
+#: resources.dbk:1115
msgid ""
"Translations of descriptions or debconf templates submitted to the Debian "
"Description Translation Project."
msgstr ""
# type: Content of: <chapter><section><variablelist><varlistentry><term>
-#: resources.dbk:1120
+#. type: Content of: <chapter><section><variablelist><varlistentry><term>
+#: resources.dbk:1121
msgid "<literal>derivatives</literal>"
msgstr ""
# type: Content of: <chapter><section><variablelist><varlistentry><listitem><para>
-#: resources.dbk:1123
+#. type: Content of: <chapter><section><variablelist><varlistentry><listitem><para>
+#: resources.dbk:1124
msgid ""
"Information about changes made to the package in derivative distributions "
"(for example Ubuntu)."
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: resources.dbk:1130
+#. type: Content of: <chapter><section><section><title>
+#: resources.dbk:1131
msgid "The PTS email interface"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: resources.dbk:1132
+#. type: Content of: <chapter><section><section><para>
+#: resources.dbk:1133
msgid ""
"You can control your subscription(s) to the PTS by sending various commands "
"to <email>pts@qa.debian.org</email>."
msgstr ""
# type: Content of: <chapter><section><section><variablelist><varlistentry><term>
-#: resources.dbk:1137
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><term>
+#: resources.dbk:1138
msgid "<literal>subscribe <sourcepackage> [<email>]</literal>"
msgstr ""
# type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><para>
-#: resources.dbk:1140
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><para>
+#: resources.dbk:1141
msgid ""
"Subscribes <replaceable>email</replaceable> to communications related to the "
"source package <replaceable>sourcepackage</replaceable>. Sender address is "
msgstr ""
# type: Content of: <chapter><section><section><variablelist><varlistentry><term>
-#: resources.dbk:1150
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><term>
+#: resources.dbk:1151
msgid "<literal>unsubscribe <sourcepackage> [<email>]</literal>"
msgstr ""
# type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><para>
-#: resources.dbk:1153
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><para>
+#: resources.dbk:1154
msgid ""
"Removes a previous subscription to the source package "
"<replaceable>sourcepackage</replaceable> using the specified email address "
msgstr ""
# type: Content of: <chapter><section><section><variablelist><varlistentry><term>
-#: resources.dbk:1160
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><term>
+#: resources.dbk:1161
msgid "<literal>unsubscribeall [<email>]</literal>"
msgstr ""
# type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><para>
-#: resources.dbk:1163
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><para>
+#: resources.dbk:1164
msgid ""
"Removes all subscriptions of the specified email address or the sender "
"address if the second argument is left out."
msgstr ""
# type: Content of: <chapter><section><section><variablelist><varlistentry><term>
-#: resources.dbk:1169
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><term>
+#: resources.dbk:1170
msgid "<literal>which [<email>]</literal>"
msgstr ""
# type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><para>
-#: resources.dbk:1172
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><para>
+#: resources.dbk:1173
msgid ""
"Lists all subscriptions for the sender or the email address optionally "
"specified."
msgstr ""
# type: Content of: <chapter><section><section><variablelist><varlistentry><term>
-#: resources.dbk:1178
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><term>
+#: resources.dbk:1179
msgid "<literal>keyword [<email>]</literal>"
msgstr ""
# type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><para>
-#: resources.dbk:1181
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><para>
+#: resources.dbk:1182
msgid ""
"Tells you the keywords that you are accepting. For an explanation of "
"keywords, <link linkend=\"pkg-tracking-system\">see above</link>. Here's a "
msgstr ""
# type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><itemizedlist><listitem><para>
-#: resources.dbk:1188
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><itemizedlist><listitem><para>
+#: resources.dbk:1189
msgid ""
"<literal>bts</literal>: mails coming from the Debian Bug Tracking System"
msgstr ""
# type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><itemizedlist><listitem><para>
-#: resources.dbk:1193
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><itemizedlist><listitem><para>
+#: resources.dbk:1194
msgid ""
"<literal>bts-control</literal>: reply to mails sent to &email-bts-control;"
msgstr ""
# type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><itemizedlist><listitem><para>
-#: resources.dbk:1199
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><itemizedlist><listitem><para>
+#: resources.dbk:1200
msgid ""
"<literal>summary</literal>: automatic summary mails about the state of a "
"package"
msgstr ""
# type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><itemizedlist><listitem><para>
-#: resources.dbk:1205
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><itemizedlist><listitem><para>
+#: resources.dbk:1206
msgid ""
"<literal>contact</literal>: mails sent to the maintainer through the "
"*@packages.debian.org aliases"
msgstr ""
# type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><itemizedlist><listitem><para>
-#: resources.dbk:1211
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><itemizedlist><listitem><para>
+#: resources.dbk:1212
msgid "<literal>cvs</literal>: notification of VCS commits"
msgstr ""
# type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><itemizedlist><listitem><para>
-#: resources.dbk:1216
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><itemizedlist><listitem><para>
+#: resources.dbk:1217
msgid ""
"<literal>ddtp</literal>: translations of descriptions and debconf templates"
msgstr ""
# type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><itemizedlist><listitem><para>
-#: resources.dbk:1221
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><itemizedlist><listitem><para>
+#: resources.dbk:1222
msgid ""
"<literal>derivatives</literal>: changes made on the package by derivative "
"distributions"
msgstr ""
# type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><itemizedlist><listitem><para>
-#: resources.dbk:1227
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><itemizedlist><listitem><para>
+#: resources.dbk:1228
msgid ""
"<literal>upload-source</literal>: announce of a new source upload that has "
"been accepted"
msgstr ""
# type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><itemizedlist><listitem><para>
-#: resources.dbk:1233
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><itemizedlist><listitem><para>
+#: resources.dbk:1234
msgid ""
"<literal>upload-binary</literal>: announce of a new binary-only upload "
"(porting)"
msgstr ""
# type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><itemizedlist><listitem><para>
-#: resources.dbk:1239
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><itemizedlist><listitem><para>
+#: resources.dbk:1240
msgid ""
"<literal>katie-other</literal>: other mails from ftpmasters (override "
"disparity, etc.)"
msgstr ""
# type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><itemizedlist><listitem><para>
-#: resources.dbk:1245
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><itemizedlist><listitem><para>
+#: resources.dbk:1246
msgid ""
"<literal>default</literal>: all the other mails (those which aren't "
"automatic)"
msgstr ""
# type: Content of: <chapter><section><section><variablelist><varlistentry><term>
-#: resources.dbk:1252
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><term>
+#: resources.dbk:1253
msgid "<literal>keyword <sourcepackage> [<email>]</literal>"
msgstr ""
# type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><para>
-#: resources.dbk:1255
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><para>
+#: resources.dbk:1256
msgid ""
"Same as the previous item but for the given source package, since you may "
"select a different set of keywords for each source package."
msgstr ""
# type: Content of: <chapter><section><section><variablelist><varlistentry><term>
-#: resources.dbk:1261
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><term>
+#: resources.dbk:1262
msgid ""
"<literal>keyword [<email>] {+|-|=} <list of keywords></literal>"
msgstr ""
# type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><para>
-#: resources.dbk:1264
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><para>
+#: resources.dbk:1265
msgid ""
"Accept (+) or refuse (-) mails classified under the given keyword(s). "
"Define the list (=) of accepted keywords. This changes the default set of "
msgstr ""
# type: Content of: <chapter><section><section><variablelist><varlistentry><term>
-#: resources.dbk:1271
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><term>
+#: resources.dbk:1272
msgid ""
"<literal>keywordall [<email>] {+|-|=} <list of keywords></"
"literal>"
msgstr ""
# type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><para>
-#: resources.dbk:1274
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><para>
+#: resources.dbk:1275
msgid ""
"Accept (+) or refuse (-) mails classified under the given keyword(s). "
"Define the list (=) of accepted keywords. This changes the set of accepted "
msgstr ""
# type: Content of: <chapter><section><section><variablelist><varlistentry><term>
-#: resources.dbk:1281
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><term>
+#: resources.dbk:1282
msgid ""
"<literal>keyword <sourcepackage> [<email>] {+|-|=} <list of "
"keywords></literal>"
msgstr ""
# type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><para>
-#: resources.dbk:1284
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><para>
+#: resources.dbk:1285
msgid ""
"Same as previous item but overrides the keywords list for the indicated "
"source package."
msgstr ""
# type: Content of: <chapter><section><section><variablelist><varlistentry><term>
-#: resources.dbk:1290
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><term>
+#: resources.dbk:1291
msgid "<literal>quit | thanks | --</literal>"
msgstr ""
# type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><para>
-#: resources.dbk:1293
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><para>
+#: resources.dbk:1294
msgid "Stops processing commands. All following lines are ignored by the bot."
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: resources.dbk:1299
+#. type: Content of: <chapter><section><section><para>
+#: resources.dbk:1300
msgid ""
"The <command>pts-subscribe</command> command-line utility (from the "
"<systemitem role=\"package\">devscripts</systemitem> package) can be handy "
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: resources.dbk:1307
+#. type: Content of: <chapter><section><section><title>
+#: resources.dbk:1308
msgid "Filtering PTS mails"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: resources.dbk:1309
+#. type: Content of: <chapter><section><section><para>
+#: resources.dbk:1310
msgid ""
"Once you are subscribed to a package, you will get the mails sent to "
"<literal><replaceable>sourcepackage</replaceable>@&pts-host;</literal>. "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: resources.dbk:1317
+#. type: Content of: <chapter><section><section><para>
+#: resources.dbk:1318
msgid ""
"Here is an example of added headers for a source upload notification on the "
"<systemitem role=\"package\">dpkg</systemitem> package:"
msgstr ""
-# type: Content of: <chapter><section><section><screen>
-#: resources.dbk:1320
+#. type: Content of: <chapter><section><section><screen>
+#: resources.dbk:1322
#, no-wrap
msgid ""
-"\n"
"X-Loop: dpkg@&pts-host;\n"
"X-PTS-Package: dpkg\n"
"X-PTS-Keyword: upload-source\n"
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: resources.dbk:1329
+#. type: Content of: <chapter><section><section><title>
+#: resources.dbk:1330
msgid "Forwarding VCS commits in the PTS"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: resources.dbk:1331
+#. type: Content of: <chapter><section><section><para>
+#: resources.dbk:1332
msgid ""
"If you use a publicly accessible VCS repository for maintaining your Debian "
"package, you may want to forward the commit notification to the PTS so that "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: resources.dbk:1337
+#. type: Content of: <chapter><section><section><para>
+#: resources.dbk:1338
msgid ""
"Once you set up the VCS repository to generate commit notifications, you "
"just have to make sure it sends a copy of those mails to "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: resources.dbk:1346
+#. type: Content of: <chapter><section><section><para>
+#: resources.dbk:1347
msgid ""
"For Subversion repositories, the usage of svnmailer is recommended. See "
"<ulink url=\"&url-alioth-pkg;\" /> for an example on how to do it."
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: resources.dbk:1352
+#. type: Content of: <chapter><section><section><title>
+#: resources.dbk:1353
msgid "The PTS web interface"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: resources.dbk:1354
+#. type: Content of: <chapter><section><section><para>
+#: resources.dbk:1355
msgid ""
"The PTS has a web interface at <ulink url=\"http://&pts-host;/\"></ulink> "
"that puts together a lot of information about each source package. It "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: resources.dbk:1364
+#. type: Content of: <chapter><section><section><para>
+#: resources.dbk:1365
msgid ""
"You can jump directly to the web page concerning a specific source package "
"with a URL like <literal>http://&pts-host;/<replaceable>sourcepackage</"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: resources.dbk:1369
+#. type: Content of: <chapter><section><section><para>
+#: resources.dbk:1370
msgid ""
"This web interface has been designed like a portal for the development of "
"packages: you can add custom content on your packages' pages. You can add "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: resources.dbk:1375
+#. type: Content of: <chapter><section><section><para>
+#: resources.dbk:1376
msgid "Static news items can be used to indicate:"
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: resources.dbk:1380
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: resources.dbk:1381
msgid ""
"the availability of a project hosted on <link linkend=\"alioth\">Alioth</"
"link> for co-maintaining the package"
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: resources.dbk:1386
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: resources.dbk:1387
msgid "a link to the upstream web site"
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: resources.dbk:1391
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: resources.dbk:1392
msgid "a link to the upstream bug tracker"
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: resources.dbk:1396
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: resources.dbk:1397
msgid "the existence of an IRC channel dedicated to the software"
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: resources.dbk:1401
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: resources.dbk:1402
msgid ""
"any other available resource that could be useful in the maintenance of the "
"package"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: resources.dbk:1407
+#. type: Content of: <chapter><section><section><para>
+#: resources.dbk:1408
msgid "Usual news items may be used to announce that:"
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: resources.dbk:1412
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: resources.dbk:1413
msgid "beta packages are available for testing"
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: resources.dbk:1417
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: resources.dbk:1418
msgid "final packages are expected for next week"
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: resources.dbk:1422
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: resources.dbk:1423
msgid "the packaging is about to be redone from scratch"
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: resources.dbk:1427
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: resources.dbk:1428
msgid "backports are available"
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: resources.dbk:1432
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: resources.dbk:1433
msgid ""
"the maintainer is on vacation (if they wish to publish this information)"
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: resources.dbk:1437
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: resources.dbk:1438
msgid "a NMU is being worked on"
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: resources.dbk:1442
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: resources.dbk:1443
msgid "something important will affect the package"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: resources.dbk:1447
+#. type: Content of: <chapter><section><section><para>
+#: resources.dbk:1448
msgid ""
"Both kinds of news are generated in a similar manner: you just have to send "
"an email either to <email>pts-static-news@qa.debian.org</email> or to "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: resources.dbk:1458
+#. type: Content of: <chapter><section><section><para>
+#: resources.dbk:1459
msgid ""
"Here are a few examples of valid mails used to generate news items in the "
"PTS. The first one adds a link to the cvsweb interface of debian-cd in the "
"Static information section:"
msgstr ""
-# type: Content of: <chapter><section><section><screen>
-#: resources.dbk:1462
+#. type: Content of: <chapter><section><section><screen>
+#: resources.dbk:1464
#, no-wrap
msgid ""
-"\n"
"From: Raphael Hertzog <hertzog@debian.org>\n"
"To: pts-static-news@qa.debian.org\n"
"Subject: Browse debian-cd SVN repository\n"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: resources.dbk:1471
+#. type: Content of: <chapter><section><section><para>
+#: resources.dbk:1472
msgid ""
"The second one is an announcement sent to a mailing list which is also sent "
"to the PTS so that it is published on the PTS web page of the package. Note "
"the use of the BCC field to avoid answers sent to the PTS by mistake."
msgstr ""
-# type: Content of: <chapter><section><section><screen>
-#: resources.dbk:1475
+#. type: Content of: <chapter><section><section><screen>
+#: resources.dbk:1477
#, no-wrap
msgid ""
-"\n"
"From: Raphael Hertzog <hertzog@debian.org>\n"
"To: debian-gtk-gnome@&lists-host;\n"
"Bcc: pts-news@qa.debian.org\n"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: resources.dbk:1489
+#. type: Content of: <chapter><section><section><para>
+#: resources.dbk:1490
msgid ""
"Think twice before adding a news item to the PTS because you won't be able "
"to remove it later and you won't be able to edit it either. The only thing "
msgstr ""
# type: Content of: <chapter><section><title>
-#: resources.dbk:1499
+#. type: Content of: <chapter><section><title>
+#: resources.dbk:1500
msgid "Developer's packages overview"
msgstr ""
# type: Content of: <chapter><section><para>
-#: resources.dbk:1501
+#. type: Content of: <chapter><section><para>
+#: resources.dbk:1502
msgid ""
"A QA (quality assurance) web portal is available at <ulink url=\"&url-ddpo;"
"\"></ulink> which displays a table listing all the packages of a single "
msgstr ""
# type: Content of: <chapter><section><para>
-#: resources.dbk:1510
+#. type: Content of: <chapter><section><para>
+#: resources.dbk:1511
msgid ""
"It is a good idea to look up your own data regularly so that you don't "
"forget any open bugs, and so that you don't forget which packages are your "
msgstr ""
# type: Content of: <chapter><section><title>
-#: resources.dbk:1517
+#. type: Content of: <chapter><section><title>
+#: resources.dbk:1518
msgid "Debian's GForge installation: Alioth"
msgstr ""
# type: Content of: <chapter><section><para>
-#: resources.dbk:1519
+#. type: Content of: <chapter><section><para>
+#: resources.dbk:1520
msgid ""
"Alioth is a Debian service based on a slightly modified version of the "
"GForge software (which evolved from SourceForge). This software offers "
msgstr ""
# type: Content of: <chapter><section><para>
-#: resources.dbk:1526
+#. type: Content of: <chapter><section><para>
+#: resources.dbk:1527
msgid ""
"It is intended to provide facilities to free software projects backed or led "
"by Debian, facilitate contributions from external developers to projects "
msgstr ""
# type: Content of: <chapter><section><para>
-#: resources.dbk:1533
+#. type: Content of: <chapter><section><para>
+#: resources.dbk:1534
msgid ""
"All Debian developers automatically have an account on Alioth. They can "
"activate it by using the recover password facility. External developers can "
msgstr ""
# type: Content of: <chapter><section><para>
-#: resources.dbk:1538
+#. type: Content of: <chapter><section><para>
+#: resources.dbk:1539
msgid "For more information please visit the following links:"
msgstr ""
# type: Content of: <chapter><section><itemizedlist><listitem><para>
-#: resources.dbk:1541
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
+#: resources.dbk:1542
msgid "<ulink url=\"&url-alioth-wiki;\" />"
msgstr ""
# type: Content of: <chapter><section><itemizedlist><listitem><para>
-#: resources.dbk:1542
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
+#: resources.dbk:1543
msgid "<ulink url=\"&url-alioth-faq;\" />"
msgstr ""
# type: Content of: <chapter><section><itemizedlist><listitem><para>
-#: resources.dbk:1543
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
+#: resources.dbk:1544
msgid "<ulink url=\"&url-alioth-pkg;\" />"
msgstr ""
# type: Content of: <chapter><section><itemizedlist><listitem><para>
-#: resources.dbk:1544
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
+#: resources.dbk:1545
msgid "<ulink url=\"&url-alioth;\" />"
msgstr ""
# type: Content of: <chapter><section><title>
-#: resources.dbk:1549
+#. type: Content of: <chapter><section><title>
+#: resources.dbk:1550
msgid "Goodies for Developers"
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: resources.dbk:1551
+#. type: Content of: <chapter><section><section><title>
+#: resources.dbk:1552
msgid "LWN Subscriptions"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: resources.dbk:1553
+#. type: Content of: <chapter><section><section><para>
+#: resources.dbk:1554
msgid ""
"Since October of 2002, HP has sponsored a subscription to LWN for all "
"interested Debian developers. Details on how to get access to this benefit "
msgid ""
msgstr ""
"Project-Id-Version: developers-reference 3.3.9\n"
-"POT-Creation-Date: 2008-06-14 14:14+0900\n"
+"POT-Creation-Date: 2009-06-25 22:00+0300\n"
"PO-Revision-Date: 2008-03-05 18:30+0900\n"
"Last-Translator: Hideki Yamane (Debian-JP) <henrich@debian.or.jp>\n"
"Language-Team: Debian JP Project <debian-doc@debian.or.jp>\n"
"Content-Transfer-Encoding: 8bit\n"
# type: Content of: <chapter><title>
+#. type: Content of: <chapter><title>
#: best-pkging-practices.dbk:7
msgid "Best Packaging Practices"
msgstr "パッケージ化のベストプラクティス"
# type: Content of: <chapter><para>
+#. type: Content of: <chapter><para>
#: best-pkging-practices.dbk:9
#, fuzzy
msgid ""
"きく依存しています。"
# type: Content of: <chapter><para>
+#. type: Content of: <chapter><para>
#: best-pkging-practices.dbk:18
msgid ""
"This chapter provides some best practices for Debian developers. All "
msgstr ""
# type: Content of: <chapter><section><title>
+#. type: Content of: <chapter><section><title>
#: best-pkging-practices.dbk:24
msgid "Best practices for <filename>debian/rules</filename>"
msgstr "<filename>debian/rules</filename> についてのベストプラクティス"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: best-pkging-practices.dbk:26
msgid ""
"The following recommendations apply to the <filename>debian/rules</filename> "
msgstr ""
# type: Content of: <chapter><section><section><title>
+#. type: Content of: <chapter><section><section><title>
#: best-pkging-practices.dbk:32
msgid "Helper scripts"
msgstr "補助スクリプト"
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:34
msgid ""
"The rationale for using helper scripts in <filename>debian/rules</filename> "
msgstr ""
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:45
msgid ""
"Helper scripts take care of these issues. Assuming you comply with the "
msgstr ""
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:52
msgid ""
"<xref linkend=\"tools\"/> contains a couple of different helpers. The most "
msgstr ""
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:66
msgid ""
"You can get started with <systemitem role=\"package\">debhelper</systemitem> "
msgstr ""
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:79
msgid ""
"Some people feel that vanilla <filename>debian/rules</filename> files are "
msgstr ""
# type: Content of: <chapter><section><section><title>
+#. type: Content of: <chapter><section><section><title>
#: best-pkging-practices.dbk:88
msgid "Separating your patches into multiple files"
msgstr ""
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:90
msgid ""
"Big, complex packages may have many bugs that you need to deal with. If you "
"out which patch sets to back out as a unit as bugs are fixed upstream."
msgstr ""
-# type: Content of: <chapter><section><section><para>
+#
. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:99
msgid ""
"Unfortunately, the packaging system as such currently doesn't provide for "
"(<filename>.diff.gz</filename>), usually within the <filename>debian/</"
"filename> directory. The only difference is that they aren't applied "
"immediately by dpkg-source, but by the <literal>build</literal> rule of "
-"<filename>debian/rules</filename>. Conversely, they are reverted in the "
-"<literal>clean</literal> rule."
+"<filename>debian/rules</filename>, through a dependency on the "
+"<literal>patch</literal> rule. Conversely, they are reverted in the "
+"<literal>clean</literal> rule, through a dependency on the <literal>unpatch</"
+"literal> rule."
msgstr ""
-# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:109
+#
. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:113
msgid ""
-"<command>dbs</command> is one of the more popular approaches to this. It "
-"does all of the above, and provides a facility for creating new and updating "
-"old patches. See the package <systemitem role=\"package\">dbs</systemitem> "
-"for more information and <systemitem role=\"package\">hello-dbs</systemitem> "
-"for an example."
+"<command>quilt</command> is the recommended tool for this. It does all of "
+"the above, and also allows to manage patch series. See the <systemitem role="
+"\"package\">quilt</systemitem> package for more information."
msgstr ""
-# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:116
+#
. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:119
msgid ""
-"<command>dpatch</command> also provides these facilities, but it's intended "
-"to be even easier to use. See the package <systemitem role=\"package"
-"\">dpatch</systemitem> for documentation and examples (in <filename>/usr/"
-"share/doc/dpatch</filename>)."
+"There are other tools to manage patches, like <command>dpatch</command>, and "
+"the patch system integrated with <systemitem role=\"package\">cdbs</"
+"systemitem>."
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: best-pkging-practices.dbk:124
+#. type: Content of: <chapter><section><section><title>
+#: best-pkging-practices.dbk:126
msgid "Multiple binary packages"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:126
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:128
msgid ""
"A single source package will often build several binary packages, either to "
"provide several flavors of the same software (e.g., the <systemitem role="
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:133
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:135
msgid ""
"The second case can be easily managed in <filename>debian/rules</filename>. "
"You just need to move the appropriate files from the build directory into "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:142
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:144
msgid ""
"The first case is a bit more difficult since it involves multiple recompiles "
"of the same software but with different configuration options. The "
msgstr ""
# type: Content of: <chapter><section><title>
-#: best-pkging-practices.dbk:154
+#. type: Content of: <chapter><section><title>
+#: best-pkging-practices.dbk:156
msgid "Best practices for <filename>debian/control</filename>"
msgstr ""
# type: Content of: <chapter><section><para>
-#: best-pkging-practices.dbk:156
+#. type: Content of: <chapter><section><para>
+#: best-pkging-practices.dbk:158
msgid ""
"The following practices are relevant to the <filename>debian/control</"
"filename> file. They supplement the <ulink url=\"&url-debian-policy;ch-"
msgstr ""
# type: Content of: <chapter><section><para>
-#: best-pkging-practices.dbk:162
+#. type: Content of: <chapter><section><para>
+#: best-pkging-practices.dbk:164
msgid ""
"The description of the package, as defined by the corresponding field in the "
"<filename>control</filename> file, contains both the package synopsis and "
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: best-pkging-practices.dbk:171
+#. type: Content of: <chapter><section><section><title>
+#: best-pkging-practices.dbk:173
msgid "General guidelines for package descriptions"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:173
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:175
msgid ""
"The package description should be written for the average likely user, the "
"average person who will use and benefit from the package. For instance, "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:180
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:182
msgid ""
"Our review of package descriptions lead us to conclude that most package "
"descriptions are technical, that is, are not written to make sense for non-"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:186
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:188
msgid ""
"How do you write for non-technical users? Avoid jargon. Avoid referring to "
"other applications or frameworks that the user might not be familiar with — "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:193
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:195
msgid ""
"Be objective. Package descriptions are not the place for advocating your "
"package, no matter how much you love it. Remember that the reader may not "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:198
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:200
msgid ""
"References to the names of any other software packages, protocol names, "
"standards, or specifications should use their canonical forms, if one "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:205
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:207
msgid ""
"If you are having problems writing your description, you may wish to send it "
"along to &email-debian-l10n-english; and request feedback."
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: best-pkging-practices.dbk:211
+#. type: Content of: <chapter><section><section><title>
+#: best-pkging-practices.dbk:213
msgid "The package synopsis, or short description"
msgstr ""
-# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:213
+#
. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:215
msgid ""
-"The synopsis line (the short description) should be concise. It must not "
-"repeat the package's name (this is policy)."
+"Policy says the synopsis line (the short description) must be concise, not "
+"repeating the package name, but also informative."
msgstr ""
-# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:217
+#
. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:219
msgid ""
-"It's a good idea to think of the synopsis as an appositive clause, not a "
-"full sentence. An appositive clause is defined in WordNet as a grammatical "
-"relation between a word and a noun phrase that follows, e.g., Rudolph the "
-"red-nosed reindeer. The appositive clause here is red-nosed reindeer. "
-"Since the synopsis is a clause, rather than a full sentence, we recommend "
-"that it neither start with a capital nor end with a full stop (period). It "
-"should also not begin with an article, either definite (the) or indefinite "
-"(a or an)."
+"The synopsis functions as a phrase describing the package, not a complete "
+"sentence, so sentential punctuation is inappropriate: it does not need extra "
+"capital letters or a final period (full stop). It should also omit any "
+"initial indefinite or definite article - \"a\", \"an\", or \"the\". Thus for "
+"instance:"
msgstr ""
-# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:226
+#. type: Content of: <chapter><section><section><screen>
+#: best-pkging-practices.dbk:225
+#, no-wrap
msgid ""
-"It might help to imagine that the synopsis is combined with the package name "
-"in the following way:"
+"Package: libeg0\n"
+"Description: exemplification support library\n"
msgstr ""
-# type: Content of: <chapter><section><section><screen>
+#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:229
-#, no-wrap
msgid ""
-"\n"
-"<replaceable>package-name</replaceable> is a <replaceable>synopsis</replaceable>.\n"
+"Technically this is a noun phrase minus articles, as opposed to a verb "
+"phrase. A good heuristic is that it should be possible to substitute the "
+"package name and synopsis into this formula:"
msgstr ""
-# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:233
-msgid "Alternatively, it might make sense to think of it as"
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:234
+msgid ""
+"The package <replaceable>name</replaceable> provides {a,an,the,some} "
+"<replaceable>synopsis</replaceable>."
msgstr ""
-# type: Content of: <chapter><section><section><screen>
-#: best-pkging-practices.dbk:235
-#, no-wrap
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:238
msgid ""
-"\n"
-"<replaceable>package-name</replaceable> is <replaceable>synopsis</replaceable>.\n"
+"Sets of related packages may use an alternative scheme that divides the "
+"synopsis into two parts, the first a description of the whole suite and the "
+"second a summary of the package's role within it:"
msgstr ""
-# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:239
-msgid "or, if the package name itself is a plural (such as developers-tools)"
+#. type: Content of: <chapter><section><section><screen>
+#: best-pkging-practices.dbk:243
+#, no-wrap
+msgid ""
+"Package: eg-tools\n"
+"Description: simple exemplification system (utilities)\n"
+"\t\t\t \n"
+"Package: eg-doc\n"
+"Description: simple exemplification system - documentation\n"
msgstr ""
-# type: Content of: <chapter><section><section><screen>
-#: best-pkging-practices.dbk:241
-#, no-wrap
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:250
msgid ""
-"\n"
-"<replaceable>package-name</replaceable> are <replaceable>synopsis</replaceable>.\n"
+"These synopses follow a modified formula. Where a package "
+"\"<replaceable>name</replaceable>\" has a synopsis \"<replaceable>suite</"
+"replaceable> (<replaceable>role</replaceable>)\" or \"<replaceable>suite</"
+"replaceable> - <replaceable>role</replaceable>\", the elements should be "
+"phrased so that they fit into the formula:"
msgstr ""
-# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:245
+#
. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:257
msgid ""
-"This way of forming a sentence from the package name and synopsis should be "
-"considered as a heuristic and not a strict rule. There are some cases where "
-"it doesn't make sense to try to form a sentence."
+"The package <replaceable>name</replaceable> provides {a,an,the} "
+"<replaceable>role</replaceable> for the <replaceable>suite</replaceable>."
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: best-pkging-practices.dbk:252
+#. type: Content of: <chapter><section><section><title>
+#: best-pkging-practices.dbk:263
msgid "The long description"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:254
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:265
msgid ""
"The long description is the primary information available to the user about "
"a package before they install it. It should provide all the information "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:260
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:271
msgid "The long description should consist of full and complete sentences."
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:263
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:274
msgid ""
"The first paragraph of the long description should answer the following "
"questions: what does the package do? what task does it help the user "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:269
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:280
msgid ""
"The following paragraphs should answer the following questions: Why do I as "
"a user need this package? What other features does the package have? What "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:277
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:288
msgid ""
"Be careful to avoid spelling and grammar mistakes. Ensure that you spell-"
"check it. Both <command>ispell</command> and <command>aspell</command> have "
"special modes for checking <filename>debian/control</filename> files:"
msgstr ""
-# type: Content of: <chapter><section><section><screen>
-#: best-pkging-practices.dbk:281
+#. type: Content of: <chapter><section><section><screen>
+#: best-pkging-practices.dbk:293
#, no-wrap
-msgid ""
-"\n"
-"ispell -d american -g debian/control\n"
+msgid "ispell -d american -g debian/control\n"
msgstr ""
-# type: Content of: <chapter><section><section><screen>
-#: best-pkging-practices.dbk:284
+#. type: Content of: <chapter><section><section><screen>
+#: best-pkging-practices.dbk:296
#, no-wrap
-msgid ""
-"\n"
-"aspell -d en -D -c debian/control\n"
+msgid "aspell -d en -D -c debian/control\n"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:288
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:299
msgid ""
"Users usually expect these questions to be answered in the package "
"description:"
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: best-pkging-practices.dbk:293
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: best-pkging-practices.dbk:304
msgid ""
"What does the package do? If it is an add-on to another package, then the "
"short description of the package we are an add-on to should be put in here."
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: best-pkging-practices.dbk:299
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: best-pkging-practices.dbk:310
msgid ""
"Why should I want this package? This is related to the above, but not the "
"same (this is a mail user agent; this is cool, fast, interfaces with PGP and "
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: best-pkging-practices.dbk:306
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: best-pkging-practices.dbk:317
msgid ""
"If this package should not be installed directly, but is pulled in by "
"another package, this should be mentioned."
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: best-pkging-practices.dbk:312
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: best-pkging-practices.dbk:323
msgid ""
"If the package is <literal>experimental</literal>, or there are other "
"reasons it should not be used, if there are other packages that should be "
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: best-pkging-practices.dbk:319
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: best-pkging-practices.dbk:330
msgid ""
"How is this package different from the competition? Is it a better "
"implementation? more features? different features? Why should I choose this "
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: best-pkging-practices.dbk:332
+#. type: Content of: <chapter><section><section><title>
+#: best-pkging-practices.dbk:343
msgid "Upstream home page"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:334
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:345
msgid ""
"We recommend that you add the URL for the package's home page in the "
"<literal>Homepage</literal> field of the <literal>Source</literal> section "
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: best-pkging-practices.dbk:342
+#. type: Content of: <chapter><section><section><title>
+#: best-pkging-practices.dbk:353
msgid "Version Control System location"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:344
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:355
msgid ""
"There are additional fields for the location of the Version Control System "
"in <filename>debian/control</filename>."
msgstr ""
# type: Content of: <chapter><section><section><section><title>
-#: best-pkging-practices.dbk:348
+#. type: Content of: <chapter><section><section><section><title>
+#: best-pkging-practices.dbk:359
msgid "Vcs-Browser"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:350
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:361
msgid ""
"Value of this field should be a <literal>http://</literal> URL pointing to a "
"web-browsable copy of the Version Control System repository used to maintain "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:355
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:366
msgid ""
"The information is meant to be useful for the final user, willing to browse "
"the latest work done on the package (e.g. when looking for the patch fixing "
msgstr ""
# type: Content of: <chapter><section><section><section><title>
-#: best-pkging-practices.dbk:362
+#. type: Content of: <chapter><section><section><section><title>
+#: best-pkging-practices.dbk:373
msgid "Vcs-*"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:364
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:375
msgid ""
"Value of this field should be a string identifying unequivocally the "
"location of the Version Control System repository used to maintain the given "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:375
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:386
msgid ""
"The information is meant to be useful for a user knowledgeable in the given "
"Version Control System and willing to build the current version of a package "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:386
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:397
msgid ""
"In the following example, an instance of the field for a Subversion "
"repository of the <systemitem role=\"package\">vim</systemitem> package is "
"<literal>Homepage</literal> fields described above is also shown."
msgstr ""
-# type: Content of: <chapter><section><section><section><screen>
-#: best-pkging-practices.dbk:394
+#. type: Content of: <chapter><section><section><section><screen>
+#: best-pkging-practices.dbk:406
#, no-wrap
msgid ""
-"\n"
" Source: vim\n"
" Section: editors\n"
" Priority: optional\n"
msgstr ""
# type: Content of: <chapter><section><title>
-#: best-pkging-practices.dbk:410
+#. type: Content of: <chapter><section><title>
+#: best-pkging-practices.dbk:421
msgid "Best practices for <filename>debian/changelog</filename>"
msgstr ""
# type: Content of: <chapter><section><para>
-#: best-pkging-practices.dbk:412
+#. type: Content of: <chapter><section><para>
+#: best-pkging-practices.dbk:423
msgid ""
"The following practices supplement the <ulink url=\"&url-debian-policy;ch-"
"docs.html#s-changelogs\">Policy on changelog files</ulink>."
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: best-pkging-practices.dbk:417
+#. type: Content of: <chapter><section><section><title>
+#: best-pkging-practices.dbk:428
msgid "Writing useful changelog entries"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:419
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:430
msgid ""
"The changelog entry for a package revision documents changes in that "
"revision, and only them. Concentrate on describing significant and user-"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:424
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:435
msgid ""
"Focus on <emphasis>what</emphasis> was changed — who, how and when are "
"usually less important. Having said that, remember to politely attribute "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:430
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:441
msgid ""
"There's no need to elaborate the trivial and obvious changes. You can also "
"aggregate several changes in one entry. On the other hand, don't be overly "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:437
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:448
msgid ""
"Use common English so that the majority of readers can comprehend it. Avoid "
"abbreviations, tech-speak and jargon when explaining changes that close "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:443
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:454
msgid ""
"It is sometimes desirable to prefix changelog entries with the names of the "
"files that were changed. However, there's no need to explicitly list each "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:449
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:460
msgid ""
"When referring to bugs, don't assume anything. Say what the problem was, "
"how it was fixed, and append the closes: #nnnnn string. See <xref linkend="
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: best-pkging-practices.dbk:456
+#. type: Content of: <chapter><section><section><title>
+#: best-pkging-practices.dbk:467
msgid "Common misconceptions about changelog entries"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:458
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:469
msgid ""
"The changelog entries should <emphasis role=\"strong\">not</emphasis> "
"document generic packaging issues (Hey, if you're looking for foo.conf, it's "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:466
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:477
msgid ""
"The only bugs closed with a changelog entry should be those that are "
"actually fixed in the same package revision. Closing unrelated bugs in the "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:471
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:482
msgid ""
"The changelog entries should <emphasis role=\"strong\">not</emphasis> be "
"used for random discussion with bug reporters (I don't see segfaults when "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:482
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:493
msgid ""
"It is an old tradition to acknowledge bugs fixed in non-maintainer uploads "
"in the first changelog entry of the proper maintainer upload. As we have "
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: best-pkging-practices.dbk:490
+#. type: Content of: <chapter><section><section><title>
+#: best-pkging-practices.dbk:501
msgid "Common errors in changelog entries"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:492
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:503
msgid ""
"The following examples demonstrate some common errors or examples of bad "
"style in changelog entries."
msgstr ""
-# type: Content of: <chapter><section><section><screen>
-#: best-pkging-practices.dbk:495
+#. type: Content of: <chapter><section><section><screen>
+#: best-pkging-practices.dbk:507
#, no-wrap
-msgid ""
-"\n"
-" * Fixed all outstanding bugs.\n"
+msgid " * Fixed all outstanding bugs.\n"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:499
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:510
msgid "This doesn't tell readers anything too useful, obviously."
msgstr ""
-# type: Content of: <chapter><section><section><screen>
-#: best-pkging-practices.dbk:501
+#. type: Content of: <chapter><section><section><screen>
+#: best-pkging-practices.dbk:513
#, no-wrap
-msgid ""
-"\n"
-" * Applied patch from Jane Random.\n"
+msgid " * Applied patch from Jane Random.\n"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:505
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:516
msgid "What was the patch about?"
msgstr ""
-# type: Content of: <chapter><section><section><screen>
-#: best-pkging-practices.dbk:507
+#. type: Content of: <chapter><section><section><screen>
+#: best-pkging-practices.dbk:519
#, no-wrap
-msgid ""
-"\n"
-" * Late night install target overhaul.\n"
+msgid " * Late night install target overhaul.\n"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:511
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:522
msgid ""
"Overhaul which accomplished what? Is the mention of late night supposed to "
"remind us that we shouldn't trust that code?"
msgstr ""
-# type: Content of: <chapter><section><section><screen>
-#: best-pkging-practices.dbk:514
+#. type: Content of: <chapter><section><section><screen>
+#: best-pkging-practices.dbk:526
#, no-wrap
-msgid ""
-"\n"
-" * Fix vsync FU w/ ancient CRTs.\n"
+msgid " * Fix vsync FU w/ ancient CRTs.\n"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:518
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:529
msgid ""
"Too many acronyms, and it's not overly clear what the, uh, fsckup (oops, a "
"curse word!) was actually about, or how it was fixed."
msgstr ""
-# type: Content of: <chapter><section><section><screen>
-#: best-pkging-practices.dbk:521
+#. type: Content of: <chapter><section><section><screen>
+#: best-pkging-practices.dbk:533
#, no-wrap
-msgid ""
-"\n"
-" * This is not a bug, closes: #nnnnnn.\n"
+msgid " * This is not a bug, closes: #nnnnnn.\n"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:525
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:536
msgid ""
"First of all, there's absolutely no need to upload the package to convey "
"this information; instead, use the bug tracking system. Secondly, there's "
"no explanation as to why the report is not a bug."
msgstr ""
-# type: Content of: <chapter><section><section><screen>
-#: best-pkging-practices.dbk:529
+#. type: Content of: <chapter><section><section><screen>
+#: best-pkging-practices.dbk:541
#, no-wrap
-msgid ""
-"\n"
-" * Has been fixed for ages, but I forgot to close; closes: #54321.\n"
+msgid " * Has been fixed for ages, but I forgot to close; closes: #54321.\n"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:533
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:544
msgid ""
"If for some reason you didn't mention the bug number in a previous changelog "
"entry, there's no problem, just close the bug normally in the BTS. There's "
"changelog)."
msgstr ""
-# type: Content of: <chapter><section><section><screen>
-#: best-pkging-practices.dbk:539
+#. type: Content of: <chapter><section><section><screen>
+#: best-pkging-practices.dbk:551
#, no-wrap
-msgid ""
-"\n"
-" * Closes: #12345, #12346, #15432\n"
+msgid " * Closes: #12345, #12346, #15432\n"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:543
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:554
msgid ""
"Where's the description? If you can't think of a descriptive message, start "
"by inserting the title of each different bug."
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: best-pkging-practices.dbk:549
+#. type: Content of: <chapter><section><section><title>
+#: best-pkging-practices.dbk:560
msgid "Supplementing changelogs with NEWS.Debian files"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:551
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:562
msgid ""
"Important news about changes in a package can also be put in <filename> NEWS."
"Debian</filename> files. The news will be displayed by tools like apt-"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:562
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:573
msgid ""
"The file format is the same as a debian changelog file, but leave off the "
"asterisks and describe each news item with a full paragraph when necessary "
"filename> file:"
msgstr ""
-# type: Content of: <chapter><section><section><screen>
-#: best-pkging-practices.dbk:570
+#. type: Content of: <chapter><section><section><screen>
+#: best-pkging-practices.dbk:582
#, no-wrap
msgid ""
-"\n"
"cron (3.0pl1-74) unstable; urgency=low\n"
"\n"
" The checksecurity script is no longer included with the cron package:\n"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:581
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:592
msgid ""
"The <filename>NEWS.Debian</filename> file is installed as <filename> /usr/"
"share/doc/<replaceable>package</replaceable>/NEWS.Debian.gz</filename>. It "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:588
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:599
msgid ""
"Unlike changelog files, you need not update <filename>NEWS.Debian</filename> "
"files with every release. Only update them if you have something "
msgstr ""
# type: Content of: <chapter><section><title>
-#: best-pkging-practices.dbk:610
+#. type: Content of: <chapter><section><title>
+#: best-pkging-practices.dbk:621
msgid "Best practices for maintainer scripts"
msgstr ""
# type: Content of: <chapter><section><para>
-#: best-pkging-practices.dbk:612
+#. type: Content of: <chapter><section><para>
+#: best-pkging-practices.dbk:623
msgid ""
"Maintainer scripts include the files <filename>debian/postinst</filename>, "
"<filename>debian/preinst</filename>, <filename>debian/prerm</filename> and "
msgstr ""
# type: Content of: <chapter><section><para>
-#: best-pkging-practices.dbk:620
+#. type: Content of: <chapter><section><para>
+#: best-pkging-practices.dbk:631
msgid ""
"Maintainer scripts must be idempotent. That means that you need to make "
"sure nothing bad will happen if the script is called twice where it would "
msgstr ""
# type: Content of: <chapter><section><para>
-#: best-pkging-practices.dbk:625
+#. type: Content of: <chapter><section><para>
+#: best-pkging-practices.dbk:636
msgid ""
"Standard input and output may be redirected (e.g. into pipes) for logging "
"purposes, so don't rely on them being a tty."
msgstr ""
# type: Content of: <chapter><section><para>
-#: best-pkging-practices.dbk:629
+#. type: Content of: <chapter><section><para>
+#: best-pkging-practices.dbk:640
msgid ""
"All prompting or interactive configuration should be kept to a minimum. "
"When it is necessary, you should use the <systemitem role=\"package"
msgstr ""
# type: Content of: <chapter><section><para>
-#: best-pkging-practices.dbk:636
+#. type: Content of: <chapter><section><para>
+#: best-pkging-practices.dbk:647
msgid ""
"Keep the maintainer scripts as simple as possible. We suggest you use pure "
"POSIX shell scripts. Remember, if you do need any bash features, the "
msgstr ""
# type: Content of: <chapter><section><para>
-#: best-pkging-practices.dbk:643
+#. type: Content of: <chapter><section><para>
+#: best-pkging-practices.dbk:654
msgid ""
"If you change your maintainer scripts, be sure to test package removal, "
"double installation, and purging. Be sure that a purged package is "
msgstr ""
# type: Content of: <chapter><section><para>
-#: best-pkging-practices.dbk:649
+#. type: Content of: <chapter><section><para>
+#: best-pkging-practices.dbk:660
msgid ""
"If you need to check for the existence of a command, you should use "
"something like"
msgstr ""
# type: Content of: <chapter><section><programlisting>
-#: best-pkging-practices.dbk:652
+#. type: Content of: <chapter><section><programlisting>
+#: best-pkging-practices.dbk:663
#, no-wrap
msgid "if [ -x /usr/sbin/install-docs ]; then ..."
msgstr ""
# type: Content of: <chapter><section><para>
-#: best-pkging-practices.dbk:654
+#. type: Content of: <chapter><section><para>
+#: best-pkging-practices.dbk:665
msgid ""
"If you don't wish to hard-code the path of a command in your maintainer "
"script, the following POSIX-compliant shell function may help:"
msgstr ""
# type: Content of: <chapter><section><para>
-#: best-pkging-practices.dbk:659
+#. type: Content of: <chapter><section><para>
+#: best-pkging-practices.dbk:670
msgid ""
"You can use this function to search <literal>$PATH</literal> for a command "
"name, passed as an argument. It returns true (zero) if the command was "
msgstr ""
# type: Content of: <chapter><section><para>
-#: best-pkging-practices.dbk:666
+#. type: Content of: <chapter><section><para>
+#: best-pkging-practices.dbk:677
msgid ""
"While <command>which</command> is an acceptable alternative, since it is "
"from the required <systemitem role=\"package\">debianutils</systemitem> "
msgstr ""
# type: Content of: <chapter><section><title>
-#: best-pkging-practices.dbk:676
+#. type: Content of: <chapter><section><title>
+#: best-pkging-practices.dbk:687
msgid ""
"Configuration management with <systemitem role=\"package\">debconf</"
"systemitem>"
msgstr ""
# type: Content of: <chapter><section><para>
-#: best-pkging-practices.dbk:678
+#. type: Content of: <chapter><section><para>
+#: best-pkging-practices.dbk:689
msgid ""
"<systemitem role=\"package\">Debconf</systemitem> is a configuration "
"management system which can be used by all the various packaging scripts "
msgstr ""
# type: Content of: <chapter><section><para>
-#: best-pkging-practices.dbk:686
+#. type: Content of: <chapter><section><para>
+#: best-pkging-practices.dbk:697
msgid ""
"Debconf is a great tool but it is often poorly used. Many common mistakes "
"are listed in the <citerefentry> <refentrytitle>debconf-devel</"
msgstr ""
# type: Content of: <chapter><section><para>
-#: best-pkging-practices.dbk:693
+#. type: Content of: <chapter><section><para>
+#: best-pkging-practices.dbk:704
msgid ""
"These guidelines include some writing style and typography recommendations, "
"general considerations about debconf usage as well as more specific "
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: best-pkging-practices.dbk:699
+#. type: Content of: <chapter><section><section><title>
+#: best-pkging-practices.dbk:710
msgid "Do not abuse debconf"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:701
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:712
msgid ""
"Since debconf appeared in Debian, it has been widely abused and several "
"criticisms received by the Debian distribution come from debconf abuse with "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:707
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:718
msgid ""
"Keep usage notes to what they belong: the NEWS.Debian, or README.Debian "
"file. Only use notes for important notes which may directly affect the "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:713
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:724
msgid ""
"Carefully choose the questions priorities in maintainer scripts. See "
"<citerefentry> <refentrytitle>debconf-devel</refentrytitle> <manvolnum>7</"
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: best-pkging-practices.dbk:721
+#. type: Content of: <chapter><section><section><title>
+#: best-pkging-practices.dbk:732
msgid "General recommendations for authors and translators"
msgstr ""
# type: Content of: <chapter><section><section><section><title>
-#: best-pkging-practices.dbk:723
+#. type: Content of: <chapter><section><section><section><title>
+#: best-pkging-practices.dbk:734
msgid "Write correct English"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:725
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:736
msgid ""
"Most Debian package maintainers are not native English speakers. So, "
"writing properly phrased templates may not be easy for them."
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:729
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:740
msgid ""
"Please use (and abuse) &email-debian-l10n-english; mailing list. Have your "
"templates proofread."
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:733
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:744
msgid ""
"Badly written templates give a poor image of your package, of your work...or "
"even of Debian itself."
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:737
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:748
msgid ""
"Avoid technical jargon as much as possible. If some terms sound common to "
"you, they may be impossible to understand for others. If you cannot avoid "
msgstr ""
# type: Content of: <chapter><section><section><section><title>
-#: best-pkging-practices.dbk:745
+#. type: Content of: <chapter><section><section><section><title>
+#: best-pkging-practices.dbk:756
msgid "Be kind to translators"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:747
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:758
msgid ""
"Debconf templates may be translated. Debconf, along with its sister package "
"<command>po-debconf</command> offers a simple framework for getting "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:752
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:763
msgid ""
"Please use gettext-based templates. Install <systemitem role=\"package\">po-"
"debconf</systemitem> on your development system and read its documentation "
"(<literal>man po-debconf</literal> is a good start)."
msgstr ""
-# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:757
+#
. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:768
msgid ""
"Avoid changing templates too often. Changing templates text induces more "
-"work to translators which will get their translation fuzzied. If you plan "
-"changes to your original templates, please contact translators. Most active "
-"translators are very responsive and getting their work included along with "
-"your modified templates will save you additional uploads. If you use "
-"gettext-based templates, the translator's name and e-mail addresses are "
-"mentioned in the po files headers."
+"work to translators which will get their translation fuzzied. A fuzzy "
+"translation is a string for which the original changed since it was "
+"translated, therefore requiring some update by a translator to be usable. "
+"When changes are small enough, the original translation is kept in PO files "
+"but marked as <literal>fuzzy</literal>."
msgstr ""
-# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:766
+#
. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:776
msgid ""
-"The use of the <command>podebconf-report-po</command> from the <systemitem "
-"role=\"package\">po-debconf</systemitem> package is highly recommended to "
-"warn translators which have incomplete translations and request them for "
-"updates."
+"If you plan to do changes to your original templates, please use the "
+"notification system provided with the <systemitem role=\"package\">po-"
+"debconf</systemitem> package, namely the <command> podebconf-report-po</"
+"command>, to contact translators. Most active translators are very "
+"responsive and getting their work included along with your modified "
+"templates will save you additional uploads. If you use gettext-based "
+"templates, the translator's name and e-mail addresses are mentioned in the "
+"PO files headers and will be used by <command> podebconf-report-po</command>."
msgstr ""
-# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:771
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:788
+msgid "A recommended use of that utility is:"
+msgstr ""
+
+#. type: Content of: <chapter><section><section><section><programlisting>
+#: best-pkging-practices.dbk:790
+#, no-wrap
+msgid "cd debian/po && podebconf-report-po --languageteam --withtranslators --call --deadline=\"+10 days\""
+msgstr ""
+
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:792
msgid ""
-"If in doubt, you may also contact the translation team for a given language "
-"(debian-l10n-xxxxx@&lists-host;), or the &email-debian-i18n; mailing list."
+"This command will first synchronize the PO and POT files in debian/po with "
+"the templates files listed in <filename>debian/po/POTFILES.in</filename>. "
+"Then, it will send a call for translation updates to the language team "
+"(mentioned in the <literal>Language-Team</literal> field of each PO file) "
+"as well as the last translator (mentioned in <literal>Last-translator</"
+"literal>). Finally, it will also send a call for new translations, in the "
+"&email-debian-i18n; mailing list."
+msgstr ""
+
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:801
+msgid ""
+"Giving a deadline to translators is always appreciated, so that they can "
+"organize their work. Please remember that some translation teams have a "
+"formalized translate/review process and a delay lower than 10 days is "
+"considered as unreasonable. A shorter delay puts too much pressure on "
+"translation teams and should be kept for very minor changes."
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:776
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:808
msgid ""
-"Calls for translations posted to &email-debian-i18n; with the "
-"<filename>debian/po/templates.pot</filename> file attached or referenced in "
-"a URL are encouraged. Be sure to mentions in these calls for new "
-"translations which languages you have existing translations for, in order to "
-"avoid duplicate work."
+"If in doubt, you may also contact the translation team for a given language "
+"(debian-l10n-xxxxx@&lists-host;), or the &email-debian-i18n; mailing list."
msgstr ""
# type: Content of: <chapter><section><section><section><title>
-#: best-pkging-practices.dbk:785
+#. type: Content of: <chapter><section><section><section><title>
+#: best-pkging-practices.dbk:815
msgid "Unfuzzy complete translations when correcting typos and spelling"
msgstr ""
-# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:787
+#
. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:817
msgid ""
"When the text of a debconf template is corrected and you are <emphasis role="
"\"strong\">sure</emphasis> that the change does <emphasis role=\"strong"
"\">not</emphasis> affect translations, please be kind to translators and "
-"unfuzzy their translations."
+"<emphasis>unfuzzy</emphasis> their translations."
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:793
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:823
msgid ""
"If you don't do so, the whole template will not be translated as long as a "
"translator will send you an update."
msgstr ""
-# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:797
+#
. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:827
msgid ""
-"To <literal>unfuzzy</literal> translations, you can proceed the following "
-"way:"
+"To <emphasis>unfuzzy</emphasis> translations, you can use two methods. The "
+"first method does <emphasis>preventive</emphasis> search and replace actions "
+"in the PO files. The latter uses <command>gettext</command> utilities to "
+"<emphasis>unfuzzy</emphasis> strings."
msgstr ""
-# type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
-#: best-pkging-practices.dbk:803
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:833
+msgid "<emphasis>Preventive unfuzzy</emphasis> method:"
+msgstr ""
+
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
+#: best-pkging-practices.dbk:838
msgid ""
-"Put all incomplete PO files out of the way. You can check the completeness "
-"by using (needs the <systemitem role=\"package\">gettext</systemitem> "
-"package installed):"
+"Try finding a complete translation file <emphasis role=\"strong\"> before</"
+"emphasis> the change:"
msgstr ""
# type: Content of: <chapter><section><section><section><orderedlist><listitem><programlisting>
-#: best-pkging-practices.dbk:807
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><programlisting>
+#: best-pkging-practices.dbk:841 best-pkging-practices.dbk:911
#, no-wrap
msgid ""
"for i in debian/po/*po; do echo -n $i: ; msgfmt -o /dev/null\n"
"--statistics $i; done"
msgstr ""
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
+#: best-pkging-practices.dbk:844
+msgid ""
+"The file only showing <emphasis>translated</emphasis> items will be used as "
+"the reference file. If there is none (which should not happen if you take "
+"care to properly interact with translators), you should use the file with "
+"the most translated strings."
+msgstr ""
+
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
+#: best-pkging-practices.dbk:852
+msgid ""
+"Identify the needed change. In this example, let's assume the change is "
+"about fixing a typo in the word <literal>typo</literal> which was "
+"inadvertently written as <literal>tpyo</literal>. Therefore, the change is "
+"<command>s/tpyo/typo</command>."
+msgstr ""
+
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
+#: best-pkging-practices.dbk:860
+msgid ""
+"Check that this change is only applied to the place where you really intend "
+"to make it and <emphasis role=\"strong\">not</emphasis> in any other place "
+"where the original string is appropriate. This specifically applies to "
+"change in punctuation, for instance."
+msgstr ""
+
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
+#: best-pkging-practices.dbk:868
+msgid ""
+"Modify all PO files by using <command>sed</command>. The use of that command "
+"is recommended over any text editor to guarantee that the files encoding "
+"will not be broken by the edit action."
+msgstr ""
+
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><programlisting>
+#: best-pkging-practices.dbk:873
+#, no-wrap
+msgid ""
+"cd debian/po\n"
+"for i in *.po; do sed -i 's/tpyo/typo/g' $i; done\n"
+msgstr ""
+
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
+#: best-pkging-practices.dbk:879
+msgid "Change the debconf template file to fix the typo."
+msgstr ""
+
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
+#: best-pkging-practices.dbk:884
+msgid "Run <command>debconf-updatepo</command>"
+msgstr ""
+
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
+#: best-pkging-practices.dbk:889
+msgid ""
+"Check the <filename>foo.po</filename> reference file. Its statistics should "
+"not be changed:"
+msgstr ""
+
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><programlisting>
+#: best-pkging-practices.dbk:893
+#, no-wrap
+msgid "msgfmt -o /dev/null --statistics debian/po/foo.po\n"
+msgstr ""
+
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:902
+msgid "Gettext utilities method:"
+msgstr ""
+
# type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
-#: best-pkging-practices.dbk:812
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
+#: best-pkging-practices.dbk:907
+msgid ""
+"Put all incomplete PO files out of the way. You can check the completeness "
+"by using (needs the <systemitem role=\"package\">gettext</systemitem> "
+"package installed):"
+msgstr ""
+
+# type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
+#: best-pkging-practices.dbk:916
msgid ""
"move all files which report either fuzzy strings to a temporary place. "
"Files which report no fuzzy strings (only translated and untranslated) will "
msgstr ""
# type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
-#: best-pkging-practices.dbk:819
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
+#: best-pkging-practices.dbk:923
msgid ""
"now <emphasis role=\"strong\">and now only</emphasis>, modify the template "
"for the typos and check again that translation are not impacted (typos, "
msgstr ""
# type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
-#: best-pkging-practices.dbk:826
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
+#: best-pkging-practices.dbk:930
msgid ""
"run <command>debconf-updatepo</command>. This will fuzzy all strings you "
"modified in translations. You can see this by running the above again"
msgstr ""
# type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
-#: best-pkging-practices.dbk:832
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
+#: best-pkging-practices.dbk:936
msgid "use the following command:"
msgstr ""
# type: Content of: <chapter><section><section><section><orderedlist><listitem><programlisting>
-#: best-pkging-practices.dbk:834
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><programlisting>
+#: best-pkging-practices.dbk:938
#, no-wrap
msgid "for i in debian/po/*po; do msgattrib --output-file=$i --clear-fuzzy $i; done"
msgstr ""
# type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
-#: best-pkging-practices.dbk:838
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
+#: best-pkging-practices.dbk:942
msgid ""
"move back to debian/po the files which showed fuzzy strings in the first step"
msgstr ""
# type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
-#: best-pkging-practices.dbk:843
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
+#: best-pkging-practices.dbk:947
msgid "run <command>debconf-updatepo</command> again"
msgstr ""
# type: Content of: <chapter><section><section><section><title>
-#: best-pkging-practices.dbk:850
+#. type: Content of: <chapter><section><section><section><title>
+#: best-pkging-practices.dbk:954
msgid "Do not make assumptions about interfaces"
msgstr ""
-# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:852
+#
. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:956
msgid ""
"Templates text should not make reference to widgets belonging to some "
-"debconf interfaces. Sentences like If you answer Yes... have no meaning "
-"for users of graphical interfaces which use checkboxes for boolean questions."
+"debconf interfaces. Sentences like <emphasis>If you answer Yes...</"
+"emphasis> have no meaning for users of graphical interfaces which use "
+"checkboxes for boolean questions."
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:857
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:961
msgid ""
"String templates should also avoid mentioning the default values in their "
"description. First, because this is redundant with the values seen by the "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:863
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:967
msgid ""
"More generally speaking, try to avoid referring to user actions. Just give "
"facts."
msgstr ""
# type: Content of: <chapter><section><section><section><title>
-#: best-pkging-practices.dbk:869
+#. type: Content of: <chapter><section><section><section><title>
+#: best-pkging-practices.dbk:973
msgid "Do not use first person"
msgstr ""
-# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:871
+#
. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:975
msgid ""
-"You should avoid the use of first person (I will do this... or We "
-"recommend...). The computer is not a person and the Debconf templates do "
-"not speak for the Debian developers. You should use neutral construction. "
-"Those of you who already wrote scientific publications, just write your "
-"templates like you would write a scientific paper. However, try using "
-"action voice if still possible, like Enable this if ... instead of This can "
-"be enabled if ...."
+"You should avoid the use of first person (<emphasis>I will do this...</"
+"emphasis> or <emphasis>We recommend...</emphasis>). The computer is not a "
+"person and the Debconf templates do not speak for the Debian developers. "
+"You should use neutral construction. Those of you who already wrote "
+"scientific publications, just write your templates like you would write a "
+"scientific paper. However, try using active voice if still possible, like "
+"<emphasis>Enable this if ...</emphasis> instead of <emphasis>This can be "
+"enabled if...</emphasis>."
msgstr ""
# type: Content of: <chapter><section><section><section><title>
-#: best-pkging-practices.dbk:881
+#. type: Content of: <chapter><section><section><section><title>
+#: best-pkging-practices.dbk:985
msgid "Be gender neutral"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:883
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:987
msgid ""
"The world is made of men and women. Please use gender-neutral constructions "
"in your writing."
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: best-pkging-practices.dbk:891
+#. type: Content of: <chapter><section><section><title>
+#: best-pkging-practices.dbk:995
msgid "Templates fields definition"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:893
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:997
msgid ""
"This part gives some information which is mostly taken from the "
"<citerefentry> <refentrytitle>debconf-devel</refentrytitle> <manvolnum>7</"
msgstr ""
# type: Content of: <chapter><section><section><section><title>
-#: best-pkging-practices.dbk:898
+#. type: Content of: <chapter><section><section><section><title>
+#: best-pkging-practices.dbk:1002
msgid "Type"
msgstr ""
# type: Content of: <chapter><section><section><section><section><title>
-#: best-pkging-practices.dbk:900
+#. type: Content of: <chapter><section><section><section><section><title>
+#: best-pkging-practices.dbk:1004
msgid "string:"
msgstr ""
# type: Content of: <chapter><section><section><section><section><para>
-#: best-pkging-practices.dbk:902
+#. type: Content of: <chapter><section><section><section><section><para>
+#: best-pkging-practices.dbk:1006
msgid ""
"Results in a free-form input field that the user can type any string into."
msgstr ""
# type: Content of: <chapter><section><section><section><section><title>
-#: best-pkging-practices.dbk:907
+#. type: Content of: <chapter><section><section><section><section><title>
+#: best-pkging-practices.dbk:1011
msgid "password:"
msgstr ""
# type: Content of: <chapter><section><section><section><section><para>
-#: best-pkging-practices.dbk:909
+#. type: Content of: <chapter><section><section><section><section><para>
+#: best-pkging-practices.dbk:1013
msgid ""
"Prompts the user for a password. Use this with caution; be aware that the "
"password the user enters will be written to debconf's database. You should "
msgstr ""
# type: Content of: <chapter><section><section><section><section><title>
-#: best-pkging-practices.dbk:916
+#. type: Content of: <chapter><section><section><section><section><title>
+#: best-pkging-practices.dbk:1020
msgid "boolean:"
msgstr ""
# type: Content of: <chapter><section><section><section><section><para>
-#: best-pkging-practices.dbk:918
+#. type: Content of: <chapter><section><section><section><section><para>
+#: best-pkging-practices.dbk:1022
msgid ""
"A true/false choice. Remember: true/false, <emphasis role=\"strong\">not "
"yes/no</emphasis>..."
msgstr ""
# type: Content of: <chapter><section><section><section><section><title>
-#: best-pkging-practices.dbk:924
+#. type: Content of: <chapter><section><section><section><section><title>
+#: best-pkging-practices.dbk:1028
msgid "select:"
msgstr ""
-# type: Content of: <chapter><section><section><section><section><para>
-#: best-pkging-practices.dbk:926
+#
. type: Content of: <chapter><section><section><section><section><para>
+#: best-pkging-practices.dbk:1030
msgid ""
"A choice between one of a number of values. The choices must be specified "
"in a field named 'Choices'. Separate the possible values with commas and "
-"spaces, like this: Choices: yes, no, maybe"
+"spaces, like this: <literal>Choices: yes, no, maybe</literal>."
+msgstr ""
+
+#. type: Content of: <chapter><section><section><section><section><para>
+#: best-pkging-practices.dbk:1035
+msgid ""
+"If choices are translatable strings, the 'Choices' field may be marked as "
+"translatable by using <literal>__Choices</literal>. The double underscore "
+"will split out each choice in a separate string."
+msgstr ""
+
+#. type: Content of: <chapter><section><section><section><section><para>
+#: best-pkging-practices.dbk:1040
+msgid ""
+"The <command>po-debconf</command> system also offers interesting "
+"possibilities to only mark <emphasis role=\"strong\">some</emphasis> choices "
+"as translatable. Example:"
+msgstr ""
+
+#. type: Content of: <chapter><section><section><section><section><programlisting>
+#: best-pkging-practices.dbk:1045
+#, no-wrap
+msgid ""
+"Template: foo/bar\n"
+"Type: Select\n"
+"#flag:translate:3\n"
+"__Choices: PAL, SECAM, Other\n"
+"_Description: TV standard:\n"
+" Please choose the TV standard used in your country.\n"
+msgstr ""
+
+#. type: Content of: <chapter><section><section><section><section><para>
+#: best-pkging-practices.dbk:1053
+msgid ""
+"In that example, only the 'Other' string is translatable while others are "
+"acronyms that should not be translated. The above allows only 'Other' to be "
+"included in PO and POT files."
+msgstr ""
+
+#. type: Content of: <chapter><section><section><section><section><para>
+#: best-pkging-practices.dbk:1058
+msgid ""
+"The debconf templates flag system offers many such possibilities. The "
+"<citerefentry> <refentrytitle>po-debconf</refentrytitle> <manvolnum>7</"
+"manvolnum> </citerefentry> manual page lists all these possibilities."
msgstr ""
# type: Content of: <chapter><section><section><section><section><title>
-#: best-pkging-practices.dbk:933
+#. type: Content of: <chapter><section><section><section><section><title>
+#: best-pkging-practices.dbk:1066
msgid "multiselect:"
msgstr ""
# type: Content of: <chapter><section><section><section><section><para>
-#: best-pkging-practices.dbk:935
+#. type: Content of: <chapter><section><section><section><section><para>
+#: best-pkging-practices.dbk:1068
msgid ""
"Like the select data type, except the user can choose any number of items "
"from the choices list (or chose none of them)."
msgstr ""
# type: Content of: <chapter><section><section><section><section><title>
-#: best-pkging-practices.dbk:941
+#. type: Content of: <chapter><section><section><section><section><title>
+#: best-pkging-practices.dbk:1074
msgid "note:"
msgstr ""
# type: Content of: <chapter><section><section><section><section><para>
-#: best-pkging-practices.dbk:943
+#. type: Content of: <chapter><section><section><section><section><para>
+#: best-pkging-practices.dbk:1076
msgid ""
"Rather than being a question per se, this datatype indicates a note that can "
"be displayed to the user. It should be used only for important notes that "
msgstr ""
# type: Content of: <chapter><section><section><section><section><title>
-#: best-pkging-practices.dbk:952
+#. type: Content of: <chapter><section><section><section><section><title>
+#: best-pkging-practices.dbk:1085
msgid "text:"
msgstr ""
# type: Content of: <chapter><section><section><section><section><para>
-#: best-pkging-practices.dbk:954
+#. type: Content of: <chapter><section><section><section><section><para>
+#: best-pkging-practices.dbk:1087
msgid "This type is now considered obsolete: don't use it."
msgstr ""
# type: Content of: <chapter><section><section><section><section><title>
-#: best-pkging-practices.dbk:959
+#. type: Content of: <chapter><section><section><section><section><title>
+#: best-pkging-practices.dbk:1092
msgid "error:"
msgstr ""
# type: Content of: <chapter><section><section><section><section><para>
-#: best-pkging-practices.dbk:961
+#. type: Content of: <chapter><section><section><section><section><para>
+#: best-pkging-practices.dbk:1094
msgid ""
"This type is designed to handle error messages. It is mostly similar to the "
"note type. Frontends may present it differently (for instance, the dialog "
msgstr ""
# type: Content of: <chapter><section><section><section><section><para>
-#: best-pkging-practices.dbk:966
+#. type: Content of: <chapter><section><section><section><section><para>
+#: best-pkging-practices.dbk:1099
msgid ""
"It is recommended to use this type for any message that needs user attention "
"for a correction of any kind."
msgstr ""
# type: Content of: <chapter><section><section><section><title>
-#: best-pkging-practices.dbk:974
+#. type: Content of: <chapter><section><section><section><title>
+#: best-pkging-practices.dbk:1107
msgid "Description: short and extended description"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:976
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1109
msgid ""
"Template descriptions have two parts: short and extended. The short "
"description is in the Description: line of the template."
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:980
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1113
msgid ""
"The short description should be kept short (50 characters or so) so that it "
"may be accomodated by most debconf interfaces. Keeping it short also helps "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:986
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1119
msgid ""
"The short description should be able to stand on its own. Some interfaces "
"do not show the long description by default, or only if the user explicitely "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:992
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1125
msgid ""
"The short description does not necessarily have to be a full sentence. This "
"is part of the keep it short and efficient recommendation."
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:996
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1129
msgid ""
"The extended description should not repeat the short description word for "
"word. If you can't think up a long description, then first, think some "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1003
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1136
msgid ""
"The extended description should use complete sentences. Paragraphs should "
"be kept short for improved readability. Do not mix two ideas in the same "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1008
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1141
msgid ""
"Don't be too verbose. User tend to ignore too long screens. 20 lines are "
"by experience a border you shouldn't cross, because that means that in the "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1014
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1147
msgid ""
"The extended description should <emphasis role=\"strong\">never</emphasis> "
"include a question."
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1018
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1151
msgid ""
"For specific rules depending on templates type (string, boolean, etc.), "
"please read below."
msgstr ""
# type: Content of: <chapter><section><section><section><title>
-#: best-pkging-practices.dbk:1024
+#. type: Content of: <chapter><section><section><section><title>
+#: best-pkging-practices.dbk:1157
msgid "Choices"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1026
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1159
msgid ""
"This field should be used for Select and Multiselect types. It contains the "
"possible choices which will be presented to users. These choices should be "
msgstr ""
# type: Content of: <chapter><section><section><section><title>
-#: best-pkging-practices.dbk:1033
+#. type: Content of: <chapter><section><section><section><title>
+#: best-pkging-practices.dbk:1166
msgid "Default"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1035
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1168
msgid ""
"This field is optional. It contains the default answer for string, select "
"and multiselect templates. For multiselect templates, it may contain a "
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: best-pkging-practices.dbk:1044
+#. type: Content of: <chapter><section><section><title>
+#: best-pkging-practices.dbk:1177
msgid "Templates fields specific style guide"
msgstr ""
# type: Content of: <chapter><section><section><section><title>
-#: best-pkging-practices.dbk:1046
+#. type: Content of: <chapter><section><section><section><title>
+#: best-pkging-practices.dbk:1179
msgid "Type field"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1048
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1181
msgid ""
"No specific indication except: use the appropriate type by referring to the "
"previous section."
msgstr ""
# type: Content of: <chapter><section><section><section><title>
-#: best-pkging-practices.dbk:1054
+#. type: Content of: <chapter><section><section><section><title>
+#: best-pkging-practices.dbk:1187
msgid "Description field"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1056
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1189
msgid ""
"Below are specific instructions for properly writing the Description (short "
"and extended) depending on the template type."
msgstr ""
# type: Content of: <chapter><section><section><section><section><title>
-#: best-pkging-practices.dbk:1060
+#. type: Content of: <chapter><section><section><section><section><title>
+#: best-pkging-practices.dbk:1193
msgid "String/password templates"
msgstr ""
# type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
-#: best-pkging-practices.dbk:1064
+#. type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
+#: best-pkging-practices.dbk:1197
msgid ""
"The short description is a prompt and <emphasis role=\"strong\">not</"
"emphasis> a title. Avoid question style prompts (IP Address?) in favour of "
msgstr ""
# type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
-#: best-pkging-practices.dbk:1071
+#. type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
+#: best-pkging-practices.dbk:1204
msgid ""
"The extended description is a complement to the short description. In the "
"extended part, explain what is being asked, rather than ask the same "
msgstr ""
# type: Content of: <chapter><section><section><section><section><title>
-#: best-pkging-practices.dbk:1081
+#. type: Content of: <chapter><section><section><section><section><title>
+#: best-pkging-practices.dbk:1214
msgid "Boolean templates"
msgstr ""
# type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
-#: best-pkging-practices.dbk:1085
+#. type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
+#: best-pkging-practices.dbk:1218
msgid ""
"The short description should be phrased in the form of a question which "
"should be kept short and should generally end with a question mark. Terse "
msgstr ""
# type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
-#: best-pkging-practices.dbk:1093
+#. type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
+#: best-pkging-practices.dbk:1226
msgid ""
"Again, please avoid referring to specific interface widgets. A common "
"mistake for such templates is if you answer Yes-type constructions."
msgstr ""
# type: Content of: <chapter><section><section><section><section><title>
-#: best-pkging-practices.dbk:1101
+#. type: Content of: <chapter><section><section><section><section><title>
+#: best-pkging-practices.dbk:1234
msgid "Select/Multiselect"
msgstr ""
# type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
-#: best-pkging-practices.dbk:1105
+#. type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
+#: best-pkging-practices.dbk:1238
msgid ""
"The short description is a prompt and <emphasis role=\"strong\">not</"
"emphasis> a title. Do <emphasis role=\"strong\">not</emphasis> use useless "
msgstr ""
# type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
-#: best-pkging-practices.dbk:1113
+#. type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
+#: best-pkging-practices.dbk:1246
msgid ""
"The extended description will complete the short description. It may refer "
"to the available choices. It may also mention that the user may choose more "
msgstr ""
# type: Content of: <chapter><section><section><section><section><title>
-#: best-pkging-practices.dbk:1123
+#. type: Content of: <chapter><section><section><section><section><title>
+#: best-pkging-practices.dbk:1256
msgid "Notes"
msgstr ""
# type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
-#: best-pkging-practices.dbk:1127
+#. type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
+#: best-pkging-practices.dbk:1260
msgid "The short description should be considered to be a *title*."
msgstr ""
# type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
-#: best-pkging-practices.dbk:1132
+#. type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
+#: best-pkging-practices.dbk:1265
msgid ""
"The extended description is what will be displayed as a more detailed "
"explanation of the note. Phrases, no terse writing style."
msgstr ""
# type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
-#: best-pkging-practices.dbk:1138
+#. type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
+#: best-pkging-practices.dbk:1271
msgid ""
"<emphasis role=\"strong\">Do not abuse debconf.</emphasis> Notes are the "
"most common way to abuse debconf. As written in debconf-devel manual page: "
msgstr ""
# type: Content of: <chapter><section><section><section><title>
-#: best-pkging-practices.dbk:1153
+#. type: Content of: <chapter><section><section><section><title>
+#: best-pkging-practices.dbk:1286
msgid "Choices field"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1155
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1288
msgid ""
"If the Choices are likely to change often, please consider using the "
"__Choices trick. This will split each individual choice into a single "
msgstr ""
# type: Content of: <chapter><section><section><section><title>
-#: best-pkging-practices.dbk:1162 best-pkging-practices.dbk:1200
+#. type: Content of: <chapter><section><section><section><title>
+#: best-pkging-practices.dbk:1295 best-pkging-practices.dbk:1333
msgid "Default field"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1164
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1297
msgid ""
"If the default value, for a select template, is likely to vary depending on "
"the user language (for instance, if the choice is a language choice), please "
"use the _DefaultChoice trick."
msgstr ""
-# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1169
+#
. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1302
msgid ""
"This special field allow translators to put the most appropriate choice "
"according to their own language. It will become the default choice when "
"their language is used while your own mentioned Default Choice will be used "
-"chan using English."
+"when using English."
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1175
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1308
msgid "Example, taken from the geneweb package templates:"
msgstr ""
-# type: Content of: <chapter><section><section><section><screen>
-#: best-pkging-practices.dbk:1177
+#. type: Content of: <chapter><section><section><section><screen>
+#: best-pkging-practices.dbk:1311
#, no-wrap
msgid ""
-"\n"
"Template: geneweb/lang\n"
"Type: select\n"
"__Choices: Afrikaans (af), Bulgarian (bg), Catalan (ca), Chinese (zh), Czech (cs), Danish (da), Dutch (nl), English (en), Esperanto (eo), Estonian (et), Finnish (fi), French (fr), German (de), Hebrew (he), Icelandic (is), Italian (it), Latvian (lv), Norwegian (no), Polish (pl), Portuguese (pt), Romanian (ro), Russian (ru), Spanish (es), Swedish (sv)\n"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1189
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1322
msgid ""
"Note the use of brackets which allow internal comments in debconf fields. "
"Also note the use of comments which will show up in files the translators "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1194
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1327
msgid ""
"The comments are needed as the DefaultChoice trick is a bit confusing: the "
"translators may put their own choice"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1202
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1335
msgid ""
"Do NOT use empty default field. If you don't want to use default values, do "
"not use Default at all."
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1206
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1339
msgid ""
"If you use po-debconf (and you <emphasis role=\"strong\">should</emphasis>, "
"see 2.2), consider making this field translatable, if you think it may be "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1211
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1344
msgid ""
"If the default value may vary depending on language/country (for instance "
"the default value for a language choice), consider using the special "
msgstr ""
# type: Content of: <chapter><section><title>
-#: best-pkging-practices.dbk:1223
+#. type: Content of: <chapter><section><title>
+#: best-pkging-practices.dbk:1356
msgid "Internationalization"
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: best-pkging-practices.dbk:1225
+#. type: Content of: <chapter><section><section><title>
+#: best-pkging-practices.dbk:1358
msgid "Handling debconf translations"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1227
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1360
msgid ""
"Like porters, translators have a difficult task. They work on many packages "
"and must collaborate with many different maintainers. Moreover, most of the "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1233
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1366
msgid ""
"The goal of <systemitem role=\"package\">debconf</systemitem> was to make "
"packages configuration easier for maintainers and for users. Originally, "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1243
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1376
msgid ""
"Using <systemitem role=\"package\">po-debconf</systemitem>, the translation "
"is stored in <filename>po</filename> files (drawing from <command>gettext</"
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: best-pkging-practices.dbk:1259
+#. type: Content of: <chapter><section><section><title>
+#: best-pkging-practices.dbk:1392
msgid "Internationalized documentation"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1261
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1394
msgid ""
"Internationalizing documentation is crucial for users, but a lot of labor. "
"There's no way to eliminate all that work, but you can make things easier "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1266
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1399
msgid ""
"If you maintain documentation of any size, its easier for translators if "
"they have access to a source control system. That lets translators see the "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1280
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1413
msgid ""
"If you maintain XML or SGML documentation, we suggest that you isolate any "
"language-independent information and define those as entities in a separate "
msgstr ""
# type: Content of: <chapter><section><title>
-#: best-pkging-practices.dbk:1290
+#. type: Content of: <chapter><section><title>
+#: best-pkging-practices.dbk:1423
msgid "Common packaging situations"
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: best-pkging-practices.dbk:1301
+#. type: Content of: <chapter><section><section><title>
+#: best-pkging-practices.dbk:1434
msgid "Packages using <command>autoconf</command>/<command>automake</command>"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1303
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1436
msgid ""
"Keeping <command>autoconf</command>'s <filename>config.sub</filename> and "
"<filename>config.guess</filename> files up to date is critical for porters, "
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: best-pkging-practices.dbk:1315
+#. type: Content of: <chapter><section><section><title>
+#: best-pkging-practices.dbk:1448
msgid "Libraries"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1317
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1450
msgid ""
"Libraries are always difficult to package for various reasons. The policy "
"imposes many constraints to ease their maintenance and to make sure upgrades "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1323
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1456
msgid ""
"Good practices for library packaging have been grouped in <ulink url=\"&url-"
"libpkg-guide;\">the library packaging guide</ulink>."
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: best-pkging-practices.dbk:1330
+#. type: Content of: <chapter><section><section><title>
+#: best-pkging-practices.dbk:1463
msgid "Documentation"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1332
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1465
msgid ""
"Be sure to follow the <ulink url=\"&url-debian-policy;ch-docs.html\">Policy "
"on documentation</ulink>."
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1337
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1470
msgid ""
"If your package contains documentation built from XML or SGML, we recommend "
"you not ship the XML or SGML source in the binary package(s). If users want "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1342
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1475
msgid ""
"Policy specifies that documentation should be shipped in HTML format. We "
"also recommend shipping documentation in PDF and plain text format if "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1349
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1482
msgid ""
"Major shipped manuals should register themselves with <systemitem role="
"\"package\">doc-base</systemitem> on installation. See the <systemitem role="
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: best-pkging-practices.dbk:1357
+#. type: Content of: <chapter><section><section><title>
+#: best-pkging-practices.dbk:1490
msgid "Specific types of packages"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1359
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1492
msgid ""
"Several specific types of packages have special sub-policies and "
"corresponding packaging rules and practices:"
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: best-pkging-practices.dbk:1365
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: best-pkging-practices.dbk:1498
msgid ""
"Perl related packages have a <ulink url=\"&url-perl-policy;\">Perl policy</"
"ulink>, some examples of packages following that policy are <systemitem role="
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: best-pkging-practices.dbk:1374
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: best-pkging-practices.dbk:1507
msgid ""
"Python related packages have their python policy; see &file-python-policy; "
"in the <systemitem role=\"package\">python</systemitem> package."
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: best-pkging-practices.dbk:1381
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: best-pkging-practices.dbk:1514
msgid ""
"Emacs related packages have the <ulink url=\"&url-emacs-policy;\">emacs "
"policy</ulink>."
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: best-pkging-practices.dbk:1388
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: best-pkging-practices.dbk:1521
msgid ""
"Java related packages have their <ulink url=\"&url-java-policy;\">java "
"policy</ulink>."
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: best-pkging-practices.dbk:1395
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: best-pkging-practices.dbk:1528
msgid ""
"Ocaml related packages have their own policy, found in &file-ocaml-policy; "
"from the <systemitem role=\"package\">ocaml</systemitem> package. A good "
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: best-pkging-practices.dbk:1403
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: best-pkging-practices.dbk:1536
msgid ""
"Packages providing XML or SGML DTDs should conform to the recommendations "
"found in the <systemitem role=\"package\">sgml-base-doc</systemitem> package."
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: best-pkging-practices.dbk:1409
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: best-pkging-practices.dbk:1542
msgid ""
"Lisp packages should register themselves with <systemitem role=\"package"
"\">common-lisp-controller</systemitem>, about which see &file-lisp-"
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: best-pkging-practices.dbk:1439
+#. type: Content of: <chapter><section><section><title>
+#: best-pkging-practices.dbk:1572
msgid "Architecture-independent data"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1441
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1574
msgid ""
"It is not uncommon to have a large amount of architecture-independent data "
"packaged with a program. For example, audio files, a collection of icons, "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1448
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1581
msgid ""
"However, if the size of the data is considerable, consider splitting it out "
"into a separate, architecture-independent package (_all.deb). By doing "
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: best-pkging-practices.dbk:1460
+#. type: Content of: <chapter><section><section><title>
+#: best-pkging-practices.dbk:1593
msgid "Needing a certain locale during build"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1462
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1595
msgid ""
"If you need a certain locale during build, you can create a temporary file "
"via this trick:"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1466
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1599
msgid ""
"If you set <varname>LOCPATH</varname> to the equivalent of <filename>/usr/"
"lib/locale</filename>, and <varname>LC_ALL</varname> to the name of the "
"Something like this:"
msgstr ""
-# type: Content of: <chapter><section><section><screen>
-#: best-pkging-practices.dbk:1470
+#. type: Content of: <chapter><section><section><screen>
+#: best-pkging-practices.dbk:1604
#, no-wrap
msgid ""
-"\n"
"LOCALE_PATH=debian/tmpdir/usr/lib/locale\n"
"LOCALE_NAME=en_IN\n"
"LOCALE_CHARSET=UTF-8\n"
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: best-pkging-practices.dbk:1484
+#. type: Content of: <chapter><section><section><title>
+#: best-pkging-practices.dbk:1617
msgid "Make transition packages deborphan compliant"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1486
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1619
msgid ""
"Deborphan is a program for helping users to detect which packages can safely "
"be removed from the system, i.e. the ones that have no packages depending "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1493
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1626
msgid ""
"For example, with <literal>--guess-dummy</literal>, <command>deborphan</"
"command> tries to search all transitional packages which were needed for "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1500
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1633
msgid ""
"So, when you are creating such a package, please make sure to add this text "
"to your short description. If you are looking for examples, just run: "
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: best-pkging-practices.dbk:1508
+#. type: Content of: <chapter><section><section><title>
+#: best-pkging-practices.dbk:1641
msgid "Best practices for <filename>orig.tar.gz</filename> files"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1510
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1643
msgid ""
"There are two kinds of original source tarballs: Pristine source and "
"repackaged upstream source."
msgstr ""
# type: Content of: <chapter><section><section><section><title>
-#: best-pkging-practices.dbk:1514
+#. type: Content of: <chapter><section><section><section><title>
+#: best-pkging-practices.dbk:1647
msgid "Pristine source"
msgstr ""
-# type: Content of: <chapter><section><section><section><para><footnote>
-#: best-pkging-practices.dbk:1516
-msgid ""
-"The defining characteristic of a pristine source tarball is that the "
-"<literal>.orig.tar.gz</literal> file is byte-for-byte identical to a tarball "
-"officially distributed by the upstream author. <footnote>"
-msgstr ""
-
-# type: Content of: <chapter><section><section><section><para><footnote><para>
-#: best-pkging-practices.dbk:1518
+#. type: Content of: <chapter><section><section><section><para><footnote><para>
+#: best-pkging-practices.dbk:1651
msgid ""
"We cannot prevent upstream authors from changing the tarball they distribute "
"without also incrementing the version number, so there can be no guarantee "
"emphasis> distributing at any point in time. All that can be expected is "
"that it is identical to something that upstream once <emphasis>did</"
"emphasis> distribute. If a difference arises later (say, if upstream "
-"notices that he wasn't using maximal comression in his original distribution "
-"and then re-<command>gzip</command>s it), that's just too bad. Since there "
-"is no good way to upload a new <literal>.orig.tar.gz</literal> for the same "
-"version, there is not even any point in treating this situation as a bug."
+"notices that he wasn't using maximal compression in his original "
+"distribution and then re-<command>gzip</command>s it), that's just too bad. "
+"Since there is no good way to upload a new <literal>.orig.tar.gz</literal> "
+"for the same version, there is not even any point in treating this situation "
+"as a bug."
msgstr ""
-# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1528
+#
. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1649
msgid ""
-"</footnote> This makes it possible to use checksums to easily verify that "
+"The defining characteristic of a pristine source tarball is that the "
+"<literal>.orig.tar.gz</literal> file is byte-for-byte identical to a tarball "
+"officially distributed by the upstream author. <placeholder type=\"footnote"
+"\" id=\"0\"/> This makes it possible to use checksums to easily verify that "
"all changes between Debian's version and upstream's are contained in the "
"Debian diff. Also, if the original source is huge, upstream authors and "
"others who already have the upstream tarball can save download time if they "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1536
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1669
msgid ""
"There is no universally accepted guidelines that upstream authors follow "
"regarding to the directory structure inside their tarball, but <command>dpkg-"
msgstr ""
# type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
-#: best-pkging-practices.dbk:1544
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
+#: best-pkging-practices.dbk:1677
msgid "It unpacks the tarball in an empty temporary directory by doing"
msgstr ""
-# type: Content of: <chapter><section><section><section><orderedlist><listitem><screen>
-#: best-pkging-practices.dbk:1546
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><screen>
+#: best-pkging-practices.dbk:1680
#, no-wrap
-msgid ""
-"\n"
-"zcat path/to/<packagename>_<upstream-version>.orig.tar.gz | tar xf -\n"
+msgid "zcat path/to/<packagename>_<upstream-version>.orig.tar.gz | tar xf -\n"
msgstr ""
# type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
-#: best-pkging-practices.dbk:1552
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
+#: best-pkging-practices.dbk:1685
msgid ""
"If, after this, the temporary directory contains nothing but one directory "
"and no other files, <command>dpkg-source</command> renames that directory to "
msgstr ""
# type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
-#: best-pkging-practices.dbk:1561
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
+#: best-pkging-practices.dbk:1694
msgid ""
"Otherwise, the upstream tarball must have been packaged without a common top-"
"level directory (shame on the upstream author!). In this case, "
msgstr ""
# type: Content of: <chapter><section><section><section><title>
-#: best-pkging-practices.dbk:1572
+#. type: Content of: <chapter><section><section><section><title>
+#: best-pkging-practices.dbk:1705
msgid "Repackaged upstream source"
msgstr "upstream のソースをパッケージしなおす"
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1574
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1707
msgid ""
"You <emphasis role=\"strong\">should</emphasis> upload packages with a "
"pristine source tarball if possible, but there are various reasons why it "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1581
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1714
msgid ""
"In these cases the developer must construct a suitable <literal>.orig.tar.gz "
"</literal> file himself. We refer to such a tarball as a repackaged "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1590
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1723
msgid ""
"There may be cases where it is desirable to repackage the source even though "
"upstream distributes a <literal>.tar.gz</literal> that could in principle be "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1599
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1732
msgid "A repackaged <literal>.orig.tar.gz</literal>"
msgstr ""
-# type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
-#: best-pkging-practices.dbk:1604
+#
. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
+#: best-pkging-practices.dbk:1737
msgid ""
-"<emphasis role=\"strong\">must</emphasis> contain detailed information how "
-"the repackaged source was obtained, and how this can be reproduced in the "
+"<emphasis role=\"strong\">must</emphasis> be documented in the resulting "
+"source package. Detailed information on how the repackaged source was "
+"obtained, and on how this can be reproduced must be provided in "
"<filename>debian/copyright</filename>. It is also a good idea to provide a "
"<literal>get-orig-source</literal> target in your <filename>debian/rules</"
"filename> file that repeats the process, as described in the Policy Manual, "
"script: debian/rules</ulink>."
msgstr ""
-# type: Content of: <chapter><section><section><section><orderedlist><listitem><para><footnote>
-#: best-pkging-practices.dbk:1616
-msgid ""
-"<emphasis role=\"strong\">should not</emphasis> contain any file that does "
-"not come from the upstream author(s), or whose contents has been changed by "
-"you. <footnote>"
-msgstr ""
-
# type: Content of: <chapter><section><section><section><orderedlist><listitem><para><footnote><para>
#. or similarly named
-#: best-pkging-practices.dbk:1618
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para><footnote><para>
+#: best-pkging-practices.dbk:1752
msgid ""
"As a special exception, if the omission of non-free files would lead to the "
"source failing to build without assistance from the Debian diff, it might be "
"source."
msgstr ""
-# type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
-#: best-pkging-practices.dbk:1625
-msgid "</footnote>"
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
+#: best-pkging-practices.dbk:1750
+msgid ""
+"<emphasis role=\"strong\">should not</emphasis> contain any file that does "
+"not come from the upstream author(s), or whose contents has been changed by "
+"you. <placeholder type=\"footnote\" id=\"0\"/>"
msgstr ""
# type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
-#: best-pkging-practices.dbk:1630
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
+#: best-pkging-practices.dbk:1764
msgid ""
"<emphasis role=\"strong\">should</emphasis>, except where impossible for "
"legal reasons, preserve the entire building and portablility infrastructure "
msgstr ""
# type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
-#: best-pkging-practices.dbk:1639
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
+#: best-pkging-practices.dbk:1773
msgid ""
"(<emphasis>Rationale:</emphasis> It is common for Debian users who need to "
"build software for non-Debian platforms to fetch the source from a Debian "
msgstr ""
# type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
-#: best-pkging-practices.dbk:1646
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
+#: best-pkging-practices.dbk:1780
msgid ""
"<emphasis role=\"strong\">should</emphasis> use <literal><packagename>-"
"<upstream-version>.orig</literal> as the name of the top-level "
msgstr ""
# type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
-#: best-pkging-practices.dbk:1654
+#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
+#: best-pkging-practices.dbk:1788
msgid ""
"<emphasis role=\"strong\">should</emphasis> be gzipped with maximal "
"compression."
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1659
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1793
msgid ""
"The canonical way to meet the latter two points is to let <literal>dpkg-"
"source -b</literal> construct the repackaged tarball from an unpacked "
msgstr ""
# type: Content of: <chapter><section><section><section><title>
-#: best-pkging-practices.dbk:1665
+#. type: Content of: <chapter><section><section><section><title>
+#: best-pkging-practices.dbk:1799
msgid "Changing binary files in <literal>diff.gz</literal>"
msgstr ""
-# type: Content of: <chapter><section><section><section><para><footnote>
-#: best-pkging-practices.dbk:1667
-msgid ""
-"Sometimes it is necessary to change binary files contained in the original "
-"tarball, or to add binary files that are not in it. If this is done by "
-"simply copying the files into the debianized source tree, <command>dpkg-"
-"source</command> will not be able to handle this. On the other hand, "
-"according to the guidelines given above, you cannot include such a changed "
-"binary file in a repackaged <filename>orig.tar.gz</filename>. Instead, "
-"include the file in the <filename>debian</filename> directory in "
-"<command>uuencode</command>d (or similar) form <footnote>"
-msgstr ""
-
# type: Content of: <chapter><section><section><section><para><footnote><para>
-#: best-pkging-practices.dbk:1674
+#. type: Content of: <chapter><section><section><section><para><footnote><para>
+#: best-pkging-practices.dbk:1808
msgid ""
"The file should have a name that makes it clear which binary file it "
"encodes. Usually, some postfix indicating the encoding should be appended "
"literal> function. The code could look like"
msgstr ""
-# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1682
+#. type: Content of: <chapter><section><section><section><para><footnote>
+#: best-pkging-practices.dbk:1816
+msgid "&example-uu;"
+msgstr ""
+
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1801
msgid ""
-"&example-uu; </footnote>. The file would then be decoded and copied to its "
-"place during the build process. Thus the change will be visible quite easy."
+"Sometimes it is necessary to change binary files contained in the original "
+"tarball, or to add binary files that are not in it. If this is done by "
+"simply copying the files into the debianized source tree, <command>dpkg-"
+"source</command> will not be able to handle this. On the other hand, "
+"according to the guidelines given above, you cannot include such a changed "
+"binary file in a repackaged <filename>orig.tar.gz</filename>. Instead, "
+"include the file in the <filename>debian</filename> directory in "
+"<command>uuencode</command>d (or similar) form <placeholder type=\"footnote"
+"\" id=\"0\"/>. The file would then be decoded and copied to its place "
+"during the build process. Thus the change will be visible quite easy."
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1688
+#. type: Content of: <chapter><section><section><section><para>
+#: best-pkging-practices.dbk:1822
msgid ""
"Some packages use <command>dbs</command> to manage patches to their upstream "
"source, and always create a new <literal>orig.tar.gz</literal> file that "
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: best-pkging-practices.dbk:1701
+#. type: Content of: <chapter><section><section><title>
+#: best-pkging-practices.dbk:1835
msgid "Best practices for debug packages"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1703
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1837
msgid ""
"A debug package is a package with a name ending in -dbg, that contains "
"additional information that gdb can use. Since Debian binaries are stripped "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1711
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1845
msgid ""
"It is up to a package's maintainer whether to create a debug package or "
"not. Maintainers are encouraged to create debug packages for library "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1721
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1855
msgid ""
"Some debug packages may contain an entire special debugging build of a "
"library or other binary, but most of them can save space and build time by "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1733
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1867
msgid ""
"The debugging symbols can be extracted from an object file using <command> "
"objcopy --only-keep-debug</command>. Then the object file can be stripped, "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1741
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1875
msgid ""
"The <command>dh_strip</command> command in debhelper supports creating debug "
"packages, and can take care of using <command>objcopy</command> to separate "
"add an entry to <filename>debian/control</filename> for the debug package."
msgstr ""
-# type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1748
+#
. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1882
msgid ""
-"Note that the Debian package should depend on the package that it provides "
+"Note that the debug package should depend on the package that it provides "
"debugging symbols for, and this dependency should be versioned. For example:"
msgstr ""
# type: Content of: <chapter><section><section><screen>
-#: best-pkging-practices.dbk:1751
+#. type: Content of: <chapter><section><section><screen>
+#: best-pkging-practices.dbk:1886
#, fuzzy, no-wrap
-msgid ""
-"\n"
-"Depends: libfoo-dbg (= ${binary:Version})\n"
+msgid "Depends: libfoo (= ${binary:Version})\n"
msgstr "Depends: libfoo-dbg (= ${binary:Version})"
msgid ""
msgstr ""
"Project-Id-Version: developers-reference 3.3.9\n"
-"POT-Creation-Date: 2008-06-14 14:14+0900\n"
+"POT-Creation-Date: 2009-06-25 22:00+0300\n"
"PO-Revision-Date: 2008-06-14 20:04+0900\n"
"Last-Translator: Hideki Yamane (Debian-JP) <henrich@debian.or.jp>\n"
"Language-Team: Debian JP Project <debian-doc@debian.or.jp>\n"
"Content-Transfer-Encoding: 8bit\n"
# type: Content of: <chapter><title>
+#. type: Content of: <chapter><title>
#: developer-duties.dbk:7
msgid "Debian Developer's Duties"
msgstr "Debian 開発者の責務"
# type: Content of: <chapter><section><title>
+#. type: Content of: <chapter><section><title>
#: developer-duties.dbk:9
msgid "Maintaining your Debian information"
msgstr "あなたの Debian に関する情報をメンテナンスする"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: developer-duties.dbk:11
msgid ""
"There's a LDAP database containing information about Debian developers at "
"をここで設定した場合、そのメールを受け取るアドレスについても同様です。"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: developer-duties.dbk:19
msgid ""
"For more information about the database, please see <xref linkend=\"devel-db"
"い。"
# type: Content of: <chapter><section><title>
+#. type: Content of: <chapter><section><title>
#: developer-duties.dbk:25
msgid "Maintaining your public key"
msgstr "公開鍵をメンテナンスする"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: developer-duties.dbk:27
msgid ""
"Be very careful with your private keys. Do not place them on any public "
"さい。<ulink url=\"&url-pgp-faq;\">PGP FAQ</ulink> を読みましょう。"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: developer-duties.dbk:34
msgid ""
"You need to ensure not only that your key is secure against being stolen, "
"(紙にも出力しておくのがベストです)。これは鍵を紛失した場合に必要になります。"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: developer-duties.dbk:40
msgid ""
"If you add signatures to your public key, or add user identities, you can "
"ring を更新できます。"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: developer-duties.dbk:45
msgid ""
"If you need to add a completely new key or remove an old key, you need to "
"replacing_keys.html\"></ulink> で確認できます。"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: developer-duties.dbk:53
msgid ""
"The same key extraction routines discussed in <xref linkend=\"registering\"/"
"す。"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: developer-duties.dbk:57
msgid ""
"You can find a more in-depth discussion of Debian key maintenance in the "
"ができます。"
# type: Content of: <chapter><section><title>
+#. type: Content of: <chapter><section><title>
#: developer-duties.dbk:64
msgid "Voting"
msgstr "投票をする"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: developer-duties.dbk:66
msgid ""
"Even though Debian isn't really a democracy, we use a democratic process to "
"は、<ulink url=\"&url-constitution;\">Debian 憲章</ulink>で規程されています。"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: developer-duties.dbk:72
msgid ""
"Other than the yearly leader election, votes are not routinely held, and "
"トを必要とします。"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: developer-duties.dbk:78
msgid ""
"You don't have to track the pre-vote discussions, as the secretary will "
"よって署名／暗号化されたメールによって行われます。"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: developer-duties.dbk:86
msgid ""
"The list of all proposals (past and current) is available on the <ulink url="
"行われたのかという関連情報の確認が可能になっています。"
# type: Content of: <chapter><section><title>
+#. type: Content of: <chapter><section><title>
#: developer-duties.dbk:93
msgid "Going on vacation gracefully"
msgstr "優雅に休暇を取る"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: developer-duties.dbk:95
msgid ""
"It is common for developers to have periods of absence, whether those are "
"は、必要なことを彼らが何であってもできるようにすることです。"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: developer-duties.dbk:102
msgid ""
"Usually this means that other developers are allowed to NMU (see <xref "
"れほど致命的なことはおきませんが、他の開発者に対してあなたが作業できない状態"
"であることを知らせるのは重要です。"
-# type: Content of: <chapter><section><para><footnote>
-#: developer-duties.dbk:109
-msgid ""
-"In order to inform the other developers, there are two things that you "
-"should do. First send a mail to <email>debian-private@&lists-host;</email> "
-"with [VAC] prepended to the subject of your message<footnote>"
-msgstr ""
-"他の開発者に通知するために行わなければならないことが 2 つあります。まず、"
-"<email>debian-private@&lists-host;</email> にサブジェクトの先頭に [VAC] と付"
-"けたメール<footnote>"
-
# type: Content of: <chapter><section><para><footnote><para>
+#. type: Content of: <chapter><section><para><footnote><para>
#: developer-duties.dbk:111
msgid ""
"This is so that the message can be easily filtered by people who don't want "
"これは、休暇のメッセージを読みたくない人がメッセージを簡単に振り分け可能にす"
"るためです。"
-# type: Content of: <chapter><section><para>
-#: developer-duties.dbk:113
+# type: Content of: <chapter><section><para><footnote>
+#. type: Content of: <chapter><section><para>
+#: developer-duties.dbk:109
+#, fuzzy
msgid ""
-"</footnote> and state the period of time when you will be on vacation. You "
-"can also give some special instructions on what to do if a problem occurs."
+"In order to inform the other developers, there are two things that you "
+"should do. First send a mail to <email>debian-private@&lists-host;</email> "
+"with [VAC] prepended to the subject of your message<placeholder type="
+"\"footnote\" id=\"0\"/> and state the period of time when you will be on "
+"vacation. You can also give some special instructions on what to do if a "
+"problem occurs."
msgstr ""
-"</footnote>の本文に、いつまで休暇予定なのかを記述して休暇に行く際に送ってくだ"
-"さい。問題が起こった際にどうすれば良いのか、特別な指示を書いておくこともでき"
-"ã\81¾ã\81\99ã\80\82"
+"他の開発者に通知するために行わなければならないことが 2 つあります。まず、"
+"<email>debian-private@&lists-host;</email> にサブジェクトの先頭に [VAC] と付"
+"ã\81\91ã\81\9fã\83¡ã\83¼ã\83«<footnote>"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: developer-duties.dbk:118
msgid ""
"The other thing to do is to mark yourself as on vacation in the <link "
"のを忘れないように!"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: developer-duties.dbk:124
msgid ""
"Ideally, you should sign up at the <ulink url=\"&url-newmaint-db;gpg.php"
"いるようなエキゾチックな場所に行く場合、これは特に重要です。"
# type: Content of: <chapter><section><title>
+#. type: Content of: <chapter><section><title>
#: developer-duties.dbk:133
msgid "Coordination with upstream developers"
msgstr "上流 (upstream) の開発者との調整について"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: developer-duties.dbk:135
msgid ""
"A big part of your job as Debian maintainer will be to stay in contact with "
"りません。"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: developer-duties.dbk:142
msgid ""
"While it's not your job to fix non-Debian specific bugs, you may freely do "
"ります。その場合は、あなたはパッチを確認して上流へ転送する必要があります。"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: developer-duties.dbk:149
msgid ""
"If you need to modify the upstream sources in order to build a policy "
"まれる修正を上流の開発者にとって良い形で提案する必要があります。必要な変更が"
"何であれ、上流のソースからフォークしないように常に試みてください。"
+#. type: Content of: <chapter><section><para>
+#: developer-duties.dbk:156
+msgid ""
+"If you find that the upstream developers are or become hostile towards "
+"Debian or the free software community, you may want to re-consider the need "
+"to include the software in Debian. Sometimes the social cost to the Debian "
+"community is not worth the benefits the software may bring."
+msgstr ""
+
# type: Content of: <chapter><section><title>
-#: developer-duties.dbk:158
+#. type: Content of: <chapter><section><title>
+#: developer-duties.dbk:164
msgid "Managing release-critical bugs"
msgstr "リリースクリティカルバグに対処する"
# type: Content of: <chapter><section><para>
-#: developer-duties.dbk:160
+#. type: Content of: <chapter><section><para>
+#: developer-duties.dbk:166
msgid ""
"Generally you should deal with bug reports on your packages as described in "
"<xref linkend=\"bug-handling\"/> . However, there's a special category of "
"\"/>で記述されているように対応する必要があります。しかしながら、注意を必要と"
"する特別なカテゴリのバグがあります - リリースクリティカルバグ (RC bug) と呼ば"
"れるものです。<literal>critical</literal>、<literal>grave</literal>、"
-"<literal>serious</literal> の重要度が付けられている全てのバグ報告は、"
-"Debian の次期安定版リリースからパッケージに含めるかどうかについての影響を持つ"
-"ã\81¨è¦\8bã\81ªã\81\95ã\82\8cã\81¦ã\81\84ã\81¾ã\81\99ã\80\82ã\81\93ã\82\8cã\82\89ã\81®ã\83\90ã\82°ã\81¯ Debian ã\81®ã\83ªã\83ªã\83¼ã\82¹ã\82\92é\81\85ã\82\89ã\81\9bã\81\9fã\82\8aã\80\81ã\83\95ã\83ªã\83¼ã\82ºæ\99\82"
-"ã\81«ã\83\91ã\83\83ã\82±ã\83¼ã\82¸å\89\8aé\99¤ã\81®èª¿æ\95´ã\81«ä½¿ã\82\8fã\82\8cã\82\8bã\81ªã\81©ã\81\95ã\82\8cã\82\8bã\81\93ã\81¨ã\81\8cã\81\82ã\82\8aã\81¾ã\81\99ã\80\82ã\81\93ã\82\8cã\81\8cã\80\81ã\81\93ã\82\8cã\82\89ã\81®ã\83\90"
-"グを可能な限り素早く修正する必要がある理由です。"
+"<literal>serious</literal> の重要度が付けられている全てのバグ報告は、Debian "
+"の次期安定版リリースからパッケージに含めるかどうかについての影響を持つと見な"
+"ã\81\95ã\82\8cã\81¦ã\81\84ã\81¾ã\81\99ã\80\82ã\81\93ã\82\8cã\82\89ã\81®ã\83\90ã\82°ã\81¯ Debian ã\81®ã\83ªã\83ªã\83¼ã\82¹ã\82\92é\81\85ã\82\89ã\81\9bã\81\9fã\82\8aã\80\81ã\83\95ã\83ªã\83¼ã\82ºæ\99\82ã\81«ã\83\91ã\83\83"
+"ã\82±ã\83¼ã\82¸å\89\8aé\99¤ã\81®èª¿æ\95´ã\81«ä½¿ã\82\8fã\82\8cã\82\8bã\81ªã\81©ã\81\95ã\82\8cã\82\8bã\81\93ã\81¨ã\81\8cã\81\82ã\82\8aã\81¾ã\81\99ã\80\82ã\81\93ã\82\8cã\81\8cã\80\81ã\81\93ã\82\8cã\82\89ã\81®ã\83\90ã\82°ã\82\92å\8f¯"
+"能な限り素早く修正する必要がある理由です。"
# type: Content of: <chapter><section><para>
-#: developer-duties.dbk:171
+#. type: Content of: <chapter><section><para>
+#: developer-duties.dbk:177
msgid ""
"Developers who are part of the <ulink url=\"&url-debian-qa;\">Quality "
"Assurance</ulink> group are following all such bugs, and trying to help "
"行う前にいつもの様には待とうとはしないでしょう)。"
# type: Content of: <chapter><section><title>
-#: developer-duties.dbk:186
+#. type: Content of: <chapter><section><title>
+#: developer-duties.dbk:192
msgid "Retiring"
msgstr "脱退について"
# type: Content of: <chapter><section><para>
-#: developer-duties.dbk:188
+#. type: Content of: <chapter><section><para>
+#: developer-duties.dbk:194
msgid ""
"If you choose to leave the Debian project, you should make sure you do the "
"following steps:"
"Debian プロジェクトから去るのを決めた場合は、以下の手順に従ってください:"
# type: Content of: <chapter><section><orderedlist><listitem><para>
-#: developer-duties.dbk:194
+#. type: Content of: <chapter><section><orderedlist><listitem><para>
+#: developer-duties.dbk:200
msgid ""
"Orphan all your packages, as described in <xref linkend=\"orphaning\"/> ."
msgstr ""
"化 (orphan) してください。"
# type: Content of: <chapter><section><orderedlist><listitem><para>
-#: developer-duties.dbk:199
+#. type: Content of: <chapter><section><orderedlist><listitem><para>
+#: developer-duties.dbk:205
msgid ""
"Send an gpg-signed email about why you are leaving the project to "
"<email>debian-private@&lists-host;</email>."
"private@&lists-host;</email> に投げてください。"
# type: Content of: <chapter><section><orderedlist><listitem><para>
-#: developer-duties.dbk:205
+#. type: Content of: <chapter><section><orderedlist><listitem><para>
+#: developer-duties.dbk:211
msgid ""
"Notify the Debian key ring maintainers that you are leaving by opening a "
"ticket in Debian RT by sending a mail to keyring@rt.debian.org with the "
"'Debian RT' という単語 (大文字小文字は関係なし) が入ったメールを keyring@rt."
"debian.org に投げて Debian RT でチケットをオープンすることで、あなたがプロ"
"ジェクトを去るのを Debian key ring メンテナに知らせてください。"
+
+# type: Content of: <chapter><section><para>
+#~ msgid ""
+#~ "</footnote> and state the period of time when you will be on vacation. "
+#~ "You can also give some special instructions on what to do if a problem "
+#~ "occurs."
+#~ msgstr ""
+#~ "</footnote>の本文に、いつまで休暇予定なのかを記述して休暇に行く際に送って"
+#~ "ください。問題が起こった際にどうすれば良いのか、特別な指示を書いておくこと"
+#~ "もできます。"
msgid ""
msgstr ""
"Project-Id-Version: developers-reference 3.3.9\n"
-"POT-Creation-Date: 2008-06-14 14:15+0900\n"
+"POT-Creation-Date: 2009-06-25 22:00+0300\n"
"PO-Revision-Date: 2008-03-05 18:30+0900\n"
"Last-Translator: Hideki Yamane (Debian-JP) <henrich@debian.or.jp>\n"
"Language-Team: Debian JP Project <debian-doc@debian.or.jp>\n"
"Content-Transfer-Encoding: 8bit\n"
# type: Content of: <chapter><title>
+#. type: Content of: <chapter><title>
#: pkgs.dbk:7
msgid "Managing Packages"
msgstr "パッケージの取扱い方"
# type: Content of: <chapter><para>
+#. type: Content of: <chapter><para>
#: pkgs.dbk:9
msgid ""
"This chapter contains information related to creating, uploading, "
"取り扱っています。"
# type: Content of: <chapter><section><title>
+#. type: Content of: <chapter><section><title>
#: pkgs.dbk:13
msgid "New packages"
msgstr "新規パッケージ"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: pkgs.dbk:15
msgid ""
"If you want to create a new package for the Debian distribution, you should "
msgstr ""
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: pkgs.dbk:23
msgid ""
"Assuming no one else is already working on your prospective package, you "
msgstr ""
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: pkgs.dbk:31
msgid ""
"You should set the subject of the bug to <literal>ITP: <replaceable>foo</"
msgstr ""
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: pkgs.dbk:45
msgid ""
"Please include a <literal>Closes: bug#<replaceable>nnnnn</replaceable></"
"archive (see <xref linkend=\"upload-bugfix\"/> )."
msgstr ""
-# type: Content of: <chapter><section><para>
+#
. type: Content of: <chapter><section><para>
#: pkgs.dbk:51
msgid ""
+"If you think your package needs some explanations for the administrators of "
+"the NEW package queue, include them in your changelog, send to "
+"ftpmaster@debian.org a reply to the email you receive as a maintainer after "
+"your upload, or reply to the rejection email in case you are already re-"
+"uploading."
+msgstr ""
+
+# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:57
+msgid ""
"When closing security bugs include CVE numbers as well as the Closes: "
"#nnnnn. This is useful for the security team to track vulnerabilities. If "
"an upload is made to fix the bug before the advisory ID is known, it is "
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:59
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:65
msgid ""
"There are a number of reasons why we ask maintainers to announce their "
"intentions:"
msgstr ""
# type: Content of: <chapter><section><itemizedlist><listitem><para>
-#: pkgs.dbk:65
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
+#: pkgs.dbk:71
msgid ""
"It helps the (potentially new) maintainer to tap into the experience of "
"people on the list, and lets them know if anyone else is working on it "
msgstr ""
# type: Content of: <chapter><section><itemizedlist><listitem><para>
-#: pkgs.dbk:71
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
+#: pkgs.dbk:77
msgid ""
"It lets other people thinking about working on the package know that there "
"already is a volunteer, so efforts may be shared."
msgstr ""
# type: Content of: <chapter><section><itemizedlist><listitem><para>
-#: pkgs.dbk:77
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
+#: pkgs.dbk:83
msgid ""
"It lets the rest of the maintainers know more about the package than the one "
"line description and the usual changelog entry ``Initial release'' that gets "
msgstr ""
# type: Content of: <chapter><section><itemizedlist><listitem><para>
-#: pkgs.dbk:84
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
+#: pkgs.dbk:90
msgid ""
"It is helpful to the people who live off <literal>unstable</literal> (and "
"form our first line of testers). We should encourage these people."
msgstr ""
# type: Content of: <chapter><section><itemizedlist><listitem><para>
-#: pkgs.dbk:90
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
+#: pkgs.dbk:96
msgid ""
"The announcements give maintainers and other interested parties a better "
"feel of what is going on, and what is new, in the project."
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:96
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:102
msgid ""
"Please see <ulink url=\"http://&ftp-master-host;/REJECT-FAQ.html\"></ulink> "
"for common rejection reasons for a new package."
msgstr ""
# type: Content of: <chapter><section><title>
-#: pkgs.dbk:102
+#. type: Content of: <chapter><section><title>
+#: pkgs.dbk:108
msgid "Recording changes in the package"
msgstr "パッケージの変更を記録する"
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:104
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:110
msgid ""
"Changes that you make to the package need to be recorded in the "
"<filename>debian/changelog</filename>. These changes should provide a "
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:115
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:121
msgid ""
"The <filename>debian/changelog</filename> file conforms to a certain "
"structure, with a number of different fields. One field of note, the "
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:123
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:129
msgid ""
"Changelog entries can be used to automatically close Debian bugs when the "
"package is installed into the archive. See <xref linkend=\"upload-bugfix\"/"
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:127
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:133
msgid ""
"It is conventional that the changelog entry of a package that contains a new "
"upstream version of the software looks like this:"
msgstr ""
# type: Content of: <chapter><section><screen>
-#: pkgs.dbk:130
+#. type: Content of: <chapter><section><screen>
+#: pkgs.dbk:137
#, fuzzy, no-wrap
-msgid ""
-"\n"
-" * new upstream version\n"
+msgid " * new upstream version\n"
msgstr "* new upstream version"
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:134
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:140
msgid ""
"There are tools to help you create entries and finalize the "
"<filename>changelog</filename> for release — see <xref linkend=\"devscripts"
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:139
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:145
msgid "See also <xref linkend=\"bpp-debian-changelog\"/> ."
msgstr "<xref linkend=\"bpp-debian-changelog\"/> も参照してください。"
# type: Content of: <chapter><section><title>
-#: pkgs.dbk:144
+#. type: Content of: <chapter><section><title>
+#: pkgs.dbk:150
msgid "Testing the package"
msgstr "パッケージをテストする"
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:146
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:152
msgid ""
"Before you upload your package, you should do basic testing on it. At a "
"minimum, you should try the following activities (you'll need to have an "
msgstr ""
# type: Content of: <chapter><section><itemizedlist><listitem><para>
-#: pkgs.dbk:153
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
+#: pkgs.dbk:159
msgid ""
"Install the package and make sure the software works, or upgrade the package "
"from an older version to your new version if a Debian package for it already "
msgstr ""
# type: Content of: <chapter><section><itemizedlist><listitem><para>
-#: pkgs.dbk:160
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
+#: pkgs.dbk:166
msgid ""
"Run <command>lintian</command> over the package. You can run "
"<command>lintian</command> as follows: <literal>lintian -v "
msgstr ""
# type: Content of: <chapter><section><itemizedlist><listitem><para>
-#: pkgs.dbk:169
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
+#: pkgs.dbk:175
msgid ""
"Normally, a package should <emphasis>not</emphasis> be uploaded if it causes "
"lintian to emit errors (they will start with <literal>E</literal>)."
msgstr ""
# type: Content of: <chapter><section><itemizedlist><listitem><para>
-#: pkgs.dbk:173
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
+#: pkgs.dbk:179
msgid ""
"For more information on <command>lintian</command>, see <xref linkend="
"\"lintian\"/> ."
msgstr ""
# type: Content of: <chapter><section><itemizedlist><listitem><para>
-#: pkgs.dbk:179
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
+#: pkgs.dbk:185
msgid ""
"Optionally run <xref linkend=\"debdiff\"/> to analyze changes from an older "
"version, if one exists."
msgstr ""
# type: Content of: <chapter><section><itemizedlist><listitem><para>
-#: pkgs.dbk:185
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
+#: pkgs.dbk:191
msgid ""
"Downgrade the package to the previous version (if one exists) — this tests "
"the <filename>postrm</filename> and <filename>prerm</filename> scripts."
msgstr ""
# type: Content of: <chapter><section><itemizedlist><listitem><para>
-#: pkgs.dbk:191
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
+#: pkgs.dbk:197
#, fuzzy
msgid "Remove the package, then reinstall it."
msgstr "パッケージを削除して、再インストールしてください。"
# type: Content of: <chapter><section><itemizedlist><listitem><para>
-#: pkgs.dbk:196
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
+#: pkgs.dbk:202
msgid ""
"Copy the source package in a different directory and try unpacking it and "
"rebuilding it. This tests if the package relies on existing files outside "
msgstr ""
# type: Content of: <chapter><section><title>
-#: pkgs.dbk:206
+#. type: Content of: <chapter><section><title>
+#: pkgs.dbk:212
#, fuzzy
msgid "Layout of the source package"
msgstr "ソースパッケージの構造"
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:208
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:214
msgid "There are two types of Debian source packages:"
msgstr "Debian のソースパッケージには 2 種類あります："
# type: Content of: <chapter><section><itemizedlist><listitem><para>
-#: pkgs.dbk:213
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
+#: pkgs.dbk:219
msgid ""
"the so-called <literal>native</literal> packages, where there is no "
"distinction between the original sources and the patches applied for Debian"
msgstr ""
# type: Content of: <chapter><section><itemizedlist><listitem><para>
-#: pkgs.dbk:219
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
+#: pkgs.dbk:225
msgid ""
"the (more common) packages where there's an original source tarball file "
"accompanied by another file that contains the patches applied for Debian"
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:225
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:231
msgid ""
"For the native packages, the source package includes a Debian source control "
"file (<literal>.dsc</literal>) and the source tarball (<literal>.tar.gz</"
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:233
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:239
msgid ""
"Whether a package is native or not is determined when it is built by "
"<citerefentry> <refentrytitle>dpkg-buildpackage</refentrytitle> "
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:239
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:245
msgid ""
"The first time a version is uploaded which corresponds to a particular "
"upstream version, the original source tar file should be uploaded and "
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:246
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:252
msgid ""
"By default, <command>dpkg-genchanges</command> and <command>dpkg-"
"buildpackage</command> will include the original source tar file if and only "
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:254
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:260
msgid ""
"If no original source is included in the upload, the original source tar-"
"file used by <command>dpkg-source</command> when constructing the <filename>."
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:261
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:267
msgid ""
"Please notice that, in non-native packages, permissions on files that are "
"not present in the .orig.tar.gz will not be preserved, as diff does not "
msgstr ""
# type: Content of: <chapter><section><title>
-#: pkgs.dbk:268
+#. type: Content of: <chapter><section><title>
+#: pkgs.dbk:274
msgid "Picking a distribution"
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:270
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:276
msgid ""
"Each upload needs to specify which distribution the package is intended "
"for. The package build process extracts this information from the first "
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:276
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:282
msgid ""
"There are several possible values for this field: <literal>stable</literal>, "
"<literal>unstable</literal>, <literal>testing-proposed-updates</literal> and "
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:282
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:288
msgid ""
"Actually, there are two other possible distributions: <literal>stable-"
"security </literal> and <literal>testing-security</literal>, but read <xref "
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:287
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:293
msgid ""
"It is not possible to upload a package into several distributions at the "
"same time."
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:291
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:297
msgid ""
"Special case: uploads to the <literal>stable</literal> and "
"<literal>oldstable</literal> distributions"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:294
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:300
msgid ""
"Uploading to <literal>stable</literal> means that the package will "
"transfered to the <literal>proposed-updates-new</literal> queue for review "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:302
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:308
msgid ""
"To ensure that your upload will be accepted, you should discuss the changes "
"with the stable release team before you upload. For that, send a mail to the "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:310
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:316
msgid ""
"Extra care should be taken when uploading to <literal>stable</literal>. "
"Basically, a package should only be uploaded to <literal>stable</literal> if "
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:317
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:323
msgid "a truly critical functionality problem"
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:322
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:328
msgid "the package becomes uninstallable"
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:327
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:333
msgid "a released architecture lacks the package"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:332
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:338
msgid ""
"In the past, uploads to <literal>stable</literal> were used to address "
"security problems as well. However, this practice is deprecated, as uploads "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:343
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:349
msgid ""
"Changing anything else in the package that isn't important is discouraged, "
"because even trivial fixes can cause bugs later on."
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:347
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:353
msgid ""
"Packages uploaded to <literal>stable</literal> need to be compiled on "
"systems running <literal>stable</literal>, so that their dependencies are "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:357
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:363
msgid ""
"Uploads to the <literal>oldstable</literal> distributions are possible as "
"long as it hasn't been archived. The same rules as for <literal>stable </"
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:364
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:370
msgid ""
"Special case: uploads to <literal>testing/testing-proposed-updates</literal>"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:366
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:372
msgid ""
"Please see the information in the <link linkend=\"t-p-u\">testing section</"
"link> for details."
msgstr ""
# type: Content of: <chapter><section><title>
-#: pkgs.dbk:374
+#. type: Content of: <chapter><section><title>
+#: pkgs.dbk:380
msgid "Uploading a package"
msgstr "パッケージをアップロードする"
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:376
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:382
msgid "Uploading to <literal>ftp-master</literal>"
msgstr "<literal>ftp-master</literal> にアップロードする"
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:378
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:384
msgid ""
"To upload a package, you should upload the files (including the signed "
"changes and dsc-file) with anonymous ftp to <literal>&ftp-master-host;</"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:387
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:393
msgid ""
"Please note that you should transfer the changes file last. Otherwise, your "
"upload may be rejected because the archive maintenance software will parse "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:392
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:398
msgid ""
"You may also find the Debian packages <xref linkend=\"dupload\"/> or <xref "
"linkend=\"dput\"/> useful when uploading packages. These handy programs "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:397
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:403
msgid ""
"For removing packages, please see the README file in that ftp directory, and "
"the Debian package <xref linkend=\"dcut\"/> ."
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:403
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:409
msgid "Delayed uploads"
msgstr "遅延アップロード"
-# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:405
+#
. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:412
msgid ""
-"Delayed uploads are done for the moment via the delayed queue at "
-"<literal>gluck </literal>. The upload-directory is <literal>gluck:~tfheen/"
-"DELAYED/[012345678]-day</literal>. 0-day is uploaded multiple times per day "
-"to <literal>&ftp-master-host;</literal>."
+"It is sometimes useful to upload a package immediately, but to want this "
+"package to arrive in the archive only a few days later. For example, when "
+"preparing a <link linkend=\"nmu\">Non-maintainer Upload</link>, you might "
+"want to give the maintainer a few days to react."
msgstr ""
-# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:411
-msgid "With a fairly recent dput, this section"
-msgstr ""
-
-# type: Content of: <chapter><section><section><screen>
-#: pkgs.dbk:413
-#, fuzzy, no-wrap
-msgid ""
-"\n"
-"[tfheen_delayed]\n"
-"method = scp\n"
-"fqdn = gluck.debian.org\n"
-"incoming = ~tfheen\n"
-msgstr ""
-"[tfheen_delayed]\n"
-"method = scp\n"
-"fqdn = gluck.debian.org\n"
-"incoming = ~tfheen"
-
-# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:420
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:419
msgid ""
-"in <filename>~/.dput.cf</filename> should work fine for uploading to the "
-"<literal>DELAYED</literal> queue."
+"An upload to the delayed directory keeps the package in <ulink url=\"http://"
+"ftp-master.debian.org/deferred.html\"> the deferred uploads queue\"</"
+"ulink>. When the specified waiting time is over, the package is moved into "
+"the regular incoming directory for processing. This is done through "
+"automatic uploading to <literal>&ftp-master-host;</literal> in upload-"
+"directory <literal>DELAYED/[012345678]-day</literal>. 0-day is uploaded "
+"multiple times per day to <literal>&ftp-master-host;</literal>."
msgstr ""
-# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:424
+#
. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:430
msgid ""
-"<emphasis>Note:</emphasis> Since this upload queue goes to <literal>&ftp-"
-"master-host;</literal>, the prescription found in <xref linkend=\"upload-ftp-"
-"master\"/> applies here as well."
+"With dput, you can use the <literal>--delayed <replaceable>DELAY</"
+"replaceable></literal> parameter to put the package into one of the queues."
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:431
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:436
msgid "Security uploads"
msgstr "セキュリティアップロード"
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:433
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:438
msgid ""
"Do <emphasis role=\"strong\">NOT</emphasis> upload a package to the security "
"upload queue (<literal>oldstable-security</literal>, <literal>stable-"
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:443
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:448
msgid "Other upload queues"
msgstr "他のアップロードキュー"
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:445
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:450
msgid ""
"The scp queues on <literal>&ftp-master-host;</literal>, and <literal> "
"security.debian.org</literal> are mostly unusable due to the login "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:450
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:455
msgid ""
"The anonymous queues on ftp.uni-erlangen.de and ftp.uk.debian.org are "
"currently down. Work is underway to resurrect them."
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:454
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:459
msgid ""
"The queues on master.debian.org, samosa.debian.org, master.debian.or.jp, and "
"ftp.chiark.greenend.org.uk are down permanently, and will not be "
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:462
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:467
msgid "Notification that a new package has been installed"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:464
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:469
msgid ""
"The Debian archive maintainers are responsible for handling package "
"uploads. For the most part, uploads are automatically handled on a daily "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:474
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:479
msgid ""
"In any case, you will receive an email notification indicating that the "
"package has been added to the archive, which also indicates which bugs will "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:480
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:485
msgid ""
"The installation notification also includes information on what section the "
"package was inserted into. If there is a disparity, you will receive a "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:485
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:490
msgid ""
"Note that if you upload via queues, the queue daemon software will also send "
"you a notification by email."
msgstr ""
# type: Content of: <chapter><section><title>
-#: pkgs.dbk:493
+#. type: Content of: <chapter><section><title>
+#: pkgs.dbk:498
msgid "Specifying the package section, subsection and priority"
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:495
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:500
msgid ""
"The <filename>debian/control</filename> file's <literal>Section</literal> "
"and <literal>Priority</literal> fields do not actually specify where the "
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:503
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:508
msgid ""
"The archive maintainers keep track of the canonical sections and priorities "
"for packages in the <literal>override file</literal>. If there is a "
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:513
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:518
msgid ""
"To alter the actual section that a package is put in, you need to first make "
"sure that the <filename>debian/control</filename> file in your package is "
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:521
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:526
msgid ""
"For more information about <literal>override files</literal>, see "
"<citerefentry> <refentrytitle>dpkg-scanpackages</refentrytitle> "
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:527
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:532
msgid ""
"Note that the <literal>Section</literal> field describes both the section as "
"well as the subsection, which are described in <xref linkend=\"archive-"
msgstr ""
# type: Content of: <chapter><section><title>
-#: pkgs.dbk:536
+#. type: Content of: <chapter><section><title>
+#: pkgs.dbk:541
msgid "Handling bugs"
msgstr "バグの取扱い"
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:538
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:543
msgid ""
"Every developer has to be able to work with the Debian <ulink url=\"&url-bts;"
"\">bug tracking system</ulink>. This includes knowing how to file bug "
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:544
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:549
msgid ""
"The bug tracking system's features are described in the <ulink url=\"&url-"
"bts-devel;\">BTS documentation for developers</ulink>. This includes "
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:550
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:555
msgid ""
"Operations such as reassigning bugs to other packages, merging separate bug "
"reports about the same issue, or reopening bugs when they are prematurely "
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:558
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:563
msgid "Monitoring bugs"
msgstr "バグの監視"
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:560
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:565
msgid ""
"If you want to be a good maintainer, you should periodically check the "
"<ulink url=\"&url-bts;\">Debian bug tracking system (BTS)</ulink> for your "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:567
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:572
msgid ""
"Maintainers interact with the BTS via email addresses at <literal>&bugs-host;"
"</literal>. Documentation on available commands can be found at <ulink url="
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:574
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:579
msgid ""
"Some find it useful to get periodic reports on open bugs. You can add a "
"cron job such as the following if you want to get a weekly email outlining "
"all the open bugs against your packages:"
msgstr ""
-# type: Content of: <chapter><section><section><screen>
-#: pkgs.dbk:578
+#. type: Content of: <chapter><section><section><screen>
+#: pkgs.dbk:584
#, no-wrap
msgid ""
-"\n"
"# ask for weekly reports of bugs in my packages\n"
"&cron-bug-report;\n"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:583
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:588
msgid ""
"Replace <replaceable>address</replaceable> with your official Debian "
"maintainer address."
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:589
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:594
msgid "Responding to bugs"
msgstr "バグへの対応"
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:591
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:596
msgid ""
"When responding to bugs, make sure that any discussion you have about bugs "
"is sent both to the original submitter of the bug, and to the bug itself (e."
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:600
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:605
msgid ""
"If you get a bug which mentions FTBFS, this means Fails to build from "
"source. Porters frequently use this acronym."
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:604
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:609
msgid ""
"Once you've dealt with a bug report (e.g. fixed it), mark it as "
"<literal>done</literal> (close it) by sending an explanation message to "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:611
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:616
msgid ""
"You should <emphasis>never</emphasis> close bugs via the bug server "
"<literal>close</literal> command sent to &email-bts-control;. If you do so, "
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:619
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:624
msgid "Bug housekeeping"
msgstr "バグを掃除する"
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:621
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:626
msgid ""
"As a package maintainer, you will often find bugs in other packages or have "
"bugs reported against your packages which are actually bugs in other "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:632
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:637
msgid ""
"Filing bugs for problems that you find in other packages is one of the civic "
"obligations of maintainership, see <xref linkend=\"submit-bug\"/> for "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:637
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:642
msgid "Here's a list of steps that you may follow to handle a bug report:"
msgstr ""
# type: Content of: <chapter><section><section><orderedlist><listitem><para>
-#: pkgs.dbk:642
+#. type: Content of: <chapter><section><section><orderedlist><listitem><para>
+#: pkgs.dbk:647
msgid ""
"Decide whether the report corresponds to a real bug or not. Sometimes users "
"are just calling a program in the wrong way because they haven't read the "
msgstr ""
# type: Content of: <chapter><section><section><orderedlist><listitem><para>
-#: pkgs.dbk:652
+#. type: Content of: <chapter><section><section><orderedlist><listitem><para>
+#: pkgs.dbk:657
msgid ""
"If the bug submitter disagrees with your decision to close the bug, they may "
"reopen it until you find an agreement on how to handle it. If you don't "
msgstr ""
# type: Content of: <chapter><section><section><orderedlist><listitem><para>
-#: pkgs.dbk:666
+#. type: Content of: <chapter><section><section><orderedlist><listitem><para>
+#: pkgs.dbk:671
msgid ""
"If the bug is real but it's caused by another package, just reassign the bug "
"to the right package. If you don't know which package it should be "
msgstr ""
# type: Content of: <chapter><section><section><orderedlist><listitem><para>
-#: pkgs.dbk:678
+#. type: Content of: <chapter><section><section><orderedlist><listitem><para>
+#: pkgs.dbk:683
msgid ""
"If the bug affects the operation of your package, please consider cloning "
"the bug and reassigning the clone to the package that really causes the "
msgstr ""
# type: Content of: <chapter><section><section><orderedlist><listitem><para>
-#: pkgs.dbk:688
+#. type: Content of: <chapter><section><section><orderedlist><listitem><para>
+#: pkgs.dbk:693
msgid ""
"Sometimes you also have to adjust the severity of the bug so that it matches "
"our definition of the severity. That's because people tend to inflate the "
msgstr ""
# type: Content of: <chapter><section><section><orderedlist><listitem><para>
-#: pkgs.dbk:696
+#. type: Content of: <chapter><section><section><orderedlist><listitem><para>
+#: pkgs.dbk:701
msgid ""
"If the bug is real but the same problem has already been reported by someone "
"else, then the two relevant bug reports should be merged into one using the "
msgstr ""
# type: Content of: <chapter><section><section><orderedlist><listitem><para>
-#: pkgs.dbk:707
+#. type: Content of: <chapter><section><section><orderedlist><listitem><para>
+#: pkgs.dbk:712
msgid ""
"The bug submitter may have forgotten to provide some information, in which "
"case you have to ask them for the required information. You may use the "
msgstr ""
# type: Content of: <chapter><section><section><orderedlist><listitem><para>
-#: pkgs.dbk:718
+#. type: Content of: <chapter><section><section><orderedlist><listitem><para>
+#: pkgs.dbk:723
msgid ""
"If the bug is related to the packaging, you just fix it. If you are not "
"able to fix it yourself, then tag the bug as <literal>help</literal>. You "
msgstr ""
# type: Content of: <chapter><section><section><orderedlist><listitem><para>
-#: pkgs.dbk:732
+#. type: Content of: <chapter><section><section><orderedlist><listitem><para>
+#: pkgs.dbk:737
msgid ""
"If you have fixed a bug in your local copy, or if a fix has been committed "
"to the CVS repository, you may tag the bug as <literal>pending</literal> to "
msgstr ""
# type: Content of: <chapter><section><section><orderedlist><listitem><para>
-#: pkgs.dbk:742
+#. type: Content of: <chapter><section><section><orderedlist><listitem><para>
+#: pkgs.dbk:747
msgid ""
"Once a corrected package is available in the archive, the bug should be "
"closed indicating the version in which it was fixed. This can be done "
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:751
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:756
msgid "When bugs are closed by new uploads"
msgstr "新規アップロードでバグがクローズされる時"
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:753
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:758
msgid ""
"As bugs and problems are fixed in your packages, it is your responsibility "
"as the package maintainer to close these bugs. However, you should not "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:761
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:766
msgid ""
"However, it's possible to avoid having to manually close bugs after the "
"upload — just list the fixed bugs in your <filename>debian/changelog</"
msgstr ""
# type: Content of: <chapter><section><section><screen>
-#: pkgs.dbk:766
+#. type: Content of: <chapter><section><section><screen>
+#: pkgs.dbk:772
#, fuzzy, no-wrap
msgid ""
-"\n"
"acme-cannon (3.1415) unstable; urgency=low\n"
"\n"
" * Frobbed with options (closes: Bug#98339)\n"
" * Added man page. Closes: #98725."
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:775
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:780
msgid ""
"Technically speaking, the following Perl regular expression describes how "
"bug closing changelogs are identified:"
msgstr ""
# type: Content of: <chapter><section><section><screen>
-#: pkgs.dbk:778
+#. type: Content of: <chapter><section><section><screen>
+#: pkgs.dbk:784
#, fuzzy, no-wrap
-msgid ""
-"\n"
-" /closes:\\s*(?:bug)?\\#\\s*\\d+(?:,\\s*(?:bug)?\\#\\s*\\d+)*/ig\n"
+msgid " /closes:\\s*(?:bug)?\\#\\s*\\d+(?:,\\s*(?:bug)?\\#\\s*\\d+)*/ig\n"
msgstr "/closes:\\s*(?:bug)?\\#\\s*\\d+(?:,\\s*(?:bug)?\\#\\s*\\d+)*/ig"
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:782
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:787
msgid ""
"We prefer the <literal>closes: #<replaceable>XXX</replaceable></literal> "
"syntax, as it is the most concise entry and the easiest to integrate with "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:791
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:796
msgid ""
"Historically, uploads identified as <link linkend=\"nmu\">Non-maintainer "
"upload (NMU)</link> were tagged <literal>fixed</literal> instead of being "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:797
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:802
msgid ""
"If you happen to mistype a bug number or forget a bug in the changelog "
"entries, don't hesitate to undo any damage the error caused. To reopen "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:809
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:814
msgid ""
"Bear in mind that it is not obligatory to close bugs using the changelog as "
"described above. If you simply want to close bugs that don't have anything "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:817
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:822
msgid ""
"For general information on how to write your changelog entries, see <xref "
"linkend=\"bpp-debian-changelog\"/> ."
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:823
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:828
msgid "Handling security-related bugs"
msgstr "セキュリティ関連バグの取扱い"
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:825
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:830
msgid ""
"Due to their sensitive nature, security-related bugs must be handled "
"carefully. The Debian Security Team exists to coordinate this activity, "
"and maintaining <literal>security.debian.org</literal>."
msgstr ""
-# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:834
+#
. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:837
msgid ""
"When you become aware of a security-related bug in a Debian package, whether "
"or not you are the maintainer, collect pertinent information about the "
"problem, and promptly contact the security team at &email-security-team; as "
"soon as possible. <emphasis role=\"strong\">DO NOT UPLOAD</emphasis> any "
-"packages for <literal>stable</literal>; the security team will do that. "
-"Useful information includes, for example:"
+"packages for <literal>stable</literal> without contacting the team. Useful "
+"information includes, for example:"
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:844
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:847
msgid ""
"Which versions of the package are known to be affected by the bug. Check "
"each version that is present in a supported Debian release, as well as "
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:851
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:854
msgid ""
"The nature of the fix, if any is available (patches are especially helpful)"
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:856
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:859
msgid ""
"Any fixed packages that you have prepared yourself (send only the <literal>."
"diff.gz</literal> and <literal>.dsc</literal> files and read <xref linkend="
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:863
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:866
msgid ""
"Any assistance you can provide to help with testing (exploits, regression "
"testing, etc.)"
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:869
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:872
msgid ""
"Any information needed for the advisory (see <xref linkend=\"bug-security-"
"advisories\"/> )"
msgstr ""
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:877
+msgid ""
+"As the maintainer of the package, you have the responsibility to maintain "
+"it, even in the stable release. You are in the best position to evaluate "
+"patches and test updated packages, so please see the sections below on how "
+"to prepare packages for the Security Team to handle."
+msgstr ""
+
+#. type: Content of: <chapter><section><section><section><title>
+#: pkgs.dbk:883
+msgid "The Security Tracker"
+msgstr ""
+
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:885
+msgid ""
+"The security team maintains a central database, the <ulink url=\"http://"
+"security-tracker.debian.net/\">Debian Security Tracker</ulink>. This "
+"contains all public information that is known about security issues: which "
+"packages and versions are affected or fixed, and thus whether stable, "
+"testing and/or unstable are vulnerable. Information that is still "
+"confidential is not added to the tracker."
+msgstr ""
+
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:893
+msgid ""
+"You can search it for a specific issue, but also on package name. Look for "
+"your package to see which issues are still open. If you can, please provide "
+"more information about those issues, or help to address them in your "
+"package. Instructions are on the tracker web pages."
+msgstr ""
+
# type: Content of: <chapter><section><section><section><title>
-#: pkgs.dbk:875
+#. type: Content of: <chapter><section><section><section><title>
+#: pkgs.dbk:901
msgid "Confidentiality"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:877
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:903
msgid ""
"Unlike most other activities within Debian, information about security "
"issues must sometimes be kept private for a time. This allows software "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:884
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:910
msgid "There are several ways developers can learn of a security problem:"
msgstr ""
# type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:889
+#. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:915
msgid "they notice it on a public forum (mailing list, web site, etc.)"
msgstr ""
# type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:894
+#. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:920
msgid "someone files a bug report"
msgstr ""
# type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:899
+#. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:925
msgid "someone informs them via private email"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:904
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:930
msgid ""
"In the first two cases, the information is public and it is important to "
"have a fix as soon as possible. In the last case, however, it might not be "
msgstr ""
# type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:912
+#. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:938
msgid ""
"If the security exposure is minor, there is sometimes no need to keep the "
"problem a secret and a fix should be made and released."
msgstr ""
# type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:918
+#. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:944
msgid ""
"If the problem is severe, it is preferable to share the information with "
"other vendors and coordinate a release. The security team keeps in contact "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:925
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:951
msgid ""
"In all cases if the person who reports the problem asks that it not be "
"disclosed, such requests should be honored, with the obvious exception of "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:932
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:958
msgid ""
"Please note that if secrecy is needed you may not upload a fix to "
"<literal>unstable</literal> (or anywhere else, such as a public CVS "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:939
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:965
msgid ""
"There are two reasons for releasing information even though secrecy is "
"requested: the problem has been known for a while, or the problem or exploit "
"has become public."
msgstr ""
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:970
+msgid ""
+"The Security Team has a PGP-key to enable encrypted communication about "
+"sensitive issues. See the <ulink url=\"http://www.debian.org/security/faq.en."
+"html#contact\">Security Team FAQ</ulink> for details."
+msgstr ""
+
# type: Content of: <chapter><section><section><section><title>
-#: pkgs.dbk:946
+#. type: Content of: <chapter><section><section><section><title>
+#: pkgs.dbk:976
msgid "Security Advisories"
msgstr "セキュリティ勧告"
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:948
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:978
msgid ""
"Security advisories are only issued for the current, released stable "
"distribution, and <emphasis>not</emphasis> for <literal>testing</literal> or "
msgstr ""
# type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:961
+#. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:991
msgid "A description of the problem and its scope, including:"
msgstr ""
# type: Content of: <chapter><section><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
-#: pkgs.dbk:966
+#. type: Content of: <chapter><section><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
+#: pkgs.dbk:996
msgid "The type of problem (privilege escalation, denial of service, etc.)"
msgstr ""
# type: Content of: <chapter><section><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
-#: pkgs.dbk:971
+#. type: Content of: <chapter><section><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
+#: pkgs.dbk:1001
msgid "What privileges may be gained, and by whom (if any)"
msgstr ""
# type: Content of: <chapter><section><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
-#: pkgs.dbk:976
+#. type: Content of: <chapter><section><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
+#: pkgs.dbk:1006
msgid "How it can be exploited"
msgstr "どのようにして攻撃が可能なのか"
# type: Content of: <chapter><section><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
-#: pkgs.dbk:981
+#. type: Content of: <chapter><section><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
+#: pkgs.dbk:1011
msgid "Whether it is remotely or locally exploitable"
msgstr "攻撃はリモートから可能なのかそれともローカルから可能なのか"
# type: Content of: <chapter><section><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
-#: pkgs.dbk:986
+#. type: Content of: <chapter><section><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
+#: pkgs.dbk:1016
msgid "How the problem was fixed"
msgstr "どのようにして問題が修正されたのか"
# type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:991
+#. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:1021
msgid "This information allows users to assess the threat to their systems."
msgstr ""
# type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:996
+#. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:1026
msgid "Version numbers of affected packages"
msgstr "影響を受けるパッケージのバージョン番号"
# type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:1001
+#. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:1031
msgid "Version numbers of fixed packages"
msgstr "修正されたパッケージのバージョン番号"
# type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:1006
+#. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:1036
msgid ""
"Information on where to obtain the updated packages (usually from the Debian "
"security archive)"
msgstr ""
# type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:1012
+#. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:1042
msgid ""
"References to upstream advisories, <ulink url=\"http://cve.mitre.org\">CVE</"
"ulink> identifiers, and any other information useful in cross-referencing "
msgstr ""
# type: Content of: <chapter><section><section><section><title>
-#: pkgs.dbk:1021
+#. type: Content of: <chapter><section><section><section><title>
+#: pkgs.dbk:1051
msgid "Preparing packages to address security issues"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1023
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1053
msgid ""
"One way that you can assist the security team in their duties is to provide "
"them with fixed packages suitable for a security advisory for the stable "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1028
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1058
msgid ""
"When an update is made to the stable release, care must be taken to avoid "
"changing system behavior or introducing new bugs. In order to do this, make "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1036
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1066
msgid ""
"This means that moving to a new upstream version is not a good solution. "
"Instead, the relevant changes should be back-ported to the version present "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1042
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1072
msgid ""
"In some cases, it is not possible to back-port a security fix, for example "
"when large amounts of source code need to be modified or rewritten. If this "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1049
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1079
msgid ""
"Related to this is another important guideline: always test your changes. "
"If you have an exploit available, try it and see if it indeed succeeds on "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1056
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1086
msgid ""
"Do <emphasis role=\"strong\">NOT</emphasis> include any changes in your "
"package which are not directly related to fixing the vulnerability. These "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1066
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1096
msgid ""
"Review and test your changes as much as possible. Check the differences "
"from the previous version repeatedly (<command>interdiff</command> from the "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1074
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1104
msgid "Be sure to verify the following items:"
msgstr ""
-# type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:1079
+#
. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:1109
msgid ""
-"Target the right distribution in your <filename>debian/changelog</"
-"filename>. For <literal>stable</literal> this is <literal>stable-security</"
-"literal> and for testing this is <literal>testing-security</literal>, and "
-"for the previous stable release, this is <literal>oldstable-security</"
-"literal>. Do not target <replaceable>distribution</replaceable><literal>-"
-"proposed-updates</literal> or <literal>stable</literal>!"
+"<emphasis role=\"strong\">Target the right distribution</emphasis> in your "
+"<filename>debian/changelog</filename>. For <literal>stable</literal> this "
+"is <literal>stable-security</literal> and for testing this is "
+"<literal>testing-security</literal>, and for the previous stable release, "
+"this is <literal>oldstable-security</literal>. Do not target "
+"<replaceable>distribution</replaceable><literal>-proposed-updates</literal> "
+"or <literal>stable</literal>!"
msgstr ""
# type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:1089
-msgid "The upload should have urgency=high."
+#. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:1120
+#, fuzzy
+msgid ""
+"The upload should have <emphasis role=\"strong\">urgency=high</emphasis>."
msgstr "アップロードは urgency=high で行う必要があります。"
-# type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:1094
+#
. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:1125
msgid ""
"Make descriptive, meaningful changelog entries. Others will rely on them to "
-"determine whether a particular bug was fixed. Always include an external "
-"reference, preferably a CVE identifier, so that it can be cross-referenced. "
-"Include the same information in the changelog for <literal>unstable</"
-"literal>, so that it is clear that the same bug was fixed, as this is very "
-"helpful when verifying that the bug is fixed in the next stable release. If "
-"a CVE identifier has not yet been assigned, the security team will request "
-"one so that it can be included in the package and in the advisory."
-msgstr ""
-
-# type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:1107
-msgid ""
-"Make sure the version number is proper. It must be greater than the current "
-"package, but less than package versions in later distributions. If in "
-"doubt, test it with <literal>dpkg --compare-versions</literal>. Be careful "
-"not to re-use a version number that you have already used for a previous "
-"upload. For <literal>testing</literal>, there must be a higher version in "
-"<literal>unstable</literal>. If there is none yet (for example, if "
-"<literal>testing</literal> and <literal>unstable</literal> have the same "
-"version) you must upload a new version to <literal>unstable</literal> first."
+"determine whether a particular bug was fixed. Add <literal>closes:</"
+"literal> statements for any <emphasis role=\"strong\">Debian bugs</emphasis> "
+"filed. Always include an external reference, preferably a <emphasis role="
+"\"strong\">CVE identifier</emphasis>, so that it can be cross-referenced. "
+"However, if a CVE identifier has not yet been assigned, do not wait for it "
+"but continue the process. The identifier can be cross-referenced later."
msgstr ""
-# type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:1119
+#
. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:1136
msgid ""
-"Do not make source-only uploads if your package has any binary-all packages "
-"(do not use the <literal>-S</literal> option to <command>dpkg-buildpackage</"
-"command>). The <command>buildd</command> infrastructure will not build "
-"those. This point applies to normal package uploads as well."
+"Make sure the <emphasis role=\"strong\">version number</emphasis> is "
+"proper. It must be greater than the current package, but less than package "
+"versions in later distributions. If in doubt, test it with <literal>dpkg --"
+"compare-versions</literal>. Be careful not to re-use a version number that "
+"you have already used for a previous upload, or one that conflicts with a "
+"binNMU. The convention is to append <literal>+</"
+"literal><replaceable>codename</replaceable><literal>1</literal>, e.g. "
+"<literal>1:2.4.3-4+etch1</literal>, of course increasing 1 for any "
+"subsequent uploads."
msgstr ""
-# type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:1128
+#
. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:1149
msgid ""
"Unless the upstream source has been uploaded to <literal>security.debian.org "
-"</literal> before (by a previous security update), build the upload with "
-"full upstream source (<literal>dpkg-buildpackage -sa</literal>). If there "
-"has been a previous upload to <literal>security.debian.org</literal> with "
-"the same upstream version, you may upload without upstream source (<literal> "
-"dpkg-buildpackage -sd</literal>)."
+"</literal> before (by a previous security update), build the upload "
+"<emphasis role=\"strong\">with full upstream source</emphasis> "
+"(<literal>dpkg-buildpackage -sa</literal>). If there has been a previous "
+"upload to <literal>security.debian.org</literal> with the same upstream "
+"version, you may upload without upstream source (<literal> dpkg-buildpackage "
+"-sd</literal>)."
msgstr ""
-# type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:1138
+#
. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:1159
msgid ""
-"Be sure to use the exact same <filename>*.orig.tar.gz</filename> as used in "
-"the normal archive, otherwise it is not possible to move the security fix "
-"into the main archives later."
+"Be sure to use the <emphasis role=\"strong\">exact same <filename>*.orig.tar."
+"gz</filename></emphasis> as used in the normal archive, otherwise it is not "
+"possible to move the security fix into the main archives later."
msgstr ""
-# type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:1145
+#
. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:1167
msgid ""
-"Build the package on a clean system which only has packages installed from "
-"the distribution you are building for. If you do not have such a system "
-"yourself, you can use a debian.org machine (see <xref linkend=\"server-"
-"machines\"/> ) or setup a chroot (see <xref linkend=\"pbuilder\"/> and <xref "
-"linkend=\"debootstrap\"/> )."
+"Build the package on a <emphasis role=\"strong\">clean system</emphasis> "
+"which only has packages installed from the distribution you are building "
+"for. If you do not have such a system yourself, you can use a debian.org "
+"machine (see <xref linkend=\"server-machines\"/> ) or setup a chroot (see "
+"<xref linkend=\"pbuilder\"/> and <xref linkend=\"debootstrap\"/> )."
msgstr ""
# type: Content of: <chapter><section><section><section><title>
-#: pkgs.dbk:1156
+#. type: Content of: <chapter><section><section><section><title>
+#: pkgs.dbk:1178
msgid "Uploading the fixed package"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1158
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1180
msgid ""
"Do <emphasis role=\"strong\">NOT</emphasis> upload a package to the security "
"upload queue (<literal>oldstable-security</literal>, <literal>stable-"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1165
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1187
msgid ""
"Do <emphasis role=\"strong\">NOT</emphasis> upload your fix to <literal> "
"proposed-updates</literal> without coordinating with the security team. "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1175
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1197
msgid ""
"Once you have created and tested the new package and it has been approved by "
"the security team, it needs to be uploaded so that it can be installed in "
"literal> ."
msgstr ""
-# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1181
+#
. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1203
msgid ""
"Once an upload to the security queue has been accepted, the package will "
-"automatically be rebuilt for all architectures and stored for verification "
-"by the security team."
+"automatically be built for all architectures and stored for verification by "
+"the security team."
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1186
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1208
msgid ""
"Uploads which are waiting for acceptance or verification are only accessible "
"by the security team. This is necessary since there might be fixes for "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1191
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1213
msgid ""
"If a member of the security team accepts a package, it will be installed on "
"<literal>security.debian.org</literal> as well as proposed for the proper "
msgstr ""
# type: Content of: <chapter><section><title>
-#: pkgs.dbk:1203
+#. type: Content of: <chapter><section><title>
+#: pkgs.dbk:1225
msgid "Moving, removing, renaming, adopting, and orphaning packages"
msgstr "パッケージの移動、削除、リネーム、変更、みなしご化"
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:1205
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:1227
msgid ""
"Some archive manipulation operations are not automated in the Debian upload "
"process. These procedures should be manually followed by maintainers. This "
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:1210
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:1232
msgid "Moving packages"
msgstr "パッケージの移動"
-# type: Content of: <chapter><section><section><para><footnote>
-#: pkgs.dbk:1212
-msgid ""
-"Sometimes a package will change its section. For instance, a package from "
-"the `non-free' section might be GPL'd in a later version, in which case the "
-"package should be moved to `main' or `contrib'.<footnote>"
-msgstr ""
-
# type: Content of: <chapter><section><section><para><footnote><para>
-#: pkgs.dbk:1214
+#. type: Content of: <chapter><section><section><para><footnote><para>
+#: pkgs.dbk:1236
msgid ""
"See the <ulink url=\"&url-debian-policy;\">Debian Policy Manual</ulink> for "
"guidelines on what section a package belongs in."
msgstr ""
-# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1216 pkgs.dbk:1648
-msgid "</footnote>"
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1234
+msgid ""
+"Sometimes a package will change its section. For instance, a package from "
+"the `non-free' section might be GPL'd in a later version, in which case the "
+"package should be moved to `main' or `contrib'.<placeholder type=\"footnote"
+"\" id=\"0\"/>"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1219
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1241
msgid ""
"If you need to change the section for one of your packages, change the "
"package control information to place the package in the desired section, and "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1231
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1253
msgid ""
"If, on the other hand, you need to change the <literal>subsection</literal> "
"of one of your packages (e.g., ``devel'', ``admin''), the procedure is "
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:1240
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:1262
msgid "Removing packages"
msgstr "パッケージの削除"
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1242
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1264
msgid ""
"If for some reason you want to completely remove a package (say, if it is an "
"old compatibility library which is no longer required), you need to file a "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1259
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1281
msgid ""
"If you want to remove a package you maintain, you should note this in the "
"bug title by prepending <literal>ROM</literal> (Request Of Maintainer). "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1268
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1290
msgid ""
"Note that removals can only be done for the <literal>unstable </literal>, "
"<literal>experimental</literal> and <literal>stable </literal> "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1277
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1299
msgid ""
"There is one exception when an explicit removal request is not necessary: If "
"a (source or binary) package is an orphan, it will be removed semi-"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1286
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1308
msgid ""
"In your removal request, you have to detail the reasons justifying the "
"request. This is to avoid unwanted removals and to keep a trace of why a "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1292
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1314
msgid ""
"Usually you only ask for the removal of a package maintained by yourself. "
"If you want to remove another package, you have to get the approval of its "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1302
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1324
msgid ""
"Further information relating to these and other package removal related "
"topics may be found at <ulink url=\"http://wiki.debian.org/ftpmaster_Removals"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1307
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1329
msgid ""
"If in doubt concerning whether a package is disposable, email &email-debian-"
"devel; asking for opinions. Also of interest is the <command>apt-cache</"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1320
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1342
msgid ""
"Once the package has been removed, the package's bugs should be handled. "
"They should either be reassigned to another package in the case where the "
msgstr ""
# type: Content of: <chapter><section><section><section><title>
-#: pkgs.dbk:1327
+#. type: Content of: <chapter><section><section><section><title>
+#: pkgs.dbk:1349
msgid "Removing packages from <filename>Incoming</filename>"
msgstr "<filename>Incoming</filename> からパッケージを削除する"
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1329
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1351
msgid ""
"In the past, it was possible to remove packages from <filename>incoming</"
"filename>. However, with the introduction of the new incoming system, this "
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:1344
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:1366
msgid "Replacing or renaming packages"
msgstr "パッケージをリプレースあるいはリネームする"
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1346
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1368
msgid ""
"When the upstream maintainers for one of your packages chose to rename their "
"software (or you made a mistake naming your package), you should follow a "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1362
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1384
msgid ""
"At other times, you may make a mistake in constructing your package and wish "
"to replace it. The only way to do this is to increase the version number "
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:1376
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:1398
msgid "Orphaning a package"
msgstr "パッケージをみなしご化する"
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1378
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1400
msgid ""
"If you can no longer maintain a package, you need to inform others, and see "
"that the package is marked as orphaned. You should set the package "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1393
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1415
msgid ""
"If you just intend to give the package away, but you can keep maintainership "
"for the moment, then you should instead submit a bug against <systemitem "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1401
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1423
msgid ""
"More information is on the <ulink url=\"&url-wnpp;\">WNPP web pages</ulink>."
msgstr ""
"す。"
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:1407
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:1429
msgid "Adopting a package"
msgstr "パッケージに変更を加える"
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1409
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1431
msgid ""
"A list of packages in need of a new maintainer is available in the <ulink "
"url=\"&url-wnpp;\">Work-Needing and Prospective Packages list (WNPP)</"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1416
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1438
msgid ""
"It is not OK to simply take over a package that you feel is neglected — that "
"would be package hijacking. You can, of course, contact the current "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1422
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1444
msgid ""
"Generally, you may not take over the package without the assent of the "
"current maintainer. Even if they ignore you, that is still not grounds to "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1432
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1454
msgid ""
"If you take over an old package, you probably want to be listed as the "
"package's official maintainer in the bug system. This will happen "
msgstr ""
# type: Content of: <chapter><section><title>
-#: pkgs.dbk:1446
+#. type: Content of: <chapter><section><title>
+#: pkgs.dbk:1468
msgid "Porting and being ported"
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:1448
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:1470
msgid ""
"Debian supports an ever-increasing number of architectures. Even if you are "
"not a porter, and you don't use any architecture but one, it is part of your "
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:1454
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:1476
msgid ""
"Porting is the act of building Debian packages for architectures that are "
"different from the original architecture of the package maintainer's binary "
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:1463
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:1485
msgid "Being kind to porters"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1465
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1487
msgid ""
"Porters have a difficult and unique task, since they are required to deal "
"with a large volume of packages. Ideally, every source package should build "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1473
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1495
msgid ""
"The first and most important thing is to respond quickly to bug or issues "
"raised by porters. Please treat porters with courtesy, as if they were in "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1480
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1502
msgid ""
"By far, most of the problems encountered by porters are caused by "
"<emphasis>packaging bugs</emphasis> in the source packages. Here is a "
msgstr ""
# type: Content of: <chapter><section><section><orderedlist><listitem><para>
-#: pkgs.dbk:1487
+#. type: Content of: <chapter><section><section><orderedlist><listitem><para>
+#: pkgs.dbk:1509
msgid ""
"Make sure that your <literal>Build-Depends</literal> and <literal>Build-"
"Depends-Indep</literal> settings in <filename>debian/control</filename> are "
msgstr ""
# type: Content of: <chapter><section><section><orderedlist><listitem><para>
-#: pkgs.dbk:1502
+#. type: Content of: <chapter><section><section><orderedlist><listitem><para>
+#: pkgs.dbk:1524
msgid ""
"If you can't set up a proper chroot, <command>dpkg-depcheck</command> may be "
"of assistance (see <xref linkend=\"dpkg-depcheck\"/> )."
msgstr ""
# type: Content of: <chapter><section><section><orderedlist><listitem><para>
-#: pkgs.dbk:1506
+#. type: Content of: <chapter><section><section><orderedlist><listitem><para>
+#: pkgs.dbk:1528
msgid ""
"See the <ulink url=\"&url-debian-policy;\">Debian Policy Manual</ulink> for "
"instructions on setting build dependencies."
msgstr ""
# type: Content of: <chapter><section><section><orderedlist><listitem><para>
-#: pkgs.dbk:1512
+#. type: Content of: <chapter><section><section><orderedlist><listitem><para>
+#: pkgs.dbk:1534
msgid ""
"Don't set architecture to a value other than <literal>all</literal> or "
"<literal>any</literal> unless you really mean it. In too many cases, "
msgstr ""
# type: Content of: <chapter><section><section><orderedlist><listitem><para>
-#: pkgs.dbk:1522
+#. type: Content of: <chapter><section><section><orderedlist><listitem><para>
+#: pkgs.dbk:1544
msgid ""
"Make sure your source package is correct. Do <literal>dpkg-source -x "
"<replaceable>package</replaceable>.dsc</literal> to make sure your source "
msgstr ""
# type: Content of: <chapter><section><section><orderedlist><listitem><para>
-#: pkgs.dbk:1530
+#. type: Content of: <chapter><section><section><orderedlist><listitem><para>
+#: pkgs.dbk:1552
msgid ""
"Make sure you don't ship your source package with the <filename>debian/"
"files</filename> or <filename>debian/substvars</filename> files. They "
msgstr ""
# type: Content of: <chapter><section><section><orderedlist><listitem><para>
-#: pkgs.dbk:1538
+#. type: Content of: <chapter><section><section><orderedlist><listitem><para>
+#: pkgs.dbk:1560
msgid ""
"Make sure you don't rely on locally installed or hacked configurations or "
"programs. For instance, you should never be calling programs in <filename>/"
msgstr ""
# type: Content of: <chapter><section><section><orderedlist><listitem><para>
-#: pkgs.dbk:1547
+#. type: Content of: <chapter><section><section><orderedlist><listitem><para>
+#: pkgs.dbk:1569
msgid ""
"Don't depend on the package you're building being installed already (a sub-"
"case of the above issue). There are, of course, exceptions to this rule, but "
msgstr ""
# type: Content of: <chapter><section><section><orderedlist><listitem><para>
-#: pkgs.dbk:1555
+#. type: Content of: <chapter><section><section><orderedlist><listitem><para>
+#: pkgs.dbk:1577
msgid ""
"Don't rely on the compiler being a certain version, if possible. If not, "
"then make sure your build dependencies reflect the restrictions, although "
msgstr ""
# type: Content of: <chapter><section><section><orderedlist><listitem><para>
-#: pkgs.dbk:1563
+#. type: Content of: <chapter><section><section><orderedlist><listitem><para>
+#: pkgs.dbk:1585
msgid ""
"Make sure your debian/rules contains separate <literal>binary-arch</literal> "
"and <literal>binary-indep</literal> targets, as the Debian Policy Manual "
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:1574
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:1596
msgid "Guidelines for porter uploads"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1576
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1598
msgid ""
"If the package builds out of the box for the architecture to be ported to, "
"you are in luck and your job is easy. This section applies to that case; it "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1584
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1606
msgid ""
"For a porter upload, no changes are being made to the source. You do not "
"need to touch any of the files in the source package. This includes "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1589
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1611
msgid ""
"The way to invoke <command>dpkg-buildpackage</command> is as <literal>dpkg-"
"buildpackage -B -m<replaceable>porter-email</replaceable></literal>. Of "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1598
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1620
msgid ""
"If you are working on a Debian machine for your porting efforts and you need "
"to sign your upload locally for its acceptance in the archive, you can run "
msgstr ""
# type: Content of: <chapter><section><section><section><title>
-#: pkgs.dbk:1605
+#. type: Content of: <chapter><section><section><section><title>
+#: pkgs.dbk:1627
msgid "Recompilation or binary-only NMU"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1607
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1629
msgid ""
"Sometimes the initial porter upload is problematic because the environment "
"in which the package was built was not good enough (outdated or obsolete "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1616
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1638
msgid ""
"You have to make sure that your binary-only NMU doesn't render the package "
"uninstallable. This could happen when a source package generates arch-"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1623
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1645
msgid ""
"Despite the required modification of the changelog, these are called binary-"
"only NMUs — there is no need in this case to trigger all other architectures "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1628
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1650
msgid ""
"Such recompilations require special ``magic'' version numbering, so that the "
"archive maintenance tools recognize that, even though there is a new Debian "
"corresponding source code)."
msgstr ""
-# type: Content of: <chapter><section><section><section><para><footnote>
-#: pkgs.dbk:1635
+# type: Content of: <chapter><section><section><section><para><footnote><para>
+#. type: Content of: <chapter><section><section><section><para><footnote><para>
+#: pkgs.dbk:1665
+msgid ""
+"In the past, such NMUs used the third-level number on the Debian part of the "
+"revision to denote their recompilation-only status; however, this syntax was "
+"ambiguous with native packages and did not allow proper ordering of "
+"recompile-only NMUs, source NMUs, and security NMUs on the same package, and "
+"has therefore been abandoned in favor of this new syntax."
+msgstr ""
+
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1657
msgid ""
"The ``magic'' for a recompilation-only NMU is triggered by using a suffix "
"appended to the package version number, following the form <literal> "
"your binary-only NMU should carry a version of <literal>2.9-3+b1</literal>. "
"If the latest version was <literal>3.4+b1 </literal> (i.e, a native package "
"with a previous recompilation NMU), your binary-only NMU should have a "
-"version number of <literal>3.4+b2</literal>. <footnote>"
-msgstr ""
-
-# type: Content of: <chapter><section><section><section><para><footnote><para>
-#: pkgs.dbk:1643
-msgid ""
-"In the past, such NMUs used the third-level number on the Debian part of the "
-"revision to denote their recompilation-only status; however, this syntax was "
-"ambiguous with native packages and did not allow proper ordering of "
-"recompile-only NMUs, source NMUs, and security NMUs on the same package, and "
-"has therefore been abandoned in favor of this new syntax."
+"version number of <literal>3.4+b2</literal>. <placeholder type=\"footnote\" "
+"id=\"0\"/>"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1651
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1673
msgid ""
"Similar to initial porter uploads, the correct way of invoking <command>dpkg-"
"buildpackage</command> is <literal>dpkg-buildpackage -B</literal> to only "
msgstr ""
# type: Content of: <chapter><section><section><section><title>
-#: pkgs.dbk:1658
+#. type: Content of: <chapter><section><section><section><title>
+#: pkgs.dbk:1680
msgid "When to do a source NMU if you are a porter"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1660
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1682
msgid ""
"Porters doing a source NMU generally follow the guidelines found in <xref "
"linkend=\"nmu\"/> , just like non-porters. However, it is expected that the "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1669
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1691
msgid ""
"If you are a porter doing an NMU for <literal>unstable</literal>, the above "
"guidelines for porting should be followed, with two variations. Firstly, "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1681
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1703
msgid ""
"Secondly, porters doing source NMUs should make sure that the bug they "
"submit to the BTS should be of severity <literal>serious</literal> or "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1689
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1711
msgid ""
"Porters should try to avoid patches which simply kludge around bugs in the "
"current version of the compile environment, kernel, or libc. Sometimes such "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1697
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1719
msgid ""
"Porters may also have an unofficial location where they can put the results "
"of their work during the waiting period. This helps others running the port "
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:1707
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:1729
msgid "Porting infrastructure and automation"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1709
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1731
msgid ""
"There is infrastructure and several tools to help automate package porting. "
"This section contains a brief overview of this automation and porting to "
msgstr ""
# type: Content of: <chapter><section><section><section><title>
-#: pkgs.dbk:1714
+#. type: Content of: <chapter><section><section><section><title>
+#: pkgs.dbk:1736
msgid "Mailing lists and web pages"
msgstr "メーリングリストとウェブページ"
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1716
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1738
msgid ""
"Web pages containing the status of each port can be found at <ulink url="
"\"&url-debian-ports;\"></ulink>."
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1720
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1742
msgid ""
"Each port of Debian has a mailing list. The list of porting mailing lists "
"can be found at <ulink url=\"&url-debian-port-lists;\"></ulink>. These "
msgstr ""
# type: Content of: <chapter><section><section><section><title>
-#: pkgs.dbk:1728
+#. type: Content of: <chapter><section><section><section><title>
+#: pkgs.dbk:1750
msgid "Porter tools"
msgstr "移植用ツール"
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1730
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1752
msgid ""
"Descriptions of several porting tools can be found in <xref linkend=\"tools-"
"porting\"/> ."
msgstr ""
# type: Content of: <chapter><section><section><section><title>
-#: pkgs.dbk:1736
+#. type: Content of: <chapter><section><section><section><title>
+#: pkgs.dbk:1758
msgid "<systemitem role=\"package\">wanna-build</systemitem>"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1738
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1760
msgid ""
"The <systemitem role=\"package\">wanna-build</systemitem> system is used as "
"a distributed, client-server build distribution system. It is usually used "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1746
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1768
msgid ""
"<systemitem role=\"package\">wanna-build</systemitem> is not yet available "
"as a package; however, all Debian porting efforts are using it for automated "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1755
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1777
msgid ""
"Most of the data produced by <systemitem role=\"package\">wanna-build </"
"systemitem> which is generally useful to porters is available on the web at "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1761
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1783
msgid ""
"We are quite proud of this system, since it has so many possible uses. "
"Independent development groups can use the system for different sub-flavors "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:1768
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:1790
msgid ""
"The buildds admins of each arch can be contacted at the mail address "
"<literal><replaceable>arch</replaceable>@buildd.debian.org</literal>."
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:1776
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:1798
msgid "When your package is <emphasis>not</emphasis> portable"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1778
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1800
msgid ""
"Some packages still have issues with building and/or working on some of the "
"architectures supported by Debian, and cannot be ported at all, or not "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1785
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1807
msgid ""
"In order to prevent broken packages from being uploaded to the archive, and "
"wasting buildd time, you need to do a few things:"
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:1791
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:1813
msgid ""
"First, make sure your package <emphasis>does</emphasis> fail to build on "
"architectures that it cannot support. There are a few ways to achieve "
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:1799
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:1821
msgid ""
"Additionally, if you believe the list of supported architectures is pretty "
"constant, you should change <literal>any</literal> to a list of supported "
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:1807
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:1829
msgid ""
"In order to prevent autobuilders from needlessly trying to build your "
"package, it must be included in <filename>packages-arch-specific</filename>, "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1817
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1839
msgid ""
"Please note that it is insufficient to only add your package to Packages-"
"arch-specific without making it fail to build on unsupported architectures: "
msgstr ""
# type: Content of: <chapter><section><title>
-#: pkgs.dbk:1830
+#. type: Content of: <chapter><section><title>
+#: pkgs.dbk:1852
msgid "Non-Maintainer Uploads (NMUs)"
msgstr ""
-# type: Content of: <chapter><section><para>
-#: pkgs.dbk:1832
-msgid ""
-"Under certain circumstances it is necessary for someone other than the "
-"official package maintainer to make a release of a package. This is called "
-"a non-maintainer upload, or NMU."
-msgstr ""
-
-# type: Content of: <chapter><section><para>
-#: pkgs.dbk:1837
-msgid ""
-"This section handles only source NMUs, i.e. NMUs which upload a new version "
-"of the package. For binary-only NMUs by porters or QA members, please see "
-"<xref linkend=\"binary-only-nmu\"/> . If a buildd builds and uploads a "
-"package, that too is strictly speaking a binary NMU. See <xref linkend="
-"\"wanna-build\"/> for some more information."
-msgstr ""
-
-# type: Content of: <chapter><section><para>
-#: pkgs.dbk:1844
-msgid ""
-"The main reason why NMUs are done is when a developer needs to fix another "
-"developer's package in order to address serious problems or crippling bugs "
-"or when the package maintainer is unable to release a fix in a timely "
-"fashion."
-msgstr ""
-
-# type: Content of: <chapter><section><para>
-#: pkgs.dbk:1849
-msgid ""
-"First and foremost, it is critical that NMU patches to source should be as "
-"non-disruptive as possible. Do not do housekeeping tasks, do not change the "
-"name of modules or files, do not move directories; in general, do not fix "
-"things which are not broken. Keep the patch as small as possible. If "
-"things bother you aesthetically, talk to the Debian maintainer, talk to the "
-"upstream maintainer, or submit a bug. However, aesthetic changes must "
-"<emphasis>not</emphasis> be made in a non-maintainer upload."
-msgstr ""
-
-# type: Content of: <chapter><section><para>
-#: pkgs.dbk:1858
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:1854
msgid ""
-"And please remember the Hippocratic Oath: Above all, do no harm. It is "
-"better to leave a package with an open grave bug than applying a non-"
-"functional patch, or one that hides the bug instead of resolving it."
+"Every package has one or more maintainers. Normally, these are the people "
+"who work on and upload new versions of the package. In some situations, it "
+"is useful that other developers can upload a new version as well, for "
+"example if they want to fix a bug in a package they don't maintain, when the "
+"maintainer needs help to respond to issues. Such uploads are called "
+"<emphasis>Non-Maintainer Uploads (NMU)</emphasis>."
msgstr ""
# type: Content of: <chapter><section><section><title>
+#. type: Content of: <chapter><section><section><title>
#: pkgs.dbk:1863
-msgid "How to do a NMU"
-msgstr "NMU のやり方"
+#, fuzzy
+msgid "When and how to do an NMU"
+msgstr "誰が NMU 可能なのか"
-# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1865
-msgid ""
-"NMUs which fix important, serious or higher severity bugs are encouraged and "
-"accepted. You should endeavor to reach the current maintainer of the "
-"package; they might be just about to upload a fix for the problem, or have a "
-"better solution."
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1866
+msgid "Before doing an NMU, consider the following questions:"
msgstr ""
-#
type: Content of: <chapter><section><section><para>
+#
. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
#: pkgs.dbk:1871
msgid ""
-"NMUs should be made to assist a package's maintainer in resolving bugs. "
-"Maintainers should be thankful for that help, and NMUers should respect the "
-"decisions of maintainers, and try to personally help the maintainer by their "
-"work."
+"Does your NMU really fix bugs? Fixing cosmetic issues or changing the "
+"packaging style in NMUs is discouraged."
msgstr ""
-#
type: Content of: <chapter><section><section><para>
+#
. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
#: pkgs.dbk:1877
msgid ""
-"A NMU should follow all conventions, written down in this section. For an "
-"upload to <literal>testing</literal> or <literal>unstable</literal>, this "
-"order of steps is recommended:"
+"Did you give enough time to the maintainer? When was the bug reported to the "
+"BTS? Being busy for a week or two isn't unusual. Is the bug so severe that "
+"it needs to be fixed right now, or can it wait a few more days?"
msgstr ""
-# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#
. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
#: pkgs.dbk:1884
msgid ""
-"Make sure that the package's bugs that the NMU is meant to address are all "
-"filed in the Debian Bug Tracking System (BTS). If they are not, submit them "
-"immediately."
+"How confident are you about your changes? Please remember the Hippocratic "
+"Oath: \"Above all, do no harm.\" It is better to leave a package with an "
+"open grave bug than applying a non-functional patch, or one that hides the "
+"bug instead of resolving it. If you are not 100% sure of what you did, it "
+"might be a good idea to seek advice from others. Remember that if you break "
+"something in your NMU, many people will be very unhappy about it."
msgstr ""
-# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:1891
+#
. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:1894
msgid ""
-"Wait a few days for the response from the maintainer. If you don't get any "
-"response, you may want to help them by sending the patch that fixes the "
-"bug. Don't forget to tag the bug with the patch keyword."
+"Have you clearly expressed your intention to NMU, at least in the BTS? It is "
+"also a good idea to try to contact the maintainer by other means (private "
+"email, IRC)."
msgstr ""
-# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:1898
+#
. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:1901
msgid ""
-"Wait a few more days. If you still haven't got an answer from the "
-"maintainer, send them a mail announcing your intent to NMU the package. "
-"Prepare an NMU as described in this section, and test it carefully on your "
-"machine (cf. <xref linkend=\"sanitycheck\"/> ). Double check that your "
-"patch doesn't have any unexpected side effects. Make sure your patch is as "
-"small and as non-disruptive as it can be."
+"If the maintainer is usually active and responsive, have you tried to "
+"contact him? In general it should be considered preferable that a maintainer "
+"takes care of an issue himself and that he is given the chance to review and "
+"correct your patch, because he can be expected to be more aware of potential "
+"issues which an NMUer might miss. It is often a better use of everyone's "
+"time if the maintainer is given an opportunity to upload a fix on their own."
msgstr ""
-#
type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:1908
+#
. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1911
msgid ""
-"Upload your package to incoming in <filename>DELAYED/7-day</filename> (cf. "
-"<xref linkend=\"delayed-incoming\"/> ), send the final patch to the "
-"maintainer via the BTS, and explain to them that they have 7 days to react "
-"if they want to cancel the NMU."
+"When doing an NMU, you must first make sure that your intention to NMU is "
+"clear. Then, you must send a patch with the differences between the current "
+"package and your proposed NMU to the BTS. The <literal>nmudiff</literal> "
+"script in the <literal>devscripts</literal> package might be helpful."
msgstr ""
-#
type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:1916
+#
. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1918
msgid ""
-"Follow what happens, you're responsible for any bug that you introduced with "
-"your NMU. You should probably use <xref linkend=\"pkg-tracking-system\"/> "
-"(PTS) to stay informed of the state of the package after your NMU."
+"While preparing the patch, you should better be aware of any package-"
+"specific practices that the maintainer might be using. Taking them into "
+"account reduces the burden of getting your changes integrated back in the "
+"normal package workflow and thus increases the possibilities that that will "
+"happen. A good place where to look for for possible package-specific "
+"practices is <ulink url=\"&url-debian-policy;ch-source.html#s-readmesource"
+"\"><literal>debian/README.source</literal></ulink>."
msgstr ""
-# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1923
+#
. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1926
msgid ""
-"At times, the release manager or an organized group of developers can "
-"announce a certain period of time in which the NMU rules are relaxed. This "
-"usually involves shortening the period during which one is to wait before "
-"uploading the fixes, and shortening the DELAYED period. It is important to "
-"notice that even in these so-called bug squashing party times, the NMU'er "
-"has to file bugs and contact the developer first, and act later. Please see "
-"<xref linkend=\"qa-bsp\"/> for details."
+"Unless you have an excellent reason not to do so, you must then give some "
+"time to the maintainer to react (for example, by uploading to the "
+"<literal>DELAYED</literal> queue). Here are some recommended values to use "
+"for delays:"
msgstr ""
-# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1932
-msgid ""
-"For the <literal>testing</literal> distribution, the rules may be changed by "
-"the release managers. Please take additional care, and acknowledge that the "
-"usual way for a package to enter <literal>testing</literal> is through "
-"<literal>unstable</literal>."
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:1933
+msgid "Upload fixing only release-critical bugs older than 7 days: 2 days"
msgstr ""
-#
type: Content of: <chapter><section><section><para>
+#
. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
#: pkgs.dbk:1938
-msgid ""
-"For the stable distribution, please take extra care. Of course, the release "
-"managers may also change the rules here. Please verify before you upload "
-"that all your changes are OK for inclusion into the next stable release by "
-"the release manager."
+msgid "Upload fixing only release-critical and important bugs: 5 days"
msgstr ""
-# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1944
-msgid ""
-"When a security bug is detected, the security team may do an NMU, using "
-"their own rules. Please refer to <xref linkend=\"bug-security\"/> for more "
-"information."
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:1943
+msgid "Other NMUs: 10 days"
msgstr ""
-# type: Content of: <chapter><section><section><para>
+#
. type: Content of: <chapter><section><section><para>
#: pkgs.dbk:1949
msgid ""
-"For the differences for Porters NMUs, please see <xref linkend=\"source-nmu-"
-"when-porter\"/> ."
+"Those delays are only examples. In some cases, such as uploads fixing "
+"security issues, or fixes for trivial bugs that blocking a transition, it is "
+"desirable that the fixed package reaches <literal>unstable</literal> sooner."
msgstr ""
-# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1953
+#
. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1955
msgid ""
-"Of course, it is always possible to agree on special rules with a maintainer "
-"(like the maintainer asking please upload this fix directly for me, and no "
-"diff required)."
+"Sometimes, release managers decide to allow NMUs with shorter delays for a "
+"subset of bugs (e.g release-critical bugs older than 7 days). Also, some "
+"maintainers list themselves in the <ulink url=\"&url-low-threshold-nmu;"
+"\">Low Threshold NMU list</ulink>, and accept that NMUs are uploaded without "
+"delay. But even in those cases, it's still a good idea to give the "
+"maintainer a few days to react before you upload, especially if the patch "
+"wasn't available in the BTS before, or if you know that the maintainer is "
+"generally active."
msgstr ""
-# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:1960
-msgid "NMU version numbering"
-msgstr ""
-
-# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1962
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1965
msgid ""
-"Whenever you have made a change to a package, no matter how trivial, the "
-"version number needs to change. This enables our packing system to function."
+"After you upload an NMU, you are responsible for the possible problems that "
+"you might have introduced. You must keep an eye on the package (subscribing "
+"to the package on the PTS is a good way to achieve this)."
msgstr ""
-# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1966
+#
. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1971
msgid ""
-"If you are doing a non-maintainer upload (NMU), you should add a new minor "
-"version number to the <replaceable>debian-revision</replaceable> part of the "
-"version number (the portion after the last hyphen). This extra minor number "
-"will start at `1'. For example, consider the package `foo', which is at "
-"version 1.1-3. In the archive, the source package control file would be "
-"<filename>foo_1.1-3.dsc</filename>. The upstream version is `1.1' and the "
-"Debian revision is `3'. The next NMU would add a new minor number `.1' to "
-"the Debian revision; the new source control file would be <filename>foo_1.1-"
-"3.1.dsc</filename>."
+"This is not a license to perform NMUs thoughtlessly. If you NMU when it is "
+"clear that the maintainers are active and would have acknowledged a patch in "
+"a timely manner, or if you ignore the recommendations of this document, your "
+"upload might be a cause of conflict with the maintainer. You should always "
+"be prepared to defend the wisdom of any NMU you perform on its own merits."
msgstr ""
-# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1977
-msgid ""
-"The Debian revision minor number is needed to avoid stealing one of the "
-"package maintainer's version numbers, which might disrupt their work. It "
-"also has the benefit of making it visually clear that a package in the "
-"archive was not made by the official maintainer."
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:1981
+msgid "NMUs and debian/changelog"
msgstr ""
-# type: Content of: <chapter><section><section><para>
+#
. type: Content of: <chapter><section><section><para>
#: pkgs.dbk:1983
msgid ""
-"If there is no <replaceable>debian-revision</replaceable> component in the "
-"version number then one should be created, starting at `0.1' (but in case of "
-"a debian native package still upload it as native package). If it is "
-"absolutely necessary for someone other than the usual maintainer to make a "
-"release based on a new upstream version then the person making the release "
-"should start with the <replaceable>debian-revision</replaceable> value "
-"`0.1'. The usual maintainer of a package should start their "
-"<replaceable>debian-revision</replaceable> numbering at `1'."
-msgstr ""
-
-# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:1993
-msgid ""
-"If you upload a package to <literal>testing</literal> or <literal>stable </"
-"literal>, sometimes, you need to fork the version number tree. For this, "
-"version numbers like 1.1-3sarge0.1 could be used."
-msgstr ""
-
-# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:2000
-msgid "Source NMUs must have a new changelog entry"
-msgstr ""
-
-# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2002
-msgid ""
-"Anyone who is doing a source NMU must create a changelog entry, describing "
-"which bugs are fixed by the NMU, and generally why the NMU was required and "
-"what it fixed. The changelog entry will have the email address of the "
-"person who uploaded it in the log entry and the NMU version number in it."
-msgstr ""
-
-# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2008
-msgid "By convention, source NMU changelog entries start with the line"
+"Just like any other (source) upload, NMUs must add an entry to "
+"<literal>debian/changelog</literal>, telling what has changed with this "
+"upload. The first line of this entry must explicitely mention that this "
+"upload is an NMU, e.g.:"
msgstr ""
# type: Content of: <chapter><section><section><screen>
-#: pkgs.dbk:2010
+#. type: Content of: <chapter><section><section><screen>
+#: pkgs.dbk:1988
#, fuzzy, no-wrap
-msgid ""
-"\n"
-" * Non-maintainer upload\n"
+msgid " * Non-maintainer upload.\n"
msgstr "* Non-maintainer upload"
-# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:2016
-msgid "Source NMUs and the Bug Tracking System"
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:1992
+msgid ""
+"The version must be the version of the last maintainer upload, plus <literal>"
+"+nmu<replaceable>X</replaceable></literal>, where <replaceable>X</"
+"replaceable> is a counter starting at <literal>1</literal>. If the last "
+"upload was also an NMU, the counter should be increased. For example, if "
+"the current version is <literal>1.5-1</literal>, then an NMU would get "
+"version <literal>1.5-1+nmu1</literal>. If the current version is "
+"<literal>1.5+nmu3</literal> (a native package which has already been NMUed), "
+"the NMU would get version <literal>1.5+nmu4</literal>. If a new upstream "
+"version is packaged in the NMU, the debian revision is set to <literal>0</"
+"literal>, for example <literal>1.6-0+nmu1</literal>."
+msgstr ""
+
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2005
+msgid ""
+"A special versioning scheme is needed to avoid disrupting the maintainer's "
+"work, since using an integer for the Debian revision will potentially "
+"conflict with a maintainer upload already in preparation at the time of an "
+"NMU, or even one sitting in the ftp NEW queue. It also has the benefit of "
+"making it visually clear that a package in the archive was not made by the "
+"official maintainer."
+msgstr ""
+
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2015
+msgid ""
+"If you upload a package to testing or stable, you sometimes need to \"fork\" "
+"the version number tree. This is the case for security uploads, for "
+"example. For this, a version of the form <literal>+deb<replaceable>XY</"
+"replaceable>u<replaceable>Z</replaceable></literal> should be used, where "
+"<replaceable>X</replaceable> and <replaceable>Y</replaceable> are the major "
+"and minor release numbers, and <replaceable>Z</replaceable> is a counter "
+"starting at <literal>1</literal>. When the release number is not yet known "
+"(often the case for <literal>testing</literal>, at the beginning of release "
+"cycles), the lowest release number higher than the last stable release "
+"number must be used. For example, while Etch (Debian 4.0) is stable, a "
+"security NMU to stable for a package at version <literal>1.5-3</literal> "
+"would have version <literal>1.5-3+deb40u1</literal>, whereas a security NMU "
+"to Lenny would get version <literal>1.5-3+deb50u1</literal>. After the "
+"release of Lenny, security uploads to the <literal>testing</literal> "
+"distribution will be versioned <literal>+deb51uZ</literal>, until it is "
+"known whether that release will be Debian 5.1 or Debian 6.0 (if that becomes "
+"the case, uploads will be versioned as <literal>+deb60uZ</literal>."
msgstr ""
-# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2018
-msgid ""
-"Maintainers other than the official package maintainer should make as few "
-"changes to the package as possible, and they should always send a patch as a "
-"unified context diff (<literal>diff -u</literal>) detailing their changes to "
-"the Bug Tracking System."
-msgstr ""
-
-# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2024
-msgid ""
-"What if you are simply recompiling the package? If you just need to "
-"recompile it for a single architecture, then you may do a binary-only NMU as "
-"described in <xref linkend=\"binary-only-nmu\"/> which doesn't require any "
-"patch to be sent. If you want the package to be recompiled for all "
-"architectures, then you do a source NMU as usual and you will have to send a "
-"patch."
-msgstr ""
+# type: Content of: <chapter><section><section><title>
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:2037
+#, fuzzy
+msgid "Using the <literal>DELAYED/</literal> queue"
+msgstr "<literal>ftp-master</literal> にアップロードする"
-# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2031
+#
. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2040
msgid ""
-"Bugs fixed by source NMUs used to be tagged fixed instead of closed, but "
-"since version tracking is in place, such bugs are now also closed with the "
-"NMU version."
+"Having to wait for a response after you request permission to NMU is "
+"inefficient, because it costs the NMUer a context switch to come back to the "
+"issue. The <literal>DELAYED</literal> queue (see <xref linkend=\"delayed-"
+"incoming\"/>) allows the developer doing the NMU to perform all the "
+"necessary tasks at the same time. For instance, instead of telling the "
+"maintainer that you will upload the updated package in 7 days, you should "
+"upload the package to <literal>DELAYED/7</literal> and tell the maintainer "
+"that he has 7 days to react. During this time, the maintainer can ask you "
+"to delay the upload some more, or cancel your upload."
msgstr ""
-# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2036
+#
. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2054
msgid ""
-"Also, after doing an NMU, you have to send the information to the existing "
-"bugs that are fixed by your NMU, including the unified diff. Historically, "
-"it was custom to open a new bug and include a patch showing all the changes "
-"you have made. The normal maintainer will either apply the patch or employ "
-"an alternate method of fixing the problem. Sometimes bugs are fixed "
-"independently upstream, which is another good reason to back out an NMU's "
-"patch. If the maintainer decides not to apply the NMU's patch but to "
-"release a new version, the maintainer needs to ensure that the new upstream "
-"version really fixes each problem that was fixed in the non-maintainer "
-"release."
+"The <literal>DELAYED</literal> queue should not be used to put additional "
+"pressure on the maintainer. In particular, it's important that you are "
+"available to cancel or delay the upload before the delay expires since the "
+"maintainer cannot cancel the upload himself."
msgstr ""
-# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2047
+#
. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2061
msgid ""
-"In addition, the normal maintainer should <emphasis>always</emphasis> retain "
-"the entry in the changelog file documenting the non-maintainer upload -- and "
-"of course, also keep the changes. If you revert some of the changes, please "
-"reopen the relevant bug reports."
+"If you make an NMU to <literal>DELAYED</literal> and the maintainer updates "
+"his package before the delay expires, your upload will be rejected because a "
+"newer version is already available in the archive. Ideally, the maintainer "
+"will take care to include your proposed changes (or at least a solution for "
+"the problems they address) in that upload."
msgstr ""
-# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:2055
-msgid "Building source NMUs"
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:2071
+msgid "NMUs from the maintainer's point of view"
msgstr ""
-# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2057
+#
. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2074
msgid ""
-"Source NMU packages are built normally. Pick a distribution using the same "
-"rules as found in <xref linkend=\"distribution\"/> , follow the other "
-"instructions in <xref linkend=\"upload\"/> ."
+"When someone NMUs your package, this means they want to help you to keep it "
+"in good shape. This gives users fixed packages faster. You can consider "
+"asking the NMUer to become a co-maintainer of the package. Receiving an NMU "
+"on a package is not a bad thing; it just means that the package is "
+"interesting enough for other people to work on it."
msgstr ""
-# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2062
+#
. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2083
msgid ""
-"Make sure you do <emphasis>not</emphasis> change the value of the maintainer "
-"in the <filename>debian/control</filename> file. Your name as given in the "
-"NMU entry of the <filename>debian/changelog</filename> file will be used for "
-"signing the changes file."
+"To acknowledge an NMU, include its changes and changelog entry in your next "
+"maintainer upload. If you do not acknowledge the NMU by including the NMU "
+"changelog entry in your changelog, the bugs will remain closed in the BTS "
+"but will be listed as affecting your maintainer version of the package."
msgstr ""
-# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:2070
-msgid "Acknowledging an NMU"
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:2092
+msgid "Source NMUs vs Binary-only NMUs (binNMUs)"
msgstr ""
-# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2072
+#
. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2095
msgid ""
-"If one of your packages has been NMU'ed, you have to incorporate the changes "
-"in your copy of the sources. This is easy, you just have to apply the patch "
-"that has been sent to you. Once this is done, you have to close the bugs "
-"that have been tagged fixed by the NMU. The easiest way is to use the "
-"<literal>-v</literal> option of <command>dpkg-buildpackage</command>, as "
-"this allows you to include just all changes since your last maintainer "
-"upload. Alternatively, you can close them manually by sending the required "
-"mails to the BTS or by adding the required <literal>closes: #nnnn</literal> "
-"in the changelog entry of your next upload."
+"The full name of an NMU is <emphasis>source NMU</emphasis>. There is also "
+"another type, namely the <emphasis>binary-only NMU</emphasis>, or "
+"<emphasis>binNMU</emphasis>. A binNMU is also a package upload by someone "
+"other than the package's maintainer. However, it is a binary-only upload."
msgstr ""
-# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2083
+#
. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2102
msgid ""
-"In any case, you should not be upset by the NMU. An NMU is not a personal "
-"attack against the maintainer. It is a proof that someone cares enough "
-"about the package that they were willing to help you in your work, so you "
-"should be thankful. You may also want to ask them if they would be "
-"interested in helping you on a more frequent basis as co-maintainer or "
-"backup maintainer (see <xref linkend=\"collaborative-maint\"/> )."
-msgstr ""
-
-# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:2093
-msgid "NMU vs QA uploads"
+"When a library (or other dependency) is updated, the packages using it may "
+"need to be rebuilt. Since no changes to the source are needed, the same "
+"source package is used."
msgstr ""
-# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2095
+#
. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2108
msgid ""
-"Unless you know the maintainer is still active, it is wise to check the "
-"package to see if it has been orphaned. The current list of orphaned "
-"packages which haven't had their maintainer set correctly is available at "
-"<ulink url=\"&url-debian-qa-orphaned;\"></ulink>. If you perform an NMU on "
-"an improperly orphaned package, please set the maintainer to <literal>Debian "
-"QA Group <packages@qa.debian.org></literal>."
+"BinNMUs are usually triggered on the buildds by wanna-build. An entry is "
+"added to debian/changelog, explaining why the upload was needed and "
+"increasing the version number as described in <xref linkend=\"binary-only-nmu"
+"\"/>. This entry should not be included in the next upload."
msgstr ""
-# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:2105
-msgid "Who can do an NMU"
-msgstr "誰が NMU 可能なのか"
-
-# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2107
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2116
msgid ""
-"Only official, registered Debian Developers can do binary or source NMUs. A "
-"Debian Developer is someone who has their key in the Debian key ring. Non-"
-"developers, however, are encouraged to download the source package and start "
-"hacking on it to fix problems; however, rather than doing an NMU, they "
-"should just submit worthwhile patches to the Bug Tracking System. "
-"Maintainers almost always appreciate quality patches and bug reports."
+"Buildds upload packages for their architecture to the archive as binary-only "
+"uploads. Strictly speaking, these are binNMUs. However, they are not "
+"normally called NMU, and they don't add an entry to debian/changelog."
msgstr ""
-# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:2117
-msgid "Terminology"
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:2124
+msgid "NMUs vs QA uploads"
msgstr ""
-# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2119
+#
. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2127
msgid ""
-"There are two new terms used throughout this section: ``binary-only NMU'' "
-"and ``source NMU''. These terms are used with specific technical meaning "
-"throughout this document. Both binary-only and source NMUs are similar, "
-"since they involve an upload of a package by a developer who is not the "
-"official maintainer of that package. That is why it's a <literal>non-"
-"maintainer</literal> upload."
+"NMUs are uploads of packages by somebody else than their assigned "
+"maintainer. There is another type of upload where the uploaded package is "
+"not yours: QA uploads. QA uploads are uploads of orphaned packages."
msgstr ""
-# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2127
+#
. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2134
msgid ""
-"A source NMU is an upload of a package by a developer who is not the "
-"official maintainer, for the purposes of fixing a bug in the package. "
-"Source NMUs always involves changes to the source (even if it is just a "
-"change to <filename>debian/changelog</filename>). This can be either a "
-"change to the upstream source, or a change to the Debian bits of the "
-"source. Note, however, that source NMUs may also include architecture-"
-"dependent packages, as well as an updated Debian diff."
+"QA uploads are very much like normal maintainer uploads: they may fix "
+"anything, even minor issues; the version numbering is normal, and there is "
+"no need to use a delayed upload. The difference is that you are not listed "
+"as the Maintainer or Uploader for the package. Also, the changelog entry of "
+"a QA upload has a special first line:"
msgstr ""
-# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2136
-msgid ""
-"A binary-only NMU is a recompilation and upload of a binary package for a "
-"given architecture. As such, it is usually part of a porting effort. A "
-"binary-only NMU is a non-maintainer uploaded binary version of a package, "
-"with no source changes required. There are many cases where porters must "
-"fix problems in the source in order to get them to compile for their target "
-"architecture; that would be considered a source NMU rather than a binary-"
-"only NMU. As you can see, we don't distinguish in terminology between "
-"porter NMUs and non-porter NMUs."
+#. type: Content of: <chapter><section><section><screen>
+#: pkgs.dbk:2142
+#, no-wrap
+msgid " * QA upload.\n"
msgstr ""
-# type: Content of: <chapter><section><section><para>
+#
. type: Content of: <chapter><section><section><para>
#: pkgs.dbk:2146
msgid ""
-"Both classes of NMUs, source and binary-only, can be lumped under the term "
-"``NMU''. However, this often leads to confusion, since most people think "
-"``source NMU'' when they think ``NMU''. So it's best to be careful: always "
-"use ``binary NMU'' or ``binNMU'' for binary-only NMUs."
+"If you want to do an NMU, and it seems that the maintainer is not active, it "
+"is wise to check if the package is orphaned (this information is displayed "
+"on the package's Package Tracking System page). When doing the first QA "
+"upload to an orphaned package, the maintainer should be set to "
+"<literal>Debian QA Group <packages@qa.debian.org></literal>. Orphaned "
+"packages which did not yet have a QA upload still have their old maintainer "
+"set. There is a list of them at <ulink url=\"&url-orphaned-not-qa;\"/>."
+msgstr ""
+
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2157
+msgid ""
+"Instead of doing a QA upload, you can also consider adopting the package by "
+"making yourself the maintainer. You don't need permission from anybody to "
+"adopt an orphaned package, you can just set yourself as maintainer and "
+"upload the new version (see <xref linkend=\"adopting\"/>)."
msgstr ""
# type: Content of: <chapter><section><title>
-#: pkgs.dbk:2156
+#. type: Content of: <chapter><section><title>
+#: pkgs.dbk:2168
msgid "Collaborative maintenance"
msgstr "共同メンテナンス"
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:2158
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:2170
msgid ""
"Collaborative maintenance is a term describing the sharing of Debian package "
"maintenance duties by several people. This collaboration is almost always a "
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:2166
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:2178
msgid ""
"Generally there is a primary maintainer and one or more co-maintainers. The "
"primary maintainer is the person whose name is listed in the "
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:2174
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:2186
msgid ""
"In its most basic form, the process of adding a new co-maintainer is quite "
"easy:"
msgstr ""
# type: Content of: <chapter><section><itemizedlist><listitem><para>
-#: pkgs.dbk:2180
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
+#: pkgs.dbk:2192
msgid ""
"Setup the co-maintainer with access to the sources you build the package "
"from. Generally this implies you are using a network-capable version "
msgstr ""
# type: Content of: <chapter><section><itemizedlist><listitem><para>
-#: pkgs.dbk:2188
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
+#: pkgs.dbk:2200
msgid ""
"Add the co-maintainer's correct maintainer name and address to the "
"<literal>Uploaders</literal> field in the first paragraph of the "
msgstr ""
# type: Content of: <chapter><section><itemizedlist><listitem><screen>
-#: pkgs.dbk:2192
+#. type: Content of: <chapter><section><itemizedlist><listitem><screen>
+#: pkgs.dbk:2205
#, fuzzy, no-wrap
-msgid ""
-"\n"
-"Uploaders: John Buzz <jbuzz@debian.org>, Adam Rex <arex@debian.org>\n"
+msgid "Uploaders: John Buzz <jbuzz@debian.org>, Adam Rex <arex@debian.org>\n"
msgstr "Uploaders: John Buzz <jbuzz@debian.org>, Adam Rex <arex@debian.org>"
# type: Content of: <chapter><section><itemizedlist><listitem><para>
-#: pkgs.dbk:2198
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
+#: pkgs.dbk:2210
msgid ""
"Using the PTS (<xref linkend=\"pkg-tracking-system\"/> ), the co-maintainers "
"should subscribe themselves to the appropriate source package."
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:2204
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:2216
msgid ""
"Another form of collaborative maintenance is team maintenance, which is "
"recommended if you maintain several packages with the same group of "
msgstr ""
# type: Content of: <chapter><section><orderedlist><listitem><para>
-#: pkgs.dbk:2213
+#. type: Content of: <chapter><section><orderedlist><listitem><para>
+#: pkgs.dbk:2225
msgid ""
"Put the team member mainly responsible for the package in the Maintainer "
"field. In the Uploaders, put the mailing list address, and the team members "
msgstr ""
# type: Content of: <chapter><section><orderedlist><listitem><para>
-#: pkgs.dbk:2220
+#. type: Content of: <chapter><section><orderedlist><listitem><para>
+#: pkgs.dbk:2232
msgid ""
"Put the mailing list address in the Maintainer field. In the Uploaders "
"field, put the team members who care for the package. In this case, you "
msgstr ""
# type: Content of: <chapter><section><para>
-#: pkgs.dbk:2228
+#. type: Content of: <chapter><section><para>
+#: pkgs.dbk:2240
msgid ""
"In any case, it is a bad idea to automatically put all team members in the "
"Uploaders field. It clutters the Developer's Package Overview listing (see "
msgstr ""
# type: Content of: <chapter><section><title>
-#: pkgs.dbk:2236
+#. type: Content of: <chapter><section><title>
+#: pkgs.dbk:2248
msgid "The testing distribution"
msgstr "テスト版ディストリビューション"
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:2238
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:2250
msgid "Basics"
msgstr "基本"
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2240
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2252
msgid ""
"Packages are usually installed into the <literal>testing</literal> "
"distribution after they have undergone some degree of <literal>testing</"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2245
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2257
msgid ""
"They must be in sync on all architectures and mustn't have dependencies that "
"make them uninstallable; they also have to have generally no known release-"
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:2254
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:2266
msgid "Updates from unstable"
msgstr "不安定版からの更新"
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2256
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2268
msgid ""
"The scripts that update the <literal>testing</literal> distribution are run "
"twice each day, right after the installation of the updated packages; these "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2264
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2276
msgid ""
"The inclusion of a package from <literal>unstable</literal> is conditional "
"on the following:"
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:2270
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:2282
msgid ""
"The package must have been available in <literal>unstable</literal> for 2, 5 "
"or 10 days, depending on the urgency (high, medium or low). Please note "
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:2280
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:2292
msgid ""
"It must not have new release-critical bugs (RC bugs affecting the version "
"available in <literal>unstable</literal>, but not affecting the version in "
"<literal>testing</literal>);"
msgstr ""
-# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:2287
+#
. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:2299
msgid ""
"It must be available on all architectures on which it has previously been "
-"built in <literal>unstable</literal>. <xref linkend=\"dak ls\"/> may be of "
+"built in <literal>unstable</literal>. <xref linkend=\"dak-ls\"/> may be of "
"interest to check that information;"
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:2294
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:2306
msgid ""
"It must not break any dependency of a package which is already available in "
"<literal>testing</literal>;"
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:2300
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:2312
msgid ""
"The packages on which it depends must either be available in "
"<literal>testing</literal> or they must be accepted into <literal>testing</"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2308
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2320
msgid ""
"To find out whether a package is progressing into <literal>testing</literal> "
"or not, see the <literal>testing</literal> script output on the <ulink url="
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2319
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2331
msgid ""
"The <filename>update_excuses</filename> file does not always give the "
"precise reason why the package is refused; you may have to find it on your "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2326
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2338
msgid ""
"Sometimes, some packages never enter <literal>testing</literal> because the "
"set of inter-relationship is too complicated and cannot be sorted out by the "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2331
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2343
msgid ""
"Some further dependency analysis is shown on <ulink url=\"http://release."
"debian.org/migration/\"></ulink> — but be warned, this page also shows build "
msgstr ""
# type: Content of: <chapter><section><section><section><title>
-#: pkgs.dbk:2336
+#. type: Content of: <chapter><section><section><section><title>
+#: pkgs.dbk:2348
msgid "out-of-date"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
#. FIXME: better rename this file than document rampant professionalism?
-#: pkgs.dbk:2339
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2351
msgid ""
"For the <literal>testing</literal> migration script, outdated means: There "
"are different versions in <literal>unstable</literal> for the release "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2347
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2359
msgid "Consider this example:"
msgstr ""
# type: Content of: <chapter><section><section><section><informaltable><tgroup><thead><row><entry>
-#: pkgs.dbk:2354 pkgs.dbk:2387
+#. type: Content of: <chapter><section><section><section><informaltable><tgroup><thead><row><entry>
+#: pkgs.dbk:2366 pkgs.dbk:2399
msgid "alpha"
msgstr "alpha"
# type: Content of: <chapter><section><section><section><informaltable><tgroup><thead><row><entry>
-#: pkgs.dbk:2355 pkgs.dbk:2388
+#. type: Content of: <chapter><section><section><section><informaltable><tgroup><thead><row><entry>
+#: pkgs.dbk:2367 pkgs.dbk:2400
msgid "arm"
msgstr "arm"
# type: Content of: <chapter><section><section><section><informaltable><tgroup><thead><row><entry>
-#: pkgs.dbk:2360 pkgs.dbk:2394 pkgs.dbk:2456
+#. type: Content of: <chapter><section><section><section><informaltable><tgroup><thead><row><entry>
+#: pkgs.dbk:2372 pkgs.dbk:2406 pkgs.dbk:2468
msgid "testing"
msgstr "テスト版"
# type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
-#: pkgs.dbk:2361 pkgs.dbk:2366 pkgs.dbk:2395 pkgs.dbk:2396 pkgs.dbk:2403
+#. type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
+#: pkgs.dbk:2373 pkgs.dbk:2378 pkgs.dbk:2407 pkgs.dbk:2408 pkgs.dbk:2415
msgid "1"
msgstr "1"
# type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
-#: pkgs.dbk:2362 pkgs.dbk:2397 pkgs.dbk:2402
+#. type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
+#: pkgs.dbk:2374 pkgs.dbk:2409 pkgs.dbk:2414
msgid "-"
msgstr "-"
# type: Content of: <chapter><section><section><section><informaltable><tgroup><thead><row><entry>
-#: pkgs.dbk:2365 pkgs.dbk:2400 pkgs.dbk:2457
+#. type: Content of: <chapter><section><section><section><informaltable><tgroup><thead><row><entry>
+#: pkgs.dbk:2377 pkgs.dbk:2412 pkgs.dbk:2469
msgid "unstable"
msgstr "不安定版"
# type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
-#: pkgs.dbk:2367 pkgs.dbk:2401
+#. type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
+#: pkgs.dbk:2379 pkgs.dbk:2413
msgid "2"
msgstr "2"
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2373
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2385
msgid ""
"The package is out of date on alpha in <literal>unstable</literal>, and will "
"not go to <literal>testing</literal>. Removing the package would not help at "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2379
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2391
msgid ""
"However, if ftp-master removes a package in <literal>unstable</literal> "
"(here on <literal>arm</literal>):"
msgstr ""
# type: Content of: <chapter><section><section><section><informaltable><tgroup><thead><row><entry>
-#: pkgs.dbk:2389
+#. type: Content of: <chapter><section><section><section><informaltable><tgroup><thead><row><entry>
+#: pkgs.dbk:2401
msgid "hurd-i386"
msgstr "hurd-i386"
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2409
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2421
msgid ""
"In this case, the package is up to date on all release architectures in "
"<literal>unstable</literal> (and the extra <literal>hurd-i386</literal> "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2414
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2426
msgid ""
"Sometimes, the question is raised if it is possible to allow packages in "
"that are not yet built on all architectures: No. Just plainly no. (Except "
msgstr ""
# type: Content of: <chapter><section><section><section><title>
-#: pkgs.dbk:2421
+#. type: Content of: <chapter><section><section><section><title>
+#: pkgs.dbk:2433
msgid "Removals from testing"
msgstr "テスト版からの削除"
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2423
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2435
msgid ""
"Sometimes, a package is removed to allow another package in: This happens "
"only to allow <emphasis>another</emphasis> package to go in if it's ready in "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2430
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2442
msgid ""
"Of course, there is another reason to remove a package from <literal>testing "
"</literal>: It's just too buggy (and having a single RC-bug is enough to be "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2435
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2447
msgid ""
"Furthermore, if a package has been removed from <literal>unstable</literal>, "
"and no package in <literal>testing</literal> depends on it any more, then it "
msgstr ""
# type: Content of: <chapter><section><section><section><title>
-#: pkgs.dbk:2442
+#. type: Content of: <chapter><section><section><section><title>
+#: pkgs.dbk:2454
msgid "circular dependencies"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2444
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2456
msgid ""
"A situation which is not handled very well by britney is if package "
"<literal>a</literal> depends on the new version of package <literal>b</"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2449
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2461
msgid "An example of this is:"
msgstr ""
# type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
-#: pkgs.dbk:2462
+#. type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
+#: pkgs.dbk:2474
msgid "a"
msgstr "a"
# type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
-#: pkgs.dbk:2463
+#. type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
+#: pkgs.dbk:2475
msgid "1; depends: b=1"
msgstr "1; depends: b=1"
# type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
-#: pkgs.dbk:2464
+#. type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
+#: pkgs.dbk:2476
msgid "2; depends: b=2"
msgstr "2; depends: b=2"
# type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
-#: pkgs.dbk:2467
+#. type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
+#: pkgs.dbk:2479
msgid "b"
msgstr "b"
# type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
-#: pkgs.dbk:2468
+#. type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
+#: pkgs.dbk:2480
msgid "1; depends: a=1"
msgstr "1; depends: a=1"
# type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
-#: pkgs.dbk:2469
+#. type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
+#: pkgs.dbk:2481
msgid "2; depends: a=2"
msgstr "2; depends: a=2"
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2475
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2487
msgid ""
"Neither package <literal>a</literal> nor package <literal>b</literal> is "
"considered for update."
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2479
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2491
msgid ""
"Currently, this requires some manual hinting from the release team. Please "
"contact them by sending mail to &email-debian-release; if this happens to "
msgstr ""
# type: Content of: <chapter><section><section><section><title>
-#: pkgs.dbk:2486
+#. type: Content of: <chapter><section><section><section><title>
+#: pkgs.dbk:2498
msgid "influence of package in testing"
msgstr "テスト版パッケージへの影響"
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2488
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2500
msgid ""
"Generally, there is nothing that the status of a package in <literal>testing "
"</literal> means for transition of the next version from <literal>unstable </"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2500
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2512
msgid ""
"In summary this means: The only influence that a package being in <literal> "
"testing</literal> has on a new version of the same package is that the new "
msgstr ""
# type: Content of: <chapter><section><section><section><title>
-#: pkgs.dbk:2507
+#. type: Content of: <chapter><section><section><section><title>
+#: pkgs.dbk:2519
msgid "details"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2509
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2521
msgid "If you are interested in details, this is how britney works:"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2512
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2524
msgid ""
"The packages are looked at to determine whether they are valid candidates. "
"This gives the update excuses. The most common reasons why a package is not "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2521
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2533
msgid ""
"Now, the more complex part happens: Britney tries to update <literal>testing "
"</literal> with the valid candidates. For that, britney tries to add each "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2531
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2543
msgid ""
"If you want to see more details, you can look it up on <filename>merkel:/org/"
"&ftp-debian-org;/testing/update_out/</filename> (or in <filename>merkel:~aba/"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2538
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2550
msgid ""
"The hints are available via <ulink url=\"http://&ftp-master-host;/testing/"
"hints/\"></ulink>."
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:2546
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:2558
msgid "Direct updates to testing"
msgstr "直接テスト版を更新する"
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2548
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2560
msgid ""
"The <literal>testing</literal> distribution is fed with packages from "
"<literal>unstable</literal> according to the rules explained above. "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2555
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2567
msgid ""
"Keep in mind that packages uploaded there are not automatically processed, "
"they have to go through the hands of the release manager. So you'd better "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2562
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2574
msgid ""
"You should not upload to <literal>testing-proposed-updates</literal> when "
"you can update your packages through <literal>unstable</literal>. If you "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2571
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2583
msgid ""
"Version numbers are usually selected by adding the codename of the "
"<literal>testing</literal> distribution and a running number, like "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: pkgs.dbk:2578
+#. type: Content of: <chapter><section><section><para>
+#: pkgs.dbk:2590
msgid "Please make sure you didn't miss any of these items in your upload:"
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:2583
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:2595
msgid ""
"Make sure that your package really needs to go through <literal>testing-"
"proposed-updates</literal>, and can't go through <literal> unstable</"
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:2590
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:2602
msgid "Make sure that you included only the minimal amount of changes;"
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:2595
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:2607
msgid ""
"Make sure that you included an appropriate explanation in the changelog;"
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:2600
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:2612
msgid ""
"Make sure that you've written <literal>testing</literal> or <literal>testing-"
"proposed-updates</literal> into your target distribution;"
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:2606
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:2618
msgid ""
"Make sure that you've built and tested your package in <literal>testing</"
"literal>, not in <literal>unstable</literal>;"
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:2612
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:2624
msgid ""
"Make sure that your version number is higher than the version in "
"<literal>testing</literal> and <literal>testing-proposed-updates</literal>, "
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: pkgs.dbk:2619
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: pkgs.dbk:2631
msgid ""
"After uploading and successful build on all platforms, contact the release "
"team at &email-debian-release; and ask them to approve your upload."
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: pkgs.dbk:2627
+#. type: Content of: <chapter><section><section><title>
+#: pkgs.dbk:2639
msgid "Frequently asked questions"
msgstr ""
# type: Content of: <chapter><section><section><section><title>
-#: pkgs.dbk:2629
+#. type: Content of: <chapter><section><section><section><title>
+#: pkgs.dbk:2641
msgid "What are release-critical bugs, and how do they get counted?"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2631
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2643
msgid ""
"All bugs of some higher severities are by default considered release-"
"critical; currently, these are <literal>critical</literal>, <literal>grave</"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2636
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2648
msgid ""
"Such bugs are presumed to have an impact on the chances that the package "
"will be released with the <literal>stable</literal> release of Debian: in "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2643
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2655
msgid ""
"The <literal>unstable</literal> bug count are all release-critical bugs "
"which are marked to apply to <replaceable>package</replaceable>/"
msgstr ""
# type: Content of: <chapter><section><section><section><title>
-#: pkgs.dbk:2651
+#. type: Content of: <chapter><section><section><section><title>
+#: pkgs.dbk:2663
msgid ""
"How could installing a package into <literal>testing</literal> possibly "
"break other packages?"
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2654
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2666
msgid ""
"The structure of the distribution archives is such that they can only "
"contain one version of a package; a package is defined by its name. So when "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2662
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2674
msgid ""
"However, the old version may have provided a binary package with an old "
"soname of a library, such as <literal>libacme-foo0</literal>. Removing the "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2668
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2680
msgid ""
"Evidently, this mainly affects packages which provide changing sets of "
"binary packages in different versions (in turn, mainly libraries). However, "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2674
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2686
msgid ""
"When the set of binary packages provided by a source package change in this "
"way, all the packages that depended on the old binaries will have to be "
msgstr ""
# type: Content of: <chapter><section><section><section><para>
-#: pkgs.dbk:2685
+#. type: Content of: <chapter><section><section><section><para>
+#: pkgs.dbk:2697
msgid ""
"If you are having problems with complicated groups of packages like this, "
"contact &email-debian-devel; or &email-debian-release; for help."
msgstr ""
+
+# type: Content of: <chapter><section><section><screen>
+#, fuzzy
+#~ msgid ""
+#~ "\n"
+#~ "[tfheen_delayed]\n"
+#~ "method = scp\n"
+#~ "fqdn = gluck.debian.org\n"
+#~ "incoming = ~tfheen\n"
+#~ msgstr ""
+#~ "[tfheen_delayed]\n"
+#~ "method = scp\n"
+#~ "fqdn = gluck.debian.org\n"
+#~ "incoming = ~tfheen"
+
+# type: Content of: <chapter><section><section><title>
+#~ msgid "How to do a NMU"
+#~ msgstr "NMU のやり方"
msgid ""
msgstr ""
"Project-Id-Version: developers-reference 3.4.0\n"
-"POT-Creation-Date: 2008-06-14 23:00+0900\n"
+"POT-Creation-Date: 2009-06-25 22:01+0300\n"
"PO-Revision-Date: 2008-07-04 04:27+0900\n"
"Last-Translator: Hideki Yamane (Debian-JP) <henrich@debian.or.jp>\n"
"Language-Team: Debian JP Project <debian-doc@debian.or.jp>\n"
"Content-Transfer-Encoding: 8bit\n"
# type: Content of: <chapter><title>
+#. type: Content of: <chapter><title>
#: resources.dbk:7
msgid "Resources for Debian Developers"
msgstr "Debian 開発者が利用可能なリソース"
# type: Content of: <chapter><para>
+#. type: Content of: <chapter><para>
#: resources.dbk:9
msgid ""
"In this chapter you will find a very brief road map of the Debian mailing "
"の利用可能なリソースを確認します。"
# type: Content of: <chapter><section><title>
+#. type: Content of: <chapter><section><title>
#: resources.dbk:14
msgid "Mailing lists"
msgstr "メーリングリスト"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:16
msgid ""
"Much of the conversation between Debian developers (and users) is managed "
"は <ulink url=\"&url-debian-lists;\"></ulink> を参照してください。"
# type: Content of: <chapter><section><section><title>
+#. type: Content of: <chapter><section><section><title>
#: resources.dbk:27
msgid "Basic rules for use"
msgstr "利用の基本ルール"
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:29
msgid ""
"When replying to messages on the mailing list, please do not send a carbon "
"ングリストに投稿する人は必ず返信を見ているはずです。"
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:35
msgid ""
"Cross-posting (sending the same message to multiple lists) is discouraged. "
"るメッセージについては、通常の慣習をしっかりと守ってください。"
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:40
msgid ""
"Please read the <ulink url=\"&url-debian-lists;#codeofconduct\">code of "
"ライン</ulink>も読むと良いでしょう。"
# type: Content of: <chapter><section><section><title>
+#. type: Content of: <chapter><section><section><title>
#: resources.dbk:48
msgid "Core development mailing lists"
msgstr "開発の中心となっているメーリングリスト"
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:50
msgid "The core Debian mailing lists that developers should use are:"
msgstr "開発者が利用すべき Debian の中核メーリングリスト:"
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
#: resources.dbk:55
msgid ""
"&email-debian-devel-announce;, used to announce important things to "
"発者がこのメーリングリストを購読する事が望まれます。"
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
#: resources.dbk:62
msgid ""
"&email-debian-devel;, used to discuss various development related technical "
msgstr "&email-debian-devel; は様々な技術関連の事柄を話し合うのに使われます。"
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
#: resources.dbk:68
msgid ""
"&email-debian-policy;, where the Debian Policy is discussed and voted on."
"行うのに使われます。"
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
#: resources.dbk:74
msgid ""
"&email-debian-project;, used to discuss various non-technical issues related "
"のに使われます。"
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:80
msgid ""
"There are other mailing lists available for a variety of special topics; see "
"<ulink url=\"http://&lists-host;/\"></ulink> を参照してください。"
# type: Content of: <chapter><section><section><title>
+#. type: Content of: <chapter><section><section><title>
#: resources.dbk:86
msgid "Special lists"
msgstr "特別なメーリングリスト"
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:88
msgid ""
"&email-debian-private; is a special mailing list for private discussions "
"</filename> ディレクトリを参照することで確認できます。"
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:100
msgid ""
"&email-debian-email; is a special mailing list used as a grab-bag for Debian "
"袋」として使われています。"
# type: Content of: <chapter><section><section><title>
+#. type: Content of: <chapter><section><section><title>
#: resources.dbk:108
msgid "Requesting new development-related lists"
msgstr "新規に開発関連のメーリングリストの開設を要求する"
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:110
msgid ""
"Before requesting a mailing list that relates to the development of a "
"るメーリングリストを使いましょう。"
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:118
msgid ""
"If you decide that a regular mailing list on &lists-host; is really what you "
"ストを埋めてください。"
# type: Content of: <chapter><section><title>
+#. type: Content of: <chapter><section><title>
#: resources.dbk:127
msgid "IRC channels"
msgstr "IRC チャンネル"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:129
msgid ""
"Several IRC channels are dedicated to Debian's development. They are mainly "
"す。"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:135
msgid ""
"The main channel for Debian in general is <literal>#debian</literal>. This "
"literal>, <literal>#debian-br</literal> and other similarly named channels "
"for speakers of other languages."
msgstr ""
-"Debian 用のメインのチャンネルは一般的にいって <literal>#debian</literal> に"
-"ã\81ªã\82\8aã\81¾ã\81\99ã\80\82ã\81\93ã\82\8cã\81¯å·¨å¤§ã\81ªã\80\81å¤\9aç\9b®ç\9a\84ã\81®ã\83\81ã\83£ã\83³ã\83\8dã\83«ã\81§ã\80\81ã\83¦ã\83¼ã\82¶ã\81\8cã\83\88ã\83\94ã\83\83ã\82¯ã\82\84ã\83\9cã\83\83ã\83\88ã\81«ã\82\88ã\81£ã\81¦æ\8f\90ä¾\9b"
-"される最近のニュースを見つけることができる場所です。<literal>#debian</"
-"literal> は英語を話す人たち用のもので、他の言語を話す人達のために同様なもの"
-"ã\81«ã\81¯ <literal>#debian.de</literal>ã\80\81<literal>#debian-fr</literal>ã\80\81"
+"Debian 用のメインのチャンネルは一般的にいって <literal>#debian</literal> にな"
+"ã\82\8aã\81¾ã\81\99ã\80\82ã\81\93ã\82\8cã\81¯å·¨å¤§ã\81ªã\80\81å¤\9aç\9b®ç\9a\84ã\81®ã\83\81ã\83£ã\83³ã\83\8dã\83«ã\81§ã\80\81ã\83¦ã\83¼ã\82¶ã\81\8cã\83\88ã\83\94ã\83\83ã\82¯ã\82\84ã\83\9cã\83\83ã\83\88ã\81«ã\82\88ã\81£ã\81¦"
+"提供される最近のニュースを見つけることができる場所です。<literal>#debian</"
+"literal> は英語を話す人たち用のもので、他の言語を話す人達のために同様なものに"
+"は <literal>#debian.de</literal>、<literal>#debian-fr</literal>、"
"<literal>#debian-br</literal> など他にも似通った名前のチャンネルがあります。"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:143
msgid ""
"The main channel for Debian development is <literal>#debian-devel</"
"however open to anyone who wants to lurk (and learn). Its topic is commonly "
"full of interesting information for developers."
msgstr ""
-"Debian 開発での中心のチャンネルは <literal>#debian-devel</literal> です。こ"
-"ã\82\8cã\81¯ã\81¨ã\81¦ã\82\82ã\82¢ã\82¯ã\83\86ã\82£ã\83\96ã\81ªã\83\81ã\83£ã\83³ã\83\8dã\83«ã\81§ã\80\81大æ\8aµ 150 人以ä¸\8aã\81\8c常ã\81«ã\83ã\82°ã\82¤ã\83³ã\81\97ã\81¦ã\81\84ã\81¾ã\81\99ã\80\82"
-"ã\81\93ã\81®ã\83\81ã\83£ã\83³ã\83\8dã\83«ã\81¯ Debian ã\81§ä½\9cæ¥ã\81\99ã\82\8b人é\81\94ã\81®ã\81\9fã\82\81ã\81®ã\83\81ã\83£ã\83³ã\83\8dã\83«ã\81§ã\81\82ã\81£ã\81¦ã\80\81ã\82µã\83\9dã\83¼ã\83\88ç\94¨"
-"ã\81®ã\83\81ã\83£ã\83³ã\83\8dã\83«ã\81§ã\81¯ã\81\82ã\82\8aã\81¾ã\81\9bã\82\93 (ã\81\9dã\81®ã\81\9fã\82\81ã\81«ã\81¯ <literal>#debian</literal> ã\81\8cã\81\82ã\82\8a"
-"ã\81¾ã\81\99)ã\80\82ã\81\93ã\81®ã\83\81ã\83£ã\83³ã\83\8dã\83«ã\81¯ã\80\81ã\81\93ã\81£ã\81\9dã\82\8aè¦\97ã\81\84ã\81¦ã\81¿ã\81\9fã\81\84 (ã\81\9dã\81\97ã\81¦å¦ã\81³ã\81\9fã\81\84) 人ã\81«å¯¾ã\81\97ã\81¦ã\82\82"
-"ã\82ªã\83¼ã\83\97ã\83³ã\81§ã\82\82ã\81\82ã\82\8aã\81¾ã\81\99ã\80\82ã\81\93ã\81®ã\83\81ã\83£ã\83³ã\83\8dã\83«ã\81®ã\83\88ã\83\94ã\83\83ã\82¯ã\81¯ã\80\81é\96\8bç\99ºè\80\85ã\81«ã\81¨ã\81£ã\81¦è\88\88å\91³æ·±ã\81\84æ\83\85å ±"
-"に大概溢れています。"
+"Debian 開発での中心のチャンネルは <literal>#debian-devel</literal> です。これ"
+"ã\81¯ã\81¨ã\81¦ã\82\82ã\82¢ã\82¯ã\83\86ã\82£ã\83\96ã\81ªã\83\81ã\83£ã\83³ã\83\8dã\83«ã\81§ã\80\81大æ\8aµ 150 人以ä¸\8aã\81\8c常ã\81«ã\83ã\82°ã\82¤ã\83³ã\81\97ã\81¦ã\81\84ã\81¾ã\81\99ã\80\82ã\81\93"
+"ã\81®ã\83\81ã\83£ã\83³ã\83\8dã\83«ã\81¯ Debian ã\81§ä½\9cæ¥ã\81\99ã\82\8b人é\81\94ã\81®ã\81\9fã\82\81ã\81®ã\83\81ã\83£ã\83³ã\83\8dã\83«ã\81§ã\81\82ã\81£ã\81¦ã\80\81ã\82µã\83\9dã\83¼ã\83\88ç\94¨ã\81®"
+"ã\83\81ã\83£ã\83³ã\83\8dã\83«ã\81§ã\81¯ã\81\82ã\82\8aã\81¾ã\81\9bã\82\93 (ã\81\9dã\81®ã\81\9fã\82\81ã\81«ã\81¯ <literal>#debian</literal> ã\81\8cã\81\82ã\82\8aã\81¾"
+"ã\81\99)ã\80\82ã\81\93ã\81®ã\83\81ã\83£ã\83³ã\83\8dã\83«ã\81¯ã\80\81ã\81\93ã\81£ã\81\9dã\82\8aè¦\97ã\81\84ã\81¦ã\81¿ã\81\9fã\81\84 (ã\81\9dã\81\97ã\81¦å¦ã\81³ã\81\9fã\81\84) 人ã\81«å¯¾ã\81\97ã\81¦ã\82\82ã\82ªã\83¼"
+"ã\83\97ã\83³ã\81§ã\82\82ã\81\82ã\82\8aã\81¾ã\81\99ã\80\82ã\81\93ã\81®ã\83\81ã\83£ã\83³ã\83\8dã\83«ã\81®ã\83\88ã\83\94ã\83\83ã\82¯ã\81¯ã\80\81é\96\8bç\99ºè\80\85ã\81«ã\81¨ã\81£ã\81¦è\88\88å\91³æ·±ã\81\84æ\83\85å ±ã\81«å¤§"
+"概溢れています。"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:151
msgid ""
"Since <literal>#debian-devel</literal> is an open channel, you should not "
msgstr ""
"<literal>#debian-devel</literal> は公開チャンネルなので、&email-debian-"
"private; で話されている話題について触れるべきではありません。この目的の為に"
-"は、<literal>#debian-private</literal> という鍵で守られた他のチャンネルがあ"
-"ã\82\8aã\81¾ã\81\99ã\80\82ã\81\93ã\81®é\8dµã\81¯ <filename>master.debian.org:&file-debian-private-archive;</"
+"は、<literal>#debian-private</literal> という鍵で守られた他のチャンネルがあり"
+"ます。この鍵は <filename>master.debian.org:&file-debian-private-archive;</"
"filename> の debian-private のアーカイブ中にあります。全ファイルで "
-"<literal>#debian-private</literal> を <command>zgrep</command> してくださ"
-"い。"
+"<literal>#debian-private</literal> を <command>zgrep</command> してください。"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:161
msgid ""
"There are other additional channels dedicated to specific subjects. "
"<literal>#debian-jr</literal>, <literal>#debian-edu</literal>, "
"<literal>#debian-oo</literal> (OpenOffice package) ..."
msgstr ""
-"他にも、特定の話題について専用のチャンネルがあります。<literal>#debian-"
-"bugs</literal> は、バグ潰しパーティ (BSP) を開催するために使われます。"
-"<literal>#debian-boot</literal> は、debian-installer の作業を調整するのに利"
-"用されています。<literal>#debian-doc</literal> は、今あなたが読んでいるよう"
-"な文章のドキュメント化について話すために時折使われています。アーキテクチャや"
-"ã\83\91ã\83\83ã\82±ã\83¼ã\82¸ç¾¤ã\81«ã\81¤ã\81\84ã\81¦è©±ã\81\99ã\81\9fã\82\81ã\80\81ä»\96ã\81«ã\82\82å°\82ç\94¨ã\83\81ã\83£ã\83³ã\83\8dã\83«ã\81\8cã\81\82ã\82\8aã\81¾ã\81\99ï¼\9a"
-"<literal>#debian-kde</literal>、<literal>#debian-dpkg</literal>、"
-"<literal>#debian-jr</literal>、<literal>#debian-edu</literal>、"
-"<literal>#debian-oo</literal> (OpenOffice パッケージ) など…"
+"他にも、特定の話題について専用のチャンネルがあります。<literal>#debian-bugs</"
+"literal> は、バグ潰しパーティ (BSP) を開催するために使われます。"
+"<literal>#debian-boot</literal> は、debian-installer の作業を調整するのに利用"
+"されています。<literal>#debian-doc</literal> は、今あなたが読んでいるような文"
+"章のドキュメント化について話すために時折使われています。アーキテクチャやパッ"
+"ã\82±ã\83¼ã\82¸ç¾¤ã\81«ã\81¤ã\81\84ã\81¦è©±ã\81\99ã\81\9fã\82\81ã\80\81ä»\96ã\81«ã\82\82å°\82ç\94¨ã\83\81ã\83£ã\83³ã\83\8dã\83«ã\81\8cã\81\82ã\82\8aã\81¾ã\81\99ï¼\9a<literal>#debian-"
+"kde</literal>、<literal>#debian-dpkg</literal>、<literal>#debian-jr</"
+"literal>、<literal>#debian-edu</literal>、<literal>#debian-oo</literal> "
+"(OpenOffice パッケージ) など…"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:172
msgid ""
"Some non-English developers' channels exist as well, for example "
"チャンネルです。"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:177
msgid ""
"Channels dedicated to Debian also exist on other IRC networks, notably on "
"4 日まで <literal>irc.debian.org</literal> のエイリアスでした。"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:183
msgid ""
"To get a cloak on freenode, you send Jörg Jaspert <joerg@debian.org> a "
"shtml#projectcloak\">Freenode のドキュメント</ulink> を参照してください。"
# type: Content of: <chapter><section><title>
+#. type: Content of: <chapter><section><title>
#: resources.dbk:194
msgid "Documentation"
msgstr "ドキュメント化"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:196
msgid ""
"This document contains a lot of information which is useful to Debian "
"ンクを全部眺めれば、より多くの事柄を学べるでしょう。"
# type: Content of: <chapter><section><title>
+#. type: Content of: <chapter><section><title>
#: resources.dbk:205
msgid "Debian machines"
msgstr "Debian のマシン群"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:207
msgid ""
"Debian has several computers working as servers, most of which serve "
"されており、全てインターネットに常時接続されています。"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:212
msgid ""
"Some of the machines are available for individual developers to use, as long "
"ulink>で定められたルールに従う限り、個々の開発者の利用が可能となっています。"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:217
msgid ""
"Generally speaking, you can use these machines for Debian-related purposes "
"してください。大抵これらのマシンはボランティアによって運用されています。"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:224
msgid ""
"Please take care to protect your Debian passwords and SSH keys installed on "
"けてください。"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:229
msgid ""
"Please do not put any material that doesn't relate to Debian on the Debian "
"置かないようにしてください。"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:233
msgid ""
"The current list of Debian machines is available at <ulink url=\"&url-devel-"
"などの情報を含んでいます。"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:239
msgid ""
"If you have a problem with the operation of a Debian server, and you think "
"に入れるのを忘れずに。"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:247
msgid ""
"If you have a problem with a certain service, not related to the system "
"いては <xref linkend=\"submit-bug\"/> を参照してください。"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:254
msgid ""
"Some of the core servers are restricted, but the information from there is "
"は他のサーバへミラーされています。"
# type: Content of: <chapter><section><section><title>
+#. type: Content of: <chapter><section><section><title>
#: resources.dbk:258
msgid "The bugs server"
msgstr "バグ報告サーバ"
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:260
msgid ""
"<literal>&bugs-host;</literal> is the canonical location for the Bug "
"す。"
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:264 resources.dbk:282
msgid "It is restricted; a mirror is available on <literal>merkel</literal>."
msgstr ""
"用可能です。"
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:267
msgid ""
"If you plan on doing some statistical analysis or processing of Debian bugs, "
"装する前に &email-debian-devel; であなたの計画を説明してください。"
# type: Content of: <chapter><section><section><title>
+#. type: Content of: <chapter><section><section><title>
#: resources.dbk:275
msgid "The ftp-master server"
msgstr "ftp-master サーバ"
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:277
msgid ""
"The <literal>&ftp-master-host;</literal> server holds the canonical copy of "
"す。<xref linkend=\"upload\"/> を参照してください。"
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:285
msgid ""
"Problems with the Debian FTP archive generally need to be reported as bugs "
"manip\"/>にある手順も参照してください。"
# type: Content of: <chapter><section><section><title>
+#. type: Content of: <chapter><section><section><title>
#: resources.dbk:293
msgid "The www-master server"
msgstr "www-master サーバ"
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:295
msgid ""
"The main web server is <literal>www-master.debian.org</literal>. It holds "
"web ページを持ち、新たな参加者に対する Debian の顔となっています。"
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:299
msgid ""
"If you find a problem with the Debian web server, you should generally "
"するのを忘れないようにしてください。"
# type: Content of: <chapter><section><section><title>
+#. type: Content of: <chapter><section><section><title>
#: resources.dbk:308
msgid "The people web server"
msgstr "people ウェブサーバ"
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:310
msgid ""
"<literal>people.debian.org</literal> is the server used for developers' own "
"ウェブページのために使われているサーバです。"
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:314
msgid ""
"If you have some Debian-specific information which you want to serve on the "
"literal> という URL でアクセス可能です。"
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:321
msgid ""
"You should only use this particular location because it will be backed up, "
"whereas on other hosts it won't."
msgstr ""
-"他のホストではバックアップされないのに対して、ここではバックアップされるので、"
-"これを使うのは特定の位置づけのものだけにするべきです。"
+"他のホストではバックアップされないのに対して、ここではバックアップされるの"
+"ã\81§ã\80\81ã\81\93ã\82\8cã\82\92使ã\81\86ã\81®ã\81¯ç\89¹å®\9aã\81®ä½\8dç½®ã\81¥ã\81\91ã\81®ã\82\82ã\81®ã\81 ã\81\91ã\81«ã\81\99ã\82\8bã\81¹ã\81\8dã\81§ã\81\99ã\80\82"
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:325
msgid ""
"Usually the only reason to use a different host is when you need to publish "
"かを使えます。"
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:330
msgid "Send mail to &email-debian-devel; if you have any questions."
msgstr "何か質問がある場合は、&email-debian-devel; にメールして下さい。"
# type: Content of: <chapter><section><section><title>
+#. type: Content of: <chapter><section><section><title>
#: resources.dbk:335
msgid "The VCS servers"
msgstr "VCS (バージョン管理システム) サーバ"
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:337
msgid ""
"If you need to use a Version Control System for any of your Debian work, you "
"ださい。"
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:348
msgid ""
"Historically, Debian first used <literal>cvs.debian.org</literal> to host "
"います。極少数のプロジェクトだけが未だに使いつづけています。"
# type: Content of: <chapter><section><section><title>
+#. type: Content of: <chapter><section><section><title>
#: resources.dbk:355
msgid "chroots to different distributions"
msgstr "複数のディストリビューション利用のために chroot を使う"
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:357
msgid ""
"On some machines, there are chroots to different distributions available. "
"す。以下の様にして使うことが出来ます："
# type: Content of: <chapter><section><section><screen>
-#: resources.dbk:360
-#, no-wrap
+#. type: Content of: <chapter><section><section><screen>
+#: resources.dbk:361
+#, fuzzy, no-wrap
msgid ""
-"\n"
"vore$ dchroot unstable\n"
"Executing shell in chroot: /org/vore.debian.org/chroots/user/unstable\n"
msgstr ""
"Executing shell in chroot: /org/vore.debian.org/chroots/user/unstable\n"
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:365
msgid ""
"In all chroots, the normal user home directories are available. You can "
"\">&url-devel-machines;</ulink> にて確認ができます。"
# type: Content of: <chapter><section><title>
+#. type: Content of: <chapter><section><title>
#: resources.dbk:374
msgid "The Developers Database"
msgstr "開発者データベース"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:376
msgid ""
"The Developers Database, at <ulink url=\"&url-debian-db;\"></ulink>, is an "
"command> として何が返ってくるかを確認してみてください。"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:384
msgid ""
"Developers can <ulink url=\"&url-debian-db-login;\">log into the database</"
"url=\"&url-debian-db-login;\">データベースにログイン</ulink>ができます。"
# type: Content of: <chapter><section><itemizedlist><listitem><para>
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
#: resources.dbk:390
msgid "forwarding address for your debian.org email"
msgstr "debian.org アドレス宛のメールを転送するアドレス"
# type: Content of: <chapter><section><itemizedlist><listitem><para>
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
#: resources.dbk:395
msgid "subscription to debian-private"
msgstr "debian-private の購読"
# type: Content of: <chapter><section><itemizedlist><listitem><para>
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
#: resources.dbk:400
msgid "whether you are on vacation"
msgstr "休暇中かどうか"
# type: Content of: <chapter><section><itemizedlist><listitem><para>
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
#: resources.dbk:405
msgid ""
"personal information such as your address, country, the latitude and "
"ム、そしてウェブページのアドレスなどの個人情報"
# type: Content of: <chapter><section><itemizedlist><listitem><para>
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
#: resources.dbk:413
msgid "password and preferred shell on Debian Project machines"
msgstr "Debian プロジェクトのマシン上でのパスワードと優先的に指定するシェル"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:418
msgid ""
"Most of the information is not accessible to the public, naturally. For "
"オンラインドキュメントを読んでください。"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:423
msgid ""
"Developers can also submit their SSH keys to be used for authorization on "
"<ulink url=\"&url-debian-db-mail-gw;\"></ulink> に記述されています。"
# type: Content of: <chapter><section><title>
+#. type: Content of: <chapter><section><title>
#: resources.dbk:431
msgid "The Debian archive"
msgstr "Debian アーカイブ"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:433
msgid ""
"The &debian-formal; distribution consists of a lot of packages (<filename>."
"(ドキュメントやインストール用ディスクイメージ) から成り立っています。"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:439
msgid "Here is an example directory tree of a complete Debian archive:"
msgstr "以下が完全な Debian アーカイブのディレクトリツリーの例です："
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:443
msgid ""
"As you can see, the top-level directory contains two directories, "
"見て分かるように、一番上のディレクトリは <filename>dists/</filename> と "
"<filename>pool/</filename> という 2 つのディレクトリを含んでいます。後者の "
"“pool” はパッケージが実際に置かれており、アーカイブのメンテナンスデータベース"
-"と関連するプログラムによって利用されます。前者には<literal>stable</"
-"literal>、<literal>testing</literal>、そして <literal>unstable</"
-"literal> というディストリビューションが含まれます。ディストリビューションサ"
-"ブディレクトリ中の <filename>Packages</filename> および <filename>Sources</"
-"filename> ファイルは <filename>pool/</filename> ディレクトリ中のファイルを参"
-"照しています。以下の各ディストリビューションのディレクトリツリーは全く同じ形"
-"式になっています。以下で <literal>stable</literal> について述べていること"
-"は <literal>unstable</literal> や <literal>testing</literal> ディストリ"
-"ã\83\93ã\83¥ã\83¼ã\82·ã\83§ã\83³ã\81«ã\82\82å\90\8cæ§\98ã\81«å½\93ã\81¦ã\81¯ã\81¾ã\82\8aã\81¾ã\81\99ã\80\82"
+"と関連するプログラムによって利用されます。前者には<literal>stable</literal>、"
+"<literal>testing</literal>、そして <literal>unstable</literal> というディスト"
+"リビューションが含まれます。ディストリビューションサブディレクトリ中の "
+"<filename>Packages</filename> および <filename>Sources</filename> ファイルは "
+"<filename>pool/</filename> ディレクトリ中のファイルを参照しています。以下の各"
+"ディストリビューションのディレクトリツリーは全く同じ形式になっています。以下"
+"で <literal>stable</literal> について述べていることは <literal>unstable</"
+"literal> や <literal>testing</literal> ディストリビューションにも同様に当ては"
+"まります。"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:457
msgid ""
"<filename>dists/stable</filename> contains three directories, namely "
"のディレクトリを含んでいます。"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:462
msgid ""
"In each of the areas, there is a directory for the source packages "
"<filename>binary-m68k</filename> など) のディレクトリがあります。"
# type: Content of: <chapter><section><para>
+#. type: Content of: <chapter><section><para>
#: resources.dbk:467
msgid ""
"The <filename>main</filename> area contains additional directories which "
"filename> など)。"
# type: Content of: <chapter><section><section><title>
+#. type: Content of: <chapter><section><section><title>
#: resources.dbk:473
msgid "Sections"
msgstr "セクション"
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:475
msgid ""
"The <literal>main</literal> section of the Debian archive is what makes up "
msgstr ""
"Debian アーカイブの <literal>main</literal> セクションは<emphasis role="
"\"strong\">公式な &debian-formal; ディストリビューション</emphasis>を構成する"
-"ものです。<literal>main</literal> セクションが公式なのは、我々のガイドライ"
-"ン全てに合致するものであるからです。他の 2 つのセクションはそうではなく、合致"
-"は異なる程度となっています…つまり、&debian-formal; の公式な一部では<emphasis "
+"ものです。<literal>main</literal> セクションが公式なのは、我々のガイドライン"
+"全てに合致するものであるからです。他の 2 つのセクションはそうではなく、合致は"
+"異なる程度となっています…つまり、&debian-formal; の公式な一部では<emphasis "
"role=\"strong\">ありません</emphasis>。"
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:483
msgid ""
"Every package in the main section must fully comply with the <ulink url="
"ウェア」です。詳細は Debian ポリシーマニュアルを確認してください。"
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:491
msgid ""
"Packages in the <literal>contrib</literal> section have to comply with the "
"DFSG, but may fail other requirements. For instance, they may depend on non-"
"free packages."
msgstr ""
-"<literal>contrib</literal> セクションにあるパッケージは DFSG に適合している"
-"必要がありますが、他の要求事項を満たせてはいないことでしょう。例えば、non-free "
+"<literal>contrib</literal> セクションにあるパッケージは DFSG に適合している必"
+"要がありますが、他の要求事項を満たせてはいないことでしょう。例えば、non-free "
"パッケージに依存している、などです。"
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:496
msgid ""
"Packages which do not conform to the DFSG are placed in the <literal>non-"
"infrastructure (such as our bug-tracking system and mailing lists) for non-"
"free software packages."
msgstr ""
-"DFSG を満たさないパッケージは <literal>non-free</literal> セクションに配置"
-"ã\81\95ã\82\8cã\81¾ã\81\99ã\80\82ã\81\93ã\82\8cã\82\89ã\81®ã\83\91ã\83\83ã\82±ã\83¼ã\82¸ã\81¯ Debian ã\83\87ã\82£ã\82¹ã\83\88ã\83ªã\83\93ã\83¥ã\83¼ã\82·ã\83§ã\83³ã\81®ä¸\80é\83¨ã\81¨ã\81\97ã\81¦ã\81¯è\80\83"
-"ã\81\88ã\82\89ã\82\8cã\81¦ã\81¯ã\81\84ã\81¾ã\81\9bã\82\93ã\81\8cã\80\81æ\88\91ã\80\85ã\81¯å\88©ç\94¨ã\81«ã\81¤ã\81\84ã\81¦ã\82µã\83\9dã\83¼ã\83\88ã\82\92è¡\8cã\81£ã\81¦ã\81\8aã\82\8aã\80\81non-free ã\82½ã\83\95ã\83\88"
+"DFSG を満たさないパッケージは <literal>non-free</literal> セクションに配置さ"
+"ã\82\8cã\81¾ã\81\99ã\80\82ã\81\93ã\82\8cã\82\89ã\81®ã\83\91ã\83\83ã\82±ã\83¼ã\82¸ã\81¯ Debian ã\83\87ã\82£ã\82¹ã\83\88ã\83ªã\83\93ã\83¥ã\83¼ã\82·ã\83§ã\83³ã\81®ä¸\80é\83¨ã\81¨ã\81\97ã\81¦ã\81¯è\80\83ã\81\88"
+"られてはいませんが、我々は利用についてサポートを行っており、non-free ソフト"
"ウェアのパッケージについて (バグ追跡システムやメーリングリストなどの) インフ"
"ラストラクチャを提供しています。"
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:503
msgid ""
"The <ulink url=\"&url-debian-policy;\">Debian Policy Manual</ulink> contains "
"ぎません。"
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:508
msgid ""
"The separation of the three sections at the top-level of the archive is "
"アーカイブの最上位階層で 3 つのセクションに別れていることは、インターネット上"
"の FTP サーバ経由であれ、CD-ROM であれ、Debian を配布したいと考える人にとって"
"大事なことです…その様な人は <literal>main</literal> セクションと "
-"<literal>contrib</literal> セクションのみを配布することで、法的なリスクを回"
-"避できます。例えば、<literal>non-free</literal> セクションにあるパッケージ"
-"ã\81®ã\81\84ã\81\8fã\81¤ã\81\8bã\81¯å\95\86ç\9a\84ã\81ªé\85\8då¸\83ã\82\92許å\8f¯ã\81\97ã\81¦ã\81\84ã\81¾ã\81\9bã\82\93ã\80\82"
+"<literal>contrib</literal> セクションのみを配布することで、法的なリスクを回避"
+"できます。例えば、<literal>non-free</literal> セクションにあるパッケージのい"
+"くつかは商的な配布を許可していません。"
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:516
msgid ""
"On the other hand, a CD-ROM vendor could easily check the individual package "
"on the CD-ROMs as it's allowed to. (Since this varies greatly from vendor "
"to vendor, this job can't be done by the Debian developers.)"
msgstr ""
-"その一方で、CD-ROMベンダは <literal>non-free</literal> 内のパッケージ群の"
-"個々のパッケージライセンスを簡単に確認でき、問題が無ければその多くを CD-ROM "
-"ã\81«å\90«ã\82\81ã\82\8bã\81\93ã\81¨ã\81\8cå\87ºæ\9d¥ã\81¾ã\81\99ã\80\82(ã\81\93ã\82\8cã\81¯ã\83\99ã\83³ã\83\80ã\81«ã\82\88ã\81£ã\81¦å¤§ã\81\84ã\81«ç\95°ã\81ªã\82\8bã\81®ã\81§ã\80\81ã\81\93ã\81®ä½\9cæ¥ã\81¯ "
-"Debian 開発者にはできません)。"
+"その一方で、CD-ROMベンダは <literal>non-free</literal> 内のパッケージ群の個々"
+"のパッケージライセンスを簡単に確認でき、問題が無ければその多くを CD-ROM に含"
+"ã\82\81ã\82\8bã\81\93ã\81¨ã\81\8cå\87ºæ\9d¥ã\81¾ã\81\99ã\80\82(ã\81\93ã\82\8cã\81¯ã\83\99ã\83³ã\83\80ã\81«ã\82\88ã\81£ã\81¦å¤§ã\81\84ã\81«ç\95°ã\81ªã\82\8bã\81®ã\81§ã\80\81ã\81\93ã\81®ä½\9cæ¥ã\81¯ Debian "
+"開発者にはできません)。"
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:522
msgid ""
"Note that the term section is also used to refer to categories which "
msgstr ""
"セクションという用語は、利用可能なパッケージの構成や参照を簡単にしているカテ"
"ゴリを指すことにも使われている点に注意ください。例えば、<literal>admin</"
-"literal>、<literal>net</literal>、<literal>utils</literal> などです。"
-"昔々、これらのセクション (むしろサブセクション) はDebian アーカイブ内のサブ"
-"ã\83\87ã\82£ã\83¬ã\82¯ã\83\88ã\83ªã\81¨ã\81\97ã\81¦å\98å\9c¨ã\81\97ã\81¦ã\81\84ã\81¾ã\81\97ã\81\9fã\80\82æ\9c\80è¿\91ã\81§ã\81¯ã\80\81ã\81\93ã\82\8cã\82\89ã\81¯ã\83\91ã\83\83ã\82±ã\83¼ã\82¸ã\81®ã\82»ã\82¯ã\82·ã\83§ã\83³"
-"ã\83\98ã\83\83ã\83\80ã\81«ã\81®ã\81¿å\98å\9c¨ã\81\97ã\81¦ã\81\84ã\81¾ã\81\99ã\80\82"
+"literal>、<literal>net</literal>、<literal>utils</literal> などです。昔々、こ"
+"れらのセクション (むしろサブセクション) はDebian アーカイブ内のサブディレクト"
+"ã\83ªã\81¨ã\81\97ã\81¦å\98å\9c¨ã\81\97ã\81¦ã\81\84ã\81¾ã\81\97ã\81\9fã\80\82æ\9c\80è¿\91ã\81§ã\81¯ã\80\81ã\81\93ã\82\8cã\82\89ã\81¯ã\83\91ã\83\83ã\82±ã\83¼ã\82¸ã\81®ã\82»ã\82¯ã\82·ã\83§ã\83³ã\83\98ã\83\83ã\83\80ã\81«ã\81®"
+"み存在しています。"
# type: Content of: <chapter>port<section><section><title>
+#. type: Content of: <chapter><section><section><title>
#: resources.dbk:532
msgid "Architectures"
msgstr "アーキテクチャ"
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:534
msgid ""
"In the first days, the Linux kernel was only available for Intel i386 (or "
"ネルも他のアーキテクチャへと移植されたのです。"
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:539
msgid ""
"The Linux 2.0 kernel supports Intel x86, DEC Alpha, SPARC, Motorola 680x0 "
"literal> (我々の間での Intel x86 の呼び方) 以外にも、これを書いている時点で "
"<literal>m68k</literal>、<literal>alpha</literal>、<literal>powerpc</"
"literal>、<literal>sparc</literal>、<literal>hurd-i386</literal>、"
-"<literal>arm</literal>、<literal>ia64</literal>、<literal>hppa</"
-"literal>、<literal>s390</literal>、<literal>mips</literal>、"
-"<literal>mipsel</literal>、そして <literal>sh</literal> があります。"
+"<literal>arm</literal>、<literal>ia64</literal>、<literal>hppa</literal>、"
+"<literal>s390</literal>、<literal>mips</literal>、<literal>mipsel</literal>、"
+"そして <literal>sh</literal> があります。"
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:553
msgid ""
"&debian-formal; 1.3 is only available as <literal>i386</literal>. Debian "
"literal>."
msgstr ""
"&debian-formal; 1.3 では <literal>i386</literal> のみが利用可能でした。"
-"Debian 2.0 では、<literal>i386</literal> と <literal>m68k</literal> アー"
-"キテクチャがリリースされました。Debian 2.1 では、<literal>i386</literal>、"
-"<literal>m68k</literal>、<literal>alpha</literal>、そして "
-"<literal>sparc</literal> アーキテクチャがリリースされました。Debian 2.2 で"
-"は <literal>powerpc</literal> および <literal>arm</literal> アーキテク"
-"チャへのサポートが追加されました。Debian 3.0 は、新たに 5 つのアーキテクチャ"
-"へのサポートが追加されました：<literal>ia64</literal>、<literal>hppa</"
-"literal>、<literal>s390</literal>、<literal>mips</literal> そして "
-"<literal>mipsel</literal> です。"
-
-# type: Content of: <chapter><section><section><para>
+"Debian 2.0 では、<literal>i386</literal> と <literal>m68k</literal> アーキテ"
+"クチャがリリースされました。Debian 2.1 では、<literal>i386</literal>、"
+"<literal>m68k</literal>、<literal>alpha</literal>、そして <literal>sparc</"
+"literal> アーキテクチャがリリースされました。Debian 2.2 では "
+"<literal>powerpc</literal> および <literal>arm</literal> アーキテクチャへのサ"
+"ポートが追加されました。Debian 3.0 は、新たに 5 つのアーキテクチャへのサポー"
+"トが追加されました：<literal>ia64</literal>、<literal>hppa</literal>、"
+"<literal>s390</literal>、<literal>mips</literal> そして <literal>mipsel</"
+"literal> です。"
+
+# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:564
msgid ""
"Information for developers and users about the specific ports are available "
"ports;\">Debian 移植版のウェブページ</ulink>で入手可能です。"
# type: Content of: <chapter><section><section><title>
+#. type: Content of: <chapter><section><section><title>
#: resources.dbk:570
msgid "Packages"
msgstr "パッケージ"
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:572
msgid ""
"There are two types of Debian packages, namely <literal>source</literal> and "
"<literal>バイナリ</literal>パッケージです。"
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:576
msgid ""
"Source packages consist of either two or three files: a <filename>.dsc</"
"filename> ファイルです。"
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:582
msgid ""
"If a package is developed specially for Debian and is not distributed "
"パッケージが特に Debian 用に作られていて Debian 以外で利用されていない場合"
"は、プログラムのソースを含んだ単純な 1 つの <filename>.tar.gz</filename> ファ"
"イルがあるだけです。パッケージが他でも利用されている場合は、<filename>.orig."
-"tar.gz</filename> は <literal>upstream ソースコード</literal>と呼ばれるもの"
-"を保持しています。<literal>upstream ソースコード</literal>は "
-"<literal>upstream メンテナ</literal> (大抵の場合はソフトウェアの作者) に"
-"ã\82\88ã\81£ã\81¦é\85\8då¸\83ã\81\95ã\82\8cã\81¦ã\81\84ã\82\8bã\82½ã\83¼ã\82¹ã\82³ã\83¼ã\83\89ã\81§ã\81\99ã\80\82ã\81\93ã\81®å ´å\90\88ã\80\81<filename>.diff.gz</"
-"filename> はDebian パッケージメンテナによって加えられた変更を含んでいます。"
+"tar.gz</filename> は <literal>upstream ソースコード</literal>と呼ばれるものを"
+"保持しています。<literal>upstream ソースコード</literal>は <literal>upstream "
+"メンテナ</literal> (大抵の場合はソフトウェアの作者) によって配布されている"
+"ã\82½ã\83¼ã\82¹ã\82³ã\83¼ã\83\89ã\81§ã\81\99ã\80\82ã\81\93ã\81®å ´å\90\88ã\80\81<filename>.diff.gz</filename> ã\81¯Debian ã\83\91ã\83\83ã\82±ã\83¼ã\82¸"
+"メンテナによって加えられた変更を含んでいます。"
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:592
msgid ""
"The <filename>.dsc</filename> file lists all the files in the source package "
"関連の追加情報 (メンテナ、バージョン、etc) を含んでいます。"
# type: Content of: <chapter><section><section><title>
+#. type: Content of: <chapter><section><section><title>
#: resources.dbk:599
msgid "Distributions"
msgstr "ディストリビューション"
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:601
msgid ""
"The directory system described in the previous chapter is itself contained "
"actually contained in the <filename>pool</filename> directory in the top-"
"level of the Debian archive itself."
msgstr ""
-"前章で説明したディレクトリシステムは、それ自体が<literal>ディストリビュー"
-"ã\82·ã\83§ã\83³ã\83\87ã\82£ã\83¬ã\82¯ã\83\88ã\83ª</literal>å\86\85ã\81«å\90«ã\81¾ã\82\8cã\81¦ã\81\84ã\81¾ã\81\99ã\80\82ã\81\9dã\82\8cã\81\9eã\82\8cã\81®ã\83\87ã\82£ã\82¹ã\83\88ã\83ªã\83\93ã\83¥ã\83¼"
-"ã\82·ã\83§ã\83³ã\81¯ã\80\81å®\9fé\9a\9bã\81«ã\81¯ Debian ã\82¢ã\83¼ã\82«ã\82¤ã\83\96è\87ªä½\93ã\81®æ\9c\80ä¸\8aä½\8dé\9a\8e層ã\81® <filename>pool</"
-"filename> ディレクトリに含まれています。"
+"前章で説明したディレクトリシステムは、それ自体が<literal>ディストリビューショ"
+"ã\83³ã\83\87ã\82£ã\83¬ã\82¯ã\83\88ã\83ª</literal>å\86\85ã\81«å\90«ã\81¾ã\82\8cã\81¦ã\81\84ã\81¾ã\81\99ã\80\82ã\81\9dã\82\8cã\81\9eã\82\8cã\81®ã\83\87ã\82£ã\82¹ã\83\88ã\83ªã\83\93ã\83¥ã\83¼ã\82·ã\83§ã\83³"
+"ã\81¯ã\80\81å®\9fé\9a\9bã\81«ã\81¯ Debian ã\82¢ã\83¼ã\82«ã\82¤ã\83\96è\87ªä½\93ã\81®æ\9c\80ä¸\8aä½\8dé\9a\8e層ã\81® <filename>pool</filename> "
+"ディレクトリに含まれています。"
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:607
msgid ""
"To summarize, the Debian archive has a root directory within an FTP server. "
"<filename>/pub/debian</filename> があります)。"
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:614
msgid ""
"A distribution comprises Debian source and binary packages, and the "
"ため)。"
# type: Content of: <chapter><section><section><section><title>
+#. type: Content of: <chapter><section><section><section><title>
#: resources.dbk:622
msgid "Stable, testing, and unstable"
msgstr "安定版 (stable)、テスト版 (testing)、不安定版 (unstable)"
# type: Content of: <chapter><section><section><section><para>
+#. type: Content of: <chapter><section><section><section><para>
#: resources.dbk:624
msgid ""
"There are always distributions called <literal>stable</literal> (residing in "
"(residing in <filename>dists/unstable</filename>). This reflects the "
"development process of the Debian project."
msgstr ""
-"常に <literal>安定版 (stable)</literal> (<filename>dists/stable</filename> "
-"に属します)、<literal>テスト晩 (testing)</literal> (<filename>dists/"
-"testing</filename> に属します)、<literal>不安定版 (unstable)</literal> "
+"常に <literal>安定版 (stable)</literal> (<filename>dists/stable</filename> に"
+"属します)、<literal>テスト晩 (testing)</literal> (<filename>dists/testing</"
+"filename> に属します)、<literal>不安定版 (unstable)</literal> "
"(<filename>dists/unstable</filename> に属します) と呼ばれるディストリビュー"
"ションが存在しています。これは Debian プロジェクトでの開発プロセスを反映して"
"います。"
# type: Content of: <chapter><section><section><section><para>
+#. type: Content of: <chapter><section><section><section><para>
#: resources.dbk:631
msgid ""
"Active development is done in the <literal>unstable</literal> distribution "
"make sure everything in this distribution is working properly, it is "
"sometimes literally unstable."
msgstr ""
-"活発な開発が<literal>不安定版 (unstable)</literal> ディストリビューションで"
-"行われています (これが、何故このディストリビューションが<literal>開発ディス"
-"ã\83\88ã\83ªã\83\93ã\83¥ã\83¼ã\82·ã\83§ã\83³</literal>ã\81¨å\91¼ã\81°ã\82\8cã\82\8bã\81\93ã\81¨ã\81\8cã\81\82ã\82\8bã\81\8bã\81¨ã\81\84ã\81\86ç\90\86ç\94±ã\81§ã\81\99)ã\80\82å\85¨ã\81¦ã\81® "
-"Debian 開発者は、このディストリビューション内の自分のパッケージを何時でも更新"
-"ã\81§ã\81\8dã\81¾ã\81\99ã\80\82ã\81¤ã\81¾ã\82\8aã\80\81ã\81\93ã\81®ã\83\87ã\82£ã\82¹ã\83\88ã\83ªã\83\93ã\83¥ã\83¼ã\82·ã\83§ã\83³ã\81®å\86\85容ã\81¯æ\97¥ã\80\85å¤\89å\8c\96ã\81\97ã\81¦ã\81\84ã\82\8bã\81®ã\81§ã\81\99ã\80\82"
-"ã\81\93ã\81®ã\83\87ã\82£ã\82¹ã\83\88ã\83ªã\83\93ã\83¥ã\83¼ã\82·ã\83§ã\83³ã\81®å\85¨ã\81¦ã\81\8cæ£ã\81\97ã\81\8få\8b\95ä½\9cã\81\99ã\82\8bã\81\8bã\82\92ä¿\9d証ã\81\99ã\82\8bã\81\93ã\81¨ã\81«ã\81¤ã\81\84ã\81¦ã\81¯ç\89¹"
-"å\88¥ã\81ªå\8aªå\8a\9bã\81¯æ\89\95ã\82\8fã\82\8cã\81¦ã\81\84ã\81ªã\81\84ã\81®ã\81§ã\80\81æ\99\82ã\81«ã\81¯æ\96\87å\97é\80\9aã\82\8aä¸\8då®\89å®\9a (unstable) ã\81¨ã\81ªã\82\8aã\81¾ã\81\99ã\80\82"
+"活発な開発が<literal>不安定版 (unstable)</literal> ディストリビューションで行"
+"われています (これが、何故このディストリビューションが<literal>開発ディストリ"
+"ã\83\93ã\83¥ã\83¼ã\82·ã\83§ã\83³</literal>ã\81¨å\91¼ã\81°ã\82\8cã\82\8bã\81\93ã\81¨ã\81\8cã\81\82ã\82\8bã\81\8bã\81¨ã\81\84ã\81\86ç\90\86ç\94±ã\81§ã\81\99)ã\80\82å\85¨ã\81¦ã\81® Debian é\96\8b"
+"発者は、このディストリビューション内の自分のパッケージを何時でも更新できま"
+"ã\81\99ã\80\82ã\81¤ã\81¾ã\82\8aã\80\81ã\81\93ã\81®ã\83\87ã\82£ã\82¹ã\83\88ã\83ªã\83\93ã\83¥ã\83¼ã\82·ã\83§ã\83³ã\81®å\86\85容ã\81¯æ\97¥ã\80\85å¤\89å\8c\96ã\81\97ã\81¦ã\81\84ã\82\8bã\81®ã\81§ã\81\99ã\80\82ã\81\93ã\81®"
+"ã\83\87ã\82£ã\82¹ã\83\88ã\83ªã\83\93ã\83¥ã\83¼ã\82·ã\83§ã\83³ã\81®å\85¨ã\81¦ã\81\8cæ£ã\81\97ã\81\8få\8b\95ä½\9cã\81\99ã\82\8bã\81\8bã\82\92ä¿\9d証ã\81\99ã\82\8bã\81\93ã\81¨ã\81«ã\81¤ã\81\84ã\81¦ã\81¯ç\89¹å\88¥ã\81ª"
+"努力は払われていないので、時には文字通り不安定 (unstable) となります。"
# type: Content of: <chapter><section><section><section><para>
+#. type: Content of: <chapter><section><section><section><para>
#: resources.dbk:640
msgid ""
"The <link linkend=\"testing\">testing</link> distribution is generated "
"been installed. See <xref linkend=\"testing\"/> ."
msgstr ""
"<link linkend=\"testing\">テスト版 (testing)</link> ディストリビューション"
-"は、パッケージが特定の判定規準を満たした際に<literal>不安定版</literal>から"
-"自動的に移動されることで生成されています。この判定規準は<literal>テスト版</literal>"
-"に含まれるパッケージとして十分な品質であることを保証する必要があります。<literal>"
-"テスト版</literal>への更新は、新しいパッケージがインストールされた後、毎日 2 回"
-"実施されています。<xref linkend=\"testing\"/> を参照してください。"
+"は、パッケージが特定の判定規準を満たした際に<literal>不安定版</literal>から自"
+"動的に移動されることで生成されています。この判定規準は<literal>テスト版</"
+"literal>に含まれるパッケージとして十分な品質であることを保証する必要がありま"
+"す。<literal>テスト版</literal>への更新は、新しいパッケージがインストールされ"
+"た後、毎日 2 回実施されています。<xref linkend=\"testing\"/> を参照してくださ"
+"い。"
# type: Content of: <chapter><section><section><section><para>
+#. type: Content of: <chapter><section><section><section><para>
#: resources.dbk:648
msgid ""
"After a period of development, once the release manager deems fit, the "
"literal> and stays there until it is finally archived. On archiving, the "
"contents are moved to <literal>&archive-host;</literal>)."
msgstr ""
-"一定の開発期間後、リリースマネージャが適当であると決定すると、<literal>テスト版 "
-"(testing)</literal> ディストリビューションはフリーズされます。これは、"
-"<literal>不安定版 (unstable)</literal> から<literal>テスト版 (testing)</literal> "
-"へのパッケージ移動をどのように行うかのポリシーがきつくなることを意味しています。"
-"ã\83\90ã\82°ã\81\8cå¤\9aã\81\99ã\81\8eã\82\8bã\83\91ã\83\83ã\82±ã\83¼ã\82¸ã\81¯å\89\8aé\99¤ã\81\95ã\82\8cã\81¾ã\81\99ã\80\82ã\83\90ã\82°ä¿®æ£ä»¥å¤\96ã\81®å¤\89æ\9b´ã\81\8c<literal>ã\83\86ã\82¹ã\83\88ç\89\88 "
-"(testing)</literal> に入ることは許可されません。いくらかの時間経過後、進行状況に"
-"応じて<literal>テスト版 (testing)</literal> ディストリビューションはより一層"
-"ã\83\95ã\83ªã\83¼ã\82ºã\81\95ã\82\8cã\81¾ã\81\99ã\80\82ã\83\86ã\82¹ã\83\88ç\89\88ã\83\87ã\82£ã\82¹ã\83\88ã\83ªã\83\93ã\83¥ã\83¼ã\82·ã\83§ã\83³ã\81®å\8f\96æ\89±ã\81\84詳細ã\81«ã\81¤ã\81\84ã\81¦ã\81¯ "
-"debian-devel-announce にてリリースチームが発表します。リリースチームが満足する"
-"程度に残っていた問題が修正された後、ディストリビューションがリリースされます。"
-"ã\83ªã\83ªã\83¼ã\82¹ã\81¯ã\80\81<literal>ã\83\86ã\82¹ã\83\88ç\89\88 (testing)</literal> ã\81\8c<literal>å®\89å®\9aç\89\88 (stable)"
-"</literal> へとリネームされる事を意味しており、<literal>テスト版 (testing)"
-"</literal> 用の新しいコピーが作成され、以前の<literal>安定版 (stable)</literal> "
-"は<literal>旧安定版 (oldstable)</literal> にリネームされ、最終的にアーカイブされる"
-"ã\81¾ã\81§å\98å\9c¨ã\81\97ã\81¦ã\81\84ã\81¾ã\81\99ã\80\82ã\82¢ã\83¼ã\82«ã\82¤ã\83\96ä½\9cæ¥ã\81§ã\81¯ã\80\81ã\82³ã\83³ã\83\86ã\83³ã\83\84ã\81¯ <literal>&archive-host;"
-"</literal> へと移動されます。"
+"一定の開発期間後、リリースマネージャが適当であると決定すると、<literal>テスト"
+"版 (testing)</literal> ディストリビューションはフリーズされます。これは、"
+"<literal>不安定版 (unstable)</literal> から<literal>テスト版 (testing)</"
+"literal> へのパッケージ移動をどのように行うかのポリシーがきつくなることを意味"
+"ã\81\97ã\81¦ã\81\84ã\81¾ã\81\99ã\80\82ã\83\90ã\82°ã\81\8cå¤\9aã\81\99ã\81\8eã\82\8bã\83\91ã\83\83ã\82±ã\83¼ã\82¸ã\81¯å\89\8aé\99¤ã\81\95ã\82\8cã\81¾ã\81\99ã\80\82ã\83\90ã\82°ä¿®æ£ä»¥å¤\96ã\81®å¤\89æ\9b´ã\81\8c"
+"<literal>テスト版 (testing)</literal> に入ることは許可されません。いくらかの"
+"時間経過後、進行状況に応じて<literal>テスト版 (testing)</literal> ディストリ"
+"ã\83\93ã\83¥ã\83¼ã\82·ã\83§ã\83³ã\81¯ã\82\88ã\82\8aä¸\80層ã\83\95ã\83ªã\83¼ã\82ºã\81\95ã\82\8cã\81¾ã\81\99ã\80\82ã\83\86ã\82¹ã\83\88ç\89\88ã\83\87ã\82£ã\82¹ã\83\88ã\83ªã\83\93ã\83¥ã\83¼ã\82·ã\83§ã\83³ã\81®å\8f\96æ\89±"
+"い詳細については debian-devel-announce にてリリースチームが発表します。リリー"
+"スチームが満足する程度に残っていた問題が修正された後、ディストリビューション"
+"ã\81\8cã\83ªã\83ªã\83¼ã\82¹ã\81\95ã\82\8cã\81¾ã\81\99ã\80\82ã\83ªã\83ªã\83¼ã\82¹ã\81¯ã\80\81<literal>ã\83\86ã\82¹ã\83\88ç\89\88 (testing)</literal> ã\81\8c"
+"<literal>安定版 (stable)</literal> へとリネームされる事を意味しており、"
+"<literal>テスト版 (testing)</literal> 用の新しいコピーが作成され、以前の"
+"<literal>安定版 (stable)</literal> は<literal>旧安定版 (oldstable)</literal> "
+"ã\81«ã\83ªã\83\8dã\83¼ã\83 ã\81\95ã\82\8cã\80\81æ\9c\80çµ\82ç\9a\84ã\81«ã\82¢ã\83¼ã\82«ã\82¤ã\83\96ã\81\95ã\82\8cã\82\8bã\81¾ã\81§å\98å\9c¨ã\81\97ã\81¦ã\81\84ã\81¾ã\81\99ã\80\82ã\82¢ã\83¼ã\82«ã\82¤ã\83\96ä½\9cæ¥ã\81§"
+"は、コンテンツは <literal>&archive-host;</literal> へと移動されます。"
# type: Content of: <chapter><section><section><section><para>
+#. type: Content of: <chapter><section><section><section><para>
#: resources.dbk:665
msgid ""
"This development cycle is based on the assumption that the "
"forth). Please refer to <link linkend=\"upload-stable\">uploads to the "
"<literal>stable</literal> distribution</link> for details."
msgstr ""
-"この開発サイクルは、<literal>不安定版 (unstable)</literal> ディストリビューション"
-"が、一定期間<literal>テスト版 (testing)</literal>を過ごした後で<literal>安定版 "
-"(stable)</literal>になる仮定に基づいています。一旦ディストリビューションが安定した"
-"と考えられたとしても、必然的にいくつかのバグは残っています — これが安定版ディストリ"
-"ビューションが時折更新されている理由です。しかし、これらの更新はとても注意深くテスト"
-"されており、新たなバグを招き入れるリスクを避けるためにそれぞれ個々にアーカイブに収録"
-"されるようになっています。<literal>安定版 (stable)</literal> への追加提案は、"
-"<filename>proposed-updates</filename> ディレクトリにて参照可能です。<filename>"
-"proposed-updates</filename> にある合格したこれらのパッケージは、定期的にまとめて"
-"安定版ディストリビューションに移動され、安定版ディストリビューションのリビジョン"
-"レベルが 1 つ増えることになります (例: ‘3.0’ は ‘3.0r1’ に、‘2.2r4’ は ‘2.2r5’ "
-"になり、以下同様)。詳細に付いては、<link linkend=\"upload-stable\"><literal>"
-"安定版 (stable)</literal> ディストリビューションへのアップロード</link>を参照して"
-"ください。"
+"この開発サイクルは、<literal>不安定版 (unstable)</literal> ディストリビュー"
+"ションが、一定期間<literal>テスト版 (testing)</literal>を過ごした後で"
+"<literal>安定版 (stable)</literal>になる仮定に基づいています。一旦ディストリ"
+"ビューションが安定したと考えられたとしても、必然的にいくつかのバグは残ってい"
+"ます — これが安定版ディストリビューションが時折更新されている理由です。しか"
+"し、これらの更新はとても注意深くテストされており、新たなバグを招き入れるリス"
+"クを避けるためにそれぞれ個々にアーカイブに収録されるようになっています。"
+"<literal>安定版 (stable)</literal> への追加提案は、<filename>proposed-"
+"updates</filename> ディレクトリにて参照可能です。<filename>proposed-updates</"
+"filename> にある合格したこれらのパッケージは、定期的にまとめて安定版ディスト"
+"リビューションに移動され、安定版ディストリビューションのリビジョンレベルが 1 "
+"つ増えることになります (例: ‘3.0’ は ‘3.0r1’ に、‘2.2r4’ は ‘2.2r5’ になり、"
+"以下同様)。詳細に付いては、<link linkend=\"upload-stable\"><literal>安定版 "
+"(stable)</literal> ディストリビューションへのアップロード</link>を参照してく"
+"ださい。"
# type: Content of: <chapter><section><section><section><para>
+#. type: Content of: <chapter><section><section><section><para>
#: resources.dbk:682
msgid ""
"Note that development under <literal>unstable</literal> continues during the "
"freeze period, since the <literal>unstable</literal> distribution remains in "
"place in parallel with <literal>testing</literal>."
msgstr ""
-"<literal>不安定版 (unstable)</literal>での開発はフリーズ期間中も続けられて"
-"ã\81\84ã\82\8bã\81\93ã\81¨ã\81«æ³¨æ\84\8fã\81\97ã\81¦ã\81\8fã\81 ã\81\95ã\81\84ã\80\82<literal>ä¸\8då®\89å®\9aç\89\88 (unstable)</literal> ã\83\87ã\82£ã\82¹ã\83\88"
-"ã\83ªã\83\93ã\83¥ã\83¼ã\82·ã\83§ã\83³ã\81¯<literal>ã\83\86ã\82¹ã\83\88ç\89\88 (testing)</literal> ã\81¨ã\81¯å¹³è¡\8cã\81\97ã\81\9fç\8a¶æ\85\8bã\81§ã\81\82"
-"ã\82\8aã\81¤ã\81¥ã\81\91ã\81¦ã\81\84ã\82\8bã\81\8bã\82\89ã\81§ã\81\99ã\80\82"
+"<literal>不安定版 (unstable)</literal>での開発はフリーズ期間中も続けられてい"
+"ã\82\8bã\81\93ã\81¨ã\81«æ³¨æ\84\8fã\81\97ã\81¦ã\81\8fã\81 ã\81\95ã\81\84ã\80\82<literal>ä¸\8då®\89å®\9aç\89\88 (unstable)</literal> ã\83\87ã\82£ã\82¹ã\83\88ã\83ª"
+"ã\83\93ã\83¥ã\83¼ã\82·ã\83§ã\83³ã\81¯<literal>ã\83\86ã\82¹ã\83\88ç\89\88 (testing)</literal> ã\81¨ã\81¯å¹³è¡\8cã\81\97ã\81\9fç\8a¶æ\85\8bã\81§ã\81\82ã\82\8aã\81¤"
+"づけているからです。"
# type: Content of: <chapter><section><section><section><title>
+#. type: Content of: <chapter><section><section><section><title>
#: resources.dbk:689
msgid "More information about the testing distribution"
msgstr "テスト版ディストリビューションについてのさらなる情報"
# type: Content of: <chapter><section><section><section><para>
+#. type: Content of: <chapter><section><section><section><para>
#: resources.dbk:691
msgid ""
"Packages are usually installed into the <literal>testing</literal> "
"distribution after they have undergone some degree of testing in "
"<literal>unstable</literal>."
msgstr ""
-"パッケージは通常、<literal>不安定版 (unstable)</literal> におけるテスト版"
-"への移行基準を満たした後で<literal>テスト版 (testing)</literal> ディストリビュー"
+"パッケージは通常、<literal>不安定版 (unstable)</literal> におけるテスト版への"
+"移行基準を満たした後で<literal>テスト版 (testing)</literal> ディストリビュー"
"ションへとインストールされます。"
# type: Content of: <chapter><section><section><section><para>
+#. type: Content of: <chapter><section><section><section><para>
#: resources.dbk:695
msgid ""
"For more details, please see the <link linkend=\"testing\">information about "
"についての情報</link>を参照してください。"
# type: Content of: <chapter><section><section><section><title>
+#. type: Content of: <chapter><section><section><section><title>
#: resources.dbk:701
msgid "Experimental"
msgstr "試験版 (experimental)"
# type: Content of: <chapter><section><section><section><para>
+#. type: Content of: <chapter><section><section><section><para>
#: resources.dbk:703
msgid ""
"The <literal>experimental</literal> distribution is a special distribution. "
"<literal>試験版 (experimental) </literal> は特殊なディストリビューションで"
"す。これは、`安定版' や `不安定版' と同じ意味での完全なディストリビューション"
"ではありません。その代わり、ソフトウェアがシステムを破壊する可能性がある、あ"
-"るいは<literal>不安定版</literal>ディストリビューションに導入することですら"
-"不安定過ぎる (だが、それにもかかわらず、パッケージにする理由はある) ものであ"
-"ã\82\8bã\82\88ã\81\86ã\81ªã\80\81ã\81¨ã\81¦ã\82\82å®\9fé¨\93ç\9a\84ã\81ªè¦\81ç´ ã\82\92å\90«ã\82\80ã\82½ã\83\95ã\83\88ã\82¦ã\82§ã\82¢ã\81®ä¸\80æ\99\82ç\9a\84ã\81ªç½®ã\81\8då ´ã\81§ã\81\82ã\82\8bã\81\93ã\81¨ã\82\92æ\84\8f"
-"味しています。<literal>試験版 (experimental)</literal> からパッケージをダウ"
-"ã\83³ã\83ã\83¼ã\83\89ã\81\97ã\81¦ã\82¤ã\83³ã\82¹ã\83\88ã\83¼ã\83«ã\81\99ã\82\8bã\83¦ã\83¼ã\82¶ã\81¯ã\80\81å\8d\81å\88\86ã\81«æ³¨æ\84\8fã\82\92å\8f\97ã\81\91ã\81¦ã\81\84ã\82\8bã\81®ã\82\92æ\9c\9få¾\85ã\81\95ã\82\8cã\81¦ã\81\84"
-"ã\81¾ã\81\99ã\80\82è¦\81ã\81\99ã\82\8bã\81«ã\80\81<literal>試é¨\93ç\89\88 (experimental)</literal> ã\83\87ã\82£ã\82¹ã\83\88ã\83ªã\83\93ã\83¥ã\83¼"
-"ã\82·ã\83§ã\83³ã\82\92å\88©ç\94¨ã\81\99ã\82\8bã\81¨ã\80\81ã\81©ã\81®ã\82\88ã\81\86ã\81«ã\81ªã\82\8bã\81\8bã\81¯å\85¨ã\81\8fã\82\8fã\81\8bã\82\89ã\81ªã\81\84ã\81¨ã\81\84ã\81\86ã\81\93ã\81¨ã\81§ã\81\99ã\80\82"
+"るいは<literal>不安定版</literal>ディストリビューションに導入することですら不"
+"安定過ぎる (だが、それにもかかわらず、パッケージにする理由はある) ものである"
+"ã\82\88ã\81\86ã\81ªã\80\81ã\81¨ã\81¦ã\82\82å®\9fé¨\93ç\9a\84ã\81ªè¦\81ç´ ã\82\92å\90«ã\82\80ã\82½ã\83\95ã\83\88ã\82¦ã\82§ã\82¢ã\81®ä¸\80æ\99\82ç\9a\84ã\81ªç½®ã\81\8då ´ã\81§ã\81\82ã\82\8bã\81\93ã\81¨ã\82\92æ\84\8få\91³"
+"しています。<literal>試験版 (experimental)</literal> からパッケージをダウン"
+"ã\83ã\83¼ã\83\89ã\81\97ã\81¦ã\82¤ã\83³ã\82¹ã\83\88ã\83¼ã\83«ã\81\99ã\82\8bã\83¦ã\83¼ã\82¶ã\81¯ã\80\81å\8d\81å\88\86ã\81«æ³¨æ\84\8fã\82\92å\8f\97ã\81\91ã\81¦ã\81\84ã\82\8bã\81®ã\82\92æ\9c\9få¾\85ã\81\95ã\82\8cã\81¦ã\81\84ã\81¾"
+"ã\81\99ã\80\82è¦\81ã\81\99ã\82\8bã\81«ã\80\81<literal>試é¨\93ç\89\88 (experimental)</literal> ã\83\87ã\82£ã\82¹ã\83\88ã\83ªã\83\93ã\83¥ã\83¼ã\82·ã\83§ã\83³"
+"を利用すると、どのようになるかは全くわからないということです。"
# type: Content of: <chapter><section><section><section><para>
+#. type: Content of: <chapter><section><section><section><para>
#: resources.dbk:715
msgid ""
"These are the <citerefentry> <refentrytitle>sources.list</refentrytitle> "
"literal>:"
msgstr ""
"以下が、<literal>試験版 (experimental)</literal> 用の <citerefentry> "
-"<refentrytitle>sources.list</refentrytitle> <manvolnum>5</manvolnum> "
-"</citerefentry>です:"
+"<refentrytitle>sources.list</refentrytitle> <manvolnum>5</manvolnum> </"
+"citerefentry>です:"
# type: Content of: <chapter><section><section><section><programlisting>
-#: resources.dbk:719
-#, no-wrap
+#. type: Content of: <chapter><section><section><section><programlisting>
+#: resources.dbk:720
+#, fuzzy, no-wrap
msgid ""
-"\n"
"deb http://ftp.<replaceable>xy</replaceable>.debian.org/debian/ experimental main\n"
"deb-src http://ftp.<replaceable>xy</replaceable>.debian.org/debian/ experimental main\n"
msgstr ""
"deb-src http://ftp.<replaceable>jp</replaceable>.debian.org/debian/ experimental main\n"
# type: Content of: <chapter><section><section><section><para>
+#. type: Content of: <chapter><section><section><section><para>
#: resources.dbk:724
msgid ""
"If there is a chance that the software could do grave damage to a system, it "
"instance, an experimental compressed file system should probably go into "
"<literal>experimental</literal>."
msgstr ""
-"ソフトウェアがシステムに多大なダメージを与える可能性がある場合、<literal>試"
-"験版 (experimental)</literal> へ配置する方が良いでしょう。例えば、実験的な圧"
-"縮ファイルシステムは恐らく<literal>試験版 (experimental)</literal> に行くこ"
-"ã\81¨ã\81«ã\81ªã\82\8bã\81§ã\81\97ã\82\87ã\81\86ã\80\82"
+"ソフトウェアがシステムに多大なダメージを与える可能性がある場合、<literal>試験"
+"版 (experimental)</literal> へ配置する方が良いでしょう。例えば、実験的な圧縮"
+"ファイルシステムは恐らく<literal>試験版 (experimental)</literal> に行くことに"
+"なるでしょう。"
# type: Content of: <chapter><section><section><section><para>
+#. type: Content of: <chapter><section><section><section><para>
#: resources.dbk:730
msgid ""
"Whenever there is a new upstream version of a package that introduces new "
"てしまう場合であれば、アップロードしないでおくか<literal>試験版 "
"(experimental)</literal> へアップロードするかしましょう。新しいバージョン、"
"ベータ版などで、利用する設定が完全に変わっているソフトウェアは、メンテナの配"
-"慮に従って<literal>試験版 (experimental)</literal> へ入れることができます。"
-"ã\82\82ã\81\97ã\82\82é\9d\9eäº\92æ\8f\9bæ\80§ã\82\84è¤\87é\9b\91ã\81ªã\82¢ã\83\83ã\83\97ã\82°ã\83¬ã\83¼ã\83\89対å¿\9cã\81«ã\81¤ã\81\84ã\81¦ä½\9cæ¥ã\81\97ã\81¦ã\81\84ã\82\8bå ´å\90\88ã\81ªã\81©ã\81¯ã\80\81"
-"<literal>試験版 (experimental)</literal> をステージングエリアとして利用する"
-"ã\81\93ã\81¨ã\81\8cã\81§ã\81\8dã\82\8bã\81®ã\81§ã\81\99ã\80\82ã\81\9dã\81®çµ\90æ\9e\9cã\80\81ã\83\86ã\82¹ã\83\88ã\83¦ã\83¼ã\82¶ã\81¯æ\97©æ\9c\9fã\81«æ\96°ã\81\97ã\81\84ã\83\90ã\83¼ã\82¸ã\83§ã\83³ã\81®å\88©ç\94¨ã\81\8cå\8f¯"
-"能になります。"
+"慮に従って<literal>試験版 (experimental)</literal> へ入れることができます。も"
+"しも非互換性や複雑なアップグレード対応について作業している場合などは、"
+"<literal>試験版 (experimental)</literal> をステージングエリアとして利用するこ"
+"ã\81¨ã\81\8cã\81§ã\81\8dã\82\8bã\81®ã\81§ã\81\99ã\80\82ã\81\9dã\81®çµ\90æ\9e\9cã\80\81ã\83\86ã\82¹ã\83\88ã\83¦ã\83¼ã\82¶ã\81¯æ\97©æ\9c\9fã\81«æ\96°ã\81\97ã\81\84ã\83\90ã\83¼ã\82¸ã\83§ã\83³ã\81®å\88©ç\94¨ã\81\8cå\8f¯è\83½"
+"になります。"
# type: Content of: <chapter><section><section><section><para>
# propagate
+#. type: Content of: <chapter><section><section><section><para>
#: resources.dbk:740
msgid ""
"Some experimental software can still go into <literal>unstable</literal>, "
"automatically removed once you upload the package in <literal>unstable</"
"literal> with a higher version number."
msgstr ""
-"試験版 (experimental) のソフトウェアは<literal>不安定版 (unstable)</"
-"literal> へ説明文に幾つかの警告を加えた上で入れることも可能ではありますが、"
-"ã\81\8aå\8b§ã\82\81ã\81¯ã\81§ã\81\8dã\81¾ã\81\9bã\82\93ã\80\82ã\81\9dã\82\8cã\81¯ã\80\81<literal>ä¸\8då®\89å®\9aç\89\88 (unstable)</literal> ã\81®ã\83\91ã\83\83"
-"ケージは<literal>テスト版 (testing)</literal> へ移行し、そして<literal>安"
-"定版 (stable)</literal> になることが期待されているからです。<literal>試験"
-"版 (experimental)</literal> を使うのをためらうべきではありません。何故なら "
+"試験版 (experimental) のソフトウェアは<literal>不安定版 (unstable)</literal> "
+"へ説明文に幾つかの警告を加えた上で入れることも可能ではありますが、お勧めはで"
+"ã\81\8dã\81¾ã\81\9bã\82\93ã\80\82ã\81\9dã\82\8cã\81¯ã\80\81<literal>ä¸\8då®\89å®\9aç\89\88 (unstable)</literal> ã\81®ã\83\91ã\83\83ã\82±ã\83¼ã\82¸ã\81¯"
+"<literal>テスト版 (testing)</literal> へ移行し、そして<literal>安定版 "
+"(stable)</literal> になることが期待されているからです。<literal>試験版 "
+"(experimental)</literal> を使うのをためらうべきではありません。何故なら "
"ftpmaster には何の苦痛も与えませんし、試験版 (experimental) のパッケージは一"
"旦<literal>不安定版 (unstable)</literal> により大きなバージョン番号でアップ"
"ロードされると自動的に削除されるからです。"
# type: Content of: <chapter><section><section><section><para>
+#. type: Content of: <chapter><section><section><section><para>
#: resources.dbk:750
msgid ""
"New software which isn't likely to damage your system can go directly into "
"(unstable)</literal> へ入れることが可能です。"
# type: Content of: <chapter><section><section><section><para>
+#. type: Content of: <chapter><section><section><section><para>
#: resources.dbk:754
msgid ""
"An alternative to <literal>experimental</literal> is to use your personal "
"<literal>people.debian.org</literal> 上の個人的な web ページを使うことです。"
# type: Content of: <chapter><section><section><section><para>
+#. type: Content of: <chapter><section><section><section><para>
#: resources.dbk:758
msgid ""
"When uploading to <literal>unstable</literal> a package which had bugs fixed "
"<literal>-v</literal> to <command>dpkg-buildpackage</command> to finally get "
"them closed."
msgstr ""
-"<literal>試験版 (experimental)</literal> のバグを修正したパッケージを<literal>"
-"不安定版 (unstable)</literal> にアップロードする際、最終的にバグをクローズするために"
-" <command>dpkg-buildpackage</command> で <literal>-v</literal> オプションの利用"
-"を検討してください。"
+"<literal>試験版 (experimental)</literal> のバグを修正したパッケージを"
+"<literal>不安定版 (unstable)</literal> にアップロードする際、最終的にバグをク"
+"ローズするために <command>dpkg-buildpackage</command> で <literal>-v</"
+"literal> オプションの利用を検討してください。"
# type: Content of: <chapter><section><section><title>
+#. type: Content of: <chapter><section><section><title>
#: resources.dbk:768
msgid "Release code names"
msgstr "リリースのコードネーム"
# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
#: resources.dbk:770
+#, fuzzy
msgid ""
"Every released Debian distribution has a <literal>code name</literal>: "
"Debian 1.1 is called <literal>buzz</literal>; Debian 1.2, <literal>rex</"
"literal>; Debian 1.3, <literal>bo</literal>; Debian 2.0, <literal>hamm</"
"literal>; Debian 2.1, <literal>slink</literal>; Debian 2.2, <literal>potato</"
"literal>; Debian 3.0, <literal>woody</literal>; Debian 3.1, <literal>sarge</"
-"literal>; Debian 4.0, <literal>etch</literal> and Debian 5.0 will be called "
-"<literal> lenny</literal>. There is also a ``pseudo-distribution'', called "
-"<literal>sid</literal>, which is the current <literal>unstable</literal> "
-"distribution; since packages are moved from <literal>unstable</literal> to "
-"<literal>testing</literal> as they approach stability, <literal>sid</"
-"literal> itself is never released. As well as the usual contents of a "
-"Debian distribution, <literal>sid</literal> contains packages for "
-"architectures which are not yet officially supported or released by Debian. "
-"These architectures are planned to be integrated into the mainstream "
-"distribution at some future date."
-msgstr ""
-"リリースされた Debian ディストリビューションは全て<literal>コードネーム</literal>"
-"を持っています： Debian 1.1 は <literal>buzz</literal>、Debian 1.2 は <literal>"
-"rex</literal>、Debian 1.3 は <literal>bo</literal>、Debian 2.0 は <literal>hamm"
-"</literal>、Debian 2.1 は <literal>slink</literal>、Debian 2.2 は "
-"<literal>potato</literal>、Debian 3.0 は <literal>woody</literal>、Debian 3.1 "
-"は <literal>sarge</literal>、Debian 4.0 は <literal>etch</literal> です。"
-"<literal>sid</literal> と呼ばれる「擬似ディストリビューション」もあり、これは現在の "
-"<literal>unstable</literal> ディストリビューションを指します。パッケージは安定に"
-"近づくと <literal>unstable</literal> から <literal>testing</literal> へと移動"
-"されるので、<literal>sid</literal> そのものは決してリリースされません。通常の Debian "
-"ディストリビューションの内容同様に、<literal>sid</literal> は Debian ではまだ公式に"
-"サポートあるいはリリースされていないアーキテクチャのパッケージを含んで"
-"います。これらのアーキテクチャは、いつか主流ディストリビューションに統合される予定です。"
-
-# type: Content of: <chapter><section><section><para>
-#: resources.dbk:787
+"literal>; Debian 4.0, <literal>etch</literal>; Debian 5.0, <literal>lenny</"
+"literal> and the next release will be called <literal>squeeze</literal>. "
+"There is also a ``pseudo-distribution'', called <literal>sid</literal>, "
+"which is the current <literal>unstable</literal> distribution; since "
+"packages are moved from <literal>unstable</literal> to <literal>testing</"
+"literal> as they approach stability, <literal>sid</literal> itself is never "
+"released. As well as the usual contents of a Debian distribution, "
+"<literal>sid</literal> contains packages for architectures which are not yet "
+"officially supported or released by Debian. These architectures are planned "
+"to be integrated into the mainstream distribution at some future date."
+msgstr ""
+"リリースされた Debian ディストリビューションは全て<literal>コードネーム</"
+"literal>を持っています： Debian 1.1 は <literal>buzz</literal>、Debian 1.2 "
+"は <literal>rex</literal>、Debian 1.3 は <literal>bo</literal>、Debian 2.0 "
+"は <literal>hamm</literal>、Debian 2.1 は <literal>slink</literal>、Debian "
+"2.2 は <literal>potato</literal>、Debian 3.0 は <literal>woody</literal>、"
+"Debian 3.1 は <literal>sarge</literal>、Debian 4.0 は <literal>etch</"
+"literal> です。<literal>sid</literal> と呼ばれる「擬似ディストリビューショ"
+"ン」もあり、これは現在の <literal>unstable</literal> ディストリビューションを"
+"指します。パッケージは安定に近づくと <literal>unstable</literal> から "
+"<literal>testing</literal> へと移動されるので、<literal>sid</literal> そのも"
+"のは決してリリースされません。通常の Debian ディストリビューションの内容同様"
+"に、<literal>sid</literal> は Debian ではまだ公式にサポートあるいはリリースさ"
+"れていないアーキテクチャのパッケージを含んでいます。これらのアーキテクチャ"
+"は、いつか主流ディストリビューションに統合される予定です。"
+
+# type: Content of: <chapter><section><section><para>
+#. type: Content of: <chapter><section><section><para>
+#: resources.dbk:788
msgid ""
"Since Debian has an open development model (i.e., everyone can participate "
"and follow the development) even the <literal>unstable</literal> and "
"the version is released, which would cause all FTP mirrors to re-retrieve "
"the whole distribution (which is quite large)."
msgstr ""
-"Debian はオープンな開発体制 (つまり、誰もが開発について参加／追いかけが可能) と"
-"ã\81ªã\81£ã\81¦ã\81\8aã\82\8aã\80\81<literal>ä¸\8då®\89å®\9aç\89\88 (unstable)</literal> ã\81\8aã\82\88ã\81³ <literal>ã\83\86ã\82¹ã\83\88ç\89\88 "
-"(testing)</literal> ディストリビューションすら Debian の FTP および HTTP サーバ"
-"ã\83\8dã\83\83ã\83\88ã\83¯ã\83¼ã\82¯ã\82\92é\80\9aã\81\98ã\81¦ã\82¤ã\83³ã\82¿ã\83¼ã\83\8dã\83\83ã\83\88ã\81¸æ\8f\90ä¾\9bã\81\95ã\82\8cã\81¦ã\81\84ã\81¾ã\81\99ã\80\82å¾\93ã\81£ã\81¦ã\80\81ã\83ªã\83ªã\83¼ã\82¹å\80\99è£\9cç\89\88ã\82\92å\90«ã\82\80"
-"ディレクトリを<literal>テスト版 (testing)</literal> と呼んだ場合、このバージョン"
-"がリリースされる際に<literal>安定版 (stable)</literal> へとリネームする必要がある"
-"ã\81¨ã\81\84ã\81\86ã\81\93ã\81¨ã\82\92æ\84\8få\91³ã\81\97ã\81¦ã\81\8aã\82\8aã\80\81ã\81\99ã\81¹ã\81¦ã\81® FTP ã\83\9fã\83©ã\83¼ã\81\8cã\83\87ã\82£ã\82¹ã\83\88ã\83ªã\83\93ã\83¥ã\83¼ã\82·ã\83§ã\83³ã\81\99ã\81¹ã\81¦ (ã\81¨ã\81¦ã\82\82"
-"巨大です) を再回収することになります。"
+"Debian はオープンな開発体制 (つまり、誰もが開発について参加／追いかけが可能) "
+"ã\81¨ã\81ªã\81£ã\81¦ã\81\8aã\82\8aã\80\81<literal>ä¸\8då®\89å®\9aç\89\88 (unstable)</literal> ã\81\8aã\82\88ã\81³ <literal>ã\83\86ã\82¹ã\83\88"
+"版 (testing)</literal> ディストリビューションすら Debian の FTP および HTTP "
+"ã\82µã\83¼ã\83\90ã\83\8dã\83\83ã\83\88ã\83¯ã\83¼ã\82¯ã\82\92é\80\9aã\81\98ã\81¦ã\82¤ã\83³ã\82¿ã\83¼ã\83\8dã\83\83ã\83\88ã\81¸æ\8f\90ä¾\9bã\81\95ã\82\8cã\81¦ã\81\84ã\81¾ã\81\99ã\80\82å¾\93ã\81£ã\81¦ã\80\81ã\83ªã\83ªã\83¼ã\82¹"
+"候補版を含むディレクトリを<literal>テスト版 (testing)</literal> と呼んだ場"
+"合、このバージョンがリリースされる際に<literal>安定版 (stable)</literal> へと"
+"ã\83ªã\83\8dã\83¼ã\83 ã\81\99ã\82\8bå¿\85è¦\81ã\81\8cã\81\82ã\82\8bã\81¨ã\81\84ã\81\86ã\81\93ã\81¨ã\82\92æ\84\8få\91³ã\81\97ã\81¦ã\81\8aã\82\8aã\80\81ã\81\99ã\81¹ã\81¦ã\81® FTP ã\83\9fã\83©ã\83¼ã\81\8cã\83\87ã\82£ã\82¹ã\83\88"
+"リビューションすべて (とても巨大です) を再回収することになります。"
# type: Content of: <chapter><section><section><para>
-#: resources.dbk:797
+#. type: Content of: <chapter><section><section><para>
+#: resources.dbk:798
msgid ""
"On the other hand, if we called the distribution directories <literal>Debian-"
"x.y</literal> from the beginning, people would think that Debian release "
"version. That's the reason why the first official Debian release was 1.1, "
"and not 1.0.)"
msgstr ""
-"一方、最初からディストリビューションディレクトリを <literal>Debian-x.y</literal> "
-"と呼んでいた場合、皆 Debian リリース <literal>x.y</literal> が利用可能になっている"
-"と考えるでしょう。(これは過去にあったことで、CD-ROM ベンダが Debian 1.0 の CD-ROM "
-"を pre-1.0 開発版を元に作成したことによります。これが。何故最初の公式 Debian の"
-"リリース版が 1.0 ではなく 1.1 であったかという理由です)。 "
+"一方、最初からディストリビューションディレクトリを <literal>Debian-x.y</"
+"literal> と呼んでいた場合、皆 Debian リリース <literal>x.y</literal> が利用可"
+"能になっていると考えるでしょう。(これは過去にあったことで、CD-ROM ベンダが "
+"Debian 1.0 の CD-ROM を pre-1.0 開発版を元に作成したことによります。これが。"
+"何故最初の公式 Debian のリリース版が 1.0 ではなく 1.1 であったかという理由で"
+"す)。 "
# type: Content of: <chapter><section><section><para>
-#: resources.dbk:805
+#. type: Content of: <chapter><section><section><para>
+#: resources.dbk:806
msgid ""
"Thus, the names of the distribution directories in the archive are "
"determined by their code names and not their release status (e.g., "
"<literal>stable</literal>, <literal>testing</literal>, and "
"<literal>unstable</literal> point to the appropriate release directories."
msgstr ""
-"従って、アーカイブ内のディストリビューションディレクトリの名前はリリースの状態では"
-"なくコードネームで決定されます (例えば `slink' など)。これらの名称は開発期間中と"
-"リリース後も同じものであり続けます。そして、簡単に変更可能なシンボリックリンクに"
-"ã\82\88ã\81£ã\81¦ã\80\81ç\8f¾å\9c¨ã\81®å®\89å®\9aç\89\88ã\83ªã\83ªã\83¼ã\82¹ã\83\87ã\82£ã\82¹ã\83\88ã\83ªã\83\93ã\83¥ã\83¼ã\82·ã\83§ã\83³ã\82\92示ã\81\99ã\81\93ã\81¨ã\81«ã\81ªã\82\8aã\81¾ã\81\99ã\80\82ã\81\93ã\82\8cã\81\8cã\80\81"
-"<literal>stable</literal>、<literal>testing</literal>、<literal>unstable"
-"</literal> へのシンボリックリンクがそれぞれ相応しいリリースディレクトリを指して"
-"ã\81\84ã\82\8bã\81®ã\81«å¯¾ã\81\97ã\81¦ã\80\81å®\9fé\9a\9bã\81®ã\83\87ã\82£ã\82¹ã\83\88ã\83ªã\83\93ã\83¥ã\83¼ã\82·ã\83§ã\83³ã\83\87ã\82£ã\83¬ã\82¯ã\83\88ã\83ªã\81§ã\81¯<literal>ã\82³ã\83¼ã\83\89ã\83\8dã\83¼ã\83 "
-"</literal>を使っている理由です。"
+"従って、アーカイブ内のディストリビューションディレクトリの名前はリリースの状"
+"態ではなくコードネームで決定されます (例えば `slink' など)。これらの名称は開"
+"発期間中とリリース後も同じものであり続けます。そして、簡単に変更可能なシンボ"
+"ã\83ªã\83\83ã\82¯ã\83ªã\83³ã\82¯ã\81«ã\82\88ã\81£ã\81¦ã\80\81ç\8f¾å\9c¨ã\81®å®\89å®\9aç\89\88ã\83ªã\83ªã\83¼ã\82¹ã\83\87ã\82£ã\82¹ã\83\88ã\83ªã\83\93ã\83¥ã\83¼ã\82·ã\83§ã\83³ã\82\92示ã\81\99ã\81\93ã\81¨ã\81«"
+"なります。これが、<literal>stable</literal>、<literal>testing</literal>、"
+"<literal>unstable</literal> へのシンボリックリンクがそれぞれ相応しいリリース"
+"ã\83\87ã\82£ã\83¬ã\82¯ã\83\88ã\83ªã\82\92æ\8c\87ã\81\97ã\81¦ã\81\84ã\82\8bã\81®ã\81«å¯¾ã\81\97ã\81¦ã\80\81å®\9fé\9a\9bã\81®ã\83\87ã\82£ã\82¹ã\83\88ã\83ªã\83\93ã\83¥ã\83¼ã\82·ã\83§ã\83³ã\83\87ã\82£ã\83¬ã\82¯ã\83\88ã\83ª"
+"では<literal>コードネーム</literal>を使っている理由です。"
# type: Content of: <chapter><section><title>
-#: resources.dbk:819
+#. type: Content of: <chapter><section><title>
+#: resources.dbk:820
msgid "Debian mirrors"
msgstr "Debian ミラーサーバ"
# type: Content of: <chapter><section><para>
-#: resources.dbk:821
+#. type: Content of: <chapter><section><para>
+#: resources.dbk:822
msgid ""
"The various download archives and the web site have several mirrors "
"available in order to relieve our canonical servers from heavy load. In "
msgstr ""
# type: Content of: <chapter><section><para>
-#: resources.dbk:832
+#. type: Content of: <chapter><section><para>
+#: resources.dbk:833
msgid ""
"All the information on Debian mirrors, including a list of the available "
"public FTP/HTTP servers, can be found at <ulink url=\"&url-debian-mirrors;"
"定することに興味を持った場合に役立つ情報とツールも含まれています。"
# type: Content of: <chapter><section><para>
-#: resources.dbk:839
+#. type: Content of: <chapter><section><para>
+#: resources.dbk:840
msgid ""
"Note that mirrors are generally run by third-parties who are interested in "
"helping Debian. As such, developers generally do not have accounts on these "
"ウントを持ってはいません。"
# type: Content of: <chapter><section><title>
-#: resources.dbk:846
+#. type: Content of: <chapter><section><title>
+#: resources.dbk:847
msgid "The Incoming system"
msgstr "Incoming システム"
# type: Content of: <chapter><section><para>
-#: resources.dbk:848
+#. type: Content of: <chapter><section><para>
+#: resources.dbk:849
msgid ""
"The Incoming system is responsible for collecting updated packages and "
"installing them in the Debian archive. It consists of a set of directories "
msgstr ""
# type: Content of: <chapter><section><para>
-#: resources.dbk:853
+#. type: Content of: <chapter><section><para>
+#: resources.dbk:854
msgid ""
"Packages are uploaded by all the maintainers into a directory called "
"<filename>UploadQueue</filename>. This directory is scanned every few "
msgstr ""
# type: Content of: <chapter><section><para>
-#: resources.dbk:872
+#. type: Content of: <chapter><section><para>
+#: resources.dbk:873
msgid ""
"Once the package is accepted, the system sends a confirmation mail to the "
"maintainer and closes all the bugs marked as fixed by the upload, and the "
msgstr ""
# type: Content of: <chapter><section><para>
-#: resources.dbk:884
+#. type: Content of: <chapter><section><para>
+#: resources.dbk:885
msgid ""
"The archive maintenance software will also send the OpenPGP/GnuPG signed "
"<filename>.changes</filename> file that you uploaded to the appropriate "
msgstr ""
# type: Content of: <chapter><section><para>
-#: resources.dbk:894
+#. type: Content of: <chapter><section><para>
+#: resources.dbk:895
msgid ""
"Though ftp-master is restricted, a copy of the installation is available to "
"all developers on <literal>&ftp-master-mirror;</literal>."
msgstr ""
-"ftp-master は利用が制限されているサーバなので、インストールされたもののコピーは "
-"<literal>&ftp-master-mirror;</literal> 上で全ての開発者が利用できるようになって"
-"います。"
-
+"ftp-master は利用が制限されているサーバなので、インストールされたもののコピー"
+"は <literal>&ftp-master-mirror;</literal> 上で全ての開発者が利用できるように"
+"なっています。"
# type: Content of: <chapter><section><title>
-#: resources.dbk:957
+#. type: Content of: <chapter><section><title>
+#: resources.dbk:958
msgid "Package information"
msgstr "パッケージ情報"
# type: Content of: <chapter><section><section><title>
-#: resources.dbk:959
+#. type: Content of: <chapter><section><section><title>
+#: resources.dbk:960
msgid "On the web"
msgstr "ウェブ上から"
# type: Content of: <chapter><section><section><para>
-#: resources.dbk:961
+#. type: Content of: <chapter><section><section><para>
+#: resources.dbk:962
msgid ""
"Each package has several dedicated web pages. <literal>http://&packages-"
"host;/<replaceable>package-name</replaceable></literal> displays each "
"links to a page which provides information, including the package "
"description, the dependencies, and package download links."
msgstr ""
-"パッケージはそれぞれ複数の目的別のウェブページを持っています。<literal>"
-"http://&packages-host;/<replaceable>package-name</replaceable></literal> は"
-"各ディストリビューション中でそれぞれ利用可能なパッケージバージョンを表示します。"
-"ã\83\90ã\83¼ã\82¸ã\83§ã\83³æ¯\8eã\81®ã\83ªã\83³ã\82¯å\85\88ã\81®ã\83\9aã\83¼ã\82¸ã\81¯ã\83\91ã\83\83ã\82±ã\83¼ã\82¸ã\81®èª¬æ\98\8eã\80\81ä¾\9då\98é\96¢ä¿\82ã\80\81ã\83\80ã\82¦ã\83³ã\83ã\83¼ã\83\89ã\81¸ã\81®ã\83ªã\83³ã\82¯"
-"を含んだ情報を提供しています。"
+"パッケージはそれぞれ複数の目的別のウェブページを持っています。"
+"<literal>http://&packages-host;/<replaceable>package-name</replaceable></"
+"literal> は各ディストリビューション中でそれぞれ利用可能なパッケージバージョン"
+"ã\82\92表示ã\81\97ã\81¾ã\81\99ã\80\82ã\83\90ã\83¼ã\82¸ã\83§ã\83³æ¯\8eã\81®ã\83ªã\83³ã\82¯å\85\88ã\81®ã\83\9aã\83¼ã\82¸ã\81¯ã\83\91ã\83\83ã\82±ã\83¼ã\82¸ã\81®èª¬æ\98\8eã\80\81ä¾\9då\98é\96¢ä¿\82ã\80\81ã\83\80"
+"ã\82¦ã\83³ã\83ã\83¼ã\83\89ã\81¸ã\81®ã\83ªã\83³ã\82¯ã\82\92å\90«ã\82\93ã\81 æ\83\85å ±ã\82\92æ\8f\90ä¾\9bã\81\97ã\81¦ã\81\84ã\81¾ã\81\99ã\80\82"
# type: Content of: <chapter><section><section><para>
-#: resources.dbk:968
+#. type: Content of: <chapter><section><section><para>
+#: resources.dbk:969
msgid ""
"The bug tracking system tracks bugs for each package. You can view the bugs "
"of a given package at the URL <literal>http://&bugs-host;/"
"<replaceable>package-name</replaceable></literal>."
msgstr ""
-"バグ追跡システムは個々のパッケージのバグを記録していきます。"
-"<literal>http://&bugs-host;/<replaceable>package-name</replaceable></literal> "
-"というような URL で与えたパッケージ名のバグを閲覧できます。"
+"バグ追跡システムは個々のパッケージのバグを記録していきます。<literal>http://"
+"&bugs-host;/<replaceable>package-name</replaceable></literal> というような "
+"URL で与えたパッケージ名のバグを閲覧できます。"
# type: Content of: <chapter><section><section><title>
-#: resources.dbk:975
+#. type: Content of: <chapter><section><section><title>
+#: resources.dbk:976
msgid "The <command>dak ls</command> utility"
msgstr "<command>dak ls</command> ユーティリティ"
# type: Content of: <chapter><section><section><para>
-#: resources.dbk:977
+#. type: Content of: <chapter><section><section><para>
+#: resources.dbk:978
msgid ""
"<command>dak ls</command> is part of the dak suite of tools, listing "
"available package versions for all known distributions and architectures. "
-"The <command>dak</command> tool is available on <literal>&ftp-master-host; "
-"</literal>, and on the mirror on <literal>&ftp-master-mirror;</literal>. It "
+"The <command>dak</command> tool is available on <literal>&ftp-master-host; </"
+"literal>, and on the mirror on <literal>&ftp-master-mirror;</literal>. It "
"uses a single argument corresponding to a package name. An example will "
"explain it better:"
msgstr ""
-"<command>dak ls</command> は dak ツールスイートの一部で、全ディストリビューション"
-"およびアーキテクチャの中から利用可能なパッケージバージョンをリストアップします。"
-"<command>dak</command> ツールは <literal>&ftp-master-host;</literal> 上と、"
-"<literal>&ftp-master-mirror;</literal> 上のミラーにて利用できます。パッケージ名に"
-"対応する一つの引数を使います。実際に例を挙げた方が分かりやすいでしょう:"
+"<command>dak ls</command> は dak ツールスイートの一部で、全ディストリビュー"
+"ションおよびアーキテクチャの中から利用可能なパッケージバージョンをリストアッ"
+"プします。<command>dak</command> ツールは <literal>&ftp-master-host;</"
+"literal> 上と、<literal>&ftp-master-mirror;</literal> 上のミラーにて利用でき"
+"ます。パッケージ名に対応する一つの引数を使います。実際に例を挙げた方が分かり"
+"やすいでしょう:"
# type: Content of: <chapter><section><section><screen>
-#: resources.dbk:984
-#, no-wrap
+#. type: Content of: <chapter><section><section><screen>
+#: resources.dbk:986
+#, fuzzy, no-wrap
msgid ""
-"\n"
"$ dak ls evince\n"
-"evince | 0.1.5-2sarge1 | oldstable | source, alpha, arm, hppa, i386, "
-"ia64, m68k, mips, mipsel, powerpc, s390, sparc\n"
+"evince | 0.1.5-2sarge1 | oldstable | source, alpha, arm, hppa, i386, ia64, m68k, mips, mipsel, powerpc, s390, sparc\n"
"evince | 0.4.0-5 | etch-m68k | source, m68k\n"
-"evince | 0.4.0-5 | stable | source, alpha, amd64, arm, hppa, i386, "
-"ia64, mips, mipsel, powerpc, s390, sparc\n"
+"evince | 0.4.0-5 | stable | source, alpha, amd64, arm, hppa, i386, ia64, mips, mipsel, powerpc, s390, sparc\n"
"evince | 2.20.2-1 | testing | source\n"
-"evince | 2.20.2-1+b1 | testing | alpha, amd64, arm, armel, hppa, i386, "
-"ia64, mips, mipsel, powerpc, s390, sparc\n"
-"evince | 2.22.2-1 | unstable | source, alpha, amd64, arm, armel, "
-"hppa, i386, ia64, m68k, mips, mipsel, powerpc, s390, sparc\n"
+"evince | 2.20.2-1+b1 | testing | alpha, amd64, arm, armel, hppa, i386, ia64, mips, mipsel, powerpc, s390, sparc\n"
+"evince | 2.22.2-1 | unstable | source, alpha, amd64, arm, armel, hppa, i386, ia64, m68k, mips, mipsel, powerpc, s390, sparc\n"
msgstr ""
"\n"
"$ dak ls evince\n"
-"evince | 0.1.5-2sarge1 | oldstable | source, alpha, arm, hppa, i386, "
-"ia64, m68k, mips, mipsel, powerpc, s390, sparc\n"
+"evince | 0.1.5-2sarge1 | oldstable | source, alpha, arm, hppa, i386, ia64, m68k, mips, mipsel, powerpc, s390, sparc\n"
"evince | 0.4.0-5 | etch-m68k | source, m68k\n"
-"evince | 0.4.0-5 | stable | source, alpha, amd64, arm, hppa, i386, "
-"ia64, mips, mipsel, powerpc, s390, sparc\n"
+"evince | 0.4.0-5 | stable | source, alpha, amd64, arm, hppa, i386, ia64, mips, mipsel, powerpc, s390, sparc\n"
"evince | 2.20.2-1 | testing | source\n"
-"evince | 2.20.2-1+b1 | testing | alpha, amd64, arm, armel, hppa, i386, "
-"ia64, mips, mipsel, powerpc, s390, sparc\n"
-"evince | 2.22.2-1 | unstable | source, alpha, amd64, arm, armel, "
-"hppa, i386, ia64, m68k, mips, mipsel, powerpc, s390, sparc\n"
+"evince | 2.20.2-1+b1 | testing | alpha, amd64, arm, armel, hppa, i386, ia64, mips, mipsel, powerpc, s390, sparc\n"
+"evince | 2.22.2-1 | unstable | source, alpha, amd64, arm, armel, hppa, i386, ia64, m68k, mips, mipsel, powerpc, s390, sparc\n"
# type: Content of: <chapter><section><section><para>
-#: resources.dbk:994
+#. type: Content of: <chapter><section><section><para>
+#: resources.dbk:995
msgid ""
"In this example, you can see that the version in <literal>unstable</literal> "
"differs from the version in <literal>testing</literal> and that there has "
"of the package has been recompiled on all architectures."
msgstr ""
"この例では、<literal>不安定版 (unstable)</literal> でのバージョンは <literal>"
-"テスト版 (testing)</literal> のバージョンと違っており、テスト版のパッケージは全"
-"アーキテクチャについて、binary-only NMU されたパッケージになっています。それぞれ"
-"のバージョンのパッケージは、全アーキテクチャ上で再コンパイルされています。"
+"テスト版 (testing)</literal> のバージョンと違っており、テスト版のパッケージは"
+"全アーキテクチャについて、binary-only NMU されたパッケージになっています。そ"
+"れぞれのバージョンのパッケージは、全アーキテクチャ上で再コンパイルされていま"
+"す。"
# type: Content of: <chapter><section><title>
-#: resources.dbk:1004
+#. type: Content of: <chapter><section><title>
+#: resources.dbk:1005
msgid "The Package Tracking System"
msgstr "パッケージ追跡システム"
# type: Content of: <chapter><section><para>
-#: resources.dbk:1006
+#. type: Content of: <chapter><section><para>
+#: resources.dbk:1007
msgid ""
"The Package Tracking System (PTS) is an email-based tool to track the "
"activity of a source package. This really means that you can get the same "
msgstr ""
# type: Content of: <chapter><section><para>
-#: resources.dbk:1011
+#. type: Content of: <chapter><section><para>
+#: resources.dbk:1012
msgid ""
"Each email sent through the PTS is classified under one of the keywords "
"listed below. This will let you select the mails that you want to receive."
msgstr ""
# type: Content of: <chapter><section><para>
-#: resources.dbk:1015
+#. type: Content of: <chapter><section><para>
+#: resources.dbk:1016
msgid "By default you will get:"
msgstr ""
# type: Content of: <chapter><section><variablelist><varlistentry><term>
-#: resources.dbk:1019
+#. type: Content of: <chapter><section><variablelist><varlistentry><term>
+#: resources.dbk:1020
msgid "<literal>bts</literal>"
msgstr "<literal>bts</literal>"
# type: Content of: <chapter><section><variablelist><varlistentry><listitem><para>
-#: resources.dbk:1022
+#. type: Content of: <chapter><section><variablelist><varlistentry><listitem><para>
+#: resources.dbk:1023
msgid "All the bug reports and following discussions."
msgstr ""
# type: Content of: <chapter><section><variablelist><varlistentry><term>
-#: resources.dbk:1027
+#. type: Content of: <chapter><section><variablelist><varlistentry><term>
+#: resources.dbk:1028
msgid "<literal>bts-control</literal>"
msgstr "<literal>bts-control</literal>"
# type: Content of: <chapter><section><variablelist><varlistentry><listitem><para>
-#: resources.dbk:1030
+#. type: Content of: <chapter><section><variablelist><varlistentry><listitem><para>
+#: resources.dbk:1031
msgid ""
"The email notifications from <email>control@&bugs-host;</email> about bug "
"report status changes."
msgstr ""
# type: Content of: <chapter><section><variablelist><varlistentry><term>
-#: resources.dbk:1036
+#. type: Content of: <chapter><section><variablelist><varlistentry><term>
+#: resources.dbk:1037
msgid "<literal>upload-source</literal>"
msgstr "<literal>upload-source</literal>"
# type: Content of: <chapter><section><variablelist><varlistentry><listitem><para>
-#: resources.dbk:1039
+#. type: Content of: <chapter><section><variablelist><varlistentry><listitem><para>
+#: resources.dbk:1040
msgid ""
"The email notification from <command>katie</command> when an uploaded source "
"package is accepted."
msgstr ""
# type: Content of: <chapter><section><variablelist><varlistentry><term>
-#: resources.dbk:1045
+#. type: Content of: <chapter><section><variablelist><varlistentry><term>
+#: resources.dbk:1046
msgid "<literal>katie-other</literal>"
msgstr "<literal>katie-other</literal>"
# type: Content of: <chapter><section><variablelist><varlistentry><listitem><para>
-#: resources.dbk:1048
+#. type: Content of: <chapter><section><variablelist><varlistentry><listitem><para>
+#: resources.dbk:1049
msgid ""
"Other warning and error emails from <command>katie</command> (such as an "
"override disparity for the section and/or the priority field)."
msgstr ""
# type: Content of: <chapter><section><variablelist><varlistentry><term>
-#: resources.dbk:1054
+#. type: Content of: <chapter><section><variablelist><varlistentry><term>
+#: resources.dbk:1055
msgid "<literal>default</literal>"
msgstr "<literal>default</literal>"
# type: Content of: <chapter><section><variablelist><varlistentry><listitem><para>
-#: resources.dbk:1057
+#. type: Content of: <chapter><section><variablelist><varlistentry><listitem><para>
+#: resources.dbk:1058
msgid ""
"Any non-automatic email sent to the PTS by people who wanted to contact the "
"subscribers of the package. This can be done by sending mail to "
msgstr ""
# type: Content of: <chapter><section><variablelist><varlistentry><term>
-#: resources.dbk:1066
+#. type: Content of: <chapter><section><variablelist><varlistentry><term>
+#: resources.dbk:1067
msgid "<literal>contact</literal>"
msgstr "<literal>contact</literal>"
# type: Content of: <chapter><section><variablelist><varlistentry><listitem><para>
-#: resources.dbk:1069
+#. type: Content of: <chapter><section><variablelist><varlistentry><listitem><para>
+#: resources.dbk:1070
msgid ""
"Mails sent to the maintainer through the *@packages.debian.org email aliases."
msgstr ""
# type: Content of: <chapter><section><variablelist><varlistentry><term>
-#: resources.dbk:1075
+#. type: Content of: <chapter><section><variablelist><varlistentry><term>
+#: resources.dbk:1076
msgid "<literal>summary</literal>"
msgstr "<literal>summary</literal>"
# type: Content of: <chapter><section><variablelist><varlistentry><listitem><para>
-#: resources.dbk:1078
+#. type: Content of: <chapter><section><variablelist><varlistentry><listitem><para>
+#: resources.dbk:1079
msgid ""
"Regular summary emails about the package's status. Currently, only "
"progression in <literal>testing</literal> is sent."
msgstr ""
# type: Content of: <chapter><section><para>
-#: resources.dbk:1085
+#. type: Content of: <chapter><section><para>
+#: resources.dbk:1086
msgid "You can also decide to receive additional information:"
msgstr ""
# type: Content of: <chapter><section><variablelist><varlistentry><term>
-#: resources.dbk:1089
+#. type: Content of: <chapter><section><variablelist><varlistentry><term>
+#: resources.dbk:1090
msgid "<literal>upload-binary</literal>"
msgstr "<literal>upload-binary</literal>"
# type: Content of: <chapter><section><variablelist><varlistentry><listitem><para>
-#: resources.dbk:1092
+#. type: Content of: <chapter><section><variablelist><varlistentry><listitem><para>
+#: resources.dbk:1093
msgid ""
"The email notification from <command>katie</command> when an uploaded binary "
"package is accepted. In other words, whenever a build daemon or a porter "
msgstr ""
# type: Content of: <chapter><section><variablelist><varlistentry><term>
-#: resources.dbk:1100
+#. type: Content of: <chapter><section><variablelist><varlistentry><term>
+#: resources.dbk:1101
msgid "<literal>cvs</literal>"
msgstr "<literal>cvs</literal>"
# type: Content of: <chapter><section><variablelist><varlistentry><listitem><para>
-#: resources.dbk:1103
+#. type: Content of: <chapter><section><variablelist><varlistentry><listitem><para>
+#: resources.dbk:1104
msgid ""
"VCS commit notifications, if the package has a VCS repository and the "
"maintainer has set up forwarding of commit notifications to the PTS. The "
msgstr ""
# type: Content of: <chapter><section><variablelist><varlistentry><term>
-#: resources.dbk:1111
+#. type: Content of: <chapter><section><variablelist><varlistentry><term>
+#: resources.dbk:1112
msgid "<literal>ddtp</literal>"
msgstr "<literal>ddtp</literal>"
# type: Content of: <chapter><section><variablelist><varlistentry><listitem><para>
-#: resources.dbk:1114
+#. type: Content of: <chapter><section><variablelist><varlistentry><listitem><para>
+#: resources.dbk:1115
msgid ""
"Translations of descriptions or debconf templates submitted to the Debian "
"Description Translation Project."
msgstr ""
# type: Content of: <chapter><section><variablelist><varlistentry><term>
-#: resources.dbk:1120
+#. type: Content of: <chapter><section><variablelist><varlistentry><term>
+#: resources.dbk:1121
msgid "<literal>derivatives</literal>"
msgstr "<literal>derivatives</literal>"
# type: Content of: <chapter><section><variablelist><varlistentry><listitem><para>
-#: resources.dbk:1123
+#. type: Content of: <chapter><section><variablelist><varlistentry><listitem><para>
+#: resources.dbk:1124
msgid ""
"Information about changes made to the package in derivative distributions "
"(for example Ubuntu)."
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: resources.dbk:1130
+#. type: Content of: <chapter><section><section><title>
+#: resources.dbk:1131
msgid "The PTS email interface"
msgstr "PTS メールインターフェイス"
# type: Content of: <chapter><section><section><para>
-#: resources.dbk:1132
+#. type: Content of: <chapter><section><section><para>
+#: resources.dbk:1133
msgid ""
"You can control your subscription(s) to the PTS by sending various commands "
"to <email>pts@qa.debian.org</email>."
msgstr ""
# type: Content of: <chapter><section><section><variablelist><varlistentry><term>
-#: resources.dbk:1137
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><term>
+#: resources.dbk:1138
msgid "<literal>subscribe <sourcepackage> [<email>]</literal>"
msgstr "<literal>subscribe <sourcepackage> [<email>]</literal>"
# type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><para>
-#: resources.dbk:1140
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><para>
+#: resources.dbk:1141
msgid ""
"Subscribes <replaceable>email</replaceable> to communications related to the "
"source package <replaceable>sourcepackage</replaceable>. Sender address is "
msgstr ""
# type: Content of: <chapter><section><section><variablelist><varlistentry><term>
-#: resources.dbk:1150
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><term>
+#: resources.dbk:1151
msgid "<literal>unsubscribe <sourcepackage> [<email>]</literal>"
msgstr "<literal>unsubscribe <sourcepackage> [<email>]</literal>"
# type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><para>
-#: resources.dbk:1153
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><para>
+#: resources.dbk:1154
msgid ""
"Removes a previous subscription to the source package "
"<replaceable>sourcepackage</replaceable> using the specified email address "
msgstr ""
# type: Content of: <chapter><section><section><variablelist><varlistentry><term>
-#: resources.dbk:1160
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><term>
+#: resources.dbk:1161
msgid "<literal>unsubscribeall [<email>]</literal>"
msgstr "<literal>unsubscribeall [<email>]</literal>"
# type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><para>
-#: resources.dbk:1163
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><para>
+#: resources.dbk:1164
msgid ""
"Removes all subscriptions of the specified email address or the sender "
"address if the second argument is left out."
msgstr ""
# type: Content of: <chapter><section><section><variablelist><varlistentry><term>
-#: resources.dbk:1169
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><term>
+#: resources.dbk:1170
msgid "<literal>which [<email>]</literal>"
msgstr "<literal>which [<email>]</literal>"
# type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><para>
-#: resources.dbk:1172
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><para>
+#: resources.dbk:1173
msgid ""
"Lists all subscriptions for the sender or the email address optionally "
"specified."
msgstr ""
# type: Content of: <chapter><section><section><variablelist><varlistentry><term>
-#: resources.dbk:1178
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><term>
+#: resources.dbk:1179
msgid "<literal>keyword [<email>]</literal>"
msgstr "<literal>keyword [<email>]</literal>"
# type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><para>
-#: resources.dbk:1181
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><para>
+#: resources.dbk:1182
msgid ""
"Tells you the keywords that you are accepting. For an explanation of "
"keywords, <link linkend=\"pkg-tracking-system\">see above</link>. Here's a "
msgstr ""
# type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><itemizedlist><listitem><para>
-#: resources.dbk:1188
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><itemizedlist><listitem><para>
+#: resources.dbk:1189
msgid ""
"<literal>bts</literal>: mails coming from the Debian Bug Tracking System"
msgstr "<literal>bts</literal>: Debian バグ追跡システムからのメール"
# type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><itemizedlist><listitem><para>
-#: resources.dbk:1193
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><itemizedlist><listitem><para>
+#: resources.dbk:1194
msgid ""
"<literal>bts-control</literal>: reply to mails sent to &email-bts-control;"
msgstr ""
# type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><itemizedlist><listitem><para>
-#: resources.dbk:1199
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><itemizedlist><listitem><para>
+#: resources.dbk:1200
msgid ""
"<literal>summary</literal>: automatic summary mails about the state of a "
"package"
msgstr ""
# type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><itemizedlist><listitem><para>
-#: resources.dbk:1205
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><itemizedlist><listitem><para>
+#: resources.dbk:1206
msgid ""
"<literal>contact</literal>: mails sent to the maintainer through the "
"*@packages.debian.org aliases"
msgstr ""
# type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><itemizedlist><listitem><para>
-#: resources.dbk:1211
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><itemizedlist><listitem><para>
+#: resources.dbk:1212
msgid "<literal>cvs</literal>: notification of VCS commits"
msgstr "<literal>cvs</literal>: VCS へのコミットを知らせます"
# type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><itemizedlist><listitem><para>
-#: resources.dbk:1216
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><itemizedlist><listitem><para>
+#: resources.dbk:1217
msgid ""
"<literal>ddtp</literal>: translations of descriptions and debconf templates"
msgstr ""
# type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><itemizedlist><listitem><para>
-#: resources.dbk:1221
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><itemizedlist><listitem><para>
+#: resources.dbk:1222
msgid ""
"<literal>derivatives</literal>: changes made on the package by derivative "
"distributions"
msgstr ""
# type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><itemizedlist><listitem><para>
-#: resources.dbk:1227
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><itemizedlist><listitem><para>
+#: resources.dbk:1228
msgid ""
"<literal>upload-source</literal>: announce of a new source upload that has "
"been accepted"
msgstr ""
# type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><itemizedlist><listitem><para>
-#: resources.dbk:1233
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><itemizedlist><listitem><para>
+#: resources.dbk:1234
msgid ""
"<literal>upload-binary</literal>: announce of a new binary-only upload "
"(porting)"
msgstr ""
# type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><itemizedlist><listitem><para>
-#: resources.dbk:1239
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><itemizedlist><listitem><para>
+#: resources.dbk:1240
msgid ""
"<literal>katie-other</literal>: other mails from ftpmasters (override "
"disparity, etc.)"
msgstr ""
# type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><itemizedlist><listitem><para>
-#: resources.dbk:1245
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><itemizedlist><listitem><para>
+#: resources.dbk:1246
msgid ""
"<literal>default</literal>: all the other mails (those which aren't "
"automatic)"
msgstr ""
# type: Content of: <chapter><section><section><variablelist><varlistentry><term>
-#: resources.dbk:1252
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><term>
+#: resources.dbk:1253
msgid "<literal>keyword <sourcepackage> [<email>]</literal>"
msgstr ""
# type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><para>
-#: resources.dbk:1255
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><para>
+#: resources.dbk:1256
msgid ""
"Same as the previous item but for the given source package, since you may "
"select a different set of keywords for each source package."
msgstr ""
# type: Content of: <chapter><section><section><variablelist><varlistentry><term>
-#: resources.dbk:1261
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><term>
+#: resources.dbk:1262
msgid ""
"<literal>keyword [<email>] {+|-|=} <list of keywords></literal>"
msgstr ""
"<literal>keyword [<email>] {+|-|=} <list of keywords></literal>"
# type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><para>
-#: resources.dbk:1264
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><para>
+#: resources.dbk:1265
msgid ""
"Accept (+) or refuse (-) mails classified under the given keyword(s). "
"Define the list (=) of accepted keywords. This changes the default set of "
msgstr ""
# type: Content of: <chapter><section><section><variablelist><varlistentry><term>
-#: resources.dbk:1271
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><term>
+#: resources.dbk:1272
msgid ""
"<literal>keywordall [<email>] {+|-|=} <list of keywords></"
"literal>"
"literal>"
# type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><para>
-#: resources.dbk:1274
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><para>
+#: resources.dbk:1275
msgid ""
"Accept (+) or refuse (-) mails classified under the given keyword(s). "
"Define the list (=) of accepted keywords. This changes the set of accepted "
msgstr ""
# type: Content of: <chapter><section><section><variablelist><varlistentry><term>
-#: resources.dbk:1281
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><term>
+#: resources.dbk:1282
msgid ""
"<literal>keyword <sourcepackage> [<email>] {+|-|=} <list of "
"keywords></literal>"
"keywords></literal>"
# type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><para>
-#: resources.dbk:1284
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><para>
+#: resources.dbk:1285
msgid ""
"Same as previous item but overrides the keywords list for the indicated "
"source package."
msgstr ""
# type: Content of: <chapter><section><section><variablelist><varlistentry><term>
-#: resources.dbk:1290
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><term>
+#: resources.dbk:1291
msgid "<literal>quit | thanks | --</literal>"
msgstr "<literal>quit | thanks | --</literal>"
# type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><para>
-#: resources.dbk:1293
+#. type: Content of: <chapter><section><section><variablelist><varlistentry><listitem><para>
+#: resources.dbk:1294
msgid "Stops processing commands. All following lines are ignored by the bot."
-msgstr "コマンド処理を終了します。これ以下の全ての行は bot からは無視されます。"
+msgstr ""
+"コマンド処理を終了します。これ以下の全ての行は bot からは無視されます。"
# type: Content of: <chapter><section><section><para>
-#: resources.dbk:1299
+#. type: Content of: <chapter><section><section><para>
+#: resources.dbk:1300
msgid ""
"The <command>pts-subscribe</command> command-line utility (from the "
"<systemitem role=\"package\">devscripts</systemitem> package) can be handy "
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: resources.dbk:1307
+#. type: Content of: <chapter><section><section><title>
+#: resources.dbk:1308
msgid "Filtering PTS mails"
msgstr "PTS からのメールを振り分ける"
# type: Content of: <chapter><section><section><para>
-#: resources.dbk:1309
+#. type: Content of: <chapter><section><section><para>
+#: resources.dbk:1310
msgid ""
"Once you are subscribed to a package, you will get the mails sent to "
"<literal><replaceable>sourcepackage</replaceable>@&pts-host;</literal>. "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: resources.dbk:1317
+#. type: Content of: <chapter><section><section><para>
+#: resources.dbk:1318
msgid ""
"Here is an example of added headers for a source upload notification on the "
"<systemitem role=\"package\">dpkg</systemitem> package:"
msgstr ""
# type: Content of: <chapter><section><section><screen>
-#: resources.dbk:1320
-#, no-wrap
+#. type: Content of: <chapter><section><section><screen>
+#: resources.dbk:1322
+#, fuzzy, no-wrap
msgid ""
-"\n"
"X-Loop: dpkg@&pts-host;\n"
"X-PTS-Package: dpkg\n"
"X-PTS-Keyword: upload-source\n"
"List-Unsubscribe: <mailto:pts@qa.debian.org?body=unsubscribe+dpkg>\n"
# type: Content of: <chapter><section><section><title>
-#: resources.dbk:1329
+#. type: Content of: <chapter><section><section><title>
+#: resources.dbk:1330
msgid "Forwarding VCS commits in the PTS"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: resources.dbk:1331
+#. type: Content of: <chapter><section><section><para>
+#: resources.dbk:1332
msgid ""
"If you use a publicly accessible VCS repository for maintaining your Debian "
"package, you may want to forward the commit notification to the PTS so that "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: resources.dbk:1337
+#. type: Content of: <chapter><section><section><para>
+#: resources.dbk:1338
msgid ""
"Once you set up the VCS repository to generate commit notifications, you "
"just have to make sure it sends a copy of those mails to "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: resources.dbk:1346
+#. type: Content of: <chapter><section><section><para>
+#: resources.dbk:1347
msgid ""
"For Subversion repositories, the usage of svnmailer is recommended. See "
"<ulink url=\"&url-alioth-pkg;\" /> for an example on how to do it."
msgstr ""
# type: Content of: <chapter><section><section><title>
-#: resources.dbk:1352
+#. type: Content of: <chapter><section><section><title>
+#: resources.dbk:1353
msgid "The PTS web interface"
msgstr "PTS ウェブインターフェイス"
# type: Content of: <chapter><section><section><para>
-#: resources.dbk:1354
+#. type: Content of: <chapter><section><section><para>
+#: resources.dbk:1355
msgid ""
"The PTS has a web interface at <ulink url=\"http://&pts-host;/\"></ulink> "
"that puts together a lot of information about each source package. It "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: resources.dbk:1364
+#. type: Content of: <chapter><section><section><para>
+#: resources.dbk:1365
msgid ""
"You can jump directly to the web page concerning a specific source package "
"with a URL like <literal>http://&pts-host;/<replaceable>sourcepackage</"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: resources.dbk:1369
+#. type: Content of: <chapter><section><section><para>
+#: resources.dbk:1370
msgid ""
"This web interface has been designed like a portal for the development of "
"packages: you can add custom content on your packages' pages. You can add "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: resources.dbk:1375
+#. type: Content of: <chapter><section><section><para>
+#: resources.dbk:1376
msgid "Static news items can be used to indicate:"
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: resources.dbk:1380
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: resources.dbk:1381
msgid ""
"the availability of a project hosted on <link linkend=\"alioth\">Alioth</"
"link> for co-maintaining the package"
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: resources.dbk:1386
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: resources.dbk:1387
msgid "a link to the upstream web site"
msgstr "upstream のウェブサイトへのリンク"
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: resources.dbk:1391
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: resources.dbk:1392
msgid "a link to the upstream bug tracker"
msgstr "upstream のバグ追跡システムへのリンク"
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: resources.dbk:1396
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: resources.dbk:1397
#, fuzzy
msgid "the existence of an IRC channel dedicated to the software"
msgstr "ソフトウェア専用 IRC チャンネルの存在"
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: resources.dbk:1401
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: resources.dbk:1402
msgid ""
"any other available resource that could be useful in the maintenance of the "
"package"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: resources.dbk:1407
+#. type: Content of: <chapter><section><section><para>
+#: resources.dbk:1408
msgid "Usual news items may be used to announce that:"
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: resources.dbk:1412
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: resources.dbk:1413
msgid "beta packages are available for testing"
msgstr "テスト用にベータ版パッケージが準備できたこと"
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: resources.dbk:1417
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: resources.dbk:1418
msgid "final packages are expected for next week"
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: resources.dbk:1422
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: resources.dbk:1423
msgid "the packaging is about to be redone from scratch"
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: resources.dbk:1427
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: resources.dbk:1428
msgid "backports are available"
msgstr "バックポート版が準備できたこと"
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: resources.dbk:1432
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: resources.dbk:1433
msgid ""
"the maintainer is on vacation (if they wish to publish this information)"
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: resources.dbk:1437
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: resources.dbk:1438
msgid "a NMU is being worked on"
msgstr ""
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
-#: resources.dbk:1442
+#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
+#: resources.dbk:1443
msgid "something important will affect the package"
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: resources.dbk:1447
+#. type: Content of: <chapter><section><section><para>
+#: resources.dbk:1448
msgid ""
"Both kinds of news are generated in a similar manner: you just have to send "
"an email either to <email>pts-static-news@qa.debian.org</email> or to "
msgstr ""
# type: Content of: <chapter><section><section><para>
-#: resources.dbk:1458
+#. type: Content of: <chapter><section><section><para>
+#: resources.dbk:1459
msgid ""
"Here are a few examples of valid mails used to generate news items in the "
"PTS. The first one adds a link to the cvsweb interface of debian-cd in the "
msgstr ""
# type: Content of: <chapter><section><section><screen>
-#: resources.dbk:1462
-#, no-wrap
+#. type: Content of: <chapter><section><section><screen>
+#: resources.dbk:1464
+#, fuzzy, no-wrap
msgid ""
-"\n"
"From: Raphael Hertzog <hertzog@debian.org>\n"
"To: pts-static-news@qa.debian.org\n"
"Subject: Browse debian-cd SVN repository\n"
"Url: http://svn.debian.org/viewsvn/debian-cd/trunk/\n"
# type: Content of: <chapter><section><section><para>
-#: resources.dbk:1471
+#. type: Content of: <chapter><section><section><para>
+#: resources.dbk:1472
msgid ""
"The second one is an announcement sent to a mailing list which is also sent "
"to the PTS so that it is published on the PTS web page of the package. Note "
msgstr ""
# type: Content of: <chapter><section><section><screen>
-#: resources.dbk:1475
-#, no-wrap
+#. type: Content of: <chapter><section><section><screen>
+#: resources.dbk:1477
+#, fuzzy, no-wrap
msgid ""
-"\n"
"From: Raphael Hertzog <hertzog@debian.org>\n"
"To: debian-gtk-gnome@&lists-host;\n"
"Bcc: pts-news@qa.debian.org\n"
"...\n"
# type: Content of: <chapter><section><section><para>
-#: resources.dbk:1489
+#. type: Content of: <chapter><section><section><para>
+#: resources.dbk:1490
msgid ""
"Think twice before adding a news item to the PTS because you won't be able "
"to remove it later and you won't be able to edit it either. The only thing "
msgstr ""
# type: Content of: <chapter><section><title>
-#: resources.dbk:1499
+#. type: Content of: <chapter><section><title>
+#: resources.dbk:1500
msgid "Developer's packages overview"
msgstr "Developer's packages overview"
# type: Content of: <chapter><section><para>
-#: resources.dbk:1501
+#. type: Content of: <chapter><section><para>
+#: resources.dbk:1502
msgid ""
"A QA (quality assurance) web portal is available at <ulink url=\"&url-ddpo;"
"\"></ulink> which displays a table listing all the packages of a single "
msgstr ""
# type: Content of: <chapter><section><para>
-#: resources.dbk:1510
+#. type: Content of: <chapter><section><para>
+#: resources.dbk:1511
msgid ""
"It is a good idea to look up your own data regularly so that you don't "
"forget any open bugs, and so that you don't forget which packages are your "
msgstr ""
# type: Content of: <chapter><section><title>
-#: resources.dbk:1517
+#. type: Content of: <chapter><section><title>
+#: resources.dbk:1518
msgid "Debian's GForge installation: Alioth"
msgstr "Debian での GForge の導入例: Alioth"
# type: Content of: <chapter><section><para>
-#: resources.dbk:1519
+#. type: Content of: <chapter><section><para>
+#: resources.dbk:1520
msgid ""
"Alioth is a Debian service based on a slightly modified version of the "
"GForge software (which evolved from SourceForge). This software offers "
msgstr ""
# type: Content of: <chapter><section><para>
-#: resources.dbk:1526
+#. type: Content of: <chapter><section><para>
+#: resources.dbk:1527
msgid ""
"It is intended to provide facilities to free software projects backed or led "
"by Debian, facilitate contributions from external developers to projects "
msgstr ""
# type: Content of: <chapter><section><para>
-#: resources.dbk:1533
+#. type: Content of: <chapter><section><para>
+#: resources.dbk:1534
msgid ""
"All Debian developers automatically have an account on Alioth. They can "
"activate it by using the recover password facility. External developers can "
msgstr ""
# type: Content of: <chapter><section><para>
-#: resources.dbk:1538
+#. type: Content of: <chapter><section><para>
+#: resources.dbk:1539
msgid "For more information please visit the following links:"
msgstr "詳細な情報については、以下のリンクを参照下さい："
# type: Content of: <chapter><section><itemizedlist><listitem><para>
-#: resources.dbk:1541
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
+#: resources.dbk:1542
msgid "<ulink url=\"&url-alioth-wiki;\" />"
msgstr "<ulink url=\"&url-alioth-wiki;\" />"
# type: Content of: <chapter><section><itemizedlist><listitem><para>
-#: resources.dbk:1542
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
+#: resources.dbk:1543
msgid "<ulink url=\"&url-alioth-faq;\" />"
msgstr "<ulink url=\"&url-alioth-faq;\" />"
# type: Content of: <chapter><section><itemizedlist><listitem><para>
-#: resources.dbk:1543
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
+#: resources.dbk:1544
msgid "<ulink url=\"&url-alioth-pkg;\" />"
msgstr "<ulink url=\"&url-alioth-pkg;\" />"
# type: Content of: <chapter><section><itemizedlist><listitem><para>
-#: resources.dbk:1544
+#. type: Content of: <chapter><section><itemizedlist><listitem><para>
+#: resources.dbk:1545
msgid "<ulink url=\"&url-alioth;\" />"
msgstr "<ulink url=\"&url-alioth;\" />"
# type: Content of: <chapter><section><title>
-#: resources.dbk:1549
+#. type: Content of: <chapter><section><title>
+#: resources.dbk:1550
msgid "Goodies for Developers"
msgstr "開発者への特典"
# type: Content of: <chapter><section><section><title>
-#: resources.dbk:1551
+#. type: Content of: <chapter><section><section><title>
+#: resources.dbk:1552
msgid "LWN Subscriptions"
msgstr "LWN の購読"
# type: Content of: <chapter><section><section><para>
-#: resources.dbk:1553
+#. type: Content of: <chapter><section><section><para>
+#: resources.dbk:1554
#, fuzzy
msgid ""
"Since October of 2002, HP has sponsored a subscription to LWN for all "
~ianmdlvl / developers-reference.git / commitdiff