Package: po-debconf
Version: 1.0.15
Severity: normal
Tags: patch
debconf-loadtemplate will not accept a templates file with i18n
markups. However, it will accept a merged file. The po-debconf
manpage should document the new debugging process. Also, the English
manpage is worded somewhat awkwardly in several places. I suggest
this patch.
- Jim Van Zandt
--- doc/en/po-debconf.7.pod-orig 2008-11-11 18:14:20.000000000 -0500
+++ doc/en/po-debconf.7.pod 2008-11-11 18:57:27.000000000 -0500
@@ -8,7 +8,7 @@
The goal of C<debconf> was to make package configuration user-friendly. In
order to achieve this, it is important to ensure that users will get the
question in their own language. Translators need a framework to easily
-work on translations without having to track down package development;
+work on translations without having to track package development;
C<po-debconf> was designed to be able to work with standard C<gettext>
tools when translating debconf templates files.
@@ -29,7 +29,7 @@
Paths are relative to the parent directory.
-=item - Prepend an underscore before translatable fields
+=item - Prepend an underscore before translatable fields in each template
Normally C<Description>, C<Choices> and sometimes C<Default> fields can be
translated.
@@ -45,7 +45,7 @@
=head1 UPDATE TEMPLATES
In order to help translators, PO files in your package should always
-be up-to-date, otherwise they may lose their time with unused strings.
+be up-to-date, otherwise they may waste their time translating unused strings.
For that, simply call the following command without arguments:
$ debconf-updatepo
@@ -60,7 +60,7 @@
files are fully translated.
The B<debconf-updatepo> program is idempotent, it modifies PO files only
-if their content has been updated. Thus the best solution to provide
+if their content has been updated. Thus the best way to provide
up-to-date PO files in your source package is to call this command from
the C<clean> target of the F<debian/rules> file.
@@ -128,7 +128,7 @@
=head2 SPLITTING CHOICES LIST
Since C<po-debconf> 0.6.0, localized fields may contain two leading
-underscores. In this case, field value is supposed to be a comma
+underscores. In this case, the field value is supposed to be a comma
separated list of values, which are put in separate msgids. Thus
if the previous example did contain
@@ -163,15 +163,15 @@
Eventually you have to remove F<foo> and manually edit F<debian/templates> to
replace C<_Choices> by C<__Choices> before B<debconf-updatepo> is run.
-=head2 PUTTING COMMENTS FOR TRANSLATORS
+=head2 PUTTING IN COMMENTS FOR TRANSLATORS
C<Dpkg> maintainers decided that by convention lines beginning with
a number sign (C<#>) are comments in F<debian/control> files, and C<po-debconf>
follows this rule. Since C<po-debconf> 0.8.0, such comments are written
-into PO files, and can then contain valuable informations for
+into PO files, and can then contain valuable information for
translators. Incidentally all previous C<po-debconf> versions ignore
lines which do not contain a colon, thus if your comments does not
-contain any colon, there is no need to add a versioned build dependency
+contain any colons, there is no need to add a versioned build dependency
against C<po-debconf>. Here is an example:
Template: debconf/button-yes
@@ -279,6 +279,23 @@
for instance one week in advance. A dedicated tool, B<podebconf-report-po>,
has been written for this purpose. Do not hesitate to abuse it!
+=head1 DEBUGGING
+
+You will find that B<debconf-loadtemplate> will not accept a templates
+file with i18n markups. However, it will accept a merged file, so if
+you have been debugging your debconf setup like this
+
+ rm /tmp/{config,templates}.dat{,-old}
+ debconf-loadtemplate debian/templates
+ DEBIAN_PRIORITY=low debconf -freadline debian/config configure 28.0
+
+you will now need something like this instead:
+
+ po2debconf debian/templates > debian/tmp/DEBIAN/templates
+ rm /tmp/{config,templates}.dat{,-old}
+ debconf-loadtemplate debian/tmp/DEBIAN/templates
+ DEBIAN_PRIORITY=low debconf -freadline debian/config configure 28.0
+
=head1 CAVEATS
=over 2
@@ -293,7 +310,7 @@
=item *
-A given English string may have only one unique translation in a given
+A given English string may be given only one unique translation in a given
language. It is impossible to give two different translations, depending
on the context. To solve this issue, you have to add special markups to
the different occurrences of a given string to make them different.
@@ -402,8 +419,9 @@
L<debconf-gettextize(1)>,
L<debconf-updatepo(1)>,
L<dh_installdebconf(1)>,
-L<podebconf-report-po(1)>.
-L<po2debconf(1)>.
+L<podebconf-report-po(1)>,
+L<po2debconf(1)>,
+L<debconf-devel(7)>.
=head1 AUTHORS
-- System Information:
Debian Release: lenny/sid
APT prefers unstable
APT policy: (990, 'unstable'), (500, 'oldstable'), (500, 'testing'), (500,
'stable')
Architecture: i386 (i686)
Kernel: Linux 2.6.25 (SMP w/4 CPU cores; PREEMPT)
Locale: LANG=C, LC_CTYPE=C (charmap=ANSI_X3.4-1968)
Shell: /bin/sh linked to /bin/bash
Versions of packages po-debconf depends on:
ii gettext 0.17-4 GNU Internationalization utilities
ii intltool-debian 0.35.0+20060710.1 Help i18n of RFC822 compliant conf
ii perl 5.10.0-13 Larry Wall's Practical Extraction
Versions of packages po-debconf recommends:
ii libcompress-zlib-perl 2.012-1 Perl module for creation and manip
pn libmail-box-perl <none> (no description available)
pn libmail-sendmail-perl <none> (no description available)
po-debconf suggests no packages.
-- no debconf information
--
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]
