--- Begin Message ---
Package: cfal
Version: 1.2.0-3
Severity: wishlist
Tags: patch l10n
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.
- update the style to the best current practice (see below)
For more details, see po-debconf documentation, especially "man 7
po-debconf"
This patch also document the most important modifications in the changelog.
Use this as a sample, and please feel free to change it to fit your taste.
If you want to give me credit for this, write my name but avoid to publish
my email address there since I already get enough spam.
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:
-------------------------
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
I applied the advices from this document concerning the short descriptions,
but you may want to change the long descriptions accordingly as well, for
example to make them clearer even to newbies. 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.
Bye, Mt.
-- System Information:
Debian Release: 3.1
APT prefers testing
APT policy: (500, 'testing')
Architecture: i386 (i686)
Kernel: Linux 2.6.7-1-686
Locale: [EMAIL PROTECTED], [EMAIL PROTECTED]
diff -ruN cfal-1.2.0.cpy/debian/control cfal-1.2.0/debian/control
--- cfal-1.2.0.cpy/debian/control 2004-11-29 23:37:20.000000000 +0100
+++ cfal-1.2.0/debian/control 2004-11-29 23:38:17.000000000 +0100
@@ -1,13 +1,13 @@
Source: cfal
Section: contrib/devel
Priority: extra
-Build-Depends: debhelper
+Build-Depends: debhelper (>= 4.1.16)
Maintainer: Adam C. Powell, IV <[EMAIL PROTECTED]>
Standards-Version: 3.5.2.0
Package: cfal
Architecture: alpha
-Depends: debconf (>= 0.5), cpio, binutils, libc6.1-dev, cpp, libots, cpml,
cfalrtl (>= 1.2.0-2)
+Depends: debconf (>= 1.2.0), cpio, binutils, libc6.1-dev, cpp, libots, cpml,
cfalrtl (>= 1.2.0-2)
Suggests: cxml
Provides: fortran-compiler
Description: Compaq Fortran Compiler for Linux Alpha
diff -ruN cfal-1.2.0.cpy/debian/po/POTFILES.in cfal-1.2.0/debian/po/POTFILES.in
--- cfal-1.2.0.cpy/debian/po/POTFILES.in 1970-01-01 01:00:00.000000000
+0100
+++ cfal-1.2.0/debian/po/POTFILES.in 2004-11-29 23:37:41.000000000 +0100
@@ -0,0 +1 @@
+[type: gettext/rfc822deb] templates
diff -ruN cfal-1.2.0.cpy/debian/po/templates.pot
cfal-1.2.0/debian/po/templates.pot
--- cfal-1.2.0.cpy/debian/po/templates.pot 1970-01-01 01:00:00.000000000
+0100
+++ cfal-1.2.0/debian/po/templates.pot 2004-11-29 23:40:14.000000000 +0100
@@ -0,0 +1,143 @@
+#
+# 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-11-29 23:40+0100\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: boolean
+#. Description
+#: ../templates:4
+msgid "Would you like to run the cfal installer now?"
+msgstr ""
+
+#. Type: boolean
+#. Description
+#: ../templates:4
+msgid ""
+"This is the Compaq cfal installer package, it does not actually contain "
+"cfal. You will need to go download cfal by hand, in a file named "
+"${filename}. Once you have downloaded it you can proceed and tell the "
+"installer which directory you put it in."
+msgstr ""
+
+#. Type: string
+#. Description
+#: ../templates:13
+msgid "Compaq cfal has been downloaded to where?"
+msgstr ""
+
+#. Type: string
+#. Description
+#: ../templates:13
+msgid ""
+"Please visit the Compaq FORTRAN Alpha Linux Compiler web page now, which is "
+"linked from http://www.support.compaq.com/alpha-tools/ , and if you agree to "
+"their terms and conditions, then download the Red Hat RPM of cfal. The file "
+"should be named ${filename}.crypt. You then need to decrypt it by running:"
+msgstr ""
+
+#. Type: string
+#. Description
+#: ../templates:13
+msgid "gpg --output ${filename} --decrypt ${filename}.crypt"
+msgstr ""
+
+#. Type: string
+#. Description
+#: ../templates:13
+msgid ""
+"and supply the password provided by Compaq. Once you have the RPM file, "
+"enter the directory you put it in (full absolute path please). Also make "
+"sure that permissions on the file allow it to be read."
+msgstr ""
+
+#. Type: boolean
+#. Description
+#: ../templates:29
+msgid "Delete RPM file once it is installed?"
+msgstr ""
+
+#. Type: boolean
+#. Description
+#: ../templates:29
+msgid ""
+"Should the RPM file be automatically deleted after installation? Otherwise, "
+"you will have to delete it later by hand."
+msgstr ""
+
+#. Type: note
+#. Description
+#: ../templates:35
+msgid "Cannot find the downloaded Compaq cfal file."
+msgstr ""
+
+#. Type: note
+#. Description
+#: ../templates:35
+msgid ""
+"The file ${filename} does not exist, or it is corrupt. You may have "
+"downloaded the wrong file, or put it in the wrong location. Please try again."
+msgstr ""
+
+#. Type: note
+#. Description
+#: ../templates:35
+msgid ""
+"If the file you downloaded has a different name, the filename may have "
+"changed since this installer was last updated. You can still try to use the "
+"installer; just rename the file you downloaded to ${filename} . Note that if "
+"you do this, there is no guarantee the installer will work. You may need to "
+"get a more recent version of this installer from Debian's \"unstable\" "
+"distribution. We are sorry if this is inconvenient but we do not have "
+"permission to redistribute Compaq cfal."
+msgstr ""
+
+#. Type: note
+#. Description
+#: ../templates:50
+msgid "The Compaq cfal installer cannot proceed."
+msgstr ""
+
+#. Type: note
+#. Description
+#: ../templates:50
+msgid ""
+"You are running in non-interactive mode, and the Compaq cfal installer needs "
+"to prompt you to download a file for it to install, and cannot. The "
+"installation of this package has been aborted. Please re-install it in "
+"interactive mode."
+msgstr ""
+
+#. Type: note
+#. Description
+#: ../templates:58
+msgid "Compaq cfal install delayed"
+msgstr ""
+
+#. Type: note
+#. Description
+#: ../templates:58
+msgid ""
+"You have opted not to run the Compaq cfal installer at this time. If you "
+"decide to run it later you can do so by running \"dpkg-reconfigure cfal\"."
+msgstr ""
diff -ruN cfal-1.2.0.cpy/debian/rules cfal-1.2.0/debian/rules
--- cfal-1.2.0.cpy/debian/rules 2004-11-29 23:37:20.000000000 +0100
+++ cfal-1.2.0/debian/rules 2004-11-29 23:37:55.000000000 +0100
@@ -10,6 +10,7 @@
clean:
dh_testdir
dh_clean
+ debconf-updatepo
binary-indep:
# Nothing to do.
diff -ruN cfal-1.2.0.cpy/debian/templates cfal-1.2.0/debian/templates
--- cfal-1.2.0.cpy/debian/templates 2004-11-29 23:37:20.000000000 +0100
+++ cfal-1.2.0/debian/templates 2004-11-29 23:39:57.000000000 +0100
@@ -1,58 +1,60 @@
Template: cfal/intro
Type: boolean
Default: true
-Description: Would you like to run the cfal installer now?
- This is the Compaq cfal installer package, it does not actually contain cfal.
- You will need to go download cfal by hand, in a file named ${filename}. Once
- you have downloaded it you can proceed and tell the installer which directory
- you put it in.
+_Description: Would you like to run the cfal installer now?
+ This is the Compaq cfal installer package, it does not actually contain
+ cfal. You will need to go download cfal by hand, in a file named
+ ${filename}. Once you have downloaded it you can proceed and tell the
+ installer which directory you put it in.
Template: cfal/download_dir
Type: string
Default: /root
-Description: Compaq cfal has been downloaded to where?
- Please visit the Compaq FORTRAN Alpha Linux Compiler web page now, which is
- linked from http://www.support.compaq.com/alpha-tools/ , and if you agree to
- their terms and conditions, then download the Red Hat RPM of cfal. The file
- should be named ${filename}.crypt. You then need to decrypt it by running:
+_Description: Compaq cfal has been downloaded to where?
+ Please visit the Compaq FORTRAN Alpha Linux Compiler web page now, which
+ is linked from http://www.support.compaq.com/alpha-tools/ , and if you
+ agree to their terms and conditions, then download the Red Hat RPM of
+ cfal. The file should be named ${filename}.crypt. You then need to
+ decrypt it by running:
.
gpg --output ${filename} --decrypt ${filename}.crypt
.
- and supply the password provided by Compaq. Once you have the RPM file, enter
- the directory you put it in (full absolute path please). Also make sure that
- permissions on the file allow it to be read.
+ and supply the password provided by Compaq. Once you have the RPM file,
+ enter the directory you put it in (full absolute path please). Also make
+ sure that permissions on the file allow it to be read.
Template: cfal/deletefile
Type: boolean
-Default: false
-Description: Delete RPM file once it is installed?
- Can I delete the RPM file once it has been installed? Otherwise, you will have
- to delete it later by hand.
+Default: false
+_Description: Delete RPM file once it is installed?
+ Should the RPM file be automatically deleted after installation?
+ Otherwise, you will have to delete it later by hand.
Template: cfal/badfile
Type: note
-Description: Cannot find the downloaded Compaq cfal file.
- The file ${filename} does not exist, or it is corrupt. You may have downloaded
- the wrong file, or put it in the wrong location. Please try again.
+_Description: Cannot find the downloaded Compaq cfal file.
+ The file ${filename} does not exist, or it is corrupt. You may have
+ downloaded the wrong file, or put it in the wrong location. Please try
+ again.
.
- If the file you downloaded has a different name, the filename may have changed
- since this installer was last updated. You can still try to use the installer;
- just rename the file you downloaded to ${filename} . Note that if you do this,
- there is no guarantee the installer will work. You may need to get a more
- recent version of this installer from Debian's "unstable" distribution. We are
- sorry if this is inconvenient but we do not have permission to redistribute
- Compaq cfal.
+ If the file you downloaded has a different name, the filename may have
+ changed since this installer was last updated. You can still try to use
+ the installer; just rename the file you downloaded to ${filename} . Note
+ that if you do this, there is no guarantee the installer will work. You
+ may need to get a more recent version of this installer from Debian's
+ "unstable" distribution. We are sorry if this is inconvenient but we do
+ not have permission to redistribute Compaq cfal.
Template: cfal/needfile
Type: note
-Description: The Compaq cfal installer cannot proceed.
- You are running in non-interactive mode, and the Compaq cfal installer needs
- to prompt you to download a file for it to install, and cannot. The
+_Description: The Compaq cfal installer cannot proceed.
+ You are running in non-interactive mode, and the Compaq cfal installer
+ needs to prompt you to download a file for it to install, and cannot. The
installation of this package has been aborted. Please re-install it in
interactive mode.
Template: cfal/later
Type: note
-Description: Compaq cfal install delayed
+_Description: Compaq cfal install delayed
You have opted not to run the Compaq cfal installer at this time. If you
decide to run it later you can do so by running "dpkg-reconfigure cfal".
--- End Message ---
