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

[RFR] templates://masqmail/{masqmail.templates}



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

This review will last from Thursday, March 19, 2009 to Sunday, March 29, 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:
--- masqmail.old/debian/masqmail.templates	2009-03-11 09:14:01.471578065 +0100
+++ masqmail/debian/masqmail.templates	2009-03-19 08:17:17.190421051 +0100
@@ -1,25 +1,25 @@
 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.

Mentioning "debconf" explicitely is generally discouraged. After all,
the configuration system could change some day and, anyway, the
internal logic might be unknown to users. The recommended way is
talking about "automatic configuration" or similar wording.

Several subsequent changes are triggered by this choice.

"by you": this is not necessarily the person doing the install, so
replace it with "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.

s/absent/missing

 
 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.

"choose this option" is the most common wording, over "select this option".

 
@@ -28,56 +28,56 @@
 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 as SMTP greeting
+ banner, as well as unqualified addresses expansion, Message-ID field
+ generation and similar operations.

not "my" hostname but the one of the machine..:-)

Consistency in the enumeration....and be less vague than "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
+ considered "local". Mail to these hosts will be delivered to a
  mailbox (or Maildir or MDA) on this host.

Use double quotes (a standard we now encourage)

Avoir Latin abreviations that are not that welcomed in English.

  .
- 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
+ name and short name.
  .
- You can also use wildcard expressions like '*' and '?'.
+ You can also use wildcard expressions containing "*" and "?".

The wildcard expressions *contain* these characters but not only them.:-)

 
 Template: masqmail/local_nets
 Type: string
-_Description: Nets considered local:
+_Description: Networks considered local:

Unjargonize. For New-Yorkers, "Nets" might mean something else..:-)

  Please enter a list of hosts, separated with semicolons (;), which are
- on your local network, ie. they are always reachable, without a
+ on the local network. They should be always reachable, without a
  dialup connection. Mail to these hosts will be delivered immediately,
  without checking for the online status.

Another drop of Latin abreviation....and unpersonnalize

  .
- 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.

Again unpersonnalize (the person doing the install  is maybe not the
one "having" the machines....).

"internet" should be spelled "Internet" but we can avoid mentioning it
and just talk about "network". After all, Masmail can be used on
networks that are not connected to the Internet.

 
 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".

Mostly unpersonnalize, use double quotes, unlatinize.

 
 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.

Explicit what "syslog" is. Splitting hair in 4: syslog is used for
logging, not for logs..:-)
 
 Template: masqmail/online_detect
 Type: select
@@ -85,13 +85,12 @@
 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.
+ namely "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.

Layout change (that saves a lot of space on debconf screens which helps
translators). Use an enumeration (with hard-formatting).

 
 Template: masqmail/online_file
 Type: string
@@ -103,72 +102,70 @@
 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.

Make the sentence simpler.

 
 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 an 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.

Explicit what MDA is.

Rewording the second paragraph. Matter of taste..:-)

 
 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.

Unlatinize.

Mention what manpage we're talking about.

"substitutions" are variable substs...so just say it..:)

 
 Template: masqmail/alias_local_caseless
 Type: boolean
 Default: false
-_Description: Should alias expansion regard case?
+_Description: Should alias expansion be case sensitive?

"case sensitive" is the commonly accepted wordign in such case

  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.

Simplify the sentence
 
 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.

Mentioning mail clients opens the gates for frequent rewording to cope
with actuality (who is still using Netscape these days?), so just drop
this and assume people will know what an MUA is.


 
 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.

I chose to capitalize the name of the software...Debatable...
 
 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 an numeric value and one of the letters s,m,h,d,w for
+ seconds, minutes, hours, days or weeks respectively. For instance, "-q10m"
+ defines a 10 minutes running interval.
  .
  Reasonable values are between 5 minutes (-q5m) and 2 hours (-q2h).

Move the example after the general explanation about the syntax and,
of course, unlatinize.
 
@@ -176,13 +173,13 @@
 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.

*I* am not online...the server is..:)
 
 Template: masqmail/fetch_daemon_ival
 Type: string
@@ -198,30 +195,33 @@
 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?

Same than above. What's online is the server.

+ 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/.

"the ip-up script" is Masqmail's one.

 
 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/.

Same than above.
 
 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.

Consistent changes with previous style.

  .
- 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-19 08:19:06.298422298 +0100
@@ -13,11 +13,11 @@
 Suggests: mail-reader, logrotate
 Conflicts: mail-transport-agent
 Homepage: http://prog.marmaro.de/masqmail
-Description: A mailer for hosts without permanent internet connection
+Description: mail transport agent for intermittently connected hosts

Follow DevRef recommendations. No leading article. Rephrase.

  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.
+ that don't have a permanent network connection, such as a home network
+ server or a notebook computer. It has special support for
+ connections to different Internet Service Providers.

Same rationale than above. Internet connection  can be generalized to
"network connection".

Unjargonize ISP...:)

  .
  In these cases, MasqMail is a slim replacement for full-blown MTAs
  such as sendmail, exim, qmail or postfix. The POP3 client can be

-- 


Template: masqmail/manage_config_with_debconf
Type: boolean
Default: true
_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
 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 automatic configuration management.
 .
 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 choose this
 option, the existing configuration file will not be managed automatically,
 and no further questions about masqmail configuration will be
 asked.

Template: masqmail/host_name
Type: string
Default:
_Description: Masqmail host name:
 Please enter the name used by masqmail to identify itself to others.
 This is most likely the machine's hostname. It is used as SMTP greeting
 banner, as well as unqualified addresses expansion, Message-ID field
 generation and similar operations.

Template: masqmail/local_hosts
Type: string
_Description: Hosts considered local:
 Please enter a list of hosts, separated with semicolons (;), 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" as well as this host's fully
 name and short name.
 .
 You can also use wildcard expressions containing "*" and "?".

Template: masqmail/local_nets
Type: string
_Description: Networks considered local:
 Please enter a list of hosts, separated with semicolons (;), which are
 on the local network. 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 containing "*" and "?", for
 instance "*.yournet.local".
 .
 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:
 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 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,
 namely "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
Default: /var/run/masqmail-route
_Description: File used to determine the online status:

Template: masqmail/online_pipe
Type: string
Default:
_Description: Name of the program used to determine the online status:
 Please choose the program to use to determine the online
 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 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 variable substitution here,
 such as ${rcpt_local} for the user name.
 .
 Masqmail's manual page describes all available variable substitutions.
 .
 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 be case sensitive?
 Masqmail uses the file /etc/aliases to redirect local addresses.
 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
 daemon. You will need this if:
  - 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
 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 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.
 .
 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. For instance, "-q10m"
 defines a 10 minutes running interval.
 .
 Reasonable values are between 5 minutes (-q5m) and 2 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, 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 when the host becomes online.

Template: masqmail/fetch_daemon_ival
Type: string
Default: -go5m
_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.
 .
 Reasonable values are between 2 minutes (-go2m) and 2 hours (-go2h).

Template: masqmail/ipup_runqueue
Type: boolean
Default: true
_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 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:
 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 for instance "ppp0" for a home computer connected
 by PPP or "ppp0 eth0" for
 a notebook.
 .
 Other possible choices are "all" to listen on all network interfaces, or
 "none" for not listening on any interface.

--- masqmail.old/debian/masqmail.templates	2009-03-11 09:14:01.471578065 +0100
+++ masqmail/debian/masqmail.templates	2009-03-19 08:35:44.675958650 +0100
@@ -1,25 +1,25 @@
 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,56 +28,56 @@
 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 as SMTP greeting
+ banner, as well as unqualified addresses expansion, Message-ID field
+ generation and similar operations.
 
 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
+ 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
+ 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:
+_Description: Networks considered local:
  Please enter a list of hosts, separated with semicolons (;), which are
- on your local network, ie. they are always reachable, without a
+ on the local network. 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
@@ -85,13 +85,12 @@
 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.
+ namely "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,72 +102,70 @@
 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 an 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 an numeric value and one of the letters s,m,h,d,w for
+ seconds, minutes, hours, days or weeks respectively. For instance, "-q10m"
+ defines a 10 minutes running interval.
  .
  Reasonable values are between 5 minutes (-q5m) and 2 hours (-q2h).
 
@@ -176,13 +173,13 @@
 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
@@ -198,30 +195,33 @@
 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-19 08:19:06.298422298 +0100
@@ -13,11 +13,11 @@
 Suggests: mail-reader, logrotate
 Conflicts: mail-transport-agent
 Homepage: http://prog.marmaro.de/masqmail
-Description: A mailer for hosts without permanent internet connection
+Description: mail transport agent for intermittently connected hosts
  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.
+ that don't have a permanent network connection, such as a home network
+ server or a notebook computer. 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
Source: masqmail
Section: mail
Priority: extra
Maintainer: markus schnalke <meillo@marmaro.de>
Standards-Version: 3.8.0
Build-Depends: debhelper (>> 3.0), liblockfile-dev, libglib2.0-dev, libident-dev

Package: masqmail
Architecture: any
Depends: ${shlibs:Depends}, ${misc:Depends}, debconf (>> 0.5) | debconf-2.0, netbase, update-inetd
Replaces: mail-transport-agent
Provides: mail-transport-agent
Suggests: mail-reader, logrotate
Conflicts: mail-transport-agent
Homepage: http://prog.marmaro.de/masqmail
Description: mail transport agent for intermittently connected hosts
 MasqMail is an MTA (mail transport agent) and POP3 client for hosts
 that don't have a permanent network connection, such as a home network
 server or a notebook computer. 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.

Attachment: signature.asc
Description: Digital signature


Reply to: