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