[Pkg-gridengine-devel] Bug#488216: gridengine: Debconf templates do not follow the writing style recommended in DevRef

[Christian Perrier]

Package: gridengine
Severity: normal
Tags: patch

A few minor things can be enhanced in the recently added debconf templates
wording.

--- gridengine-common.templates.old	2008-06-27 09:05:37.338802089 +0200
+++ gridengine-common.templates	2008-06-27 09:07:12.842801514 +0200
@@ -1,22 +1,23 @@
 Template: shared/gridengineconfig
 Type: boolean
 Default: true
-_Description: Use debconf to configure SGE?
- Please choose whether you wish to use debconf in order to configure SGE.
- If you answer no to this question, you will need to configure the cluster
- manually before any of the daemons or client programs will work.
+_Description: Configure SGE automatically?
+ Please choose whether you wish configure SGE automatically (with
+ debconf). If you do not configure it automatically, the daemons or client
+ programs will not work until a manual configuration is performed.

Direct references to "debconf" is discouraged. Users might not know what
this is. The usual recommendation is a mention to "automatic configuration".

 Template: shared/gridenginecell
 Type: string
 Default: default
 _Description: SGE cell name:
  Please provide the SGE cell name for use by client programs and the
- execution daemon
+ execution daemon.

Missing final dot

 Template: shared/gridenginemaster
 Type: string
 _Description: SGE master hostname:
  The execution daemon and the client programs need to know where the cluster
- master is in order to run.  The hostname entered here must be the fully
- qualified domain name of the grid master.
+ master is in order to run.
+ .
+ Please enter the fully qualified domain name of the grid master.

Separate the important recommendation in its own paragraph. Use the "standard"
wording in such case.


Please also note that you seem to be using 4 different (but identical)
templates files. These should all be mentioned in debian/po/POTFILES.in if
you want all debconf templates to be translated.

Of course, if the above changes are made, they should go in all templates
files...

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

Kernel: Linux 2.6.25-2-686 (SMP w/1 CPU core)
Locale: LANG=fr_FR.UTF-8, LC_CTYPE=fr_FR.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
-------------- next part --------------
--- gridengine-common.templates.old	2008-06-27 09:05:37.338802089 +0200
+++ gridengine-common.templates	2008-06-27 09:10:31.306801568 +0200
@@ -1,22 +1,23 @@
 Template: shared/gridengineconfig
 Type: boolean
 Default: true
-_Description: Use debconf to configure SGE?
- Please choose whether you wish to use debconf in order to configure SGE.
- If you answer no to this question, you will need to configure the cluster
- manually before any of the daemons or client programs will work.
+_Description: Configure SGE automatically?
+ Please choose whether you wish configure SGE automatically (with
+ debconf). If you do not configure it automatically, the daemons or client
+ programs will not work until a manual configuration is performed.
 
 Template: shared/gridenginecell
 Type: string
 Default: default
 _Description: SGE cell name:
  Please provide the SGE cell name for use by client programs and the
- execution daemon
+ execution daemon.
 
 Template: shared/gridenginemaster
 Type: string
 _Description: SGE master hostname:
  The execution daemon and the client programs need to know where the cluster
- master is in order to run.  The hostname entered here must be the fully
- qualified domain name of the grid master.
+ master is in order to run.
+ .
+ Please enter the fully qualified domain name of the grid master.