Package: kerberos-configs 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.
K.
--
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/kerberos-configs-1.6/debian/control
kerberos-configs-1.6/debian/control
--- orig/kerberos-configs-1.6/debian/control 2002-03-28 16:46:00.000000000
-0300
+++ kerberos-configs-1.6/debian/control 2005-02-16 03:38:28.000000000 -0300
@@ -2,12 +2,12 @@
Section: net
Priority: optional
Maintainer: Sam Hartman <[EMAIL PROTECTED]>
-Build-Depends: debhelper (>> 3.0.0)
+Build-Depends: debhelper (>> 4.1.16)
Standards-Version: 3.5.0
Package: krb5-config
Architecture: all
-Depends: debconf (>= 0.4.0)
+Depends: debconf (>= 1.2.0)
Conflicts: heimdal-lib (<< 0.3e-5), libkrb53 (<< 1.2.2-5)
Description: Configuration files for Kerberos Version 5
This package provides /etc/krb5.conf and any other files needed to
@@ -18,7 +18,7 @@
Package: krb4-config
Architecture: all
-Depends: debconf (>= 0.4.0)
+Depends: debconf (>= 1.2.0)
Conflicts: kerberos4kth1 (<< 1.1)
Replaces: kerberos4kth-user
Description: Configuration files for Kerberos Version 4
diff -ruN orig/kerberos-configs-1.6/debian/krb4-config.templates
kerberos-configs-1.6/debian/krb4-config.templates
--- orig/kerberos-configs-1.6/debian/krb4-config.templates 2001-05-21
10:08:59.000000000 -0300
+++ kerberos-configs-1.6/debian/krb4-config.templates 2005-02-16
03:42:43.000000000 -0300
@@ -1,6 +1,6 @@
Template: krb4-config/default_realm
Type: string
-Description: What is the default Kerberos version 4 realm?
+_Description: What is the default Kerberos version 4 realm?
When users attempt to use Kerberos and specify a principal or user
name without specifying what administrative Kerberos realm that
principal belongs to, the system appends the default realm.
@@ -11,31 +11,32 @@
Type: boolean
Default: true
Description: You will never see this
- We want to try and capture user changes when they edit a config file
- manually. To do this we look in the config script to read the file.
+ We want to try and capture user changes when they edit a config file
+ manually. To do this we look in the config script to read the file.
However, in the case of preconfigure, the config script is run twice
- before the postinst is run. Thus we may read the wrong value before the
- edited value is written out in postinst.
- If this is false we skip reading config files until postinst runs.
+ before the postinst is run. Thus we may read the wrong value before the
+ edited value is written out in postinst. If this is false we skip reading
+ config files until postinst runs.
Template: krb4-config/dns_for_default
Type: boolean
Default: false
-Description: Does DNS contain pointers to your realm's Kerberos Servers?
- Traditionally new realms have been added to /etc/krb.conf so that
- clients can find the Kerberos servers for the realm. Modern Kerberos
- implementations sometimes support looking this information up using DNS. If
- your default realm has DNS pointers, then they will be used. Otherwise, if
- your realm is not already in /etc/krb.conf, you will be asked for the
- Kerberos servers' hostnames so the realm can be added.
+_Description: Does DNS contain pointers to your realm's Kerberos Servers?
+ Traditionally new realms have been added to /etc/krb.conf so that clients
+ can find the Kerberos servers for the realm. Modern Kerberos
+ implementations sometimes support looking this information up using DNS.
+ If your default realm has DNS pointers, then they will be used.
+ Otherwise, if your realm is not already in /etc/krb.conf, you will be
+ asked for the Kerberos servers' hostnames so the realm can be added.
Template: krb4-config/kerberos_servers
Type: string
-Description: What are the Kerberos servers for your realm?
- Enter the hostnames of Kerberos version 4 servers in the ${realm} Kerberos
realm separated by spaces.
+_Description: What are the Kerberos servers for your realm?
+ Enter the hostnames of Kerberos version 4 servers in the ${realm} Kerberos
+ realm separated by spaces.
Template: krb4-config/admin_server
Type: string
-Description: What is the administrative server for your Kerberos realm?
- Enter the hostname of the administrative (password changing) server
- for the ${realm} Kerberos realm.
+_Description: What is the administrative server for your Kerberos realm?
+ Enter the hostname of the administrative (password changing) server for
+ the ${realm} Kerberos realm.
diff -ruN orig/kerberos-configs-1.6/debian/krb5-config.templates
kerberos-configs-1.6/debian/krb5-config.templates
--- orig/kerberos-configs-1.6/debian/krb5-config.templates 2001-05-21
09:33:27.000000000 -0300
+++ kerberos-configs-1.6/debian/krb5-config.templates 2005-02-16
03:42:57.000000000 -0300
@@ -1,6 +1,6 @@
Template: krb5-config/default_realm
Type: string
-Description: What is the default Kerberos version 5 realm?
+_Description: What is the default Kerberos version 5 realm?
When users attempt to use Kerberos and specify a principal or user
name without specifying what administrative Kerberos realm that
principal belongs to, the system appends the default realm.
@@ -11,31 +11,32 @@
Type: boolean
Default: true
Description: You will never see this
- We want to try and capture user changes when they edit a config file
- manually. To do this we look in the config script to read the file.
+ We want to try and capture user changes when they edit a config file
+ manually. To do this we look in the config script to read the file.
However, in the case of preconfigure, the config script is run twice
- before the postinst is run. Thus we may read the wrong value before the
- edited value is written out in postinst.
- If this is false we skip reading config files until postinst runs.
+ before the postinst is run. Thus we may read the wrong value before the
+ edited value is written out in postinst. If this is false we skip reading
+ config files until postinst runs.
Template: krb5-config/dns_for_default
Type: boolean
Default: false
-Description: Does DNS contain pointers to your realm's Kerberos Servers?
- Traditionally new realms have been added to /etc/krb5.conf so that
- clients can find the Kerberos servers for the realm. Modern Kerberos
- implementations support looking this information up using DNS. If
- your default realm has DNS pointers, then they will be used. Otherwise, if
+_Description: Does DNS contain pointers to your realm's Kerberos Servers?
+ Traditionally new realms have been added to /etc/krb5.conf so that clients
+ can find the Kerberos servers for the realm. Modern Kerberos
+ implementations support looking this information up using DNS. If your
+ default realm has DNS pointers, then they will be used. Otherwise, if
your realm is not already in /etc/krb5.conf, you will be asked for the
Kerberos servers' hostnames so the realm can be added.
Template: krb5-config/kerberos_servers
Type: string
-Description: What are the Kerberos servers for your realm?
- Enter the hostnames of Kerberos servers in the ${realm} Kerberos realm
separated by spaces.
+_Description: What are the Kerberos servers for your realm?
+ Enter the hostnames of Kerberos servers in the ${realm} Kerberos realm
+ separated by spaces.
Template: krb5-config/admin_server
Type: string
-Description: What is the administrative server for your Kerberos realm?
- Enter the hostname of the administrative (password changing) server
- for the ${realm} Kerberos realm.
+_Description: What is the administrative server for your Kerberos realm?
+ Enter the hostname of the administrative (password changing) server for
+ the ${realm} Kerberos realm.
diff -ruN orig/kerberos-configs-1.6/debian/po/POTFILES.in
kerberos-configs-1.6/debian/po/POTFILES.in
--- orig/kerberos-configs-1.6/debian/po/POTFILES.in 1969-12-31
21:00:00.000000000 -0300
+++ kerberos-configs-1.6/debian/po/POTFILES.in 2005-02-16 03:39:45.000000000
-0300
@@ -0,0 +1,2 @@
+[type: gettext/rfc822deb] krb4-config.templates
+[type: gettext/rfc822deb] krb5-config.templates
diff -ruN orig/kerberos-configs-1.6/debian/po/templates.pot
kerberos-configs-1.6/debian/po/templates.pot
--- orig/kerberos-configs-1.6/debian/po/templates.pot 1969-12-31
21:00:00.000000000 -0300
+++ kerberos-configs-1.6/debian/po/templates.pot 2005-02-16
03:44:26.000000000 -0300
@@ -0,0 +1,114 @@
+#
+# 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-16 03:44-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
+#: ../krb4-config.templates:3
+msgid "What is the default Kerberos version 4 realm?"
+msgstr ""
+
+#. Type: string
+#. Description
+#: ../krb4-config.templates:3 ../krb5-config.templates:3
+msgid ""
+" When users attempt to use Kerberos and specify a principal or user\n"
+" name without specifying what administrative Kerberos realm that\n"
+" principal belongs to, the system appends the default realm.\n"
+" Normally default realm is the upper case version of the local DNS\n"
+" domain."
+msgstr ""
+
+#. Type: boolean
+#. Description
+#: ../krb4-config.templates:24 ../krb5-config.templates:24
+msgid "Does DNS contain pointers to your realm's Kerberos Servers?"
+msgstr ""
+
+#. Type: boolean
+#. Description
+#: ../krb4-config.templates:24
+msgid ""
+"Traditionally new realms have been added to /etc/krb.conf so that clients "
+"can find the Kerberos servers for the realm. Modern Kerberos "
+"implementations sometimes support looking this information up using DNS. If "
+"your default realm has DNS pointers, then they will be used. Otherwise, if "
+"your realm is not already in /etc/krb.conf, you will be asked for the "
+"Kerberos servers' hostnames so the realm can be added."
+msgstr ""
+
+#. Type: string
+#. Description
+#: ../krb4-config.templates:34 ../krb5-config.templates:34
+msgid "What are the Kerberos servers for your realm?"
+msgstr ""
+
+#. Type: string
+#. Description
+#: ../krb4-config.templates:34
+msgid ""
+"Enter the hostnames of Kerberos version 4 servers in the ${realm} Kerberos "
+"realm separated by spaces."
+msgstr ""
+
+#. Type: string
+#. Description
+#: ../krb4-config.templates:40 ../krb5-config.templates:40
+msgid "What is the administrative server for your Kerberos realm?"
+msgstr ""
+
+#. Type: string
+#. Description
+#: ../krb4-config.templates:40 ../krb5-config.templates:40
+msgid ""
+"Enter the hostname of the administrative (password changing) server for the "
+"${realm} Kerberos realm."
+msgstr ""
+
+#. Type: string
+#. Description
+#: ../krb5-config.templates:3
+msgid "What is the default Kerberos version 5 realm?"
+msgstr ""
+
+#. Type: boolean
+#. Description
+#: ../krb5-config.templates:24
+msgid ""
+"Traditionally new realms have been added to /etc/krb5.conf so that clients "
+"can find the Kerberos servers for the realm. Modern Kerberos "
+"implementations support looking this information up using DNS. If your "
+"default realm has DNS pointers, then they will be used. Otherwise, if your "
+"realm is not already in /etc/krb5.conf, you will be asked for the Kerberos "
+"servers' hostnames so the realm can be added."
+msgstr ""
+
+#. Type: string
+#. Description
+#: ../krb5-config.templates:34
+msgid ""
+"Enter the hostnames of Kerberos servers in the ${realm} Kerberos realm "
+"separated by spaces."
+msgstr ""
diff -ruN orig/kerberos-configs-1.6/debian/rules
kerberos-configs-1.6/debian/rules
--- orig/kerberos-configs-1.6/debian/rules 2001-05-21 10:18:38.000000000
-0300
+++ kerberos-configs-1.6/debian/rules 2005-02-16 03:39:25.000000000 -0300
@@ -22,6 +22,7 @@
dh_testdir
dh_testroot
rm -f build-stamp configure-stamp
+ debconf-updatepo
# Add here commands to clean up after the build process.
signature.asc
Description: Digital signature
