[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

[RFR] templates://mopd/{templates}



Please find, for review, the debconf templates and packages descriptions for the mopd source package.

This review will last from Friday, January 02, 2009 to Monday, January 12, 2009.

Please send reviews as unified diffs (diff -u) against the original
files. Comments about your proposed changes will be appreciated.

Your review should be sent as an answer to this mail.

When appropriate, I will send intermediate requests for review, with
"[RFRn]" (n>=2) as a subject tag.

When we will reach a consensus, I send a "Last Chance For
Comments" mail with "[LCFC]" as a subject tag.

Finally, the reviewed templates will be sent to the package maintainer
as a bug report, and a mail will be sent to this list with "[BTS]" as
a subject tag.

Rationale:
--- ../mopd.old/debian/templates	2009-01-02 19:02:58.748394156 +0100
+++ debian/templates	2009-01-02 19:08:24.369033489 +0100
@@ -1,20 +1,27 @@
 Template: mopd/other_interface
 Type: string
-_Description: Enter an interface:
+_Description: Interface for mopd:
  Please enter the interface you would like to run mopd on.

String templates are generally worded as "prompts". Hence following
that usage.

 
 Template: mopd/bad_interface
-Type: note
-_Description: mopd's currently configured interface is unavailable
- A configuration exists in /etc/mopd.conf.  The interface indicated in that
- file '${cur_iface}' does not appear to be available.  Please resolve the
+Type: error
+_Description: Non existing interface for mopd
+ The MOP daemon configuration already exists as /etc/mopd.conf.
+ .
+ However, that configuration file specifies '${cur_iface}' as listening
+ interface but it currently does not exist.
+ .
+ You should resolve this
  situation by manually editing the configuration file appropriately. Until
  this issue is resolved it is likely that mopd will not function correctly.

This template is more an "error" than a note....

Complete sentences as discouraged as synopsis for such templates...

I splitted the paragraphs in shorter paragraphs to improve readability.

I'm not entirely happy with my wording for the second
paragraphs. Other -l10n-english readers (and native speakers...),
suggestions welcomed !

 
 Template: mopd/interface
 Type: select
-_Choices: other, all, ${choices}
-_Description: Interface:
+#flag:translate!:3
+__Choices: other, all, ${choices}

See po-debconf(7) for tricks about "#flag"....

Splitting choices for easier translation. The third one is not
translatable, of course.

+_Description: Interface for mopd:
  Please choose the interface you would like to run mopd on, or select
- 'other' if the interface is not in this list, select 'all' if you would
- like mopd to listen on all interfaces.
+ 'other' if the interface is not in this list.
+ .
+ If you want mopd to listen on all interfaces, please choose 'all'.

Splitting in two sentences and paragraphs.



I am not happy at all with the package description, but I can't find
anything. I have no idea what MOPD is....and I'm afraid that the
package description doesn't help for this...:-)

Maintainer, it's probably up to you to explain us what is
MOPD.... ;and that would become the package description...:-)


-- 


Template: mopd/other_interface
Type: string
_Description: Interface for mopd:
 Please enter the interface you would like to run mopd on.

Template: mopd/bad_interface
Type: error
_Description: Non existing interface for mopd
 The MOP daemon configuration already exists as /etc/mopd.conf.
 .
 However, that configuration file specifies '${cur_iface}' as listening
 interface but it currently does not exist.
 .
 You should resolve this
 situation by manually editing the configuration file appropriately. Until
 this issue is resolved it is likely that mopd will not function correctly.

Template: mopd/interface
Type: select
#flag:translate!:3
__Choices: other, all, ${choices}
_Description: Interface for mopd:
 Please choose the interface you would like to run mopd on, or select
 'other' if the interface is not in this list.
 .
 If you want mopd to listen on all interfaces, please choose 'all'.
--- ../mopd.old/debian/templates	2009-01-02 19:02:58.748394156 +0100
+++ debian/templates	2009-01-02 19:08:24.369033489 +0100
@@ -1,20 +1,27 @@
 Template: mopd/other_interface
 Type: string
-_Description: Enter an interface:
+_Description: Interface for mopd:
  Please enter the interface you would like to run mopd on.
 
 Template: mopd/bad_interface
-Type: note
-_Description: mopd's currently configured interface is unavailable
- A configuration exists in /etc/mopd.conf.  The interface indicated in that
- file '${cur_iface}' does not appear to be available.  Please resolve the
+Type: error
+_Description: Non existing interface for mopd
+ The MOP daemon configuration already exists as /etc/mopd.conf.
+ .
+ However, that configuration file specifies '${cur_iface}' as listening
+ interface but it durrently does not exist.an interface indicated in that
+ file '${cur_iface}' does not appear to be available.
+ .
+ You should resolve this
  situation by manually editing the configuration file appropriately. Until
  this issue is resolved it is likely that mopd will not function correctly.
 
 Template: mopd/interface
 Type: select
-_Choices: other, all, ${choices}
-_Description: Interface:
+#flag:translate!:3
+__Choices: other, all, ${choices}
+_Description: Interface for mopd:
  Please choose the interface you would like to run mopd on, or select
- 'other' if the interface is not in this list, select 'all' if you would
- like mopd to listen on all interfaces.
+ 'other' if the interface is not in this list.
+ .
+ If you want mopd to listen on all interfaces, please choose 'all'.
Source: mopd
Section: net
Priority: extra
Maintainer: Christine Caulfield <christine.caulfield@googlemail.com>
Build-Depends: debhelper (>= 4.1.16), libelfg0-dev
Standards-Version: 3.5.6.0

Package: mopd
Architecture: any
Depends: ${shlibs:Depends}, debconf | debconf-2.0
Description: The Maintenance Operations Protocol (MOP) loader daemon
 The MOP daemon services MOP load requests on one or all Ethernet interfaces.
 Normally, a filename (uppercase and ending in .SYS) is included in the load 
 request.

Attachment: signature.asc
Description: Digital signature


Reply to: