Package: ntop Version: 2:3.0-5 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.
Patch description:
------------------
The attached patch does the required modifications:
- debian/control modification for dependencies:
build-dep: debhelper (>= 4.1.16) which depends on po-debconf
depend: debconf (>= 1.2.0) since old versions have problems with templates
specifying the encoding of their content
- Add 'debconf-updatepo' to the clean target of your debian/rules
(to make sure that the relevant files are ready for translation in the
distributed source packages, and thus help translators)
- execute "debconf-gettextize debian/*templates*". This does:
- generate po/ directory containing all the translation mecanism
- change the template file to mark some strings as translatable by putting
a _ before the field name.
- mark the right strings as translatable in the templates. This is a manual
check to make sure that fields containing stuff which cannot be
translated such as kernel module name, and the one not shown to the users
are not marked as translatable.
- removed files left by debconf-gettextize (*.templates.XX which are the
old-style translations and now live in debian/po/XX.po)
The previously existing translation were not lost in the process, but
automatically converted to po files. You may however want to ask your
previous translator to review them and update them if needed. Also ask
them to add their name in the header of the po files, to ease future
maintainance and update of the file.
For more details, see po-debconf documentation, especially "man 7
po-debconf"
About 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...
Stylistic considerations:
-------------------------
The templates of your package may be easily improved by applying the advices
contained at the following address:
http://people.debian.org/~bubulle/dtsg/dtsg.txt
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.
Future:
-------
Once the switch is achieved, and style improvements are done (if any), I
guess that you will receive translations of your templates rather soon. They
will consist in XX.po files where XX is the code of the language they
contain. Simply put them to debian/po, add a changelog entry, and your
package is ready for rebuilding and uploading after the usual checks.
If you modify your templates in the future, no action is absolutely
mandatory from you to take care of the translations (outdated translations
will be automatically discarded). But it is nicer to your translators and
your not english speaking users to include the updated translations in the
same upload. For that, run debconf-updatepo, and mail each translator the
XX.po file they provided you. Their adress can be found in the headers of
the po file. Wait a few days so that they can do their work, and put the new
version of the po file back in position in debian/po before upload.
Thanks for helping the translators, and thus your non english speaker
end-users.
-- System Information:
Debian Release: 3.1
APT prefers unstable
APT policy: (500, 'unstable'), (500, 'testing'), (1, 'experimental')
Architecture: i386 (i686)
Kernel: Linux 2.6.10-1-k7
Locale: LANG=en_US, LC_CTYPE=en_US (charmap=ISO-8859-1)
Versions of packages ntop depends on:
ii debconf 1.4.45 Debian configuration management sy
ii libc6 2.3.2.ds1-20 GNU C Library: Shared libraries an
ii libfreetype6 2.1.7-2.3 FreeType 2 font engine, shared lib
ii libgd2-noxpm 2.0.33-1.1 GD Graphics Library version 2 (wit
ii libgdbm3 1.8.3-2 GNU dbm database routines (runtime
ii libglib1.2 1.2.10-9 The GLib library of C routines
ii libjpeg62 6b-9 The Independent JPEG Group's JPEG
ii libpcap0.7 0.7.2-7 System interface for user-level pa
ii libpng12-0 1.2.8rel-1 PNG library - runtime
ii libssl0.9.7 0.9.7e-3 SSL shared libraries
ii libxml2 2.6.16-2 GNOME XML library
ii zlib1g 1:1.2.2-4 compression library - runtime
-- debconf information:
* ntop/interfaces: eth0
* ntop/user: ntop
--
Lucas Wall <[EMAIL PROTECTED]> .''`.
Buenos Aires, Argentina : :ø : Debian GNU/Linux
http://www.kadath.com.ar `. `' http://www.debian.org
PGP: 1024D/84FB46D6 `-
5D25 528A 83AB 489B 356A http://people.debian.org/~lwall
4087 BC9B 4733 84FB 46D6 mailto:[EMAIL PROTECTED]
diff -ruN orig/ntop-3.0/debian/control ntop-3.0/debian/control
--- orig/ntop-3.0/debian/control 2005-02-18 10:45:08.000000000 -0300
+++ ntop-3.0/debian/control 2005-02-18 11:26:06.000000000 -0300
@@ -7,7 +7,7 @@
Package: ntop
Architecture: any
-Depends: ${shlibs:Depends}, debconf (>= 0.2.26)
+Depends: ${shlibs:Depends}, debconf (>= 1.2.0)
Description: display network usage in top-like format
ntop is a Network Top program. It displays a summary of network usage by
machines on your network in a format reminiscent of the unix top utility.
diff -ruN orig/ntop-3.0/debian/po/POTFILES.in ntop-3.0/debian/po/POTFILES.in
--- orig/ntop-3.0/debian/po/POTFILES.in 1969-12-31 21:00:00.000000000 -0300
+++ ntop-3.0/debian/po/POTFILES.in 2005-02-18 11:27:09.000000000 -0300
@@ -0,0 +1 @@
+[type: gettext/rfc822deb] templates
diff -ruN orig/ntop-3.0/debian/po/templates.pot ntop-3.0/debian/po/templates.pot
--- orig/ntop-3.0/debian/po/templates.pot 1969-12-31 21:00:00.000000000
-0300
+++ ntop-3.0/debian/po/templates.pot 2005-02-18 11:28:24.000000000 -0300
@@ -0,0 +1,60 @@
+#
+# 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: 2005-02-18 11:28-0300\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <[EMAIL PROTECTED]>\n"
+"Language-Team: LANGUAGE <[EMAIL PROTECTED]>\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=CHARSET\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Type: string
+#. Description
+#: ../templates:4
+msgid "Which is the name of the user to run the ntop daemon as ?"
+msgstr ""
+
+#. Type: string
+#. Description
+#: ../templates:4
+msgid ""
+"The selected user will be created if not already available. Don't choose "
+"root, it is not recommended and will be discarded anyway."
+msgstr ""
+
+#. Type: string
+#. Description
+#: ../templates:4
+msgid ""
+"If you select an empty string no user will be created on the system and you "
+"will need to do that configuration yourself."
+msgstr ""
+
+#. Type: string
+#. Description
+#: ../templates:14
+msgid "Which interfaces should ntop listen on?"
+msgstr ""
+
+#. Type: string
+#. Description
+#: ../templates:14
+msgid ""
+"Please enter a comma separated list of interfaces ntop should listen on."
+msgstr ""
diff -ruN orig/ntop-3.0/debian/rules ntop-3.0/debian/rules
--- orig/ntop-3.0/debian/rules 2005-02-18 10:45:08.000000000 -0300
+++ ntop-3.0/debian/rules 2005-02-18 11:26:56.000000000 -0300
@@ -45,6 +45,7 @@
dh_testdir
dh_testroot
rm -f build-stamp* configure-stamp*
+ debconf-updatepo
# Add here commands to clean up after the build process.
-$(MAKE) distclean
diff -ruN orig/ntop-3.0/debian/templates ntop-3.0/debian/templates
--- orig/ntop-3.0/debian/templates 2005-02-18 10:45:08.000000000 -0300
+++ ntop-3.0/debian/templates 2005-02-18 11:27:49.000000000 -0300
@@ -1,15 +1,15 @@
Template: ntop/user
Type: string
Default: ntop
-Description: Which is the name of the user to run the ntop daemon as ?
- The selected user will be created if not already available.
- Don't choose root, it is not recommended and will be discarded anyway.
+_Description: Which is the name of the user to run the ntop daemon as ?
+ The selected user will be created if not already available. Don't choose
+ root, it is not recommended and will be discarded anyway.
.
- If you select an empty string no user will be created on the system and you
- will need to do that configuration yourself.
+ If you select an empty string no user will be created on the system and
+ you will need to do that configuration yourself.
Template: ntop/interfaces
Type: string
Default: eth0
-Description: Which interfaces should ntop listen on?
+_Description: Which interfaces should ntop listen on?
Please enter a comma separated list of interfaces ntop should listen on.
signature.asc
Description: Digital signature
