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

[RFR] templates://mailagent/{templates.master}



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

This review will last from Wednesday, February 06, 2008 to Saturday, February 16, 2008.

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:
--- ../mailagent.old/debian/templates.master	2008-01-18 06:23:01.849400408 +0100
+++ debian/templates.master	2008-02-02 07:44:45.703486717 +0100
@@ -1,14 +1,14 @@
 Template: shared/news/organization
 Type: string
 Default: --none--
-_Description: Name of your organization:
- You don't seem to have an /etc/news/organization file. Usually that
- contains the name of your organization as you want it to appear on
- the Organization line of outgoing articles/mail/patches. Please
- supply the name of your organization as you want it to appear in
- those places.  (It would be useful if this also specifies your
- location.  Your city name is probably sufficient if well known.) For
- example: .
-    University of Southern North Dakota, Hoople
+_Description: Organization name:

More neutral. This is not necessarily "my" organization

+ The /etc/news/organization file does not exist. That file contains
+ the name of the organization this server belongs to so that it
+ appears on the Organization line of outgoing articles, mail or patches.

Again, more unpersonnalization.

  .
- Type in "--none--" if you do not want to specify one.
+ Please enter the name of the organization as you want it to appear in
+ those places. It is common practice to add a city name to the organization
+ name, for instance:
+  University of Southern North Dakota, Hoople
+ .
+ If you enter "--none--", no organization name will be setup.

Other changes are mostly splitting out in paragraphs for improved readability.


--- ../mailagent.old/debian/control	2008-01-18 06:23:01.837401460 +0100
+++ debian/control	2008-02-02 07:46:56.583485328 +0100
@@ -11,40 +11,34 @@
 Package: mailagent
 Depends: ${shlibs:Depends}, perl, debconf (>= 1.2.0) | debconf-2.0, exim4 | postfix | sendmail | mail-transport-agent
 Architecture: any
-Description: An automatic mail-processing tool and filter.
- Mailagent allows you to process your mail automatically. This has
- far more functionality than procmail, and is easier to configure
- (providing, of course, that you grok perl). As a mail processing
- tool, this slices, it dices, it ...
- .
- Given a set of lex-like rules, you are able to file mails to specific
- folders (plain Unix-style folders and also MMDF and MH ones), forward
- messages to a third person, pipe a message to a command or even post
- the message to a newsgroup.
+Description: automatic mail-processing tool and filter

drop leading article and capital letter

+ Mailagent processes mail automatically. It provides
+ ore functionality than procmail, and is generally considered to be
+ easier to configure with some Perl skills.
+ .
+ Given a set of lex-like rules, mails can be filed to specific
+ folders (plain Unix-style folders and also MMDF and MH ones), messages
+ may be forwarded to a third person, piped to a command or posted
+ to newsgroups.

Be more factual about what the program does. Whether it allows "me" or
other people may vary.....

I use more formal writing (yeah, Manoj, I know....) without excess, though.

  .
  It is also possible to process messages containing some commands. 
  .
- You may also set up a vacation program, which will automatically
- answer your mail while you are not there, but more flexibly than the
+ Mailfilter can be used to setup a vacation program, which will automatically
+ answer mail automatically with more flexibly than the

Again, not only "your" mail, ie the local admin, but for all users of
the system, hence the more neutral wording

  Unix command of the same name. You only need to supply a message to
  be sent and the frequency at which this will occur. Some simple macro
- substitutions allow you to re-use some parts of the mail header into
- your vacation message, for a more personalized reply. 
+ substitutions allow re-using some parts of the mail header into
+ vacation messages, for a more personalized reply. 
  .
- You may also set up a generic mail server, without the hassle of the
+ Mailfilter can also be used to setup a generic mail server, without the hassle of the
  lower-level concerns like error recovery, logging or command parsing. 
  .
- The mailagent is not usually invoked manually but is rather called
- via the filter program, which is in turn invoked by sendmail. That
- means you must have sendmail/smail on your system to use this. You
- also must have perl to run the mailagent scripts.
- .
  It is possible to extend the mailagent filtering commands by
- implementing them in perl and then having them automagically loaded
+ implementing them in Perl and then having them automagically loaded

Proper capitalization of Perl

  when used. 
  .
  Please note that on Debian systems, mailagent can not lock /var/spool/mail
- directory mailboxes, and thus one must put a catch all rule saving all mail 
+ directory mailboxes, and thus one must put a catch-all rule saving all mail 

hyphen

  in ones home directory. This is because Debian MDA policy requires them to 
  be setgid mail, and making anything as extensible as mailagent setgid 
  anything negates any benefit of having group permission protection.

-- 


Template: shared/news/organization
Type: string
Default: --none--
_Description: Organization name:
 The /etc/news/organization file does not exist. That file contains
 the name of the organization this server belongs to so that it
 appears on the Organization line of outgoing articles, mail or patches.
 .
 Please enter the name of the organization as you want it to appear in
 those places. It is common practice to add a city name to the organization
 name, for instance:
  University of Southern North Dakota, Hoople
 .
 If you enter "--none--", no organization name will be setup.
--- ../mailagent.old/debian/templates.master	2008-01-18 06:23:01.849400408 +0100
+++ debian/templates.master	2008-02-02 07:44:45.703486717 +0100
@@ -1,14 +1,14 @@
 Template: shared/news/organization
 Type: string
 Default: --none--
-_Description: Name of your organization:
- You don't seem to have an /etc/news/organization file. Usually that
- contains the name of your organization as you want it to appear on
- the Organization line of outgoing articles/mail/patches. Please
- supply the name of your organization as you want it to appear in
- those places.  (It would be useful if this also specifies your
- location.  Your city name is probably sufficient if well known.) For
- example: .
-    University of Southern North Dakota, Hoople
+_Description: Organization name:
+ The /etc/news/organization file does not exist. That file contains
+ the name of the organization this server belongs to so that it
+ appears on the Organization line of outgoing articles, mail or patches.
  .
- Type in "--none--" if you do not want to specify one.
+ Please enter the name of the organization as you want it to appear in
+ those places. It is common practice to add a city name to the organization
+ name, for instance:
+  University of Southern North Dakota, Hoople
+ .
+ If you enter "--none--", no organization name will be setup.
--- ../mailagent.old/debian/control	2008-01-18 06:23:01.837401460 +0100
+++ debian/control	2008-02-02 07:46:56.583485328 +0100
@@ -11,40 +11,34 @@
 Package: mailagent
 Depends: ${shlibs:Depends}, perl, debconf (>= 1.2.0) | debconf-2.0, exim4 | postfix | sendmail | mail-transport-agent
 Architecture: any
-Description: An automatic mail-processing tool and filter.
- Mailagent allows you to process your mail automatically. This has
- far more functionality than procmail, and is easier to configure
- (providing, of course, that you grok perl). As a mail processing
- tool, this slices, it dices, it ...
- .
- Given a set of lex-like rules, you are able to file mails to specific
- folders (plain Unix-style folders and also MMDF and MH ones), forward
- messages to a third person, pipe a message to a command or even post
- the message to a newsgroup.
+Description: automatic mail-processing tool and filter
+ Mailagent processes mail automatically. It provides
+ ore functionality than procmail, and is generally considered to be
+ easier to configure with some Perl skills.
+ .
+ Given a set of lex-like rules, mails can be filed to specific
+ folders (plain Unix-style folders and also MMDF and MH ones), messages
+ may be forwarded to a third person, piped to a command or posted
+ to newsgroups.
  .
  It is also possible to process messages containing some commands. 
  .
- You may also set up a vacation program, which will automatically
- answer your mail while you are not there, but more flexibly than the
+ Mailfilter can be used to setup a vacation program, which will automatically
+ answer mail automatically with more flexibly than the
  Unix command of the same name. You only need to supply a message to
  be sent and the frequency at which this will occur. Some simple macro
- substitutions allow you to re-use some parts of the mail header into
- your vacation message, for a more personalized reply. 
+ substitutions allow re-using some parts of the mail header into
+ vacation messages, for a more personalized reply. 
  .
- You may also set up a generic mail server, without the hassle of the
+ Mailfilter can also be used to setup a generic mail server, without the hassle of the
  lower-level concerns like error recovery, logging or command parsing. 
  .
- The mailagent is not usually invoked manually but is rather called
- via the filter program, which is in turn invoked by sendmail. That
- means you must have sendmail/smail on your system to use this. You
- also must have perl to run the mailagent scripts.
- .
  It is possible to extend the mailagent filtering commands by
- implementing them in perl and then having them automagically loaded
+ implementing them in Perl and then having them automagically loaded
  when used. 
  .
  Please note that on Debian systems, mailagent can not lock /var/spool/mail
- directory mailboxes, and thus one must put a catch all rule saving all mail 
+ directory mailboxes, and thus one must put a catch-all rule saving all mail 
  in ones home directory. This is because Debian MDA policy requires them to 
  be setgid mail, and making anything as extensible as mailagent setgid 
  anything negates any benefit of having group permission protection.
Source: mailagent
XS-VCS-Arch: http://arch.debian.org/arch/private/srivasta/grab/mailagent
XS-VCS-Browse: http://arch.debian.org/cgi-bin/archzoom.cgi/srivasta@debian.org--lenny/mailagent?expand
Section: mail
Priority: optional
Maintainer: Manoj Srivastava <srivasta@debian.org>
Standards-Version: 3.7.2.0
Build-Depends: groff-base, po-debconf, file, gettext
 

Package: mailagent
Depends: ${shlibs:Depends}, perl, debconf (>= 1.2.0) | debconf-2.0, exim4 | postfix | sendmail | mail-transport-agent
Architecture: any
Description: automatic mail-processing tool and filter
 Mailagent processes mail automatically. It provides
 ore functionality than procmail, and is generally considered to be
 easier to configure with some Perl skills.
 .
 Given a set of lex-like rules, mails can be filed to specific
 folders (plain Unix-style folders and also MMDF and MH ones), messages
 may be forwarded to a third person, piped to a command or posted
 to newsgroups.
 .
 It is also possible to process messages containing some commands. 
 .
 Mailfilter can be used to setup a vacation program, which will automatically
 answer mail automatically with more flexibly than the
 Unix command of the same name. You only need to supply a message to
 be sent and the frequency at which this will occur. Some simple macro
 substitutions allow re-using some parts of the mail header into
 vacation messages, for a more personalized reply. 
 .
 Mailfilter can also be used to setup a generic mail server, without the hassle of the
 lower-level concerns like error recovery, logging or command parsing. 
 .
 It is possible to extend the mailagent filtering commands by
 implementing them in Perl and then having them automagically loaded
 when used. 
 .
 Please note that on Debian systems, mailagent can not lock /var/spool/mail
 directory mailboxes, and thus one must put a catch-all rule saving all mail 
 in ones home directory. This is because Debian MDA policy requires them to 
 be setgid mail, and making anything as extensible as mailagent setgid 
 anything negates any benefit of having group permission protection.

Attachment: signature.asc
Description: Digital signature


Reply to: