[request-tracker-maintainers] [RFR] templates://rtfm/{templates}

[Christian Perrier]

All suggestions by Justin have been incorporated in my changes.

New patch attached.


About Niko's concerns: I propose continuing the review. If you have
changes ready before the end of the review process (before I send the
bug report with the proposed patch, then talk with us and we'll
integrate them.

If the changes come later, we will just need to be careful not doing
them *after* I start the second phase: the call for translations. It
would then be better to wait until the call for translations completes
to re-modify the templates and then call for updates to existing
translations.



-------------- next part --------------
--- rtfm.old/debian/templates	2007-10-19 07:50:33.343782503 +0200
+++ rtfm/debian/templates	2007-10-23 06:46:29.559374275 +0200
@@ -1,34 +1,38 @@
 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.
+ RTFM needs some database modifications 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/modify-database-prompt
 Type: boolean
 Default: true
+#flag:translate!:3
 _Description: Modify the database?
- It looks like RTFM needs a database modification to be functional: ${modification}.
+ A database modification is required for RTFM to be functional:
+ .
+ ${modification}
 
 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-19 07:50:33.343782503 +0200
+++ rtfm/debian/control	2007-10-23 06:48:01.554816768 +0200
@@ -13,15 +13,13 @@
  libyaml-perl, libtree-simple-perl, ${misc:Depends}, ${perl:Depends}, 
  debconf | debconf-2.0, ucf (>= 0.28)
 Description: RT FAQ Manager
- RTFM is an enterprise-grade knowledge management tool that enables an
- organization to easily capture and share its employees' knowledge and wisdom.
+ RTFM is a knowledge management tool implemented as an add-on to RT
+ (Request Tracker) that enables an organization to easily capture and
+ share its employees' knowledge and wisdom.
  .
  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.
+ 'articles'. Like RT, RTFM lets users contribute additional information
+ to existing articles. It guarantees that each article's full history is
+ preserved for future inspection. RTFM simplifies browsing in the
+ knowledge base and finding critical information.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: Digital signature
Url : http://lists.alioth.debian.org/pipermail/pkg-request-tracker-maintainers/attachments/20071023/f7658721/attachment-0003.pgp