From: taffit-guest <taffit-guest@313b444b-1b9f-4f58-a734-7bb04f332e8d>
Date: Mon, 31 May 2010 23:40:18 +0000 (+0000)
Subject:   * Apply updated patch from Nicolas François. Closes: #257150
X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=developers-reference.git;a=commitdiff_plain;h=deb6e9334b71b51950c02335fc511d48099dcfc0

  * Apply updated patch from Nicolas François. Closes: #257150

git-svn-id: svn://anonscm.debian.org/ddp/manuals/trunk/developers-reference@7380 313b444b-1b9f-4f58-a734-7bb04f332e8d
---

diff --git a/best-pkging-practices.dbk b/best-pkging-practices.dbk
index ca9f149..c436c6f 100644
--- a/best-pkging-practices.dbk
+++ b/best-pkging-practices.dbk
@@ -1360,6 +1360,13 @@ type documented in <citerefentry> <refentrytitle>po-debconf</refentrytitle>
 
 <section id="bpp-i18n">
 <title>Internationalization</title>
+<para>
+This section contains global information for developers to make translators'
+life easier.  More information for translators and developers interrested
+in internationalization are available in the <ulink
+url="&url-i18n-l10n;">Internationalisation and localisation in Debian</ulink>
+documentation.
+</para>
 <section id="bpp-i18n-debconf">
 <title>Handling debconf translations</title>
 <para>
@@ -1421,6 +1428,14 @@ language-independent information and define those as entities in a separate
 file which is included by all the different translations.  This makes it much
 easier, for instance, to keep URLs up to date across multiple files.
 </para>
+<para>
+Some tools (e.g. <systemitem role="package">po4a</systemitem>, <systemitem
+role="package">poxml</systemitem>, or the <systemitem
+role="package">translate-toolkit</systemitem>) are specialized in extracting
+the translatable material from different formats.  They produce PO files, a
+format quite common to translators, which permits to see what needs to be
+retranslated when the translated document is updated.
+</para>
 </section>
 
 </section>
diff --git a/debian/changelog b/debian/changelog
index d5bdd13..d46f431 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -55,6 +55,7 @@ developers-reference (3.4.4) UNRELEASED; urgency=low
   * Update outdated mentions, typos and tags. Closes: #578664
   * French translation update in progress (index, scope, ressources, pkgs and
     best-pkging-practices).
+  * Apply updated patch from Nicolas François. Closes: #257150
 
   [ Lucas Nussbaum ]
   * Document the new derivatives-bugs PTS keyword.