[Emacs-diffs] emacs/etc NEWS

[Glenn Morris]

CVSROOT:        /sources/emacs
Module name:    emacs
Changes by:     Glenn Morris <gm>       09/03/05 03:40:36

Modified files:
        etc            : NEWS 

Log message:
        More Rmail details.

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/emacs/etc/NEWS?cvsroot=emacs&r1=1.1993&r2=1.1994

Patches:
Index: NEWS
===================================================================
RCS file: /sources/emacs/emacs/etc/NEWS,v
retrieving revision 1.1993
retrieving revision 1.1994
diff -u -b -r1.1993 -r1.1994
--- NEWS        1 Mar 2009 18:51:33 -0000       1.1993
+++ NEWS        5 Mar 2009 03:40:35 -0000       1.1994
@@ -926,11 +926,10 @@
 
 +++
 *** Rmail no longer converts the messages to Babyl format.
-Instead, it keeps them in their original mbox format, both on disk and
-in Rmail buffers, and does conversion and decoding when a message is
-displayed.
+Instead, it uses UNIX mbox format, both on disk and in Rmail buffers,
+and does conversion and decoding when a message is displayed.
 
-First time you visit an Rmail file in Babyl format, Rmail
+The first time you visit an Rmail file in Babyl format, Rmail
 automatically converts it to mbox format.  This is a one-time
 conversion, but it can take a few minutes, depending on how fast is
 your machine and on the size of the file.  You should find the rest of
@@ -940,8 +939,33 @@
 because there is no way to save the list of inbox files in an
 mbox-format file.
 
-FIXME: Add more mbox merge details
+If you have written any extensions to Rmail, they are likely to need
+updating.  Conceptually, the Rmail buffer that you see is no longer
+just a narrowed portion of the whole.  So you cannot access the whole
+of a message (or message collection) by a simple save-restriction and
+widen.  Instead, there are two buffers: the rmail-buffer, and the
+rmail-view-buffer. The former is the buffer that you see, the latter
+is invisible.  Most of the time, the invisible `view' buffer contains
+the full contents of the Rmail file, and the Rmail buffer contains a
+decoded copy of the current message (with only a subset of the
+headers). In this state, Rmail is said to be `swapped'.
+
+You may find the following functions useful:
+
+`rmail-get-header' and `rmail-set-header' get or set the value of a
+message header, whether or not it is currently visible.
+
+`rmail-apply-in-message' is a general purpose function that calls a
+function (with arguments) which you specify on the full text of a given
+message.  To further narrow to just the headers, search forward for "\n\n".
+
++++
+*** The new command `rmail-mime' displays MIME messages.
+It is bound to `v' in Rmail buffers and summaries. It displays plain
+text and multipart messages in a temporary buffer, and offers buttons
+to save attachments.
 
+---
 *** The command `rmail-redecode-body' no longer accepts the optional arg RAW.
 Since Rmail now holds messages in their original undecoded form in a
 separate buffer, `rmail-redecode-body' no longer encodes the original