meillo@41: This files lists changes which may be important for you, especially
meillo@41: in regard to compatiblity in upgrades.
meillo@41: 
meillo@41: See ChangeLog file for more details and technical changes that don't
meillo@41: affect users directly.
meillo@41: 
meillo@41: The manual pages describe newly added options. Take them for reference.
meillo@41: 
meillo@41: 
meillo@41: 0.3.0
meillo@41: 
meillo@41: - Hello, I'm meillo, the new maintainer and developer of masqmail. Oku
meillo@41: handed masqmail over to me, as he wasn't active anymore. I will release
meillo@41: new code with version numbers starting from 0.3.0 to ease dividing
meillo@41: between oku's releases and mine.
meillo@41: 
meillo@41: - This release includes various fixes for problems in 0.2.21, mainly
meillo@41: based on bugs from Debian.
meillo@41: 
meillo@41: - Distribution specific data has been excluded from the distribution,
meillo@41: but is separately available on the website.
meillo@41: 
meillo@41: - Man pages will not be generated from xml sources in future, but the
meillo@41: nroff sources will be maintained directly.
meillo@41: 
meillo@41: - The default online status file is now
meillo@41: /var/run/masqmail/masqmail-route, as it already was in the Debian
meillo@41: package.
meillo@41: 
meillo@41: 0.2.21
meillo@41: 
meillo@41: - Retrospective: Probably, this version was not published in the usual
meillo@41: way by oku. I (meillo) grabbed it from Debian's package archive. It does
meillo@41: not introduce new functions but fixes security problems, such as writing
meillo@41: log files as user `mail'. It also changes the location for pid files;
meillo@41: they are stored in /var/run/masqmail/ now.
meillo@0: 
meillo@0: 0.2.18
meillo@0: 
meillo@0: - delivery warnings and failures are now also implermented if the
meillo@0: connection to a server fails. Because masqmail is designed for dialup
meillo@0: networks, a connection failure will merely generate a warning by default.
meillo@0: If you deliver in a local network and use the default local_net route,
meillo@0: this would generte a failure. You can change this behaviour by setting
meillo@41: 'connect_error_fail' to either true or false in the route configurations.
meillo@0: 
meillo@0: 0.2.17
meillo@0: 
meillo@0: - delivery warnings have been finally implemented: if delivery of a mail
meillo@0: fails temporarily, warning mail will be generated, informing the sender
meillo@0: of the problem. After some time, the mail will be handled as failing
meillo@0: permanently, and be bounced. New options: 'warn_intervals',
meillo@0: 'max_defer_time' and 'warnmsg_file'.
meillo@0: 
meillo@0: - the message templates for failures and warnings will now be installed
meillo@0: into /usr/share/masqmail/tpl/, and no longer to /etc/masqmail/tpl/. The
meillo@0: default for the search path (options 'errmsg_file' and 'warnmsg_file'
meillo@0: has been changed accordingly.
meillo@0: 
meillo@0: - new option 'last_route'. See man 5 masqmail.route.
meillo@0: 
meillo@0: 0.2.12
meillo@0: two new options have been added:
meillo@0: - do_pipelining will be used only in broken mail setups. Actually, I
meillo@0: implemented it only to test such a setup.
meillo@0: 
meillo@0: - helo_name for routes sets the helo_name. This may be useful for
meillo@0: eg. ssh tunneling, or if do_correcthelo does not work, because you are
meillo@0: behind a firewall.
meillo@0: 
meillo@0: - the old 'remote_port' option should not be used any more. Set the
meillo@0: port with mail_host="foo.bar.com:1234" in the route file instead.
meillo@0: 
meillo@0: 0.2.11
meillo@0: 
meillo@0: - two new options have been added: do_save_envelope_to for the main
meillo@0: configuration and map_h_mail_followup_to_addresses for the route
meillo@0: files. See the man pages on purpose and usage.
meillo@0: 
meillo@0: - the route files can now be mode 0400, owned by root. Previous
meillo@0: versions had problems when sendmail was called directly by a
meillo@0: non-priviledged user, because the route files could not be read.
meillo@0: 
meillo@0: 0.2.10
meillo@0: 
meillo@0: - this version should work on FreeBSD. At least I care now if it does not.
meillo@0: 
meillo@0: - masqmail now writes pid files to /var/run/, one for the smtp/queue
meillo@0: daemon and one for the get daemon. So you now know whom to kill ;-)
meillo@0: 
meillo@0: - much effort has been put into the Debian package, which now uses debconf.
meillo@0: 
meillo@0: 0.2.7
meillo@0: 
meillo@0: - sorry for my reluctany in the last months...
meillo@0: - my email address is oku@masqmail.cx. I hope that I keep this for the rest
meillo@0: of my life...
meillo@0: 
meillo@0: 0.2.6
meillo@0: 
meillo@0: - you can configure the prefered local delivery mechanism for each user. See
meillo@0: man page masqmail.conf (5), options mbox_default, mbox_users, mda_users and
meillo@0: maildir_users. BIT FAT NOTE: if you used an mda, set mbox_default = "mda"
meillo@0: (or use the mda_users option). Just setting mda is not enough any more.
meillo@0: 
meillo@0: - there are the allowed_return_paths and not_allowed_return_paths for the
meillo@0: route configurations, this enables better checking for return path addresses
meillo@0: than allowed_mail_locals. You can also use this to enable or disable messages
meillo@0: from null sender addresses (<>) using "<>".
meillo@0: note: this option has been there for quite a time... I just forgot to document it.
meillo@0: 
meillo@0: 0.2.5
meillo@0: 
meillo@0: - simple relay checking: if you set do_relay=false in masqmail.conf, users
meillo@0: with a return path that is not local will get a 550 reply if they try to
meillo@0: deliver to a not local address. This is for users to force them to have a
meillo@0: proper configuration. It is _not_ to prevent spammers from using your MTA
meillo@0: as a relay, it can be easily forged! masqmail is not designed to be an always
meillo@0: accessible MTA for an internet site.
meillo@0: 
meillo@0: - added Maildir support. To use it, add --enable-maildir as ./configure
meillo@0: optiom. Currently, if enabled, all local deliveries are to Maildir
meillo@0: (in ~user/Maildir), and none to mailbox. This is preliminary, future versions
meillo@0: will be configurable (probably together with mda delivery).
meillo@0: 
meillo@0: 0.2.4 
meillo@0: 
meillo@0: - added -v option, this logs to stdout, so you see what happens when
meillo@0: calling masqmail from command line. This is not yet finished, and only
meillo@0: for fetching mails completed.
meillo@0: 
meillo@0: 0.2.3
meillo@0: 
meillo@0: - new option lock_dir where locks will be put to. Defaults to the spool
meillo@0: dir with '/lock/' appended (if spool_dir is /var/spool/masqmail/, lock_dir
meillo@0: is /var/spool/masqmail/lock/).
meillo@0: 
meillo@0: - You can use the 'do_uidl_dele' option more reliably. The uidl list
meillo@0: will be written immediately after a message was fetched, so if you use the
meillo@0: do_uidl and do_uidl_dele option you can safely interrupt masqmail when it is
meillo@0: getting mail via pop3, and do not get the message again next time.
meillo@0: 
meillo@0: - there are a lot of new options for ./configure to customize masqmail
meillo@0: to your needs. See INSTALL.
meillo@0: 
meillo@0: - Uli Funcke sent a patch with the new options 'local_addresses' and
meillo@0: 'not_local_addresses' for masqmail.conf. With these, you can declare single
meillo@0: email addresses as local, though they normally are not, and vice versa,
meillo@0: declare addresses as not local though normally they are (determined with
meillo@0: local_hosts). These options are not yet documented.
meillo@0: 
meillo@0: 0.2.2
meillo@0: - with -go5m you can now run a get daemon, the command 'masqmail -go5m' will fetch
meillo@0: mail every five minutes, using the detected online configuration.
meillo@0: 
meillo@0: 0.2.1
meillo@0: 
meillo@0: - there is a new option for the main conf: online_gets. Using this option,
meillo@0: you can retrieve mail with just calling masqmail -go, masqmail will detect
meillo@41: whether it is online (similar to connect_routes (which is now called
meillo@0: online_routes)).
meillo@0: 
meillo@0: 0.2.0
meillo@0: 
meillo@0: This is the first release of he development branch of masqmail
meillo@0: 
meillo@0: - the default configuration is now /etc/masqmail/masqmail.conf
meillo@0:   (as it already was for the debian package). The --with-conffile
meillo@0:   option for configure has been replaced by the --with-confdir option.
meillo@0: 
meillo@0: - added delivery failure notices:
meillo@0:   o you can customize your own delivery failure report, its
meillo@0:     default location is /etc/masqmail/tpl/failmsg.tpl
meillo@0:   o if a delivery via a route fails permanently (the server replied with a 5xx status)
meillo@0:     the message will be bounced, if it is bounced, no further delivery will be attempted.
meillo@0:     This is different to previous versions, where failed messages were kept in the queue until
meillo@0:     it was finally delivered, deleted or forever.
meillo@0: 
meillo@0: - there is a new online detection method: pipe. This allows you more
meillo@0:   flexibility to detect the current online status, eg. the DHCP status on notebooks.
meillo@0: 
meillo@0: This method will once replace the 'mserver' option,
meillo@0: you can already use the program mservdetect to use it:
meillo@0: 
meillo@0: online_method=pipe
meillo@0: online_pipe="/usr/bin/mservdetect localhost 222"
meillo@0: 
meillo@0: instead of
meillo@0: 
meillo@41: online_detect=mserver
meillo@0: mserver_iface="localhost:222"
meillo@0: 
meillo@0: 0.1.9
meillo@0: 
meillo@0: - you can use pipes in routes to implement gateways to uucp, fax, sms etc.
meillo@0: The setup is similar to mda transport. See man pages.
meillo@0: 
meillo@0: - for each connection (connect_routes), you can now give a list of
meillo@0: route files, which will be used in the order given. You can use the
meillo@0: filter rules (allowed_* and not_allowed_* rules) within each route.
meillo@0: 
meillo@0: 0.1.8
meillo@0: 
meillo@0: - for pop retrieval and smtp sending you can use a wrapper for eg. ssl
meillo@0: tunneling. See man pages.
meillo@0: 
meillo@0: - a user can delete his mail from the spool with -Mrm if received
meillo@0: locally, and if you configure with --enable-ident and set
meillo@0: ident_trusted_nets also if received via smtp.
meillo@0: 
meillo@0: - a backslash now works to escape characters in the configuration, so
meillo@0: you can now use quotes inside quotes. All other characters with a
meillo@0: leading backslash will be converted to itself (\a becomes a, \\
meillo@0: becomes \).
meillo@0: 
meillo@0: - you can now use an mda for local mails. The mda will be called
meillo@0: *after* alias expansion. See documentation for more.
meillo@0: 
meillo@0: 0.1.0
meillo@0: - masqmail can now retrieve mail with pop3. See the manual on how to do that.
meillo@0: - supports now ESMTP AUTH as a client.
meillo@0: - when called with -qo (without a connection name), the online status
meillo@0: will be checked with the configured method.
meillo@0: 
meillo@0: 0.0.10
meillo@0: - there is now alias support. Give the location of the alias file (usually /etc/aliases) with eg.
meillo@0: alias_file = "/etc/aliases"
meillo@0: - delivery to pipes is now possible, but only if it appears in an alias file. Example:
meillo@0: pipe: |/usr/bin/command
meillo@0: will expand the address pipe to "|/usr/bin/command" which invokes '/usr/bin/command'
meillo@0: as the user and group masqmail is running as.
meillo@0: - entries starting with '\' in alias files will not be exanded further
meillo@0: 
meillo@0: - changed permissions for queue runs again: got to be root, mail or in group trusted.
meillo@0: 
meillo@0: - some configuration parameters can be read from files, these are
meillo@0: allowed_mail_locals, not_allowed_mail_locals, allowed_rcpt_domains, not_allowed_rcpt_domains,
meillo@0: map_return_path_addresses, map_h_from_addresses, map_h_reply_to_addresses
meillo@0: any entry in these list beginning with a '/' are regarded as
meillo@0: filenames, the content of these will be put at that location. Entries
meillo@0: in these files are separated by new lines.  Example:
meillo@0: in the route file you have:
meillo@0: map_h_from_addresses = "/etc/masqmail/hfrom.map"
meillo@0: and hfrom.map contains:
meillo@0: 
meillo@0: john: John Smith <jsmith@mail.academic.edu>
meillo@0: cmiller: "Charlie Miller" <cmiller@foo.com>
meillo@0: 
meillo@0: UPDATE (Jan 2000): The new home location of MasqMail is
meillo@0: http://www.innominate.org/~oku/masqmail/, the new email adress of the
meillo@0: author is Oliver Kurth <kurth@innominate.de>.
meillo@0: 
meillo@0: 0.0.9
meillo@0: - see ChangeLog.
meillo@0: 
meillo@0: NOTE: The home location of MasqMail at
meillo@0: http://merlin.uni-sw.gwdg.de/~okurth/masqmail/ is uncertain from the
meillo@0: beginning of Nov. 1999! See http://www.freshmeat.net for new
meillo@0: announcements. I leave the university and begin a new job on Nov. 1st 1999
meillo@0: in Berlin :-).
meillo@0: 
meillo@0: 0.0.8:
meillo@0: - there is now a FAQ page. See docs/faq.html.
meillo@0: - added allowed_rcpt_domains option for routes.
meillo@0: - added allowed_mail_locals and not_allowed_mail_locals options for routes.
meillo@0: - mailq now gives information about the time mails spent in the queue,
meillo@0: the message size and the received host.
meillo@0: 
meillo@0: 0.0.7:
meillo@0: -bug fix release: for statements in two	adjacent lines, the second was not recognized.
meillo@0: 
meillo@0: 0.0.6:
meillo@0: - bug fix release: some MUAs (cucipop) saw the locally delivered mails
meillo@0: concatenated. (cucipop is not a MUA  but a pop server, but it has to read the
meillo@0: mails).
meillo@0: 
meillo@0: 0.0.5:
meillo@0: - fixed a bug that caused the headers to be lost under some circumstances.
meillo@0: - added expand_h_sender_domain option for routes.
meillo@0: - rewrote the libresolv part in configure. Should work better now.
meillo@0: 
meillo@0: 0.0.4:
meillo@0: - MM should now recognize whether libresolv should be linked.
meillo@0: - added --with-logdir=LOGDIR and --with-spooldir=SPOOLDIR to set directories.
meillo@0:   These will be created if not already existent.
meillo@0: - added --with-user=USER, --with-group=GROUP options to set user and group id
meillo@0:   for MasqMail.
meillo@0: 
meillo@0: 0.0.3:
meillo@0: - MasqMail can now deliver mails that are received at online
meillo@0:   time immediately to the internet. See the options detect_online,
meillo@0:   mserver_iface and online_file.
meillo@0: - You can define a route configuration for the local net. See option
meillo@0:   local_net_route.
meillo@0: