[request-tracker-maintainers] Bug#449516: rtfm: [debconf_rewrite] Debconf templates and debian/control review

Tue Nov 6 09:11:41 UTC 2007

Package: rtfm
Version: N/A
Severity: normal
Tags: patch

Dear Debian maintainer,

On Monday, October 22, 2007, I notified you of the beginning of a review process
concerning debconf templates for rtfm.

The debian-l10n-english contributors have now reviewed these templates,
and the proposed changes are attached to this bug report.

Please review the suggested changes are suggested, and if you have any
objections, let me know in the next 3 days.

Please try to avoid uploading rtfm with these changes right now.

The second phase of this process will begin on Friday, November 09, 2007, when I will
coordinate updates to translations of debconf templates.

The existing translators will be notified of the changes: they will
receive an updated PO file for their language.

Simultaneously, a general call for new translations will be sent to
the debian-i18n mailing list.

Both these calls for translations will request updates to be sent as
individual bug reports. That will probably trigger a lot of bug
reports against your package, but these should be easier to deal with.

The call for translation updates and new translations will run until
about Friday, November 30, 2007. Please avoid uploading a package with fixed or changed
debconf templates and/or translation updates in the meantime. Of
course, other changes are safe.

Please note that this is an approximative delay, which depends on my
own availability to process this work and is influenced by the fact
that I simultaneously work on many packages.

Around <DAY25>, I will contact you again and will send a final patch
summarizing all the updates (changes to debconf templates,
updates to debconf translations and new debconf translations).

Again, thanks for your attention and cooperation.


-- System Information:
Debian Release: lenny/sid
  APT prefers unstable
  APT policy: (500, 'unstable'), (1, 'experimental')
Architecture: i386 (i686)

Kernel: Linux 2.6.22-3-686 (SMP w/1 CPU core)
Locale: LANG=C, LC_CTYPE=C (charmap=ANSI_X3.4-1968)
Shell: /bin/sh linked to /bin/dash
-------------- next part --------------

--- rtfm.old/debian/templates	2007-10-26 06:44:55.775875248 +0200
+++ rtfm/debian/templates	2007-11-06 10:11:37.074372301 +0100
@@ -1,41 +1,52 @@
+# These templates have been reviewed by the debian-l10n-english
+# team
+#
+# If modifications/additions/rewording are needed, please ask
+# debian-l10n-english at lists.debian.org for advice.
+#
+# Even minor modifications require translation updates and such
+# changes should be coordinated with translators and reviewers.
+
 Template: rt3.6-rtfm/modify-database-permission
 Type: select
-_Choices: allow, prompt, deny
+__Choices: allow, prompt, deny
 Default: allow
-_Description: Permission to modify the database:
- RTFM needs some database modifications to be functional.  If you want, the
- installation procedure can make these modifications automatically or
- prompt you when they are needed. Alternatively, you can run the necessary
- commands manually. See README.Debian.
+_Description: Permission to modify the Request Tracker database:
+ RTFM needs some modifications in the Request Tracker database to be
+ functional. These modifications can be made automatically or
+ you may be prompted when they are needed. Alternatively, you can run
+ the necessary commands manually.
+ .
+ Please check the README.Debian file for more details.
 
 Template: rt3.6-rtfm/setup-database-prompt
 Type: boolean
 Default: true
-_Description: Set up the database for RTFM?
- New tables must be created in the RT database for RTFM to be functional.
+_Description: Set up the Request Tracker database?
+ New tables must be created in the Request Tracker database for RTFM
+ to be functional.
 
 Template: rt3.6-rtfm/upgrade-database-prompt
 Type: boolean
 Default: true
-_Description: Upgrade the database?
- The RT database schema and contents must be upgraded for this version
- of RTFM.
+_Description: Upgrade the Request Tracker database?
+ The Request Tracker database schema and contents must be upgraded for
+ this version of RTFM.
 
 Template: rt3.6-rtfm/modify-database-error
 Type: select
-_Choices: abort, retry, ignore
+__Choices: abort, retry, ignore
 Default: abort
-_Description: Error modifying the database. Solution:
- An error seems to have occurred while modifying the database. If it's of
- any help, this was the error encountered:
+#flag:translate!:3
+_Description: Action after database modification error:
+ An error occurred while modifying the database:
  .
  ${error}
  .
  The full output should be available in the RT log, most probably syslog.
  .
- You can either retry, abort the installation or ignore the error. If you
- want to retry, another attempt will be made at performing the operation.
- If you abort, the operation will fail and you will need to downgrade,
- reinstall, reconfigure the package, or otherwise manually intervene to
- continue using it.  If you choose to ignore the error, the operation will
- continue.
+ You can retry the modification, abort the installation or ignore the
+ error. If you abort the installation, the operation will fail and
+ you will need to manually intervene (for instance by purging and
+ reinstalling). If you choose to ignore the error, the upgrade process
+ will continue.
--- rtfm.old/debian/control	2007-10-26 06:44:55.775875248 +0200
+++ rtfm/debian/control	2007-10-26 06:45:45.273423117 +0200
@@ -12,16 +12,16 @@
 Depends: request-tracker3.6, libhtml-tree-perl, libtime-modules-perl, 
  libyaml-perl, libtree-simple-perl, ${misc:Depends}, ${perl:Depends}, 
  debconf | debconf-2.0, ucf (>= 0.28)
-Description: RT FAQ Manager for Request Tracker 3.6
- RTFM is an enterprise-grade knowledge management tool that enables an
- organization to easily capture and share its employees' knowledge and wisdom.
+Description: FAQ Manager for Request Tracker 3.6
+ RTFM is an add-on to Request Tracker (RT), the extensible ticketing
+ system. It provides a knowledge management tool to help an
+ organization collect and share the knowledge and wisdom of its
+ members.
  .
- Just as you use RT (Request Tracker, the open-source ticketing system) to log
- tickets and resolve issues, RTFM lets you open, categorize and search for
- "articles." Like RT, RTFM lets your users contribute additional information
- to existing articles and makes sure that each article's full history is
- preserved for future inspection. RTFM makes it easy to quickly search the
- knowledge base and find critical information.
- .
- RTFM is implemented as an add-on to RT. This package integrates with
- RT 3.6, available in the request-tracker3.6 package.
+ Just as you use RT to log tickets and resolve issues, RTFM lets you
+ create, categorize and search for 'articles'. Like RT, RTFM lets
+ users contribute additional information to existing articles, but
+ guarantees that each article's full history is preserved for future
+ inspection. RTFM simplifies browsing in the knowledge base and
+ finding critical information.
+
