In many cases it serves no purpose. It gets converted to mailto:
in html output, which is mainly just an invitation to get spam.
* doc/misc/erc.texi (Special Features): Update contact information.
(History): Avoid using @email.
* doc/misc/eshell.texi (Bugs and ideas): Minor updates.
* doc/misc/faq.texi (Reporting bugs, Origin of the term Emacs)
(Setting up a customization file)
(Using an already running Emacs process, Turning off beeping)
(Packages that do not come with Emacs)
(Replying to the sender of a message): Avoid using @email.
* doc/misc/pcl-cvs.texi (Contributors, Bugs): Avoid using @email.
* doc/misc/reftex.texi (Imprint): Avoid using @email.
* doc/misc/ses.texi (Top): Update bug reporting instructions.
(Acknowledgments): Avoid using @email.
* doc/misc/woman.texi (Introduction, Background): Remove outdated information.
(Bugs, Acknowledgments): Avoid using @email.
Be more systematic about using "@." (not ".") at end of sentence that
ends in a capital letter, and about appending "@:" after non-ends of
sentences that end in a lower case letter followed by "." followed by
whitespace. Omit unnecessary use of "@:" and "@.". Similarly for "?"
and "!". Be more consistent about putting a comma after "i.e." and
"e.g."; this is the typical American style and it's easier to code in
Texinfo.
Fixes: debbugs:12973
* doc/misc/faq.texi: (File-name conventions):
Shorten section name to avoid overfull line.
(How to add fonts): Use smallexample to avoid overfull lines.
* doc/misc/faq.texi (Major packages and programs): Remove section.
There is no point listing 6 packages (cf etc/MORE.STUFF).
(Finding Emacs and related packages): Move "Spell-checkers" here.
* doc/misc/faq.texi (Contacting the FSF): Mainly just refer to the web-site.
(Binding combinations of modifiers and function keys):
Let's assume people reading this are not using Emacs 18.
* lisp/mail/mailalias.el (build-mail-aliases): Make it interactive.
* lisp/mail/sendmail.el (build-mail-aliases): Update autoload.
* doc/misc/faq.texi (Expanding aliases when sending mail):
Now build-mail-aliases is interactive.
* doc/misc/Makefile.in (emacsdir): New variable.
($(infodir)/efaq): Pass -I $(emacsdir) to makeinfo.
* doc/misc/faq.texi (VER): Replace with EMACSVER from emacsver.texi.
* doc/lispref/Makefile.in (emacsdir): New variable.
(MAKEINFO): Add -I $emacsdir.
(dist): Copy emacsver.texi.
* doc/lispref/book-spine.texinfo, doc/lispref/elisp.texi:
* doc/lispref/vol2.texi, doc/lispref/vol1.texi:
Set EMACSVER by including emacsver.texi.
* doc/emacs/emacsver.texi.in: New file.
* doc/emacs/emacs.texi: Set EMACSVER by including emacsver.texi.
* doc/emacs/Makefile.in (distclean): Delete emacsver.texi.
(dist): Copy emacsver.texi.
* admin/admin.el (set-version): No need to act on doc/ files any more.
* configure.in (AC_OUTPUT): Add doc/emacs/emacsver.texi.
* make-dist: Include doc/emacs/*.texi.in.
(Extended commands): Most people have arrow keys.
(Emacs manual): Say how to follow info links.
(File-name conventions): Change title a bit. Explain about source
versus installed. Condense etc description.
(Guidelines for newsgroup postings): Mention Savannah list page.
(Newsgroup archives): Simplify.
(Contacting the FSF): Add contact URL.
(Emacs Lisp documentation): Printed version not always available.
(Installing Texinfo documentation): Explain how by hand installation is
not normally needed. Use add-to-list. Remove duplicate reference.
(Informational files for Emacs): Move info on Help menu here from
"File-name conventions".
(Help installing Emacs): Tweak uref.
(Obtaining the FAQ): Mention repository.
(Origin of the term Emacs): Explain "ITS".
(Changing load-path): Use add-to-list.
(Automatic indentation): Clarify this is for Text mode.
Don't mention Indented Text mode.
(Finding Emacs on the Internet): The FSF does not seem to offer a
deluxe distribution on CD anymore.
Recommend the latest release. Mention how to get older FAQs.
Recommend the Emacs manual.
(Guidelines for newsgroup postings): Discourage cross-posts.
(Underlining paragraphs): Remove.
(Editing MS-DOS files): Remove pre-Emacs 20 information.
(Bugs and problems): Update key-binding.
(Problems with very large files): Mention 64-bit.
(Shell process exits abnormally): Remove.
(Problems with Shell Mode): Rename and update.
(Spontaneous entry into isearch-mode)
(Problems talking to certain hosts): Remove. This is old information,
in etc/PROBLEMS if needed.
(Emacs takes a long time to visit files, Updating Emacs): Remove.
(Dired claims that no file is on this line): Update.
(Installing Emacs, Problems building Emacs): Simplify.
(Emacs for MS-DOS): Refer to msdos/INSTALL rather than duplicating
information.
(Emacs for MS-Windows): Rename from "Emacs for Windows". Simplify.
(Emacs for Mac OS X): Rename from "Emacs for Apple computers".
(JDEE): "JDEE", not "JDE".
(Handling C-s and C-q with flow control, Binding C-s and C-q):
Remove. This is old information, in etc/PROBLEMS if needed.
(stty and Backspace key, Kanji and Chinese characters): Remove.
(Right-to-left alphabets): Update section.
(Changing the included text prefix): Gnus uses message-yank-prefix.
Add cross-reference to Supercite manual.
(Saving a copy of outgoing mail): Simplify output file description.
(Expanding aliases when sending mail): Refer to Emacs manual.
Remove old info about RFC822.
Correct description of how to rebuild aliases.
(Rmail writes to /var/spool/mail): Update location from /usr/spool/mail.
(MIME with Emacs mail packages)
(Viewing articles with embedded underlining)
(Saving a multi-part Gnus posting, Gnus hangs for a long time):
Remove old sections.
(Killing based on nonstandard headers): Remove. Scoring is preferable,
and is well-documented in the Gnus manual.
(Reading news with Emacs): Merge "Learning more about Gnus" into here.
(Making Gnus faster): Rename from "Starting Gnus faster".
Merge "Catch-up is slow in Gnus" into here.
