From e0f3b26c85f385053fb562f15029ad4c3882b061 Mon Sep 17 00:00:00 2001 From: Ken Hornstein Date: Sun, 22 Apr 2012 12:59:18 -0500 Subject: [PATCH] Update for post-1.5 release. --- DATE | 2 +- NEWS | 140 ++++++++++++++++++++++++++++++++++++++++++++ VERSION | 2 +- docs/pending-release-notes | 63 -------------------- 4 files changed, 142 insertions(+), 65 deletions(-) create mode 100644 NEWS diff --git a/DATE b/DATE index 0d6a82e..daa299b 100644 --- a/DATE +++ b/DATE @@ -1 +1 @@ - 3 January 2012 +22 April 2012 diff --git a/NEWS b/NEWS new file mode 100644 index 0000000..b25d66a --- /dev/null +++ b/NEWS @@ -0,0 +1,140 @@ +# +# NEWS - Release notes for nmh 1.5 +# + +Welcome to nmh, the new version of the classic MH mail handling +system. Long-time MH and nmh users should read carefully the NOTABLE +CHANGES section, as there are some subtle but significant changes +to the way nmh now behaves. Otherwise, please see the README and INSTALL +files for help on getting started with nmh. + +------------ +NEW FEATURES +------------ + +The following are new features for the 1.5 release of nmh. + +- Improved performance for TLS encryption of the SMTP protocol. +- MH-E and POP support are now always compiled in. +- The selection of a locking directory for dot-locking files is now + controllable via configure. +- fileproc and mhlproc mh-profile are now obeyed by send, rcvdist, + and whatnow. +- New mh-format instructions have been implemented: %(putlit), + %(concataddr), %(myhost), %(myname), %(localmbox). See mh-format(5) + for more details. +- Nmh's idea of the local mailbox is now configurable via a new profile + entry, Local-Mailbox. See mh-profile(5) for more details. +- comp, forw, and dist now process all component templates through + mh-format(5), and now all support new command line arguments -from, + -to, -cc, -fcc, and -subject. +- burst(1) now supports any valid message delimiter according to RFC 934. +- post(8) now requires a From: header in all drafts that it processes; + see NOTABLE CHANGES below for more details. +- post(8) can now explicitly control the SMTP envelope address either via + the Sender: header or the new Envelope-From: header. +- The -attach option is now the default for send (using the header + Nmh-Attachment) and -attachformat 1 is the default attachment type. +- repl and dist now support new switches -atfile and -noatfile to control + the creation of the ./@ link to the message being replied or + redistributed. The current default is -atfile. +- Support (if available) for readline editing and filename completion at + the WhatNow? prompt. +- Support for using an external command to filter the body of a message + through in mhl. See mhl(1) for more details, specifically, the + "format" keyword, the "formatproc" entry in mh-profile(5), and the + -fmtproc switch for mhl and repl. +- Preliminary support for improved MIME handling when replying to messages! + Yes, a long requested feature has a solution. A perl script + called replyfilter is available; it is designed to act as a mhl + external filter to process MIME messages in a more logical way. + It is available in $(srcdir)/docs/contrib/replyfilter or is + typically installed as $(prefix)/share/doc/nmh/contrib/replyfilter. + See the comments at the top of replyfilter for usage information; + it will likely require some adjustment for your site. replyfilter + requires the MIME-Tools and MailTools perl modules. + +---------------------------- +OBSOLETE/DEPRECATED FEATURES +---------------------------- + +The following features have either been removed completely or marked +as officially deprecated for removal in a future release of nmh. + +- The creation of the ./@ link to the message being replied or + redistributed is deprecated; -noatfile will be the default in the + next release. If there are no requests to maintain -atfile it + will be removed in a future release. +- Old code enabled by the UCI preprocessor definition has been removed. +- All configuration options that were formerly only adjustable by editing + config.h have either been moved into configure or removed completely. +- Support for the built-in ftp client (used when dealing with external-body + message parts in MIME messages) has been removed. +- The following environment variables are marked as obsolete/deprecated. + Support for them will be removed from the next nmh release: + MHPOPDEBUG (use -snoop command line switch instead) + MM_NOASK (use -nolist and -nopause command line switches instead) + NOMHNPROC (use -nocheckmime command line switch instead) + FACEPROC (undocumented faceproc feature to be removed) +- The hostable option of mts.conf is no longer needed and has been removed. + +--------------- +NOTABLE CHANGES +--------------- + +The largest change is that post(8) now requires a From: header in all drafts +that it processes. + +The impetus for this change has been the evolution of email and client +systems. When MH was first developed the norm was to have tightly managed +clients that were part of the same domain as a user's email address. This +is no longer a valid assumption, and the algorithm used by nmh to determine +the user's local mailbox is no longer a reasonable default. + +Unfortunately, the way that nmh uses the user's local mailbox used to happen +very late in the message process; it was handled by post during message +submission. If no From: header exists in the current draft post would +insert one based on it's idea of the local mailbox, which was frequently +wrong. + +After a long discussion within the nmh development community, it was +decided that the only reasonable way forward was to move the local mailbox +handling up a level and place it under more direct control of the end +user. post(8) no longer will try to determine the local mailbox name; +it will take that information from the draft message. Thus a From: header +is now required in all drafts. + +As part of these changes, all message composition utilities now process +their component files using mh-format. All of the default component +files have been modified to include a From: header in them; this will +give the user a chance to see nmh's idea of the local mailbox and modify +it if desired. The new mh-profile(5) entry Local-Mailbox can be used +to adjust the local mailbox name if the system default is not appropriate. + +So how should end-users adapt to these changes? Here are some suggestions: + +1) If you use the default component files, everything should basically work + the same for you. You should see a From: header in the drafts of your + messages. If the address you see in the From: header is incorrect + you can change it via the Local-Mailbox profile entry. You can also + use the -from switch to change it on a per-command basis. + +2) If you have custom component files that include a From: header or + you perform custom processing on drafts that end up placing a From: + header in the draft message, everything should work as before. + +3) If you have custom component files that do NOT include a From: header + then you will have to adapt then to include a From: header. You + can either simply hard-code the correct From: header or use the + default component files as a guide (see mh-format(5) for more + details, specifically the %(localmbox) function). + +The other significant change is the support for filters in mhl. Included +in the distribution is replyfilter, a filter designed for sane processing +of MIME messages during replies. Since this isn't as integrated into +nmh as we would prefer, it's included in the contrib directory as an +optional component. Please try it out and give us feedback. + +-- +The nmh team +nmh-workers@nongnu.org diff --git a/VERSION b/VERSION index d918f45..bad3e98 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -1.4-dev +1.5+dev diff --git a/docs/pending-release-notes b/docs/pending-release-notes index e71fdf9..226d1fb 100644 --- a/docs/pending-release-notes +++ b/docs/pending-release-notes @@ -1,65 +1,2 @@ Things to add to the release notes for the next full release: -- Switched to buffered output when performing TLS encryption in the SMTP - MTA to increase performance. -- mh-e support has been changed so that it is always compiled into nmh; - old features that were previously enabled by the MHE option have been - garbage collected. -- Old code enabled by the UCI preprocessor definition has been - garbage-collected. -- LOCKDIR is now configurable via --enable-lockdir -- All configuration options that were formerly only adjustable via editing - config.h have been removed. -- Support for the built-in ftp client (used when dealing with external body - message parts in MIME messages) has been removed. -- fileproc and mhlproc mh-profile entries will now be obeyed by - send, rcvdist, and whatnow. -- New mh-format(5) instructions have been implemented: %(putlit), - %(concataddr), %(myhost), %(myname) -- The --enable-pop configure option has been removed; POP support is now - compiled in always. -- You can now filter the body of a message through a user-defined filter - program inside of repl (the idea is that it will be used by repl). - See mhl(1), specifically the "format" keyword and "formatproc" in - mh-profile(5). -- The test suite has been integrated into the Makefile via "make check". -- The following environment variables are obsolete/deprecated. Support for - them will be removed from the next nmh release: - MHPOPDEBUG (use -snoop command line switch instead) - MM_NOASK (use -nolist and -nopause command line switches instead) - NOMHNPROC (use -nocheckmime command line switch instead) - FACEPROC (undocumented faceproc feature to be removed) -- nmh's idea of the local mailbox is available via a new mh-profile(5) - escape, %(localmbox). The local mailbox name is now configurable - via a new mh-profile(5) entry, Local-Mailbox. -- comp, forw, and dist all support -from, -to, -cc, -fcc, and -subject - switches. They also all process all component templates through - mh-format(5). -- post(8) now requires a From: header in all drafts that it processes - for sending. The default component templates have all been adjusted - to include appropriate From: headers based on either the -from switch - or the local mailbox. -- burst(1) now supports any valid message delimiter according to RFC 934. -- A problem with the MD5 digest calculator on 64-bit systems has been fixed. -- Fixed mhbuild -check to properly insert Content-MD5 header. -- Fixed mhlist -verbose to work with all content types [Bug #35219]. -- Fixed file descriptor leaks in mhparse [Bug #24004: (debbug 344182)]. -- Fixed mhstore to honor nmh-storage profile entry even with -auto - [Bug #35303]. -- post(8) can now explicitly control the SMTP envelope address either via - the Sender: header or the new Envelope-From: header. -- The -attach option is now the default (using Nmh-Attachment) and - -attachformat 1 is now the default. -- repl and dist currently create a link named ./@ to the message being - replied or redistributed. A switch, -noatfile, has been added to - disable creation of this link. The current default behavior can - also be specified with -atfile. The current default behavior is - obsolete/deprecated: -noatfile will become the default in the next - nmh release. If there are no requests to maintain -atfile, it will - be removed in the future. -- Added support for readline editing and command/filename completion at - the WhatNow? prompt -- The hostable option of mts.conf is no longer needed and has been removed. -- A sample mhl filter for handling MIME content inside of mhl has been - placed as "replyfilter" in the doc contrib directory, which is typically - installed as /share/doc/nmh/contrib/. -- 1.7.10.4