summaryrefslogtreecommitdiff
path: root/doc/emacs/sending.texi
diff options
context:
space:
mode:
Diffstat (limited to 'doc/emacs/sending.texi')
-rw-r--r--doc/emacs/sending.texi24
1 files changed, 23 insertions, 1 deletions
diff --git a/doc/emacs/sending.texi b/doc/emacs/sending.texi
index 6b94cd0b737..7d9f4917929 100644
--- a/doc/emacs/sending.texi
+++ b/doc/emacs/sending.texi
@@ -1,5 +1,5 @@
@c This is part of the Emacs manual.
-@c Copyright (C) 1985--1987, 1993--1995, 1997, 2000--2023 Free Software
+@c Copyright (C) 1985--1987, 1993--1995, 1997, 2000--2024 Free Software
@c Foundation, Inc.
@c See file emacs.texi for copying conditions.
@node Sending Mail
@@ -257,6 +257,24 @@ of the address, such as the person's full name. Emacs puts them in if
they are needed. For instance, it inserts the above address as
@samp{"John Q. Smith" <none@@example.com>}.
+@findex rebuild-mail-abbrevs
+@findex merge-mail-abbrevs
+ After editing the @file{~/.mailrc} file, or if the file was modified
+outside of Emacs, you can update the mail aliases used by a running
+Emacs session with @w{@kbd{M-x rebuild-mail-abbrevs @key{RET}}}. This
+prompts for the name of the file to use, the default being the value
+of @code{mail-personal-alias-file}. A similar command
+@code{merge-mail-abbrevs} prompts for a file with mail aliases, then
+merges the aliases in that file with the existing ones.
+
+@findex define-mail-abbrev
+ Alternatively, you can use Emacs commands to define mail aliases.
+The command @code{define-mail-abbrev} prompts for the alias and the
+full address, and defines the alias to expand to the full address.
+Emacs will save the added aliases whenever it offers to save all
+files (for @kbd{C-x s} or @kbd{C-x C-c}), like it does with other
+abbrevs (@pxref{Saving Abbrevs}).
+
Emacs also recognizes include commands in @file{~/.mailrc}. They
look like this:
@@ -282,6 +300,10 @@ fields, such as @samp{Subject}.
@kbd{M-x mail-abbrev-insert-alias}. This reads an alias name, with
completion, and inserts its definition at point.
+@findex mail-abbrev-complete-alias
+ The command @code{mail-abbrev-complete-alias} completes on the mail
+alias preceding point.
+
@node Mail Commands
@section Mail Commands
@cindex Message mode