Package: am-utils
Severity: minor
Tags: patch
Hi,
Most of your templates do not follow the developers-reference (see
http://www.debian.org/doc/manuals/developers-reference/ch-best-
pkging-practices.en.html#s-bpp-config-mgmt
for further details).
Here are my comments, a full patch is attached.
-Description: This is an internal template. No need for translation.
+Description: for internal use
Lintian does not check templates which have the string "for internal
use".
Template: am-utils/import-amd-conf
Type: boolean
-_Description: Import old amd configuration ?
+_Description: Import old amd configuration?
Typographical mistake.
- You seem to have amd configuration files available (the "amd"
package is
- the precursor to am-utils).
+ Amd configuration files seems to be available on this system
(the "amd"
+ package is the precursor to am-utils).
Suggested rephrasing.
- Would you like to try to import amd's configuration into am-utils ?
+ A mechanism has been developed to import these amd's
configuration files,
+ but it may fail in some cases.
The long description should give facts, not prompt the user or repeat
the same thing as in the short description.
Template: am-utils/log-to-file
Type: note
-_Description: Cannot log to file.
+_Description: Failed to log to file
[...]
Template: am-utils/import-amd-failed
Type: note
-_Description: Automatic import of amd's configuration failed.
+_Description: Automatic import of amd's configuration failed
The short description of a note template is a title.
Template: am-utils/use-nis
Type: boolean
Default: false
-_Description: Is the amd master map propagated through NIS ?
+_Description: Is the amd master map propagated through NIS?
Typographical mistake.
.
- We're just talking about the *master* map here.
+ Only the *master* map is concerned here.
Please never use first person. Just give facts.
Template: am-utils/nis-master-map
Type: string
Default: amd.master
-_Description: What is the name of the NIS master map ?
+_Description: Name of the NIS master map:
[...]
Type: select
_Choices: config, onekey, mountpoint, custom
Default: onekey
-_Description: What's the master map style ?
+_Description: Master map style:
[...]
Template: am-utils/nis-key
Type: string
Default: default
-_Description: What key should be used for this system ?
+_Description: Key to use for this system:
[...]
Template: am-utils/nis-custom
Type: string
Default: echo "/amd-is-misconfigured /usr/share/am-utils/amd.net"
-_Description: What command should be run to extract the master map ?
+_Description: Command to run to extract the master map:
The short description of a string template should be formatted as a
prompt.
Template: am-utils/map-net
Type: boolean
Default: true
-_Description: Use the net map ?
+_Description: Use the net map?
[...]
Template: am-utils/map-home
Type: boolean
Default: false
-_Description: Use the passwd map ?
+_Description: Use the passwd map?
Typographical mistake.
Template: am-utils/map-others
Type: string
-_Description: What other maps should be used ?
+_Description: Other maps to use:
The short description of a string template should be formatted as a
prompt.
- If you need to use other kinds of maps, you can enter them here...
+ If you need to use other kinds of maps, you can enter them here.
This punctuation is pointless.
Template: am-utils/clustername
Type: string
-_Description: What cluster name should be used?
+_Description: Cluster name to use:
The short description of a string template should be formatted as a
prompt.
-Template: am-utils/done
-Type: select
-_Choices: yes, no, abort
-Default: yes
-_Description: Are you happy with these settings ?
- If you choose "no", we will start the configuration over.
- .
- If you choose "abort", the configuration will be aborted and
you'll have to
- use "dpkg-reconfigure am-utils" to finish the configuration.
- .
- If you choose "yes", your current configuration will be used.
-
-Template: am-utils/reconfigure
-Type: note
-_Description: Configuration aborted...
- Remember to use "dpkg-reconfigure am-utils" to configure this
package.
Please do remove these templates. If it was needed, every package
would
need it, and it would be inside debconf. It only annoys the user
who has
to read one more screen to install the package.
Template: am-utils/config-reimport
Type: select
_Choices: import, discard, keep
Default: import
-_Description: Do you want to try importing your manual changes
to /etc/default/am-utils ?
+_Description: Action to perform for the manual changes:
The short description of a select template should be formatted as a
prompt.
- The /etc/default/am-utils file has been changed outside of debconf.
+ The /etc/default/am-utils file has been changed outside of the
package
+ configuration process.
.
- If you try to import it, some comments and formatting as well as
values
- unknown to debconf might be lost. If you just changed some
values, you
+ If you try to import it, some comments and formatting as well as
unknown
+ values might be lost. If you just changed some values, you
might be ok.
.
- If you discard the changes done manually, the values stored
inside debconf
- (from last time am-utils was configured with debconf) will be used.
+ If you discard the changes done manually, the values stored
during the
+ previous configuration of am-utils will be used.
Avoid refering to debconf. The user might not know what it is.
- You can also keep the manual configuration and leave everything
as it
- is...
+ You can also keep the manual configuration and leave everything
as it is.
Pointless punctuation, that gives a feeling of poor quality.
Template: am-utils/config-md5sum
Type: string
Default: none
-Description: This is an internal template. No need for translation.
+Description: for internal use
For lintian.
Please also note that many of these errors are noticed by lintian.
Cheers,
--
Thomas Huriaux
