summaryrefslogtreecommitdiff
path: root/doc/misc/faq.texi
diff options
context:
space:
mode:
authorGlenn Morris <rgm@gnu.org>2013-07-24 21:25:18 -0400
committerGlenn Morris <rgm@gnu.org>2013-07-24 21:25:18 -0400
commit7add5a8a7a65bdff16f6f4eeaad9074996683dd0 (patch)
tree77c96ba391d87c5518dc5a4c1e50221bcd16ad75 /doc/misc/faq.texi
parent6758206c805224a21a27bb323d56b8a858c0d848 (diff)
Reduce use of @email in doc/misc
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.
Diffstat (limited to 'doc/misc/faq.texi')
-rw-r--r--doc/misc/faq.texi42
1 files changed, 26 insertions, 16 deletions
diff --git a/doc/misc/faq.texi b/doc/misc/faq.texi
index 39b4a9037b..f51d3a91a6 100644
--- a/doc/misc/faq.texi
+++ b/doc/misc/faq.texi
@@ -445,9 +445,9 @@ mail-to-news gateway).
The correct way to report Emacs bugs is to use the command
@kbd{M-x report-emacs-bug}. It sets up a mail buffer with the
-essential information and the correct e-mail address, which is
-@email{bug-gnu-emacs@@gnu.org} for the released versions of Emacs.
-Anything sent to @email{bug-gnu-emacs@@gnu.org} also appears in the
+essential information and the correct e-mail address,
+@email{bug-gnu-emacs@@gnu.org}.
+Anything sent there also appears in the
newsgroup @uref{news:gnu.emacs.bug}, but please use e-mail instead of
news to submit the bug report. This ensures a reliable return address
so you can be contacted for further details.
@@ -460,13 +460,17 @@ report (@pxref{Bugs, , Reporting Bugs, emacs, The GNU Emacs Manual}).
RMS says:
@quotation
-Sending bug reports to @email{help-gnu-emacs@@gnu.org} (which has the
-effect of posting on @uref{news:gnu.emacs.help}) is undesirable because
-it takes the time of an unnecessarily large group of people, most of
-whom are just users and have no idea how to fix these problem.
-@email{bug-gnu-emacs@@gnu.org} reaches a much smaller group of people
-who are more likely to know what to do and have expressed a wish to
-receive more messages about Emacs than the others.
+Sending bug reports to
+@url{http://lists.gnu.org/mailman/listinfo/help-gnu-emacs,
+the help-gnu-emacs mailing list}
+(which has the effect of posting on @uref{news:gnu.emacs.help}) is
+undesirable because it takes the time of an unnecessarily large group
+of people, most of whom are just users and have no idea how to fix
+these problem.
+@url{http://lists.gnu.org/mailman/listinfo/bug-gnu-emacs, The
+bug-gnu-emacs list} reaches a much smaller group of people who are
+more likely to know what to do and have expressed a wish to receive
+more messages about Emacs than the others.
@end quotation
RMS says it is sometimes fine to post to @uref{news:gnu.emacs.help}:
@@ -961,7 +965,8 @@ by RMS for the editor TECO (Text Editor and COrrector, originally Tape
Editor and COrrector) under ITS (the Incompatible Timesharing System) on
a PDP-10. RMS had already extended TECO with a ``real-time''
full-screen mode with reprogrammable keys. Emacs was started by
-@email{gls@@east.sun.com, Guy Steele} as a project to unify the many
+@c gls@@east.sun.com
+Guy Steele as a project to unify the many
divergent TECO command sets and key bindings at MIT, and completed by
RMS.
@@ -1341,7 +1346,9 @@ of files from Macintosh, Microsoft, and Unix platforms.
In general, new Emacs users should not be provided with @file{.emacs}
files, because this can cause confusing non-standard behavior. Then
-they send questions to @email{help-gnu-emacs@@gnu.org} asking why Emacs
+they send questions to
+@url{http://lists.gnu.org/mailman/listinfo/help-gnu-emacs,
+the help-gnu-emacs mailing list} asking why Emacs
isn't behaving as documented.
Emacs includes the Customize facility (@pxref{Using Customize}). This
@@ -1806,7 +1813,8 @@ requested by @code{emacsclient}, Emacs will switch to it; otherwise
@cindex @code{gnuserv}
There is an alternative version of @samp{emacsclient} called
-@samp{gnuserv}, written by @email{ange@@hplb.hpl.hp.com, Andy Norman}
+@c ange@@hplb.hpl.hp.com
+@samp{gnuserv}, written by Andy Norman
(@pxref{Packages that do not come with Emacs}). @samp{gnuserv} uses
Internet domain sockets, so it can work across most network connections.
@@ -1974,7 +1982,8 @@ On some systems, @key{Insert} toggles @code{overwrite-mode} on and off.
@cindex Visible bell
@cindex Bell, visible
-@email{martin@@cc.gatech.edu, Martin R. Frank} writes:
+@c martin@@cc.gatech.edu
+Martin R. Frank writes:
Tell Emacs to use the @dfn{visible bell} instead of the audible bell,
and set the visible bell to nothing.
@@ -3305,7 +3314,7 @@ to get more details about the features that it offers, and then if you
wish, Emacs can download and automatically install it for you.
@uref{http://www.damtp.cam.ac.uk/user/sje30/emacs/ell.html, The Emacs Lisp
-List (ELL)}, maintained by @email{S.J.Eglen@@damtp.cam.ac.uk, Stephen Eglen},
+List (ELL)}, maintained by Stephen Eglen,
aims to provide one compact list with links to all of the current Emacs
Lisp files on the Internet. The ELL can be browsed over the web, or
from Emacs with @uref{http://www.damtp.cam.ac.uk/user/sje30/emacs/ell.el,
@@ -4314,7 +4323,8 @@ these systems, you should configure @code{movemail} to use @code{flock}.
@cindex Sender, replying only to
@cindex Rmail, replying to the sender of a message in
-@email{isaacson@@seas.upenn.edu, Ron Isaacson} says: When you hit
+@c isaacson@@seas.upenn.edu
+Ron Isaacson says: When you hit
@key{r} to reply in Rmail, by default it CCs all of the original
recipients (everyone on the original @samp{To} and @samp{CC}
lists). With a prefix argument (i.e., typing @kbd{C-u} before @key{r}),