[pkg-fetchmail-maint] Bug#241883: marked as done (fetchmail: man page and code comments & messages are unclear on global vars and their default vals)

Debian Bug Tracking System owner at bugs.debian.org
Fri Jan 13 12:03:20 UTC 2006


Your message dated Fri, 13 Jan 2006 03:47:06 -0800
with message-id <E1ExNOc-0006Ck-3X at spohr.debian.org>
and subject line Bug#241883: fixed in fetchmail 6.3.1-1
has caused the attached Bug report to be marked as done.

This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
Bug report if necessary, and/or fix the problem forthwith.

(NB: If you are a system administrator and have no idea what I am
talking about this indicates a serious mail system misconfiguration
somewhere.  Please contact me immediately.)

Debian bug tracking system administrator
(administrator, Debian Bugs database)

--------------------------------------
Received: (at submit) by bugs.debian.org; 3 Apr 2004 16:48:53 +0000
>From swift at alum.mit.edu Sat Apr 03 08:48:53 2004
Return-path: <swift at alum.mit.edu>
Received: from pool-68-163-244-218.bos.east.verizon.net (beth.swift.xxx) [68.163.244.218] (root)
	by spohr.debian.org with esmtp (Exim 3.35 1 (Debian))
	id 1B9oKD-00081c-00; Sat, 03 Apr 2004 08:48:53 -0800
Received: from beth.swift.xxx (swift at localhost.swift.xxx [127.0.0.1])
	by beth.swift.xxx (8.12.11/8.12.11/Debian-3) with ESMTP id i33GmbJQ020297
	(version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT)
	for <submit at bugs.debian.org>; Sat, 3 Apr 2004 11:48:37 -0500
Received: (from swift at localhost)
	by beth.swift.xxx (8.12.11/8.12.11/Debian-3) id i33GmbdO020295;
	Sat, 3 Apr 2004 11:48:37 -0500
To: Debian Bug Tracking System <submit at bugs.debian.org>
Subject: fetchmail: man page and code comments & messages are unclear on
 global vars and their default vals
From: Matt Swift <swift at alum.mit.edu>
Date: Sat, 03 Apr 2004 11:48:36 -0500
Message-ID: <m265chknx7.fsf at beth.swift.xxx>
User-Agent: Gnus/5.110002 (No Gnus v0.2) Emacs/21.3 (gnu/linux)
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-Transfinites-MailScanner: clean
X-Transfinites-MailScanner-SpamCheck: not spam, SpamAssassin (score=-4.9,
	required 6, autolearn=not spam, BAYES_00 -4.90)
X-MailScanner-From: swift at alum.mit.edu
Delivered-To: submit at bugs.debian.org
X-Spam-Checker-Version: SpamAssassin 2.60-bugs.debian.org_2004_03_25 
	(1.212-2003-09-23-exp) on spohr.debian.org
X-Spam-Status: No, hits=-6.0 required=4.0 tests=BAYES_30,HAS_PACKAGE 
	autolearn=no version=2.60-bugs.debian.org_2004_03_25
X-Spam-Level: 

Package: fetchmail
Version: 6.2.5-5
Severity: normal

When global options are mentioned in the man page, the words "global
option" should be used.

The discussions of the meaning of global options and their associated
command-line options should cross-reference each other and references
to each concept (e.g., local postmaster) elsewhere in the man page
should consistently refer to the global options (since it ought to be
just one, and the command-line options do not offer all the
functionality of the global options).

Following are a number of particular comments and revisions; some of
them implement the two general comments above, but they are NOT the
complete set of revisions that ought to be made in response to the two
general comments above.


The section on global options in the man page should
(1) explain that the boolean variables can set with or without the word "no,"
(2) say what the default value is, and
(3) list the three boolean options (bouncemail, spambounce, syslog) consecutively.

For example

    set    bouncemail		Direct error mail to the sender (DEFAULT).
    set no bouncemail		Direct error mail to the local postmaster (see 'postmaster' global option).
    set no spambounce		Do not bounce spam-blocked mail (DEFAULT).
    set    spambounce		Bounce spam-blocked mail to destination indicated by 'bouncemail' global option.
    set no syslog		Do not log errors through syslog(3) (DEFAULT).
    set    syslog		Log errors through syslog(3).



---------QUOTING FROM THE MAN PAGE:

[INCORRECT: revise per list of all global options above]
set no spambounce      Send spam bounces


[CONFUSING: revise per list of all global options above]
set no bouncemail      Direct error mail to postmaster rather than sender


[CORRECT; CONFUSING: say "global option",
                     say default is off,
                     say destination of bounce is determined by
                       setting of global option 'bouncemail'.]
If the 'spambounce' option is on, mail that is spam-blocked triggers an
RFC1892 bounce message informing the originator that we do not accept mail
from it.


[INCOMPLETE: revise to reflect three uses of 'postmaster' as described
             below]
set postmaster         Give the name of the last-resort mail recipient


[CONFUSING: revise to "sending bounces due to errors or spam-blocking"
            or simply to "sending bounces"]
Fetchmail's method of sending bouncemail and spam bounces requires
that port 25 of localhost be available for sending mail via SMTP.


[CONFUSING: make discussion of command-line option a cross-reference
            to full discussion under the associated 'bouncemail' global option]
The --nobounce option suppresses the normal action of bouncing errors
back to the sender in an RFC1894-conformant error message.  If
nobounce is on, the message will go to the postmaster instead.


[CONFUSING: say "'bouncemail' global option"
            replace paren phrase with (see the 'postmaster' global option)]

if 'nobounce' is on it will go to the postmaster (which in turn
defaults to being the calling user).


[INCOMPLETE: this "postmaster" is used for three purposes:
             multidrop-last-resort, error-bounces, and spam-block-bounces;
             the FETCHMAILUSER envariable ought to be explained at the same time;
             this discussion should appear under the 'postmaster'
             global option and the discussion of the command-line
             option and envariable should refer to this.]

The --postmaster <name> option (keyword: set postmaster) specifies the
last-resort username to which multidrop mail is to be forwarded if no
matching local recipient can be found.  Normally this is just the user
who invoked fetchmail.  If the invoking user is root, then the default
of this option is the user 'postmaster'.  Setting postmaster to the
empty string causes such mail to be discarded.


[INCOMPLETE: as above]
The 'set postmaster' statement sets the address to which multidrop
mail defaults if there are no local matches.


[CONFUSING: move this explanation as described above]

If the FETCHMAILUSER variable is set, it is used as the name of the
calling user (default local name) for purposes such as mailing error
notifications.  Otherwise, if either the LOGNAME or USER variable is
correctly set (e.g. the corresponding UID matches the session user ID)
then that name is used as the default local name.  Otherwise
getpwuid(3) must be able to retrieve a password entry for the session
ID (this elaborate logic is designed to handle the case of multiple
names per userid gracefully).


---------------QUOTING FROM fetchmail.c:

[INCOMPLETE: this value is used for THREE purposes as described above]

    if (runp->postmaster)
	printf(GT_("Fetchmail will forward misaddressed multidrop messages to %s.\n"),
	       runp->postmaster);


-- System Information:
Debian Release: testing/unstable
  APT prefers unstable
  APT policy: (500, 'unstable')
Architecture: i386 (i686)
Kernel: Linux 2.4.23
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8

Versions of packages fetchmail depends on:
ii  adduser                     3.52         Add and remove users and groups
ii  base-files                  3.0.14       Debian base system miscellaneous f
ii  debconf                     1.4.21       Debian configuration management sy
ii  debianutils                 2.8.1        Miscellaneous utilities specific t
ii  libc6                       2.3.2.ds1-11 GNU C Library: Shared libraries an
ii  libssl0.9.7                 0.9.7d-1     SSL shared libraries

-- debconf information:
* fetchmail/confwarn: 
  fetchmail/initdefaultswarn: 
* fetchmail/systemwide: false
  fetchmail/runasroot: false
  fetchmail/fetchidswarn: 

---------------------------------------
Received: (at 241883-close) by bugs.debian.org; 13 Jan 2006 11:50:53 +0000
>From katie at ftp-master.debian.org Fri Jan 13 03:50:53 2006
Return-path: <katie at ftp-master.debian.org>
Received: from katie by spohr.debian.org with local (Exim 4.50)
	id 1ExNOc-0006Ck-3X; Fri, 13 Jan 2006 03:47:06 -0800
From: Hector Garcia <hector at debian.org>
To: 241883-close at bugs.debian.org
X-Katie: $Revision: 1.65 $
Subject: Bug#241883: fixed in fetchmail 6.3.1-1
Message-Id: <E1ExNOc-0006Ck-3X at spohr.debian.org>
Sender: Archive Administrator <katie at ftp-master.debian.org>
Date: Fri, 13 Jan 2006 03:47:06 -0800
X-Spam-Checker-Version: SpamAssassin 2.60-bugs.debian.org_2005_01_02 
	(1.212-2003-09-23-exp) on spohr.debian.org
X-Spam-Level: 
X-Spam-Status: No, hits=-6.0 required=4.0 tests=BAYES_00,HAS_BUG_NUMBER 
	autolearn=no version=2.60-bugs.debian.org_2005_01_02
X-CrossAssassin-Score: 19

Source: fetchmail
Source-Version: 6.3.1-1

We believe that the bug you reported is fixed in the latest version of
fetchmail, which is due to be installed in the Debian FTP archive:

fetchmail_6.3.1-1.diff.gz
  to pool/main/f/fetchmail/fetchmail_6.3.1-1.diff.gz
fetchmail_6.3.1-1.dsc
  to pool/main/f/fetchmail/fetchmail_6.3.1-1.dsc
fetchmail_6.3.1-1_i386.deb
  to pool/main/f/fetchmail/fetchmail_6.3.1-1_i386.deb
fetchmail_6.3.1.orig.tar.gz
  to pool/main/f/fetchmail/fetchmail_6.3.1.orig.tar.gz
fetchmailconf_6.3.1-1_all.deb
  to pool/main/f/fetchmail/fetchmailconf_6.3.1-1_all.deb



A summary of the changes between this version and the previous one is
attached.

Thank you for reporting the bug, which will now be closed.  If you
have further comments please address them to 241883 at bugs.debian.org,
and the maintainer will reopen the bug report if appropriate.

Debian distribution maintenance software
pp.
Hector Garcia <hector at debian.org> (supplier of updated fetchmail package)

(This message was generated automatically at their request; if you
believe that there is a problem with it please contact the archive
administrators by mailing ftpmaster at debian.org)


-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Format: 1.7
Date: Fri, 13 Jan 2006 12:01:10 +0100
Source: fetchmail
Binary: fetchmailconf fetchmail
Architecture: source i386 all
Version: 6.3.1-1
Distribution: unstable
Urgency: low
Maintainer: Fetchmail Maintainers <pkg-fetchmail-maint at lists.alioth.debian.org>
Changed-By: Hector Garcia <hector at debian.org>
Description: 
 fetchmail  - SSL enabled POP3, APOP, IMAP mail gatherer/forwarder
 fetchmailconf - fetchmail configurator
Closes: 156094 207919 212240 213299 213484 218040 224564 229014 230615 241883 242384 244828 276044 276424 277324 296163 298557 301348 301964 304701 304701 316446 316454 317761 320645 323028 327250 329975 338007 340630 344582 345263 345944
Changes: 
 fetchmail (6.3.1-1) unstable; urgency=low
 .
   [ Nico Golde ]
   * New upstream release
     - Fixed tracepolls problem for 2nd user in skip stanza (Closes: #156094).
     - Corrected global option descriptions in manpage (Closes: #241883).
     - Progress dots will appear now (Closes: #298557).
     - Fixed manpage typos (Closes: #323028).
     - Fixed character encoding of fetchmail daemon (Closes: #277324).
     - Fixed broken subjects in notification mails (Closes: #301348)
     - uidl usage is not switched on by default anymore (Closes: #304701).
     - Security fix. CVE-2005-4348 (Closes: #345944).
     - Ipv6 is now enabled by default (Closes: #345263, #329975).
   * Removed de.po fix because upstream included it.
   * Added Homepage tag to control file.
   * Update manpage patch to current version.
   * Removed flex and bison from build depends, they are no longer needed.
   * Fetchmail now uses gettext.
   * Removed --enable-ipv6 (its default now) and --enable-netsec cause
     it is no longer working.
   * Added call to make update-gmo to fix localisation problems (Closes: #340630).
   * Updated copyright file.
   * Removed Loïc Minier from uploaders.
   * Added fetchmail-ssl removal to NEWS file.
   * Removed xutils dependency because makedepend is not necessary since 6.3.0.
   * Moved fetchmail home directory to /var/lib/fetchmail (Closes: #327250).
   * Removed NEWS.truncated file from installation and replaced with OLDNEWS.
 .
   [ Hector Garcia ]
   * Remove man1 from mandir on install time. (change on the packaging).
   * Added myself to uploaders.
   * Added patch to fix warning on fetchmail man page. Should submit upstream.
   * Included gettext on build-depend.
   * Included patch to update es.po. Already sended patch to usual translator.
   * Added /etc/default/fetchmail to define when to start fetchmail or not
     (Closes: #344582, #218040, #276044).
   * Added NEWS.Debian to explain above.
   * Made changes on control file to delete properly old fetchmail-ssl. I must
     ask ftpmaster to delete it from archive.
   * Removed depend on base-files (>= 2.2.0). Woody was released with 3.0.2
   * Fixed a problem on debian/rules that was forcing configure to be called twice.
   * Changed UIDL file to /var/lib/fetchmail/.fetchmail-UIDL-cache since now
     upstream needs to write more files on same dir, hence /var/mail it is not
     suitable.
   * Added python to build-depends.
 .
 fetchmail (6.3.0-1) unstable; urgency=low
 .
   * New upstream release.
     - Security fix. CVE-2005-2335 and CVE-2005-3088
     - Drop support for OS not conforming to the Single Unix Specification v2
       or v3 (aka IEEE Std 1003.1-2001).
     - Default for --smtphost is now always "localhost".
     - Force fetchsizelimit to 1 for APOP and RPOP.
     - Patch, to use a NULL envelope from, not write a Return-Path header (both to
       meet RFC-2821), changed From, added Subject header, rewording the human
       readable part.  (Closes: #316446).
     - Patch to avoid a segfault in multidrop/received mode when the
       Received: headers are malformatted.
     - MIME-encode bodies and Subject headers of warning messages, limiting
       the header to 7 bits.
     - Normalize most locale codesets to IANA codesets.
     - Nico Golde's patch to support "proto RPOP" in the configuration file,
       reported. (Closes: #242384)
     - Added Russian translation.
     - Dropped da=Danish, el=Greek and tr=Turkish translations which have more
       than 10% (61+) untranslated or fuzzy messages.
     - Major fetchmail(1) manual page overhaul.
     - Fix fetchmail leaks sockets when SSL negotiation fails.
       (Closes: #301964).
     - Really fix (garbage in Received: lines when smtphostset).
       (Closes: #207919).
     - When writing the PID file, write a FHS 2.3 compliant PID file.
       (Closes: #230615).
     - Make ODMR really silent, suppress "fetchmail: receiving message data".
      (Closes: #296163).
     - Add From: header to warning emails. (Closes: #244828).
     - Fix IMAP code to use password of arbitrary length from configuration
       file (although not when read interactively). (Closes: #276424).
     - Document that fetchmail may automatically enable UIDL option.
       (Closes: #304701).
     - Put *BOLD* text into the manual page near --mda to state unmistakably
       that the --mda %T and %F substitutions add single quotes, hoping to avoid
       bogus bug reports. (Closes: #224564).
     - gettext (intl/) has been removed from the fetchmail package.
     - Use of automake.
     - Rename fetchmailconf to fetchmailconf.py. Created a /bin/sh wrapper.
     - New dummy fetchmailconf manual page.
     - fetchmailconf redirects fetchmail's input from /dev/null so it doesn't
       wait for the user to enter a password when the user doesn't even see the prompt.
     - Write RFC-compliant BSMTP envelopes.
     - Received: headers now enclose the for <...> destination address in angle
       brackets for consistency with Postfix.
     - Delete oversized messages with the new --limitflush option.
       (Closes: #212240).
     - Add full support for --service option.
     - Make "envelope 'Delivered-To'" work with dropdelivered.
     - fetchmail should now automatically detect if OpenSSL requires -ldl
     - Missed --port/--service/--ssl cleanups in the manual.
     - Properly shut down SSL connections.
     - Add support for SubjectAltName (RFC-2595 or 2818), to avoid bogus certificate
       mismatch errors. Patch by Roland Stigge, Debian Bug#201113. (MA)
     - make fetchmail --silent --quit really silent. (Closes: #229014)
     - Exit with error if the lock file cannot be read.
     - Do not break some other process's lockfile in "-q" mode, but wait for
       the other process's exit.
     - Man page: --sslfingerprint points user to x509(1ssl) and gives an
          example how to use it. (Closes: #213484)
     - Try to obtain FQDN as our own host by default, rather than using
      "localhost". If hostname cannot be qualified, complain noisily and continue,
       unless Kerberos, ODMR or ETRN are used (these require a FQDN).
       Partial fix of Debian Bug#150137. (Closes: #316454).
     - fetchmailconf now sets the service properly after autoprobe.
       (Closes: #320645).
     - When eating IMAP message trailer, don't see any line containing "OK"
       as the end of the trailer, but wait for the proper tagged OK line. To work
       around the qmail + Courier-IMAP problem in Debian. (Closes: #338007).
     - Fixes: when trying to send a bounce message, don't bail out if we cannot
       qualify our own hostname, so we aren't losing the bounce. Instead, pass the
       buck on to the SMTP server and use our own unqualified hostname.
       (Closes: #317761)
     - Updated translations: Albanian [sq] (Besnik Bleta), Catalan [ca] (Ernest
       Adrogué Calveras), Czech [cs] (Miloslav Trmac), German [de] (MA),
       Spanish (Castilian) [es] (Javier Kohen), French [fr] (MA),
       Polish [pl] (Jakub Bogusz), Russian [ru] (Pavel Maryanov).
     - In oversized warning messages, print the account name, too.
       (Closes: #213299).
   * Remove man1 from mandir on install time. (change on the packaging).
   * Deleted es.po patch. Included upstream. Updated 00list.
   * Added myself to uploaders.
   * Added patch to fix warning on fetchmail man page. Should submit upstream.
Files: 
 07169cd69d58bcd10087b97c9e5f797a 747 mail optional fetchmail_6.3.1-1.dsc
 8d77911b29439f773d3bc30604e6ff23 1236186 mail optional fetchmail_6.3.1.orig.tar.gz
 099478927d3ba81a0e79ac49e1c80dde 43504 mail optional fetchmail_6.3.1-1.diff.gz
 76cb698468e1cc6529a14ea6a9ad3fc4 32826 mail optional fetchmailconf_6.3.1-1_all.deb
 0b88a8e2489e6b837a46b96cbd8e5719 558832 mail optional fetchmail_6.3.1-1_i386.deb

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.2 (GNU/Linux)

iD8DBQFDx44rMwsDi2xjdG0RAv+LAJ9EFo+LO6htPhkGsBNH1X5MxluhGwCgjCSX
mDk072shb7L5AmBFflxrZuQ=
=QALn
-----END PGP SIGNATURE-----




More information about the pkg-fetchmail-maint mailing list