Commit e73c2434 authored by Chong Yidong's avatar Chong Yidong

Document Message mode as the default mail mode.

* sending.texi (Sending Mail): Document the fact that Message mode is
now the default mail mode.
(Mail Format, Mail Headers): Document mail-from-style changes.
(Mail Commands): Rename from Mail mode.  Document Message mode.
(Mail Misc): Rename from Mail mode Misc.
(Mail Sending, Header Editing, Mail Misc): Switch to Message mode
command names and update keybindings.
(Header Editing): Document message-tab.  De-document
mail-self-blind, mail-default-reply-to, and mail-archive-file-name in
favor of mail-default-headers.  Ad index entries for user-full-name and
user-mail-address.
(Citing Mail): Update changes in Message mode behavior.  Document
mail-yank-prefix.
(Mail Signature): New node, moved from Mail Misc.
(Mail Aliases): Mail abbrevs are the default with Message mode.
(Mail Methods): Note that Message mode is now the default.

* rmail.texi (Rmail Reply):
* text.texi (Text Mode):
* major.texi (Major Modes):
* mule.texi (Output Coding): Refer to Message mode.

* custom.texi (Init Examples): Add xref to Mail Header.

* emacs.texi (Top):  Fix xrefs.
parent 481134fd
2010-03-28 Chong Yidong <cyd@stupidchicken.com>
Document Message mode as the default mail mode.
* sending.texi (Sending Mail): Copyedits.
(Mail Format, Mail Headers): Document mail-from-style changes.
(Mail Commands): Rename from Mail mode. Document Message mode.
(Mail Misc): Rename from Mail mode Misc.
(Mail Sending, Header Editing, Mail Misc): Switch to Message mode
command names and update keybindings.
(Header Editing): Document message-tab. De-document
mail-self-blind, mail-default-reply-to, and mail-archive-file-name in
favor of mail-default-headers. Ad index entries for user-full-name and
user-mail-address.
(Citing Mail): Update changes in Message mode behavior. Document
mail-yank-prefix.
(Mail Signature): New node, moved from Mail Misc.
(Mail Aliases): Mail abbrevs are the default with Message mode.
(Mail Methods): Note that Message mode is now the default.
* rmail.texi (Rmail Reply):
* text.texi (Text Mode):
* major.texi (Major Modes):
* mule.texi (Output Coding): Refer to Message mode.
* custom.texi (Init Examples): Add xref to Mail Header.
* emacs.texi (Top): Fix xrefs.
2010-03-25 Chong Yidong <cyd@stupidchicken.com>
* maintaining.texi (VC With A Merging VCS): C-x v v now creates a
......
......@@ -2269,8 +2269,9 @@ Specify your own email address, if Emacs can't figure it out correctly.
(setq user-mail-address "cheney@@torture.gov")
@end example
Various Emacs packages that need your own email address use the value of
@code{user-mail-address}.
Various Emacs packages, such as Message mode, consult
@code{user-mail-address} when they need to know your email address.
@xref{Mail Headers}.
@item
Make Text mode the default mode for new buffers.
......
......@@ -886,16 +886,17 @@ Sending Mail
* Mail Format:: Format of the mail being composed.
* Mail Headers:: Details of some standard mail header fields.
* Mail Aliases:: Abbreviating and grouping mail addresses.
* Mail Mode:: Special commands for editing mail being composed.
* Mail Commands:: Special commands for editing mail being composed.
* Mail Signature:: Adding a signature to every message.
* Mail Amusements:: Distracting the NSA; adding fortune messages.
* Mail Methods:: Using alternative mail-composition methods.
Mail Mode
Mail Commands
* Mail Sending:: Commands to send the message.
* Header Editing:: Commands to move to header fields and edit them.
* Citing Mail:: Copying all or part of a message you are replying to.
* Mail Mode Misc:: Spell checking, signatures, etc.
* Citing Mail:: Quoting a message you are replying to.
* Mail Misc:: Attachments, spell checking, etc.
Reading Mail with Rmail
......
......@@ -41,7 +41,7 @@ languages. These include Lisp mode (which has several variants), C
mode, Fortran mode, and others. The remaining major modes are not
intended for use on users' files; they are used in buffers created for
specific purposes by Emacs, such as Dired mode for buffers made by
Dired (@pxref{Dired}), Mail mode for buffers made by @kbd{C-x m}
Dired (@pxref{Dired}), Message mode for buffers made by @kbd{C-x m}
(@pxref{Sending Mail}), and Shell mode for buffers used for
communicating with an inferior shell process (@pxref{Interactive
Shell}).
......
......@@ -961,15 +961,16 @@ still use an unsuitable coding system if you type its name in response
to the question.)
@vindex sendmail-coding-system
When you send a message with Mail mode (@pxref{Sending Mail}), Emacs has
four different ways to determine the coding system to use for encoding
the message text. It tries the buffer's own value of
@code{buffer-file-coding-system}, if that is non-@code{nil}. Otherwise,
it uses the value of @code{sendmail-coding-system}, if that is
non-@code{nil}. The third way is to use the default coding system for
new files, which is controlled by your choice of language environment,
if that is non-@code{nil}. If all of these three values are @code{nil},
Emacs encodes outgoing mail using the Latin-1 coding system.
When you send a message with Message mode (@pxref{Sending Mail}),
Emacs has four different ways to determine the coding system to use
for encoding the message text. It tries the buffer's own value of
@code{buffer-file-coding-system}, if that is non-@code{nil}.
Otherwise, it uses the value of @code{sendmail-coding-system}, if that
is non-@code{nil}. The third way is to use the default coding system
for new files, which is controlled by your choice of language
environment, if that is non-@code{nil}. If all of these three values
are @code{nil}, Emacs encodes outgoing mail using the Latin-1 coding
system.
@node Text Coding
@section Specifying a Coding System for File Text
......
......@@ -683,12 +683,12 @@ standard meaning.
@node Rmail Reply
@section Sending Replies
Rmail has several commands that use Mail mode to send outgoing mail.
@xref{Sending Mail}, for information on using Mail mode, including
certain features meant to work with Rmail. What this section documents
are the special commands of Rmail for entering Mail mode. Note that the
usual keys for sending mail---@kbd{C-x m}, @kbd{C-x 4 m}, and @kbd{C-x 5
m}---also work normally in Rmail mode.
Rmail has several commands to send outgoing mail. @xref{Sending
Mail}, for information on using Message mode, including certain
features meant to work with Rmail. What this section documents are
the special commands of Rmail for entering the mail buffer. Note that
the usual keys for sending mail---@kbd{C-x m}, @kbd{C-x 4 m}, and
@kbd{C-x 5 m}---also work normally in Rmail mode.
@table @kbd
@item m
......@@ -735,12 +735,12 @@ the reply command with a numeric argument: @kbd{C-u r} or @kbd{1 r}.
This means to reply only to the sender of the original message.
Once the @samp{*mail*} buffer has been initialized, editing and
sending the mail goes as usual (@pxref{Sending Mail}). You can edit the
presupplied header fields if they are not what you want. You can also
use the commands of Mail mode (@pxref{Mail Mode}), including @kbd{C-c
C-y} which yanks in the message that you are replying to. You can
also switch to the Rmail buffer, select a different message there, switch
back, and yank the new current message.
sending the mail goes as usual (@pxref{Sending Mail}). You can edit
the presupplied header fields if they are not what you want. You can
also use commands such as @kbd{C-c C-y}, which yanks in the message
that you are replying to (@pxref{Mail Commands}). You can also switch
to the Rmail buffer, select a different message there, switch back,
and yank the new current message.
@kindex M-m @r{(Rmail)}
@findex rmail-retry-failure
......
This diff is collapsed.
......@@ -928,10 +928,10 @@ type @kbd{@key{ESC} @key{TAB}} or @kbd{C-M-i}.
@vindex text-mode-hook
Entering Text mode runs the hook @code{text-mode-hook}. Other major
modes related to Text mode also run this hook, followed by hooks of
their own; this includes Paragraph-Indent Text mode, Nroff mode, @TeX{}
mode, Outline mode, and Mail mode. Hook functions on
@code{text-mode-hook} can look at the value of @code{major-mode} to see
which of these modes is actually being entered. @xref{Hooks}.
their own; this includes Paragraph-Indent Text mode, Nroff mode,
@TeX{} mode, Outline mode, and Message mode. Hook functions on
@code{text-mode-hook} can look at the value of @code{major-mode} to
see which of these modes is actually being entered. @xref{Hooks}.
@node Outline Mode
@section Outline Mode
......
......@@ -250,6 +250,7 @@ matched topics found in the index.
manual that generates an Info file which gives the same information
through a menu structure.
+++
** Message mode is now the default mode for composing mail.
The default for `mail-user-agent' is now message-user-agent, so the
......@@ -259,6 +260,7 @@ Message mode has been included in Emacs, as part of the Gnus package,
for several years. It provides several features that are absent in
Mail mode, such as MIME handling.
---
*** If the user has not customized mail-user-agent, `compose-mail'
checks for Mail mode customizations, and issues a warning if these
customizations are found. This alerts users who may otherwise be
......@@ -284,9 +286,8 @@ This starts an incremental search of the comint/shell input history.
*** ansi-color is now enabled by default in Shell mode.
To disable it, set ansi-color-for-comint-mode to nil.
+++
** Tramp
+++
*** New connection methods "rsyncc", "imap" and "imaps".
On systems which support GVFS-Fuse, Tramp offers also the new
connection methods "dav", "davs", "obex" and "synce".
......@@ -317,7 +318,7 @@ not support this feature.
it displays the old names for the files and it can show logs/diffs for
the corresponding lines. Currently only Git and Mercurial take
advantage of this feature.
---
*** The log command in vc-annotate can display a single log entry
instead of redisplaying the full log. The RCS, CVS and SCCS VC
backends do not support this.
......@@ -341,7 +342,7 @@ their content displayed.
*** vc-bzr supports operating with shelves: the shelve list is
displayed in the *vc-dir* header, shelves can be created, removed and applied.
---
*** log-edit-strip-single-file-name controls whether or not single filenames
are stripped when copying text from the ChangeLog to the *VC-Log* buffer.
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment