[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#209393: diskless: Please switch to gettext-based debconf templates



Package: diskless
Version: N/A
Severity: wishlist
Tags: patch

(this text is generic for "po-debconf switch" bug reports. If something is
specific to your package, look at the end of this BR)

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*"
- removed files left by debconf-gettextize (*.templates.old which are the
  old-style templates and *.templates.xx which are the former translated
  templates
- french translation proofreading (the file is debian/po/fr.po) if a french 
  translation (partial or not) already existed for the templates


Then diff file creation....

I, in the same time, started to work on a french translation if none
was there. In such case, the fr.po file will be sent to you through
another BR.

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)

Then you will pick up the fr.po file from my own patch (I often make small
corrections to existing french translations to make them conformant to
the existing standards of the Debian french l10n team).


Build Dependencies of the package have to become the following :

Build-Depends(-Indep) should list "debhelper (>= 4.1.16)" (debhelper
depends upon po-debconf) if you use debhelper, or "po-debconf"
directly if you don't (but, then, please look at po-debconf man page)

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...

Additional notes, specific to this package :
--------------------------------------------
I've changed some trivial english errors in original templates and removed
all question marks in short descriptions for templates (look strange and
useless).

As this package is orphaned, I intend to NMU/QA Upload it as soon as the
french translation of the templates will have been proofread.

-- System Information:
Debian Release: testing/unstable
Architecture: i386
Kernel: Linux mykerinos 2.4.21 #1 jeu jui 24 08:36:17 CEST 2003 i686
Locale: LANG=fr_FR.ISO-8859-1, LC_CTYPE=fr_FR.ISO-8859-1 (ignored: LC_ALL set to fr_FR)

diff -Nru ./diskless-0.3.18.0.2.ori/debian/control ./diskless-0.3.18.0.2/debian/control
--- ./diskless-0.3.18.0.2.ori/debian/control	2003-09-08 18:12:47.000000000 +0200
+++ ./diskless-0.3.18.0.2/debian/control	2003-09-09 18:00:49.000000000 +0200
@@ -3,7 +3,7 @@
 Priority: extra
 Maintainer: QA Group <packages@qa.debian.org>
 Standards-Version: 3.5.5
-Build-Depends-Indep: debhelper (>= 3.0.0), jade, docbook-dsssl, sgml-data, docbook-xml
+Build-Depends-Indep: debhelper (>= 4.1.16), jade, docbook-dsssl, sgml-data, docbook-xml
 
 Package: diskless
 Architecture: all
diff -Nru ./diskless-0.3.18.0.2.ori/debian/diskless-image-secure.templates ./diskless-0.3.18.0.2/debian/diskless-image-secure.templates
--- ./diskless-0.3.18.0.2.ori/debian/diskless-image-secure.templates	2003-09-08 18:12:47.000000000 +0200
+++ ./diskless-0.3.18.0.2/debian/diskless-image-secure.templates	2003-09-09 18:12:20.000000000 +0200
@@ -1,76 +1,76 @@
 Template: diskless-image/master
 Type: string
 Default: master
-Description: Name of master?
- This option specifies the default name for the master host. This
- is required to be setup by some debian packages. It should have
- an entry in the DNS.
+_Description: Name of master
+ This option specifies the default name for the master host. This is
+ required to be setup by some debian packages. It should have an entry in
+ the DNS.
 
 Template: diskless-image/nfsserver
 Type: string
 Default: 192.168.87.129
-Description: NFS server address?
+_Description: NFS server address
  This specifies the address of the central NFS server where to mount
- partitions from on the clients. It is recommended that this
- contain the IP address, although this is not required.
+ partitions from on the clients. It is recommended that this contain the IP
+ address, although this is not required.
 
 Template: diskless-image/nfsimagedir
 Type: string
 Default: /var/lib/diskless/default/root
-Description: NFS image directory mount point?
- This options specifies the path which will be used by the clients
- to mount the NFS image directory.
+_Description: NFS image directory mount point
+ This option specifies the path which will be used by the clients to mount
+ the NFS image directory.
 
 Template: diskless-image/nfshostsdir
 Type: string
 Default: /var/lib/diskless/default
-Description: Hosts' directories mount point?
- This options specifies the path which will be used by the clients
- to their private read-write directories.  The IP address
- will be appended to the end of this path.
+_Description: Hosts directories mount point
+ This option specifies the path which will be used by the clients to their
+ private read-write directories.  The IP address will be appended to the
+ end of this path.
 
 Template: diskless-image/nfshomedir
 Type: string
 Default: /home
-Description: NFS exported home directories?
- This specifies where /home on the clients should be mounted from your
- NFS server. Examples are /home, /tftpboot/home, etc. This directory must
- be exported on your NFS server via /etc/exports, and will be mounted as
- /home. Set this value to "none", if you don't want to mount /home (in
- this case, /home will be an empty read-only directory).
+_Description: NFS exported home directories
+ This specifies where /home on the clients should be mounted from your NFS
+ server. Examples are /home, /tftpboot/home, etc. This directory must be
+ exported on your NFS server via /etc/exports, and will be mounted as
+ /home. Set this value to "none", if you don't want to mount /home (in this
+ case, /home will be an empty read-only directory).
 
 Template: diskless-image/nameserver
 Type: string
 Default: 127.0.0.1
-Description: IP address of nameserver?
- This option specifies the default nameserver for each client in
- this group.
+_Description: IP address of nameserver
+ This option specifies the default nameserver for each client in this
+ group.
 
 Template: diskless-image/domain
 Type: string
 Default: chocbit.org.au
-Description: Domain?
- This option specifies the default DNS domain for each client in
- this group.
+_Description: Domain
+ This option specifies the default DNS domain for each client in this
+ group.
 
 Template: diskless-image/maildomain
 Type: string
 Default: chocbit.org.au
-Description: Default mail domain?
- This option specifies the default domain name to be used for out going mail.
- The mail host name specified in the host setup will be appended to the
- start of this value to form the FQDN.
+_Description: Default mail domain
+ This option specifies the default domain name to be used for out going
+ mail. The mail host name specified in the host setup will be appended to
+ the start of this value to form the FQDN.
 
 Template: diskless-image/mailroute
 Type: string
 Default: smtp
-Description: Default mail route?
+_Description: Default mail route
  All mail, incoming and outgoing, is routed via this server.
 
 Template: diskless-image/devfs
 Type: select
-Choices: yes, no
+_Choices: yes, no
 Default: no
-Description: Use DEVFS for /dev?
+_Description: Use DEVFS for /dev?
  This option specifies whether or not you want to use the DEVFS system
  available via patch for Linux 2.2.x or 2.3.x (not tested).
diff -Nru ./diskless-0.3.18.0.2.ori/debian/diskless-image-simple.templates ./diskless-0.3.18.0.2/debian/diskless-image-simple.templates
--- ./diskless-0.3.18.0.2.ori/debian/diskless-image-simple.templates	2003-09-08 18:12:47.000000000 +0200
+++ ./diskless-0.3.18.0.2/debian/diskless-image-simple.templates	2003-09-09 18:27:00.000000000 +0200
@@ -1,76 +1,76 @@
 Template: diskless-image/master
 Type: string
 Default: master
-Description: Name of master?
- This option specifies the default name for the master host. This
- is required to be setup by some debian packages. It should have
- an entry in the DNS.
+_Description: Name of master
+ This option specifies the default name for the master host. This is
+ required to be setup by some Debian packages. It should have an entry in
+ the DNS.
 
 Template: diskless-image/nfsserver
 Type: string
 Default: 192.168.87.129
-Description: NFS server address?
+_Description: NFS server address
  This specifies the address of the central NFS server where to mount
- partitions from on the clients. It is recommended that this
- contain the IP address, although this is not required.
+ partitions from on the clients. It is recommended that this contain the IP
+ address, although this is not required.
 
 Template: diskless-image/nfsimagedir
 Type: string
 Default: /var/lib/diskless/default/root
-Description: NFS image directory mount point?
- This options specifies the path which will be used by the clients
- to mount the NFS image directory.
+_Description: NFS image directory mount point
+ This option specifies the path which will be used by the clients to mount
+ the NFS image directory.
 
 Template: diskless-image/nfshostsdir
 Type: string
 Default: /var/lib/diskless/default
-Description: Hosts' directories mount point?
- This options specifies the path which will be used by the clients
- to their private read-write directories.  The IP address
- will be appended to the end of this path.
+_Description: Hosts directories mount point
+ This option specifies the path which will be used by the clients to their
+ private read-write directories.  The IP address will be appended to the
+ end of this path.
 
 Template: diskless-image/nfshomedir
 Type: string
 Default: /home
-Description: NFS exported home directories?
- This specifies where /home on the clients should be mounted from your
- NFS server. Examples are /home, /tftpboot/home, etc. This directory must
- be exported on your NFS server via /etc/exports, and will be mounted as
- /home. Set this value to "none", if you don't want to mount /home (in
- this case, /home will be an empty read-only directory).
+_Description: NFS exported home directories
+ This specifies where /home on the clients should be mounted from your NFS
+ server. Examples are /home, /tftpboot/home, etc. This directory must be
+ exported on your NFS server via /etc/exports, and will be mounted as
+ /home. Set this value to "none", if you don't want to mount /home (in this
+ case, /home will be an empty read-only directory).
 
 Template: diskless-image/nameserver
 Type: string
 Default: 127.0.0.1
-Description: IP address of nameserver?
- This option specifies the default nameserver for each client in
- this group.
+_Description: IP address of nameserver
+ This option specifies the default nameserver for each client in this
+ group.
 
 Template: diskless-image/domain
 Type: string
 Default: chocbit.org.au
-Description: Domain?
- This option specifies the default DNS domain for each client in
- this group.
+_Description: Domain
+ This option specifies the default DNS domain for each client in this
+ group.
 
 Template: diskless-image/maildomain
 Type: string
 Default: chocbit.org.au
-Description: Default mail domain?
- This option specifies the default domain name to be used for out going mail.
- The mail host name specified in the host setup will be appended to the
- start of this value to form the FQDN.
+_Description: Default mail domain
+ This option specifies the default domain name to be used for out going
+ mail. The mail host name specified in the host setup will be appended to
+ the start of this value to form the FQDN.
 
 Template: diskless-image/mailroute
 Type: string
 Default: smtp
-Description: Default mail route?
+_Description: Default mail route
  All mail, incoming and outgoing, is routed via this server.
 
 Template: diskless-image/devfs
 Type: select
-Choices: yes, no
+_Choices: yes, no
 Default: no
-Description: Use DEVFS for /dev?
+_Description: Use DEVFS for /dev?
  This option specifies whether or not you want to use the DEVFS system
  available via patch for Linux 2.2.x or 2.3.x (not tested).
diff -Nru ./diskless-0.3.18.0.2.ori/debian/po/POTFILES.in ./diskless-0.3.18.0.2/debian/po/POTFILES.in
--- ./diskless-0.3.18.0.2.ori/debian/po/POTFILES.in	1970-01-01 01:00:00.000000000 +0100
+++ ./diskless-0.3.18.0.2/debian/po/POTFILES.in	2003-09-09 18:00:50.000000000 +0200
@@ -0,0 +1,2 @@
+[type: gettext/rfc822deb] diskless-image-secure.templates
+[type: gettext/rfc822deb] diskless-image-simple.templates
diff -Nru ./diskless-0.3.18.0.2.ori/debian/po/templates.pot ./diskless-0.3.18.0.2/debian/po/templates.pot
--- ./diskless-0.3.18.0.2.ori/debian/po/templates.pot	1970-01-01 01:00:00.000000000 +0100
+++ ./diskless-0.3.18.0.2/debian/po/templates.pot	2003-09-09 18:27:05.000000000 +0200
@@ -0,0 +1,159 @@
+#
+#    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: 2003-09-09 18:27+0200\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"
+
+#. Description
+#: ../diskless-image-secure.templates:4 ../diskless-image-simple.templates:4
+msgid "Name of master"
+msgstr ""
+
+#. Description
+#: ../diskless-image-secure.templates:4
+msgid ""
+"This option specifies the default name for the master host. This is required "
+"to be setup by some debian packages. It should have an entry in the DNS."
+msgstr ""
+
+#. Description
+#: ../diskless-image-secure.templates:12 ../diskless-image-simple.templates:12
+msgid "NFS server address"
+msgstr ""
+
+#. Description
+#: ../diskless-image-secure.templates:12 ../diskless-image-simple.templates:12
+msgid ""
+"This specifies the address of the central NFS server where to mount "
+"partitions from on the clients. It is recommended that this contain the IP "
+"address, although this is not required."
+msgstr ""
+
+#. Description
+#: ../diskless-image-secure.templates:20 ../diskless-image-simple.templates:20
+msgid "NFS image directory mount point"
+msgstr ""
+
+#. Description
+#: ../diskless-image-secure.templates:20 ../diskless-image-simple.templates:20
+msgid ""
+"This option specifies the path which will be used by the clients to mount "
+"the NFS image directory."
+msgstr ""
+
+#. Description
+#: ../diskless-image-secure.templates:27 ../diskless-image-simple.templates:27
+msgid "Hosts directories mount point"
+msgstr ""
+
+#. Description
+#: ../diskless-image-secure.templates:27 ../diskless-image-simple.templates:27
+msgid ""
+"This option specifies the path which will be used by the clients to their "
+"private read-write directories.  The IP address will be appended to the end "
+"of this path."
+msgstr ""
+
+#. Description
+#: ../diskless-image-secure.templates:35 ../diskless-image-simple.templates:35
+msgid "NFS exported home directories"
+msgstr ""
+
+#. Description
+#: ../diskless-image-secure.templates:35 ../diskless-image-simple.templates:35
+msgid ""
+"This specifies where /home on the clients should be mounted from your NFS "
+"server. Examples are /home, /tftpboot/home, etc. This directory must be "
+"exported on your NFS server via /etc/exports, and will be mounted as /home. "
+"Set this value to \"none\", if you don't want to mount /home (in this case, /"
+"home will be an empty read-only directory)."
+msgstr ""
+
+#. Description
+#: ../diskless-image-secure.templates:45 ../diskless-image-simple.templates:45
+msgid "IP address of nameserver"
+msgstr ""
+
+#. Description
+#: ../diskless-image-secure.templates:45 ../diskless-image-simple.templates:45
+msgid ""
+"This option specifies the default nameserver for each client in this group."
+msgstr ""
+
+#. Description
+#: ../diskless-image-secure.templates:52 ../diskless-image-simple.templates:52
+msgid "Domain"
+msgstr ""
+
+#. Description
+#: ../diskless-image-secure.templates:52 ../diskless-image-simple.templates:52
+msgid ""
+"This option specifies the default DNS domain for each client in this group."
+msgstr ""
+
+#. Description
+#: ../diskless-image-secure.templates:59 ../diskless-image-simple.templates:59
+msgid "Default mail domain"
+msgstr ""
+
+#. Description
+#: ../diskless-image-secure.templates:59 ../diskless-image-simple.templates:59
+msgid ""
+"This option specifies the default domain name to be used for out going mail. "
+"The mail host name specified in the host setup will be appended to the start "
+"of this value to form the FQDN."
+msgstr ""
+
+#. Description
+#: ../diskless-image-secure.templates:67 ../diskless-image-simple.templates:67
+msgid "Default mail route"
+msgstr ""
+
+#. Description
+#: ../diskless-image-secure.templates:67 ../diskless-image-simple.templates:67
+msgid "All mail, incoming and outgoing, is routed via this server."
+msgstr ""
+
+#. Choices
+#: ../diskless-image-secure.templates:72 ../diskless-image-simple.templates:72
+msgid "yes, no"
+msgstr ""
+
+#. Description
+#: ../diskless-image-secure.templates:74 ../diskless-image-simple.templates:74
+msgid "Use DEVFS for /dev?"
+msgstr ""
+
+#. Description
+#: ../diskless-image-secure.templates:74 ../diskless-image-simple.templates:74
+msgid ""
+"This option specifies whether or not you want to use the DEVFS system "
+"available via patch for Linux 2.2.x or 2.3.x (not tested)."
+msgstr ""
+
+#. Description
+#: ../diskless-image-simple.templates:4
+msgid ""
+"This option specifies the default name for the master host. This is required "
+"to be setup by some Debian packages. It should have an entry in the DNS."
+msgstr ""

Reply to: