Bug#235834: multi-gnome-terminal: Please switch to gettext-based debconf templates
Package: multi-gnome-terminal
Version: n/a
Severity: wishlist
Tags: patch l10n
Using the "new" gettext format for debconf templates helps for templates
translations. For instance, detecting outdated or untranslated strings
becomes considerably easier. It also keeps track of who did which
translation.
The attached patch does the required modifications :
- debian/control modification for dependencies (see below)
- execute "debconf-gettextize debian/*templates*"
- mark the right strings as translatable in the templates (see below)
- update the style to the best current practice (see below)
If you want to reproduce this by yourself instead of applying the
patch, you have to do:
- install po-debconf on your system
- go to the debian directory
- read man po-debconf..:-)
- run "debconf-gettextize *.templates"
- read the output
- change Build-Depends or Build-Depends-Indep (see below)
They should list "debhelper (>= 4.1.16)" (debhelper depends upon
po-debconf) since you use debhelper.
- update the templates file to mark as translatable only the fields
which should (ie, not the one containing stuff which cannot be
translated such as kernel module name, and neither the one not
shown to the users), and improve the style to follow the dstg.
For more details, see po-debconf documentation, especially "man 7
po-debconf"
Read this if you're concerned with backports :
--------------------------------------------
Please note that the suggested modifications will make your
package a little bit harder to backport to earlier Debian releases. If
this is a concern to you, you may try to adopt the method used by the
openssh package and detailed by Colin Watson in
http://lists.debian.org/debian-i18n/2003/debian-i18n-200307/msg00026.html
This patch does not includes this method as this would make it too
invasive, IMHO. So, preserving backportability is up to you...
The rest of the story :
---------------------
While I was working on the convertion to po-debconf, I noticed that the
templates of your package may be easily improved by applying the advices
contained at the following address:
http://people.debian.org/~bubulle/dtsg.txt
Please read this document, and improve your templates. For example, the
first one smells like a debconf abuse, even if I'm not completely sure of
it. The second one may be placed in NEWS.Debian, where it really belongs.
You should also explain the kind of problem preventing you from doing so
automatically. I mean, if that's dangerous, do not ask your user to do so
blindly. If not, do so automatically ;)
Don't get me wrong, I don't want to criticize, I just want the template to
reach a translatable state (ie quite stable) rather soon.
Once the switch is achieved, and the style improvement are done, I
guess that you will receive translations of your templates rather soon. You
may consider asking on the debian-i18n@lists.debian.org mailing list for
translations once you think that your templates are in a sort of final state
where they won't be modified in the near future.
Thanks for helping the translators, and thus your non english speaker
end-users.
Bye, Mt.
-- System Information:
Debian Release: testing/unstable
Architecture: i386
Kernel: Linux galadriel 2.4.22 #1 ven nov 21 16:02:19 CET 2003 i686
Locale: LANG=fr_FR.ISO-8859-1, LC_CTYPE=fr_FR.ISO-8859-1
diff -ruN multi-gnome-terminal-1.6.2.ori/debian/control multi-gnome-terminal-1.6.2/debian/control
--- multi-gnome-terminal-1.6.2.ori/debian/control 2004-03-02 10:21:30.000000000 -0800
+++ multi-gnome-terminal-1.6.2/debian/control 2004-03-02 10:21:47.000000000 -0800
@@ -2,14 +2,14 @@
Section: x11
Priority: optional
Maintainer: Debian QA Group <packages@qa.debian.org>
-Build-Depends: debhelper (>> 4.0.0), gettext, libgnome-dev (>= 1.4.2-3), liborbit-dev, flex, bison, libgtk1.2-dev, xlibs-dev, libxml-dev, libgdk-pixbuf-gnome-dev (>= 0.18.0-3), libglade-gnome0-dev, intltool, libbz2-dev, libgtkxmhtml-dev, zlib1g-dev, scrollkeeper, jade, docbook-dsssl
+Build-Depends: debhelper (>= 4.1.16), gettext, libgnome-dev (>= 1.4.2-3), liborbit-dev, flex, bison, libgtk1.2-dev, xlibs-dev, libxml-dev, libgdk-pixbuf-gnome-dev (>= 0.18.0-3), libglade-gnome0-dev, intltool, libbz2-dev, libgtkxmhtml-dev, zlib1g-dev, scrollkeeper, jade, docbook-dsssl
Build-Depends-Indep: gtk-doc-tools
Standards-Version: 3.6.1
Package: multi-gnome-terminal
Section: gnome
Architecture: any
-Pre-Depends: debconf (>= 0.2.17)
+Pre-Depends: debconf (>= 1.2.0)
Depends: ${shlibs:Depends}
Provides: x-terminal-emulator
Recommends: multi-gnome-terminal-doc
diff -ruN multi-gnome-terminal-1.6.2.ori/debian/multi-gnome-terminal.templates multi-gnome-terminal-1.6.2/debian/multi-gnome-terminal.templates
--- multi-gnome-terminal-1.6.2.ori/debian/multi-gnome-terminal.templates 2004-03-02 10:21:31.000000000 -0800
+++ multi-gnome-terminal-1.6.2/debian/multi-gnome-terminal.templates 2004-03-02 10:22:09.000000000 -0800
@@ -1,6 +1,6 @@
Template: multi-gnome-terminal/alternatives_may_be_needed_to_change
Type: note
-Description: alternatives was changed.
+_Description: alternatives was changed.
alternatives of x-terminal-emulator which multi-gnome-terminal has was
changed to multi-gnome-terminal.wrapper.
.
@@ -10,11 +10,10 @@
Template: multi-gnome-terminal/alternatives_must_be_needed_to_change
Type: note
-Description: alternatives was changed.
+_Description: alternatives was changed.
alternatives of x-terminal-emulator which multi-gnome-terminal has was
changed to multi-gnome-terminal.wrapper.
.
You need to change it again because you use multi-gnome-terminal for
- x-terminal-emulator. I don't change it here automatically because it may be
- caused a problem.
-
+ x-terminal-emulator. I don't change it here automatically because it may
+ be caused a problem.
diff -ruN multi-gnome-terminal-1.6.2.ori/debian/po/POTFILES.in multi-gnome-terminal-1.6.2/debian/po/POTFILES.in
--- multi-gnome-terminal-1.6.2.ori/debian/po/POTFILES.in 1969-12-31 16:00:00.000000000 -0800
+++ multi-gnome-terminal-1.6.2/debian/po/POTFILES.in 2004-03-02 10:22:09.000000000 -0800
@@ -0,0 +1 @@
+[type: gettext/rfc822deb] multi-gnome-terminal.templates
diff -ruN multi-gnome-terminal-1.6.2.ori/debian/po/templates.pot multi-gnome-terminal-1.6.2/debian/po/templates.pot
--- multi-gnome-terminal-1.6.2.ori/debian/po/templates.pot 1969-12-31 16:00:00.000000000 -0800
+++ multi-gnome-terminal-1.6.2/debian/po/templates.pot 2004-03-02 10:22:10.000000000 -0800
@@ -0,0 +1,57 @@
+#
+# Translators, if you are not familiar with the PO format, gettext
+# documentation is worth reading, especially sections dedicated to
+# this format, e.g. by running:
+# info -n '(gettext)PO Files'
+# info -n '(gettext)Header Entry'
+#
+# Some information specific to po-debconf are available at
+# /usr/share/doc/po-debconf/README-trans
+# or http://www.debian.org/intl/l10n/po-debconf/README-trans
+#
+# Developers do not need to manually edit POT or PO files.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: PACKAGE VERSION\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2004-03-02 10:22-0800\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
+"Language-Team: LANGUAGE <LL@li.org>\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=CHARSET\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Type: note
+#. Description
+#: ../multi-gnome-terminal.templates:3
+msgid ""
+"If you manually changed it to multi-gnome-terminal, you need to change it "
+"again. I don't change it here automatically because it may be caused a "
+"problem."
+msgstr ""
+
+#. Type: note
+#. Description
+#: ../multi-gnome-terminal.templates:13
+msgid "alternatives was changed."
+msgstr ""
+
+#. Type: note
+#. Description
+#: ../multi-gnome-terminal.templates:13
+msgid ""
+"alternatives of x-terminal-emulator which multi-gnome-terminal has was "
+"changed to multi-gnome-terminal.wrapper."
+msgstr ""
+
+#. Type: note
+#. Description
+#: ../multi-gnome-terminal.templates:13
+msgid ""
+"You need to change it again because you use multi-gnome-terminal for x-"
+"terminal-emulator. I don't change it here automatically because it may be "
+"caused a problem."
+msgstr ""
Reply to: