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