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

Dear Debian maintainer,

On Sunday, March 15, 2009, I notified you of the beginning of a review process
concerning debconf templates for masqmail.

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, and if you have any
objections, let me know in the next 3 days.

However, please try to avoid uploading masqmail with these changes
right now.

The second phase of this process will begin on Sunday, April 05, 2009, 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 Sunday, April 26, 2009. 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 Monday, April 27, 2009, 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: squeeze/sid
Architecture: i386 (i686)

Kernel: Linux 2.6.28-1-686 (SMP w/1 CPU core)
Locale: LANG=C, LC_CTYPE=C (charmap=ANSI_X3.4-1968)
Shell: /bin/sh linked to /bin/dash
--- masqmail.old/debian/masqmail.templates      2009-03-11 09:14:01.471578065 
+0100
+++ masqmail/debian/masqmail.templates  2009-04-02 08:18:09.233801525 +0200
@@ -1,25 +1,34 @@
+# These templates have been reviewed by the debian-l10n-english
+# team
+#
+# If modifications/additions/rewording are needed, please ask
+# debian-l10n-engl...@lists.debian.org for advice.
+#
+# Even minor modifications require translation updates and such
+# changes should be coordinated with translators and reviewers.
+
 Template: masqmail/manage_config_with_debconf
 Type: boolean
 Default: true
-_Description: Manage masqmail.conf using debconf?
- The /etc/masqmail/masqmail.conf file can be handled automatically
- by debconf, or manually by you.
+_Description: Manage masqmail.conf automatically?
+ The /etc/masqmail/masqmail.conf file can be handled automatically by
+ answering a few questions, or entirely manually by the local administrator.
  .
  Note that only specific, marked sections of the configuration file will be
- handled by debconf if you select this option; if those markers are absent,
- you will have to update the file manually, or move or delete the file.
+ managed this way if you choose this option; if those markers are missing,
+ you will have to update the file manually, or remove the file.
 
 Template: masqmail/move_existing_nondebconf_config
 Type: boolean
 Default: false
 _Description: Replace existing /etc/masqmail/masqmail.conf file?
  The existing /etc/masqmail/masqmail.conf file currently on the system does
- not contain a marked section for debconf to write its data.
+ not contain a marked section for automatic configuration management.
  .
- If you select this option, the existing configuration
+ If you choose this option, the existing configuration
  file will be backed up to /etc/masqmail/masqmail.conf.debconf-backup and a
- new file written to /etc/masqmail/masqmail.conf.  If you do not select this
- option, the existing configuration file will not be managed by debconf,
+ new file written to /etc/masqmail/masqmail.conf.  If you do not choose this
+ option, the existing configuration file will not be managed automatically,
  and no further questions about masqmail configuration will be
  asked.
 
@@ -28,70 +37,69 @@
 Default:
 _Description: Masqmail host name:
  Please enter the name used by masqmail to identify itself to others.
- This is most likely your hostname. It is used in its SMTP greeting
- banner, for expanding unqualified addresses, the Message ID and so on.
+ This is most likely the machine's hostname. It is used in the SMTP
+ greetings banner and generated Message-ID fields, as well as for
+ expansion of unqualified addresses, and so on.
 
 Template: masqmail/local_hosts
 Type: string
 _Description: Hosts considered local:
- Please enter a list of hosts, separated with semicolons (;), which are
- considered 'local', ie. mail to these hosts will be delivered to a
+ Please enter a list, separated with semicolons (;), of hosts which are
+ considered "local". Mail to these hosts will be delivered to a
  mailbox (or Maildir or MDA) on this host.
  .
- You will most likely insert 'localhost', your hostname in its fully
- qualified form and just the simple hostname here.
+ You will most likely insert "localhost" as well as this host's fully
+ qualified name and short name.
  .
- You can also use wildcard expressions like '*' and '?'.
+ You can also use wildcard expressions containing "*" and "?".
 
 Template: masqmail/local_nets
 Type: string
-_Description: Nets considered local:
- Please enter a list of hosts, separated with semicolons (;), which are
- on your local network, ie. they are always reachable, without a
+_Description: Networks considered local:
+ Please enter a list, separated with semicolons (;), of hosts which are
+ on the local network. That is, they should be always reachable, without a
  dialup connection. Mail to these hosts will be delivered immediately,
  without checking for the online status.
  .
- You can use wildcard expressions like '*' and '?', eg. *.yournet.local
+ You can use wildcard expressions containing "*" and "?", for
+ instance "*.yournet.local".
  .
- If you have only one box, you can leave this empty. If you do not want
- to use masqmail as an offline MTA, and the whole internet or another mail
- server which accepts outgoing mail is at all times
- reachable to you, just insert '*'.
+ That field can be left empty if this host is the only host on the
+ network. If you do not want
+ to use Masqmail as an offline MTA and all servers likely to receive
+ outbound mail from this host are always reachable, just use "*"
+ here.
 
 Template: masqmail/listen_addresses
 Type: string
 Default: localhost:25
 _Description: Interfaces for incoming connections:
- Masqmail, for security reasons, does not listen an all network
- interfaces by default. If there are no other hosts connected to your
- host, just leave the default 'localhost:25' value. If there are other
- hosts that may want to send SMTP messages to this host, add the
- address of your network interface here, eg.:
- localhost:25;192.168.1.2:25.
- .
- Of course you can also replace the '25' with another port number, however
- this is unusual.
+ For security reasons, Masqmail does not listen an all network
+ interfaces by default. If there are no other hosts connected to this
+ host, "localhost:25" is enough for local operation. If there are other
+ hosts that need to send SMTP mail to this host, you should add the
+ address of the relevant network interface, for instance
+ "localhost:25;192.168.1.2:25".
 
 Template: masqmail/use_syslog
 Type: boolean
 Default: false
-_Description: Use syslogd for logs?
- You can decide whether masqmail should log via syslog or not. If not,
- logs will be written to /var/log/masqmail/masqmail.log.
+_Description: Use the system log daemon for logging?
+ Masqmail may log via the system log daemon (syslog) or use its
+ own custom logging in /var/log/masqmail/masqmail.log.
 
 Template: masqmail/online_detect
 Type: select
 __Choices: file, pipe
 Default: file
 _Description: Online detection method:
- Masqmail has different methods to determine whether it is online or not,
- these are 'file','pipe'.
- .
- For 'file', masqmail checks for the existence of a file, and, if it
- exists, reads from it the name of the connection.
- .
- For 'pipe', masqmail calls a program or script, which outputs the name
- if online or nothing if not. You can use eg. the program guessnet for this.
+ Masqmail has two methods to determine whether it is online or not:
+ "file" and "pipe".
+  - With "file", it checks for the existence of a file. If it
+    exists, the name of the connection is read from that file.
+  - With "pipe", it calls a program or script, which outputs the name
+    if online or nothing if not. The "guessnet" program is a good
+    candidate for such use.
 
 Template: masqmail/online_file
 Type: string
@@ -103,86 +111,85 @@
 Default:
 _Description: Name of the program used to determine the online status:
  Please choose the program to use to determine the online
- status. Please note that, when this program is called, masqmail has
- the user id 'mail'.
+ status. This program is called with "mail" as user ID.
 
 Template: masqmail/mbox_default
 Type: select
 Choices: mbox, mda, maildir
 Default: mbox
 _Description: Local delivery style:
- Local mail can be delivered to a mailbox, to an MDA (eg. procmail)
- or to a qmail style Maildir in the users home dir.
- .
- You can select the default style here. You can configure this also
- on a per-user basis with the options mbox_users, mda_users and
- maildir_users.
+ Local mail can be delivered to a mailbox, to a mail delivery
+ agent (MDA) such as procmail
+ or to Maildir-style mailboxes in the users' home directories.
+ .
+ This choice affects the default delivery mechanism. It can be defined
+ on a per-user basis with the "mbox_users", "mda_users" and
+ "maildir_users" options.
 
 Template: masqmail/mda
 Type: string
 Default: /usr/bin/procmail -Y -d ${rcpt_local}
 _Description: MDA command line (including options):
  Please choose the path to the mail delivery agent (MDA), including
- its arguments. You can use substitution values here,
- eg. ${rcpt_local} for the user name.
+ its arguments. You can use variable substitution here,
+ such as ${rcpt_local} for the user name.
  .
- For other substitutions please see the man page.
+ Masqmail's manual page describes all available variable substitutions.
  .
- This question is also asked if you did not set mbox_default to mda,
- since you can use mda for a set of users specially.
+ This question is meaningful even when choosing another option than
+ MDA delivery, in case MDA is used for a restricted set of users.
 
 Template: masqmail/alias_local_caseless
 Type: boolean
 Default: false
-_Description: Should alias expansion regard case?
+_Description: Should alias expansion be case sensitive?
  Masqmail uses the file /etc/aliases to redirect local addresses.
- The search for a match in /etc/aliases can be regarding upper/lower
- case or insensitive to case.
+ The search for a match in /etc/aliases can be case sensitive or not.
 
 Template: masqmail/init_smtp_daemon
 Type: boolean
 Default: true
 _Description: Start SMTP listening daemon?
- Please choose whether you want masqmail to start as an SMTP listening
+ Please choose whether you want Masqmail to start as an SMTP listening
  daemon. You will need this if:
-  - there are other hosts in your local network that may want to send
-    mail via this host
-  - you use a mail client that sends mail via SMTP (netscape,
-    mozilla are examples)
+  - there are other hosts in the local network that may want to send
+    mail via this host;
+  - you use a local mail client that sends mail via SMTP.
 
 Template: masqmail/init_queue_daemon
 Type: boolean
 Default: true
 _Description: Start SMTP queue running daemon?
- Please choose this option if you want masqmail to start as a queue
+ Please choose this option if you want Masqmail to start as a queue
  running daemon. You're very likely to need this. It is used for mail
  that cannot delivered immediately, either because of delivery
- failures or because you were not online on the first attempt to send
+ failures or because the host is not online on the first attempt to send
  a mail.
 
 Template: masqmail/queue_daemon_ival
 Type: string
 Default: -q10m
 _Description: Interval for the queue running daemon:
- Please choose the interval for the queue running daemon. -q10m means
- flush the queue every 10 minutes.
+ Please choose the interval for the queue running daemon.
  .
- The format is -q, followed by an numeric value and one of the letters 
s,m,h,d,w for
- seconds, minutes, hours, days or weeks respectively.
+ The format is "-q", followed by a numeric value and one of the letters
+ s, m, h, d, or w, for seconds, minutes, hours, days, or weeks,
+ respectively. For instance, "-q10m" defines a ten-minute interval
+ between runs.
  .
- Reasonable values are between 5 minutes (-q5m) and 2 hours (-q2h).
+ Reasonable values are between five minutes (-q5m) and two hours (-q2h).
 
 Template: masqmail/init_fetch_daemon
 Type: boolean
 Default: false
 _Description: Start POP3 fetch daemon?
- Please choose this option if you want masqmail to start as a fetch
- daemon. If you do so, masqmail will try to fetch mail from POP3
- servers that you configure in regular intervals, detecting the online
+ Please choose this option if you want Masqmail to start as a fetch
+ daemon. If you do so, it will try to fetch mail from configured POP3
+ servers, detecting the online
  status first.
  .
  No matter what you choose here, you can later select whether you want to fetch
- mail the moment you get online.
+ mail when the host becomes online.
 
 Template: masqmail/fetch_daemon_ival
 Type: string
@@ -190,38 +197,42 @@
 _Description: Interval for the fetch daemon:
  Please choose the interval for the fetch daemon.
  .
- The format is -go, followed by an numeric value and one of the letters 
s,m,h,d,w for
- seconds, minutes, hours, days or weeks respectively.
+ The format is "-go", followed by a numeric value and one of the letters
+ s, m, h, d, or w, for seconds, minutes, hours, days, or weeks,
+ respectively.
  .
- Reasonable values are between 2 minutes (-go2m) and 2 hours (-go2h).
+ Reasonable values are between two minutes (-go2m) and two hours (-go2h).
 
 Template: masqmail/ipup_runqueue
 Type: boolean
 Default: true
-_Description: Flush mail queue when you get online?
- Please choose whether you want masqmail to immediately flush its mail
- queue as soon as you go online. This will be done in the ip-up script
+_Description: Flush mail queue when online?
+ Please choose whether you want Masqmail to immediately flush its mail
+ queue as soon as the host comes online. This will be done by Masqmail's
+ ip-up script
  in /etc/ppp/ip-up or in /etc/network/if-up.d/.
 
 Template: masqmail/ipup_fetch
 Type: boolean
 Default: false
-_Description: Fetch mail when you get online?
- Please choose whether you want masqmail to immediately fetch mail
- from POP3 servers as soon as you go online. This will be done in the
- ip-up script in /etc/ppp/ip-up or in /etc/network/if-up.d/.
+_Description: Fetch mail when online?
+ Please choose whether you want Masqmail to immediately fetch mail
+ from POP3 servers as soon as the host comes online. This will be done
+ by Masqmail's ip-up script in /etc/ppp/ip-up or in /etc/network/if-up.d/.
 
 Template: masqmail/ifup_ifaces
 Type: string
 Default: all
-_Description: List of interfaces used for masqmail online detection:
+_Description: List of interfaces used for Masqmail online detection:
  Please choose a list of network interfaces which will trigger queue
  runs and/or fetching mails when going up. The list will be used in
  the /etc/ppp/ip-up and /etc/network/if-up.d/ scripts, when the
  interface goes up.
  .
- A reasonable choice is eg. 'ppp0' for a desktop at home, or 'ppp0 eth0' for
+ A reasonable choice is for instance "ppp0" for a home computer connected
+ by PPP or "ppp0 eth0" for
  a notebook.
  .
- Set to 'all' for all interfaces, or 'none' for no interfaces.
+ Other possible choices are "all" to listen on all network interfaces, or
+ "none" for not listening on any interface.
 
--- masqmail.old/debian/control 2009-03-11 09:14:01.467578127 +0100
+++ masqmail/debian/control     2009-03-31 07:27:21.885146556 +0200
@@ -13,12 +13,12 @@
 Suggests: mail-reader, logrotate
 Conflicts: mail-transport-agent
 Homepage: http://prog.marmaro.de/masqmail
-Description: A mailer for hosts without permanent internet connection
- MasqMail is an MTA (mail transport agent) and POP3 client for hosts
- that don't have a permanent internet connection, eg. a home network
- or a single host at home and notebooks. It has special support for
- connections to different ISPs.
+Description: mail transport agent for intermittently connected hosts
+ Masqmail is an MTA (mail transport agent) and POP3 client for hosts
+ with no permanent network connection, such as home network servers
+ or notebook computers. It has special support for connections to
+ different Internet Service Providers.
  .
- In these cases, MasqMail is a slim replacement for full-blown MTAs
- such as sendmail, exim, qmail or postfix. The POP3 client can be
- a small replacement for other full-featured tools like fetchmail.
+ In these cases, Masqmail is a slim replacement for full-blown MTAs
+ such as Sendmail, Exim, Qmail or Postfix. The POP3 client can be
+ a small replacement for other full-featured tools like Fetchmail.

Reply via email to