--- Begin Message ---
Source: developers-reference
Version: 3.4.6
Severity: wishlist
Tags: l10n patch
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA256
Hi,
The developers reference currently documents two ways to unfuzzy
translations [1]. msguntypot offers an easy way to do the job, please
document it instead. The attached diff may be difficult to read, but you
can have a look at the built document [2] if you prefer.
1: http://www.debian.org/doc/manuals/developers-reference/best-pkging-practices.html#s6.5.2.3
2: http://people.debian.org/~taffit/developers-reference/best-pkging-practices.html#s6.5.2.3
Regards
David
- -- System Information:
Debian Release: wheezy/sid
APT prefers unstable
APT policy: (500, 'unstable'), (500, 'testing'), (500, 'stable'), (1, 'experimental')
Architecture: amd64 (x86_64)
Kernel: Linux 3.1.0-1-amd64 (SMP w/1 CPU core)
Locale: LANG=fr_FR.UTF-8, LC_CTYPE=fr_FR.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.11 (GNU/Linux)
iQIcBAEBCAAGBQJPCf4OAAoJELgqIXr9/gnyUJgQAJC5cCA/j6XskVILGPSP7ery
Shd+ibqjHCvh0hwhq2yIPooiJhrZB0lvxCVZB3wJ153fcATf5pzixWorRbUvseNw
LsVGocmssdG3dEleUtOHbjfPz3SvkMDJtno4EIl0Pat8o9kzQ3t/SdKbUrqwuSee
EagdwFZeIRoE7t12QRqFpXoqUzBh4djmcbgYWw27hOFBkm0RuNnWEF4N5XiUShUW
wgJPjArSguRW5ediJNr0/6aCoHVCqcOJlkvpFyz9DRnhd0s8pV9Ty4fWz0UJpplP
9X40zYi75P8l3+aVaToVYIQr5J4HO+39FdNxpzBKdC+5+cFtQaphCbwqfubv2uPR
Oza4wvdwJu0lUXklOlF8ZFYwezVxIjV92IRnIf7ExhXyLladwKRSmxmn85EAIPr7
fbjUFCDLs9FZvJ5G0LTTTEMWkWNfE9brh1X0EKPLx/UYX00MF/VIJ+kDmODvVtW0
CveRTVTIxZNF/w3MPcaAQOaAFZASHc00ki2uYshB3zFJ+/JWw9d6sazF8X+fv47o
TXHob+f84pYbPk4gjdGG7Z3N80qyhjvqzAxznElnDu6podloH3wS+tHym2+Kanpe
8Nil5LMPTmyrJoqTyPi0zWs72iXCDRZrYs3u2crCr+zjDPK/QBZN8GoN5DWTpePu
TFBP1MwqecxIgYIcSwfP
=Q0YY
-----END PGP SIGNATURE-----
Index: best-pkging-practices.dbk
===================================================================
--- best-pkging-practices.dbk (révision 9028)
+++ best-pkging-practices.dbk (copie de travail)
@@ -830,129 +830,63 @@
translator will send you an update.
</para>
<para>
-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.
+To <emphasis>unfuzzy</emphasis> translations, you can use
+<command>msguntypot</command> (part of the <systemitem
+role="package">po4a</systemitem> package).
</para>
-<para>
-<emphasis>Preventive unfuzzy</emphasis> method:
-</para>
<orderedlist numeration="arabic">
<listitem>
<para>
-Try finding a complete translation file <emphasis role="strong">before</emphasis>
-the change:
+Regenerate the POT and PO files.
</para>
-<programlisting>for i in debian/po/*po; do echo -n $i: ; msgfmt -o /dev/null --statistics $i; done</programlisting>
-<para>
-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.
-</para>
+<programlisting>debconf-updatepo</programlisting>
</listitem>
<listitem>
<para>
-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>.
+Make a copy of the POT file.
</para>
+<programlisting>cp templates.pot templates.pot.orig</programlisting>
</listitem>
<listitem>
<para>
-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.
+Make a copy of all the PO files.
</para>
+<programlisting>mkdir po_fridge; cp *.po po_fridge</programlisting>
</listitem>
<listitem>
<para>
-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:
+Change the debconf template files to fix the typos.
</para>
-<programlisting>
-cd debian/po
-for i in *.po; do sed -i 's/tpyo/typo/g' $i; done
-</programlisting>
</listitem>
<listitem>
<para>
-Change the debconf template file to fix the typo.
+Regenerate the POT and PO files (again).
</para>
-</listitem>
-<listitem>
+<programlisting>debconf-updatepo</programlisting>
<para>
-Run <command>debconf-updatepo</command>.
+At this point, the typo fix fuzzied all the translations, and this
+unfortunate change is the only one between the PO files of your main
+directory and the one from the fridge. Here is how to solve this.
</para>
</listitem>
<listitem>
<para>
-Check the <filename>foo.po</filename> reference file. Its statistics should
-not be changed:
+Discard fuzzy translation, restore the ones from the fridge.
</para>
-<programlisting>
-msgfmt -o /dev/null --statistics debian/po/foo.po
-</programlisting>
+<programlisting>cp po_fridge/*.po .</programlisting>
</listitem>
<listitem>
<para>
-If the file's statistics changed, you did something wrong. Try again
-or ask for help on the &email-debian-i18n; mailing list.
+Manually merge the PO files with the new POT file, but taking the useless fuzzy into account.
</para>
+<programlisting>msguntypot -o templates.pot.orig -n templates.pot *.po</programlisting>
</listitem>
-</orderedlist>
-<para>
-Gettext utilities method:
-</para>
-<orderedlist numeration="arabic">
<listitem>
-<para>
-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):
+<para>
+Clean up.
</para>
-<programlisting>for i in debian/po/*po; do echo -n $i: ; msgfmt -o /dev/null --statistics $i; done</programlisting>
+<programlisting>rm -rf templates.pot.orig po_fridge</programlisting>
</listitem>
-<listitem>
-<para>
-Move all files which report either fuzzy strings to a temporary place. Files
-which report no fuzzy strings (only translated and untranslated) will be kept
-in place.
-</para>
-</listitem>
-<listitem>
-<para>
-Now <emphasis role="strong">and now only</emphasis>, modify the template for
-the typos and check again that translation are not impacted (typos, spelling
-errors, sometimes typographical corrections are usually OK).
-</para>
-</listitem>
-<listitem>
-<para>
-Run <command>debconf-updatepo</command>. This will fuzzy all strings you
-modified in translations. You can see this by running the above again.
-</para>
-</listitem>
-<listitem>
-<para>
-Use the following command:
-</para>
-<programlisting>for i in debian/po/*po; do msgattrib --output-file=$i --clear-fuzzy $i; done</programlisting>
-</listitem>
-<listitem>
-<para>
-Move back to <filename>debian/po</filename> the files which showed fuzzy strings in the first step.
-</para>
-</listitem>
-<listitem>
-<para>
-Run <command>debconf-updatepo</command> again.
-</para>
-</listitem>
</orderedlist>
</section>
--- End Message ---
--- Begin Message ---
Source: developers-reference
Source-Version: 3.4.7
We believe that the bug you reported is fixed in the latest version of
developers-reference, which is due to be installed in the Debian FTP archive:
developers-reference-de_3.4.7_all.deb
to main/d/developers-reference/developers-reference-de_3.4.7_all.deb
developers-reference-fr_3.4.7_all.deb
to main/d/developers-reference/developers-reference-fr_3.4.7_all.deb
developers-reference-ja_3.4.7_all.deb
to main/d/developers-reference/developers-reference-ja_3.4.7_all.deb
developers-reference_3.4.7.dsc
to main/d/developers-reference/developers-reference_3.4.7.dsc
developers-reference_3.4.7.tar.bz2
to main/d/developers-reference/developers-reference_3.4.7.tar.bz2
developers-reference_3.4.7_all.deb
to main/d/developers-reference/developers-reference_3.4.7_all.deb
A summary of the changes between this version and the previous one is
attached.
Thank you for reporting the bug, which will now be closed. If you
have further comments please address them to 655153@bugs.debian.org,
and the maintainer will reopen the bug report if appropriate.
Debian distribution maintenance software
pp.
David Prévot <taffit@debian.org> (supplier of updated developers-reference package)
(This message was generated automatically at their request; if you
believe that there is a problem with it please contact the archive
administrators by mailing ftpmaster@debian.org)
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA256
Format: 1.8
Date: Tue, 17 Jan 2012 16:36:12 -0400
Source: developers-reference
Binary: developers-reference developers-reference-de developers-reference-fr developers-reference-ja
Architecture: source all
Version: 3.4.7
Distribution: unstable
Urgency: low
Maintainer: Developers Reference Maintainers <debian-policy@lists.debian.org>
Changed-By: David Prévot <taffit@debian.org>
Description:
developers-reference - guidelines and information for Debian developers
developers-reference-de - guidelines and information for Debian developers, in German
developers-reference-fr - guidelines and information for Debian developers, in French
developers-reference-ja - guidelines and information for Debian developers, in Japanese
Closes: 569219 629530 643929 643930 643931 643932 643933 643934 643935 655096 655153
Changes:
developers-reference (3.4.7) unstable; urgency=low
.
* Team upload.
.
[ Raphaël Hertzog ]
* Document some best practices for meta-packages. Extend those for
transitional packages. Based on a patch by Luca Falavigna
<dktrkranz@debian.org> (thanks!). Closes: #569219
* Update license pointer to correctly point to GPL-2. Closes: #643929
Thanks to Luca Falavigna.
* Update URL of Debian Mentors FAQ. Closes: #643930
Thanks to Luca Falavigna for the patch.
* Refresh some release-specific information. Closes: #643931
Based on a patch by Luca Falavigna.
* Refresh some ftpmaster-related information. Closes: #643932
Thanks to Luca Falavigna for the patch.
* Update minimal GPG key length to match current requirements.
Closes: #643933 Thanks to Luca Falavigna for the patch.
* Update login information for rt.debian.org. Closes: #643934
Thanks to Luca Falavigna for the patch.
* Drop section about yada. Its usage is highly discouraged. Closes: #643935
Thanks to Luca Falavigna for the patch.
* Update best practice about unfuzzying PO file translations to recommend
msguntypot. Thanks to David Prévot for the patch.
Acked-by Christian Perrier. Closes: #655153
.
[ David Prévot ]
* Add doc-base file for the German translation.
* Typo fix, thanks to Andreas Moog. Closes: #655096
* Use XeTeX backend, that fix quotes in examples. Closes: #629530
* Build the Japanese PDF, thanks to Osamu Aoki and the maint-guide build
process.
.
* Translation updates (all completed)
- Japanese by Hideki Yamane.
- German by Chris Leick.
- French by David Prévot.
Checksums-Sha1:
07d537e5047d07c0a4a63a0a634f9e5ea28c7d28 2236 developers-reference_3.4.7.dsc
335a6bc01eb768235d756f90d1153e5902cf8bff 653774 developers-reference_3.4.7.tar.bz2
23ed2d29b0d93a39ac7a9a9200950090f6982341 694234 developers-reference_3.4.7_all.deb
591951e359219c137c9f9ca16dfc8d28ad94ceb6 772434 developers-reference-de_3.4.7_all.deb
87fe948293456c0a0bad44b22225adf4c594d6b0 751928 developers-reference-fr_3.4.7_all.deb
30193d3c19a35623f531d2f95e1b93c394430041 1193226 developers-reference-ja_3.4.7_all.deb
Checksums-Sha256:
f7b2d4b33610cfe10d5745032eb54877854235ae29dbed9689297b301309d3ee 2236 developers-reference_3.4.7.dsc
cbe0e52b61d041bd54a48f7d4000decdeb227397a0a22072a5c99778cff82dae 653774 developers-reference_3.4.7.tar.bz2
63a188fa918d0cfe2e80b3406b534268951ac69c22963dad11191b6abe2b53ff 694234 developers-reference_3.4.7_all.deb
b0fae103033e27d1d836369847d355485ca2fd1b5d0e617cfb1caf52de017018 772434 developers-reference-de_3.4.7_all.deb
d55e2606462e66f43c5fd388b91cbd82a7c1e53669764ce7cb06dbbefab8085f 751928 developers-reference-fr_3.4.7_all.deb
0e5b2a9a747350a70c9e434b2dc0500572dd719e2816afb4a3749f41e7ce167e 1193226 developers-reference-ja_3.4.7_all.deb
Files:
21e6ba5a10c2107b2fa47af60d5dd7c7 2236 doc optional developers-reference_3.4.7.dsc
ee399c35ad753abfe1a8d43ed2411216 653774 doc optional developers-reference_3.4.7.tar.bz2
9b0c02ed87d50455c62094b649ff03f7 694234 doc optional developers-reference_3.4.7_all.deb
4c6b522f83e951c4212e359e20f24ff8 772434 doc optional developers-reference-de_3.4.7_all.deb
50b4150d8b4380d715cc861b29f88c91 751928 doc optional developers-reference-fr_3.4.7_all.deb
d749b22d72eba528bb5a54a8295688f0 1193226 doc optional developers-reference-ja_3.4.7_all.deb
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.11 (GNU/Linux)
iQIcBAEBCAAGBQJPFeE1AAoJELgqIXr9/gny97sQAJSsCnWuKmV0GrQbi9mvNYhj
m1nvVq9NwQ90Lyu42YqbbfJQZOChN46Me2ArdSi9RjmsskdX+UM/CyuCkWNCKiKM
cEGeaZXbMAH+cxWdw3PCCJaW/iXc++GA20g6WMVudTSUd3VO2wS6l5u/pqOY6Zyd
haMNfFQlrg3zu42mxtgiAHuNVkqaEUDTfVoFvf8kZJZKVRpv54W7YickyZAwL2G0
sZ6xXfvjl7B5xBKkrsT+fnz3ToZyvgU51GfyAA2clAMiLi/Iz8EfWSHR7Wh30V9Y
+F3INoy1ugVPC28gs9VKtT8xvHlXBofkwxWFMX6g7jICo9NMMd+x29oUmArzohtu
EjviRU4wMa98ag2wj4/ktCAktcy+E5G+DAy+txXXzaBFRp019O9tu62tR4DlDhyk
JjMZSmNCsEFOX5KACbRerwZazQvLOIx7kJHwYkBzD/TkIJuakZw/d3i+J5dIoNBu
lsoPBxsYE09/zLDysOnPo6qV9B7rEnIO6prvUHQYmzvMZ0Ir3n1hh4eV4rdPT3DG
ORy2Ra3e9dakHLLAYQd/YXe8vsL6G4g14KK4FECSyiWTQUKUk7H9hAgG4g7UbSvy
18p3g0FacbOUk8CR/X3gIZIOLMf1dsb+FE1T9XIBFquUUG2SWIXR28kbNzhTu9yF
sH+zpuw5cJW4O0Bt//PH
=IRnS
-----END PGP SIGNATURE-----
--- End Message ---