]> git.eshelyaron.com Git - emacs.git/commitdiff
Merge from origin/emacs-27
authorGlenn Morris <rgm@gnu.org>
Tue, 7 Sep 2021 15:31:22 +0000 (08:31 -0700)
committerGlenn Morris <rgm@gnu.org>
Tue, 7 Sep 2021 15:31:22 +0000 (08:31 -0700)
97aa8240d2 (origin/emacs-27) * doc/misc/efaq.texi: Misc copyedits.
e1050492d1 * doc/misc/efaq.texi (Reporting bugs): Refer to the Emacs ...

# Conflicts:
# doc/misc/efaq.texi

1  2 
doc/misc/efaq.texi

index 66f47cad43b8c3b3e3d906063fd8948227427633,0be35396b80770b90852ee3e22bb56936764104f..5c26f8f7564cc530074b3b551a31609cef7f3f31
@@@ -370,27 -363,23 +360,23 @@@ There are various Emacs mailing lists, 
  @uref{https://savannah.gnu.org/mail/?group=emacs, the Emacs Savannah
  page}.
  
- Messages advocating ``non-free'' software are considered unacceptable
- on any of the GNU mailing lists, except for
- @url{https://lists.gnu.org/mailman/listinfo/gnu-misc-discuss, the
- gnu-misc-discuss mailing list} which was created to hold the extensive
- flame-wars on the subject.
+ The main ones are: @code{help-gnu-emacs}, @code{bug-gnu-emacs},
+ and @code{emacs-devel}.
  
- ``Non-free'' software includes any software for which the end user
- can't freely modify the source code and exchange enhancements.  Be
- careful to remove any GNU mailing lists from @samp{Cc:} when posting a
- reply that recommends such software.
+ Messages advocating ``non-free'' software are considered unacceptable on
 -any of the @code{gnu.*} mailing lists (except for @code{gnu-misc-discuss}).
++any of the @code{gnu.*} mailing lists (except for @url{https://lists.gnu.org/mailman/listinfo/gnu-misc-discuss, the gnu-misc-discuss mailing list}).
+ ``Non-free'' software includes any software for which the end user can't
+ freely modify the source code and exchange enhancements.  Please
+ remove GNU mailing lists from the recipients when
+ posting a reply that recommends such software.
  
- @url{https://lists.gnu.org/mailman/listinfo/bug-gnu-emacs, The
- bug-gnu-emacs list} is a place where bug reports appear, but we
- recommend using the commands @kbd{M-x report-emacs-bug} or @kbd{M-x
- submit-emacs-patch} if at all possible (@pxref{Reporting bugs}).
- Some GNU mailing lists are gatewayed to (Usenet) newsgroups.
- For example, sending an email to
- @url{https://lists.gnu.org/mailman/listinfo/bug-gnu-emacs, The
- bug-gnu-emacs list} has the effect of posting on the newsgroup
- @uref{news:gnu.emacs.help}).
+ @cindex newsgroups
+ Some of the GNU mailing lists are gatewayed to newsgroups.
+ The newsgroup @uref{news:comp.emacs} is for discussion of Emacs programs
+ in general.  The newsgroup @uref{news:gnu.emacs.help} (i.e., the
+ @code{help-gnu-emacs} mailing list) is specifically
+ for GNU Emacs.  It therefore makes no sense to cross-post to both
+ groups, since only one can be appropriate to any question.
  
  Finally, we recommend reading the
  @url{https://www.gnu.org/philosophy/kind-communication.html, GNU Kind
@@@ -408,8 -395,11 +394,10 @@@ years, although there may be some unint
  archive can be browsed over the web at
  @uref{https://lists.gnu.org/r/, the GNU mail archive}.
  
 -Web-based Usenet search services, such as
 -@uref{http://groups.google.com/groups/dir?q=gnu&, Google}, also
 -archive the @code{gnu.*} newsgroups.
+ @cindex Usenet archives for GNU groups
+ @cindex Old Usenet postings for GNU groups
 +Some web-based Usenet search services also archive the @code{gnu.*}
 +newsgroups.
  
  @node Reporting bugs
  @section Where should I report bugs and other problems with Emacs?
  @cindex How to submit a bug report
  @cindex Reporting bugs
  
- 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,
- @email{bug-gnu-emacs@@gnu.org}.
+ Please see the Emacs manual for information on how to report bugs.
+ @xref{Checklist, , Checklist for Bug Reports, emacs, The GNU Emacs Manual}.
  
- Be sure to read the ``Bugs'' section of the Emacs manual before reporting
- a bug!  The manual describes in detail how to submit a useful bug
- report (@pxref{Bugs, , Reporting Bugs, emacs, The GNU Emacs Manual}).
- (@xref{Emacs manual}, if you don't know how to read the manual.)
+ It is better to report bugs as described there than to ask on the help
+ mailing list.  RMS says:
  
+ @quotation
  Sending bug reports to
 -@url{https://lists.gnu.org/mailman/listinfo/help-gnu-emacs,
 -the help-gnu-emacs mailing list} 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{https://lists.gnu.org/mailman/listinfo/bug-gnu-emacs, The
 -bug-gnu-emacs list} reaches a much smaller group of people who are
 +@url{https://lists.gnu.org/mailman/listinfo/help-gnu-emacs, the
 +help-gnu-emacs mailing list} 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{https://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 the help list:
  
+ @quotation
  If you have reported a bug and you don't hear about a possible fix,
  then after a suitable delay (such as a week) it is okay to post on
- @code{help-gnu-emacs@@gnu.org} asking if anyone can help you.
+ the help list asking if anyone can help you.
+ @end quotation
  
  If you are unsure whether you have found a bug, consider the following
  non-exhaustive list, courtesy of RMS:
@@@ -908,6 -890,7 +892,7 @@@ in the Emacs development repository (@p
  * New in Emacs 22::
  * New in Emacs 21::
  * New in Emacs 20::
 -* Difference between Emacs and XEmacs::
++* What was XEmacs?::
  @end menu
  
  @node Origin of the term Emacs
@@@ -1471,6 -1453,43 +1455,28 @@@ several languages in the same document
  modifying variables without having to use Lisp; and automatic conversion
  of files from Macintosh, Microsoft, and Unix platforms.
  
 -
 -@node Difference between Emacs and XEmacs
 -@section What is the difference between Emacs and XEmacs (formerly Lucid Emacs)?
++@node What was XEmacs?
++@section What was XEmacs?
+ @cindex XEmacs
 -@cindex Difference Emacs and XEmacs
 -@cindex Lucid Emacs
 -@cindex Epoch
+ XEmacs was a branch version of Emacs that is no longer actively
 -developed.  XEmacs was first called Lucid Emacs, and was initially
 -derived from a prerelease version of Emacs 19.  In this FAQ, we use
 -the name ``Emacs'' only for the official version.
 -
 -XEmacs last released a new version on January 30, 2009, and it lacks
 -many important features that exists in Emacs.  In the past, it was not
 -uncommon for Emacs packages to include code for compatibility with
 -XEmacs.  Nowadays, although some packages still maintain such
 -compatibility code, several of the more popular built-in and third
 -party packages have either stopped supporting XEmacs or were developed
 -exclusively for Emacs.
++developed.  XEmacs last released a new version on January 30, 2009,
++and it lacks many important features that exist in Emacs.  Since its
++development has stopped, we do not expect to see any new releases.
 -Some XEmacs code has been contributed to Emacs, and we would like to
 -use other parts, but the earlier XEmacs maintainers did not always
 -keep track of the authors of contributed code, which makes it
 -impossible for the FSF to get copyright papers signed for that code.
 -(The FSF requires these papers for all the code included in the Emacs
 -release, aside from generic C support packages that retain their
 -separate identity and are not integrated into the code of Emacs
 -proper.)
++In the past, it was not uncommon for Emacs packages to include code
++for compatibility with XEmacs.  Nowadays, most built-in and third party
++packages have either stopped supporting XEmacs or were developed
++exclusively for Emacs.
++XEmacs was initially derived from a prerelease version of Emacs 19.
+ If you want to talk about these two versions and distinguish them,
+ please call them ``Emacs'' and ``XEmacs.''  To contrast ``XEmacs''
+ with ``GNU Emacs'' would be misleading, since XEmacs too has its
+ origin in the work of the GNU Project.  Terms such as ``Emacsen'' and
+ ``(X)Emacs'' are not wrong, but they are not very clear, so it
+ is better to write ``Emacs and XEmacs.''
  @c ------------------------------------------------------------
  @node Common requests
  @chapter Common requests
@@@ -3409,9 -3412,9 +3414,9 @@@ a list of sites that make them availabl
  the main GNU distribution site, sources are available as
  
  @c Don't include VER in the file name, because pretests are not there.
- @uref{https://ftp.gnu.org/pub/gnu/emacs/emacs-VERSION.tar.gz}
+ @uref{https://ftp.gnu.org/pub/gnu/emacs/emacs-VERSION.tar.xz}
  
 -(Replace @samp{VERSION} with the relevant version number, e.g., @samp{27.1}.)
 +(Replace @samp{VERSION} with the relevant version number, e.g., @samp{28.1}.)
  
  @item
  Next uncompress and extract the source files.  This requires