aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorGlenn Morris2009-06-13 02:21:29 +0000
committerGlenn Morris2009-06-13 02:21:29 +0000
commit85b438b7bc2e4a4fb27e7564a2ee698d6c944a86 (patch)
treea254150c743fcbaaf8ef34ed1d72cf05be4f009b
parent60959d23f4d7f0854f464deb3e84f6eecfb2cd9b (diff)
downloademacs-85b438b7bc2e4a4fb27e7564a2ee698d6c944a86.tar.gz
emacs-85b438b7bc2e4a4fb27e7564a2ee698d6c944a86.zip
Remove the term "on-line" (meaning "Info") throughout, since
in this day and age the common meaning is "on the web". (copying): Use @copyright in all cases. (Basic keys): Remove reference to deleted manual node "Text Characters". (File-name conventions): Use GNU as an example rather than SERVICE. default.el lives in site-lisp. Update Info directory location. (Real meaning of copyleft): GPL actions have been brought, but all settled out of court. (Guidelines for newsgroup postings): Shorten section title. Simplify comp.emacs description. (Newsgroup archives): Change Google URL. Describe Gmane. (Unsubscribing from Emacs lists): Remove discussion of "distribution points". Mention List-Unsubscribe header. (Contacting the FSF): Update email and URLs. (Basic editing): Mention F1 for help. (Installing Texinfo documentation): Refer to Texinfo website rather than ftp server. (Printing a Texinfo file): Mention texi2pdf. (Informational files for Emacs): Don't describe FTP or SERVICE, they are just stubs nowadays. (Latest version of Emacs): Explain version numbers. (Spell-checkers, Checking TeX and *roff documents): Remove sections. (Turning on syntax highlighting): No need to mention hilit19 any more. (Finding Emacs on the Internet): Refer to URLs rather than DISTRIB, FTP. (Modes for various languages): Remove section. (Major packages and programs): Remove most version and maintainer information - it's hard to keep up-to-date, and adds nothing. Similarly with direct links to mailing lists. (Spell-checkers): Rename node from Ispell. Mention Aspell and Hunspell. (Mailcrypt): Remove section - mailcrypt has not been updated in mnay years, and Emacs comes with tools for this now. (Patch): Remove section - this is a standard tool. (Using function keys under X): Remove section.
-rw-r--r--doc/misc/ChangeLog36
-rw-r--r--doc/misc/faq.texi390
2 files changed, 122 insertions, 304 deletions
diff --git a/doc/misc/ChangeLog b/doc/misc/ChangeLog
index 27399be011b..69484b8f55a 100644
--- a/doc/misc/ChangeLog
+++ b/doc/misc/ChangeLog
@@ -1,3 +1,39 @@
12009-06-13 Glenn Morris <rgm@gnu.org>
2
3 * faq.texi: Remove the term "on-line" (meaning "Info") throughout, since
4 in this day and age the common meaning is "on the web".
5 (copying): Use @copyright in all cases.
6 (Basic keys): Remove reference to deleted manual node "Text Characters".
7 (File-name conventions): Use GNU as an example rather than SERVICE.
8 default.el lives in site-lisp. Update Info directory location.
9 (Real meaning of copyleft): GPL actions have been brought, but all
10 settled out of court.
11 (Guidelines for newsgroup postings): Shorten section title.
12 Simplify comp.emacs description.
13 (Newsgroup archives): Change Google URL. Describe Gmane.
14 (Unsubscribing from Emacs lists): Remove discussion of "distribution
15 points". Mention List-Unsubscribe header.
16 (Contacting the FSF): Update email and URLs.
17 (Basic editing): Mention F1 for help.
18 (Installing Texinfo documentation): Refer to Texinfo website rather
19 than ftp server.
20 (Printing a Texinfo file): Mention texi2pdf.
21 (Informational files for Emacs): Don't describe FTP or SERVICE, they
22 are just stubs nowadays.
23 (Latest version of Emacs): Explain version numbers.
24 (Spell-checkers, Checking TeX and *roff documents): Remove sections.
25 (Turning on syntax highlighting): No need to mention hilit19 any more.
26 (Finding Emacs on the Internet): Refer to URLs rather than DISTRIB, FTP.
27 (Modes for various languages): Remove section.
28 (Major packages and programs): Remove most version and maintainer
29 information - it's hard to keep up-to-date, and adds nothing.
30 Similarly with direct links to mailing lists.
31 (Spell-checkers): Rename node from Ispell. Mention Aspell and Hunspell.
32 (Mailcrypt): Remove section - mailcrypt has not been updated in mnay
33 years, and Emacs comes with tools for this now.
34 (Patch): Remove section - this is a standard tool.
35 (Using function keys under X): Remove section.
36
12009-06-12 Glenn Morris <rgm@gnu.org> 372009-06-12 Glenn Morris <rgm@gnu.org>
2 38
3 * faq.texi (Viewing Info files outside of Emacs): Xinfo is no more. 39 * faq.texi (Viewing Info files outside of Emacs): Xinfo is no more.
diff --git a/doc/misc/faq.texi b/doc/misc/faq.texi
index 1af7625c18e..2056e01f217 100644
--- a/doc/misc/faq.texi
+++ b/doc/misc/faq.texi
@@ -14,9 +14,10 @@
14@copying 14@copying
15Copyright @copyright{} 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 15Copyright @copyright{} 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009
16Free Software Foundation, Inc.@* 16Free Software Foundation, Inc.@*
17Copyright 1994,1995,1996,1997,1998,1999,2000 Reuven M. Lerner@* 17Copyright @copyright{} 1994, 1995, 1996, 1997, 1998, 1999, 2000
18Copyright 1992,1993 Steven Byrnes@* 18Reuven M. Lerner@*
19Copyright 1990,1991,1992 Joseph Brian Wells@* 19Copyright @copyright{} 1992, 1993 Steven Byrnes@*
20Copyright @copyright{} 1990, 1991, 1992 Joseph Brian Wells@*
20 21
21@quotation 22@quotation
22This list of frequently asked questions about GNU Emacs with answers 23This list of frequently asked questions about GNU Emacs with answers
@@ -59,6 +60,7 @@ distribution.]
59@node Top, FAQ notation, (dir), (dir) 60@node Top, FAQ notation, (dir), (dir)
60@top The GNU Emacs FAQ 61@top The GNU Emacs FAQ
61 62
63@c FIXME @today is just the day we ran `makeinfo'.
62This is the GNU Emacs FAQ, last updated on @today{}. 64This is the GNU Emacs FAQ, last updated on @today{}.
63 65
64This FAQ is maintained as a part of GNU Emacs. If you find any errors, 66This FAQ is maintained as a part of GNU Emacs. If you find any errors,
@@ -98,7 +100,7 @@ used in the FAQ.
98@menu 100@menu
99* Basic keys:: 101* Basic keys::
100* Extended commands:: 102* Extended commands::
101* On-line manual:: 103* Emacs manual::
102* File-name conventions:: 104* File-name conventions::
103* Common acronyms:: 105* Common acronyms::
104@end menu 106@end menu
@@ -181,10 +183,10 @@ pressed.}.
181@kbd{C-?} (aka @key{DEL}) is @acronym{ASCII} code 127. It is a misnomer to call 183@kbd{C-?} (aka @key{DEL}) is @acronym{ASCII} code 127. It is a misnomer to call
182@kbd{C-?} a ``control'' key, since 127 has both bits 5 and 6 turned ON. 184@kbd{C-?} a ``control'' key, since 127 has both bits 5 and 6 turned ON.
183Also, on very few keyboards does @kbd{C-?} generate @acronym{ASCII} code 127. 185Also, on very few keyboards does @kbd{C-?} generate @acronym{ASCII} code 127.
186@c FIXME I cannot understand the previous sentence.
184 187
185@inforef{Text Characters, Text Characters, emacs}, and @inforef{Keys, 188@inforef{Keys, Keys, emacs}, for more information. (@xref{Emacs
186Keys, emacs}, for more information. (@xref{On-line manual}, for more 189manual}, for more information about Info.)
187information about Info.)
188 190
189@node Extended commands 191@node Extended commands
190@section What does @file{M-x @var{command}} mean? 192@section What does @file{M-x @var{command}} mean?
@@ -213,14 +215,14 @@ good candidate for this, on keyboards that have such a key.
213If you need to run non-interactive Emacs functions, see @ref{Evaluating 215If you need to run non-interactive Emacs functions, see @ref{Evaluating
214Emacs Lisp code}. 216Emacs Lisp code}.
215 217
216@node On-line manual 218@node Emacs manual
217@section How do I read topic XXX in the on-line manual? 219@section How do I read topic XXX in the Emacs manual?
218@cindex On-line manual, reading topics in 220@cindex Emacs manual, reading topics in
219@cindex Reading topics in the on-line manual 221@cindex Reading topics in the Emacs manual
220@cindex Finding topics in the on-line manual 222@cindex Finding topics in the Emacs manual
221@cindex Info, finding topics in 223@cindex Info, finding topics in
222 224
223When we refer you to some @var{topic} in the on-line manual, you can 225When we refer you to some @var{topic} in the Emacs manual, you can
224read this manual node inside Emacs (assuming nothing is broken) by 226read this manual node inside Emacs (assuming nothing is broken) by
225typing @kbd{C-h i m emacs @key{RET} m @var{topic} @key{RET}}. 227typing @kbd{C-h i m emacs @key{RET} m @var{topic} @key{RET}}.
226 228
@@ -238,14 +240,13 @@ improperly. In this case you should complain.
238Emacs manual. 240Emacs manual.
239 241
240@node File-name conventions 242@node File-name conventions
241@section What are @file{etc/SERVICE}, @file{src/config.h}, and @file{lisp/default.el}? 243@section What are @file{etc/GNU}, @file{src/config.h}, and @file{site-lisp/default.el}?
242@cindex File-name conventions 244@cindex File-name conventions
243@cindex Conventions for file names 245@cindex Conventions for file names
244@cindex Directories and files that come with Emacs 246@cindex Directories and files that come with Emacs
245 247
246These are files that come with Emacs. The Emacs distribution is divided 248These are files that come with Emacs. The Emacs distribution is divided
247into subdirectories; the important ones are @file{etc}, @file{lisp}, and 249into subdirectories; e.g. @file{etc}, @file{lisp}, and @file{src}.
248@file{src}.
249 250
250If you use Emacs, but don't know where it is kept on your system, start 251If you use Emacs, but don't know where it is kept on your system, start
251Emacs, then type @kbd{C-h v data-directory @key{RET}}. The directory 252Emacs, then type @kbd{C-h v data-directory @key{RET}}. The directory
@@ -254,12 +255,12 @@ name displayed by this will be the full pathname of the installed
254@code{data-directory}, and @kbd{C-h v} displays the value and the 255@code{data-directory}, and @kbd{C-h v} displays the value and the
255documentation of a variable.) 256documentation of a variable.)
256 257
257The location of your Info directory (i.e., where on-line documentation 258The location of your Info directory (i.e., where Info documentation
258is stored) is kept in the variable @code{Info-default-directory-list}. Use 259is stored) is kept in the variable @code{Info-default-directory-list}. Use
259@kbd{C-h v Info-default-directory-list @key{RET}} to see the value of 260@kbd{C-h v Info-default-directory-list @key{RET}} to see the value of
260this variable, which will be a list of directory names. The last 261this variable, which will be a list of directory names. The last
261directory in that list is probably where most Info files are stored. By 262directory in that list is probably where most Info files are stored. By
262default, Info documentation is placed in @file{/usr/local/info}. 263default, Info documentation is placed in @file{/usr/local/share/info}.
263 264
264Some of these files are available individually via FTP or e-mail; see 265Some of these files are available individually via FTP or e-mail; see
265@ref{Informational files for Emacs}. They all are available in the 266@ref{Informational files for Emacs}. They all are available in the
@@ -267,9 +268,6 @@ source distribution. Many of the files in the @file{etc} directory are
267also available via the Emacs @samp{Help} menu, or by typing @kbd{C-h ?} 268also available via the Emacs @samp{Help} menu, or by typing @kbd{C-h ?}
268(@kbd{M-x help-for-help}). 269(@kbd{M-x help-for-help}).
269 270
270Your system administrator may have removed the @file{src} directory and
271many files from the @file{etc} directory.
272
273@node Common acronyms 271@node Common acronyms
274@section What are FSF, LPF, GNU, RMS, FTP, and GPL? 272@section What are FSF, LPF, GNU, RMS, FTP, and GPL?
275@cindex FSF, definition of 273@cindex FSF, definition of
@@ -355,9 +353,12 @@ available at @uref{http://progfree.org/, the LPF home page}.
355The real legal meaning of the GNU General Public License (copyleft) will 353The real legal meaning of the GNU General Public License (copyleft) will
356only be known if and when a judge rules on its validity and scope. 354only be known if and when a judge rules on its validity and scope.
357There has never been a copyright infringement case involving the GPL to 355There has never been a copyright infringement case involving the GPL to
358set any precedents. Please take any discussion regarding this issue to 356set any precedents. Although legal actions have been brought against
359the newsgroup @uref{news:gnu.misc.discuss}, which was created to hold the 357companies for violating the terms of the GPL, so far all have been
360extensive flame wars on the subject. 358settled out of court (in favour of the plaintiffs). Please take any
359discussion regarding this issue to the newsgroup
360@uref{news:gnu.misc.discuss}, which was created to hold the extensive
361flame wars on the subject.
361 362
362RMS writes: 363RMS writes:
363 364
@@ -372,7 +373,7 @@ recipients the same freedom that you enjoyed.
372@end quotation 373@end quotation
373 374
374@node Guidelines for newsgroup postings 375@node Guidelines for newsgroup postings
375@section What are appropriate messages for @uref{news:gnu.emacs.help}, @uref{news:gnu.emacs.bug}, @uref{news:comp.emacs}, etc.? 376@section What are appropriate messages for the various Emacs newsgroups?
376@cindex Newsgroups, appropriate messages for 377@cindex Newsgroups, appropriate messages for
377@cindex GNU newsgroups, appropriate messages for 378@cindex GNU newsgroups, appropriate messages for
378@cindex Usenet groups, appropriate messages for 379@cindex Usenet groups, appropriate messages for
@@ -386,14 +387,8 @@ of the file.) For those lists which are gatewayed with newsgroups, it
386lists both the newsgroup name and the mailing list address. 387lists both the newsgroup name and the mailing list address.
387 388
388The newsgroup @uref{news:comp.emacs} is for discussion of Emacs programs 389The newsgroup @uref{news:comp.emacs} is for discussion of Emacs programs
389in general. This includes Emacs along with various other 390in general. The newsgroup @uref{news:gnu.emacs.help} is specifically
390implementations, such as XEmacs, JOVE, MicroEmacs, Freemacs, MG, 391for GNU Emacs.
391Unipress, CCA, and Epsilon.
392
393Many people post Emacs questions to @uref{news:comp.emacs} because they
394don't receive any of the @code{gnu.*} newsgroups. Arguments have been
395made both for and against posting GNU-Emacs-specific material to
396@uref{news:comp.emacs}. You have to decide for yourself.
397 392
398Messages advocating ``non-free'' software are considered unacceptable on 393Messages advocating ``non-free'' software are considered unacceptable on
399any of the @code{gnu.*} newsgroups except for @uref{news:gnu.misc.discuss}, 394any of the @code{gnu.*} newsgroups except for @uref{news:gnu.misc.discuss},
@@ -423,11 +418,12 @@ The archive can be browsed over the web at
423@uref{http://lists.gnu.org/archive/html/, the GNU mail archive}. 418@uref{http://lists.gnu.org/archive/html/, the GNU mail archive}.
424 419
425Web-based Usenet search services, such as 420Web-based Usenet search services, such as
426@uref{http://groups.google.com/groups/dir?sel=33592484, Google}, also 421@uref{http://groups.google.com/groups/dir?q=gnu&, Google}, also
427archive the @code{gnu.*} groups. 422archive the @code{gnu.*} groups.
428 423
429You can read the archives of the @code{gnu.*} groups and post new 424You can read the archives of the @code{gnu.*} groups and post new
430messages at @uref{http://gmane.org/, Gmane}. 425messages at @uref{http://gmane.org/, Gmane}. Gmane is a service that
426presents mailing lists as newsgroups.
431 427
432@node Reporting bugs 428@node Reporting bugs
433@section Where should I report bugs and other problems with Emacs? 429@section Where should I report bugs and other problems with Emacs?
@@ -438,7 +434,7 @@ messages at @uref{http://gmane.org/, Gmane}.
438 434
439The correct way to report Emacs bugs is to use the command 435The correct way to report Emacs bugs is to use the command
440@kbd{M-x report-emacs-bug}. It sets up a mail buffer with the 436@kbd{M-x report-emacs-bug}. It sets up a mail buffer with the
441essential information and the correct e-mail address which is 437essential information and the correct e-mail address, which is
442@email{bug-gnu-emacs@@gnu.org} for the released versions of Emacs. 438@email{bug-gnu-emacs@@gnu.org} for the released versions of Emacs.
443Anything sent to @email{bug-gnu-emacs@@gnu.org} also appears in the 439Anything sent to @email{bug-gnu-emacs@@gnu.org} also appears in the
444newsgroup @uref{news:gnu.emacs.bug}, but please use e-mail instead of 440newsgroup @uref{news:gnu.emacs.bug}, but please use e-mail instead of
@@ -448,7 +444,7 @@ so you can be contacted for further details.
448Be sure to read the ``Bugs'' section of the Emacs manual before reporting 444Be sure to read the ``Bugs'' section of the Emacs manual before reporting
449a bug! The manual describes in detail how to submit a useful bug 445a bug! The manual describes in detail how to submit a useful bug
450report (@pxref{Bugs, , Reporting Bugs, emacs, The GNU Emacs Manual}). 446report (@pxref{Bugs, , Reporting Bugs, emacs, The GNU Emacs Manual}).
451(@xref{On-line manual}, if you don't know how to read the manual.) 447(@xref{Emacs manual}, if you don't know how to read the manual.)
452 448
453RMS says: 449RMS says:
454 450
@@ -481,20 +477,16 @@ does, that is a bug.
481@end quotation 477@end quotation
482 478
483@node Unsubscribing from Emacs lists 479@node Unsubscribing from Emacs lists
484@section How do I unsubscribe from this mailing list? 480@section How do I unsubscribe from a mailing list?
485@cindex Unsubscribing from GNU mailing lists 481@cindex Unsubscribing from GNU mailing lists
486@cindex Removing yourself from GNU mailing lists 482@cindex Removing yourself from GNU mailing lists
487 483
488If you are receiving a GNU mailing list named @var{list}, you might be 484If you are receiving a GNU mailing list named @var{list}, you should be
489able to unsubscribe from it by sending a request to the address 485able to unsubscribe from it by sending a request to the address
490@email{@var{list}-request@@gnu.org}. However, this will not work if you are 486@email{@var{list}-request@@gnu.org}. Mailing lists mails normally
491not listed on the main mailing list, but instead receive the mail from a 487contain information in either the message header
492distribution point. In that case, you will have to track down at which 488(@samp{List-Unsubscribe:}) or as a footer that tells you how to
493distribution point you are listed. Inspecting the @samp{Received} headers 489unsubscribe.
494on the mail messages may help, along with liberal use of the @samp{EXPN} or
495@samp{VRFY} sendmail commands through @samp{telnet @var{site-address}
496smtp}. Ask your postmaster for help, if you cannot figure out these
497details.
498 490
499@node Contacting the FSF 491@node Contacting the FSF
500@section What is the current address of the FSF? 492@section What is the current address of the FSF?
@@ -506,7 +498,7 @@ details.
506@table @asis 498@table @asis
507 499
508@item E-mail 500@item E-mail
509gnu@@gnu.org 501info@@fsf.org
510 502
511@item Telephone 503@item Telephone
512+1-617-542-5942 504+1-617-542-5942
@@ -515,7 +507,7 @@ gnu@@gnu.org
515+1-617-542-2652 507+1-617-542-2652
516 508
517@item World Wide Web 509@item World Wide Web
518@uref{http://www.gnu.org/} 510@uref{http://www.fsf.org/}
519 511
520@item Postal address 512@item Postal address
521Free Software Foundation@* 513Free Software Foundation@*
@@ -527,14 +519,14 @@ USA@*
527 519
528@cindex Ordering GNU software 520@cindex Ordering GNU software
529For details on how to order items directly from the FSF, see the 521For details on how to order items directly from the FSF, see the
530@uref{http://www.gnu.org/order/order.html, GNU Web site}. 522@uref{http://shop.fsf.org/, FSF on-line store}.
531 523
532@c ------------------------------------------------------------ 524@c ------------------------------------------------------------
533@node Getting help 525@node Getting help
534@chapter Getting help 526@chapter Getting help
535@cindex Getting help 527@cindex Getting help
536 528
537This chapter tells you how to get help with Emacs 529This chapter tells you how to get help with Emacs.
538 530
539@menu 531@menu
540* Basic editing:: 532* Basic editing::
@@ -569,7 +561,8 @@ help-for-help} instead to invoke help. To discover what key (if any)
569invokes help on your system, type @kbd{M-x where-is @key{RET} 561invokes help on your system, type @kbd{M-x where-is @key{RET}
570help-for-help @key{RET}}. This will print a comma-separated list of key 562help-for-help @key{RET}}. This will print a comma-separated list of key
571sequences in the echo area. Ignore the last character in each key 563sequences in the echo area. Ignore the last character in each key
572sequence listed. Each of the resulting key sequences invokes help. 564sequence listed. Each of the resulting key sequences (e.g. @key{F1} is
565common) invokes help.
573 566
574Emacs help works best if it is invoked by a single key whose value 567Emacs help works best if it is invoked by a single key whose value
575should be stored in the variable @code{help-char}. 568should be stored in the variable @code{help-char}.
@@ -587,7 +580,7 @@ There are several methods for finding out how to do things in Emacs.
587 580
588@cindex Reading the Emacs manual 581@cindex Reading the Emacs manual
589@item 582@item
590The complete text of the Emacs manual is available on-line via the Info 583The complete text of the Emacs manual is available via the Info
591hypertext reader. Type @kbd{C-h r} to display the manual in Info mode. 584hypertext reader. Type @kbd{C-h r} to display the manual in Info mode.
592Typing @key{h} immediately after entering Info will provide a short 585Typing @key{h} immediately after entering Info will provide a short
593tutorial on how to use it. 586tutorial on how to use it.
@@ -657,9 +650,8 @@ information. To get a list of these commands, type @samp{?} after
657@cindex Emacs manual, obtaining a printed or HTML copy of 650@cindex Emacs manual, obtaining a printed or HTML copy of
658 651
659You can order a printed copy of the Emacs manual from the FSF. For 652You can order a printed copy of the Emacs manual from the FSF. For
660details see the @uref{http://www.gnu.org/order/order.html, GNU Web site}. 653details see the @uref{http://shop.fsf.org/, FSF on-line store}.
661 654
662@c The number 620 below is version-dependent!
663The full Texinfo source for the manual also comes in the @file{doc/emacs} 655The full Texinfo source for the manual also comes in the @file{doc/emacs}
664directory of the Emacs distribution, if you're daring enough to try to 656directory of the Emacs distribution, if you're daring enough to try to
665print out this several-hundred-page manual yourself (@pxref{Printing a Texinfo 657print out this several-hundred-page manual yourself (@pxref{Printing a Texinfo
@@ -670,7 +662,7 @@ you can get a PostScript or PDF (or HTML) version from
670 662
671@uref{http://www.gnu.org/software/emacs/manual/} 663@uref{http://www.gnu.org/software/emacs/manual/}
672 664
673@xref{Learning how to do something}, for how to view the manual on-line. 665@xref{Learning how to do something}, for how to view the manual.
674 666
675@node Emacs Lisp documentation 667@node Emacs Lisp documentation
676@section Where can I get documentation on Emacs Lisp? 668@section Where can I get documentation on Emacs Lisp?
@@ -684,11 +676,11 @@ Within Emacs, you can type @kbd{C-h f} to get the documentation for a
684function, @kbd{C-h v} for a variable. 676function, @kbd{C-h v} for a variable.
685 677
686For more information, the Emacs Lisp Reference Manual is available 678For more information, the Emacs Lisp Reference Manual is available
687on-line, in Info format. @xref{Top, Emacs Lisp,, elisp, The 679in Info format. @xref{Top, Emacs Lisp,, elisp, The
688Emacs Lisp Reference Manual}. 680Emacs Lisp Reference Manual}.
689 681
690You can also order a hardcopy of the manual, details on ordering it from 682You can also order a hardcopy of the manual, details on ordering it from
691FSF are on the @uref{http://www.gnu.org/order/order.html, GNU Web site}. 683FSF are on the @uref{http://shop.fsf.org/, FSF on-line store}.
692 684
693An HTML version of the Emacs Lisp Reference Manual is available at 685An HTML version of the Emacs Lisp Reference Manual is available at
694 686
@@ -703,17 +695,14 @@ An HTML version of the Emacs Lisp Reference Manual is available at
703@cindex Info files, how to install 695@cindex Info files, how to install
704 696
705First, you must turn the Texinfo files into Info files. You may do this 697First, you must turn the Texinfo files into Info files. You may do this
706using the stand-alone @file{makeinfo} program, available as part of the latest 698using the stand-alone @file{makeinfo} program, available as part of the
707Texinfo package at 699Texinfo package at
708 700
709@uref{ftp://ftp.gnu.org/pub/gnu/texinfo/texinfo-4.8.tar.gz} 701@uref{http://www.gnu.org/software/texinfo/}
710
711and all mirrors of @samp{ftp.gnu.org} (for a list, @pxref{Current GNU
712distributions}).
713 702
714For information about the Texinfo format, read the Texinfo manual which 703For information about the Texinfo format, read the Texinfo manual which
715comes with the Texinfo package. This manual also comes installed in 704comes with the Texinfo package. This manual also comes installed in
716Info format, so you can read it on-line; type @kbd{C-h i m texinfo 705Info format, so you can read it from Emacs; type @kbd{C-h i m texinfo
717@key{RET}}. 706@key{RET}}.
718 707
719Alternatively, you could use the Emacs command @kbd{M-x 708Alternatively, you could use the Emacs command @kbd{M-x
@@ -830,6 +819,8 @@ printed copy.
830The @samp{texi2dvi} script is part of the GNU Texinfo distribution 819The @samp{texi2dvi} script is part of the GNU Texinfo distribution
831(@pxref{Installing Texinfo documentation}). 820(@pxref{Installing Texinfo documentation}).
832 821
822Alternatively, @samp{texi2pdf} produces PDF files.
823
833@item 824@item
834Print the DVI file @file{@var{texinfo-source}.dvi} in the normal way for 825Print the DVI file @file{@var{texinfo-source}.dvi} in the normal way for
835printing DVI files at your site. For example, if you have a PostScript 826printing DVI files at your site. For example, if you have a PostScript
@@ -869,13 +860,11 @@ You can get Tkinfo at
869@cindex Files included with Emacs 860@cindex Files included with Emacs
870@cindex @file{COPYING}, description of file 861@cindex @file{COPYING}, description of file
871@cindex @file{DISTRIB}, description of file 862@cindex @file{DISTRIB}, description of file
872@cindex @file{FTP}, description of file
873@cindex @file{GNU}, description of file 863@cindex @file{GNU}, description of file
874@cindex @file{INTERVIEW}, description of file 864@cindex @file{INTERVIEW}, description of file
875@cindex @file{MACHINES}, description of file 865@cindex @file{MACHINES}, description of file
876@cindex @file{MAILINGLISTS}, description of file 866@cindex @file{MAILINGLISTS}, description of file
877@cindex @file{NEWS}, description of file 867@cindex @file{NEWS}, description of file
878@cindex @file{SERVICE}, description of file
879 868
880This isn't a frequently asked question, but it should be! A variety of 869This isn't a frequently asked question, but it should be! A variety of
881informational files about Emacs and relevant aspects of the GNU project 870informational files about Emacs and relevant aspects of the GNU project
@@ -893,9 +882,6 @@ GNU General Public License
893@item DISTRIB 882@item DISTRIB
894Emacs Availability Information 883Emacs Availability Information
895 884
896@item FTP
897How to get GNU Software by Internet FTP
898
899@item GNU 885@item GNU
900The GNU Manifesto 886The GNU Manifesto
901 887
@@ -912,9 +898,6 @@ GNU Project Electronic Mailing Lists
912@item NEWS 898@item NEWS
913Emacs news, a history of recent user-visible changes 899Emacs news, a history of recent user-visible changes
914 900
915@item SERVICE
916GNU Service Directory
917
918@end table 901@end table
919 902
920More GNU information, including back issues of the @cite{GNU's 903More GNU information, including back issues of the @cite{GNU's
@@ -996,7 +979,10 @@ conventions}).
996@cindex Version, latest 979@cindex Version, latest
997@cindex Latest version of Emacs 980@cindex Latest version of Emacs
998 981
999Emacs @value{VER} is the current version as of this writing. 982Emacs @value{VER} is the current version as of this writing. A version
983number with two components (e.g. @samp{22.1}) indicates a released
984version; three components (e.g. @samp{23.0.50}) indicate a development
985version.
1000 986
1001@node New in Emacs 20 987@node New in Emacs 20
1002@section What is different about Emacs 20? 988@section What is different about Emacs 20?
@@ -1168,8 +1154,6 @@ full list.
1168* Yanking text in isearch:: 1154* Yanking text in isearch::
1169* Wrapping words automatically:: 1155* Wrapping words automatically::
1170* Turning on auto-fill by default:: 1156* Turning on auto-fill by default::
1171* Spell-checkers::
1172* Checking TeX and *roff documents::
1173* Changing load-path:: 1157* Changing load-path::
1174* Using an already running Emacs process:: 1158* Using an already running Emacs process::
1175* Compiler error messages:: 1159* Compiler error messages::
@@ -1601,21 +1585,6 @@ If you want @code{auto-fill} mode on in all major modes, do this:
1601(setq-default auto-fill-function 'do-auto-fill) 1585(setq-default auto-fill-function 'do-auto-fill)
1602@end lisp 1586@end lisp
1603 1587
1604@node Spell-checkers
1605@section Where can I get a better spelling checker for Emacs?
1606@cindex Checking spelling
1607@cindex Spelling, checking text documents
1608
1609Use Ispell. @xref{Ispell}.
1610
1611@node Checking TeX and *roff documents
1612@section How can I spell-check @TeX{} or *roff documents?
1613@cindex Spelling, checking @TeX{} documents
1614@cindex @TeX{} documents, checking spelling in
1615
1616Use Ispell. Ispell can handle @TeX{} and *roff documents.
1617@xref{Ispell}.
1618
1619@node Changing load-path 1588@node Changing load-path
1620@section How do I change @code{load-path}? 1589@section How do I change @code{load-path}?
1621@cindex @code{load-path}, modifying 1590@cindex @code{load-path}, modifying
@@ -2495,11 +2464,6 @@ appear in different colors. For instance, in a programming mode,
2495variables will appear in one face, keywords in a second, and comments in 2464variables will appear in one face, keywords in a second, and comments in
2496a third. 2465a third.
2497 2466
2498@cindex hilit19 is deprecated
2499Earlier versions of Emacs supported hilit19, a similar package. Use of
2500hilit19 is now considered non-standard, although @file{hilit19.el} comes
2501with the stock Emacs distribution. It is no longer maintained.
2502
2503To turn @code{font-lock-mode} off within an existing buffer, use 2467To turn @code{font-lock-mode} off within an existing buffer, use
2504@kbd{M-x font-lock-mode @key{RET}}. 2468@kbd{M-x font-lock-mode @key{RET}}.
2505 2469
@@ -2928,7 +2892,7 @@ properly told to do DNS lookups with the correct command line switch.
2928@cindex Debugging @file{.emacs} file 2892@cindex Debugging @file{.emacs} file
2929 2893
2930An error occurred while loading either your @file{.emacs} file or the 2894An error occurred while loading either your @file{.emacs} file or the
2931system-wide file @file{lisp/default.el}. Emacs 21.1 and later pops the 2895system-wide file @file{site-lisp/default.el}. Emacs 21.1 and later pops the
2932@file{*Messages*} buffer, and puts there some additional information 2896@file{*Messages*} buffer, and puts there some additional information
2933about the error, to provide some hints for debugging. 2897about the error, to provide some hints for debugging.
2934 2898
@@ -3394,7 +3358,6 @@ Please don't post it to @uref{news:gnu.emacs.help} or send e-mail to
3394* Emacs for Windows:: 3358* Emacs for Windows::
3395* Emacs for GNUstep:: 3359* Emacs for GNUstep::
3396* Emacs for Apple computers:: 3360* Emacs for Apple computers::
3397* Modes for various languages::
3398@end menu 3361@end menu
3399 3362
3400@node Finding Emacs on the Internet 3363@node Finding Emacs on the Internet
@@ -3405,9 +3368,11 @@ Please don't post it to @uref{news:gnu.emacs.help} or send e-mail to
3405@cindex Distribution, retrieving Emacs 3368@cindex Distribution, retrieving Emacs
3406@cindex Internet, retrieving from 3369@cindex Internet, retrieving from
3407 3370
3408Look in the files @file{etc/DISTRIB} and @file{etc/FTP} for 3371Information on downloading Emacs is available at
3409information on nearby archive sites. If you don't already have Emacs, 3372@uref{http://www.gnu.org/software/emacs/, the Emacs home-page}.
3410see @ref{Informational files for Emacs}, for how to get these files. 3373
3374For an order form for all Emacs and FSF distributions deliverable from
3375the USA, see @uref{http://shop.fsf.org/}.
3411 3376
3412@xref{Installing Emacs}, for information on how to obtain and build the latest 3377@xref{Installing Emacs}, for information on how to obtain and build the latest
3413version of Emacs, and see @ref{Current GNU distributions}, for a list of 3378version of Emacs, and see @ref{Current GNU distributions}, for a list of
@@ -3478,9 +3443,6 @@ The most up-to-date official GNU software is normally kept at
3478 3443
3479@uref{ftp://ftp.gnu.org/pub/gnu} 3444@uref{ftp://ftp.gnu.org/pub/gnu}
3480 3445
3481Read the files @file{etc/DISTRIB} and @file{etc/FTP} for more
3482information.
3483
3484A list of sites mirroring @samp{ftp.gnu.org} can be found at 3446A list of sites mirroring @samp{ftp.gnu.org} can be found at
3485 3447
3486@uref{http://www.gnu.org/order/ftp.html} 3448@uref{http://www.gnu.org/order/ftp.html}
@@ -3540,7 +3502,7 @@ information is available from
3540@cindex Emacs for MS-DOS 3502@cindex Emacs for MS-DOS
3541@cindex Tools needed to compile Emacs under DOS 3503@cindex Tools needed to compile Emacs under DOS
3542 3504
3543A pre-built binary distribution of Emacs is available from the 3505A pre-built binary distribution of Emacs 20 is available from the
3544SimTel.NET archives. This version apparently works under MS-DOS and 3506SimTel.NET archives. This version apparently works under MS-DOS and
3545Windows (3.X, 9X, ME, NT, and 2000) and supports long file names under 3507Windows (3.X, 9X, ME, NT, and 2000) and supports long file names under
3546Windows 9X, Windows ME, and Windows 2000. More information is available 3508Windows 9X, Windows ME, and Windows 2000. More information is available
@@ -3643,30 +3605,6 @@ Beginning with version 23.1, Emacs supports GNUstep natively.
3643 3605
3644Beginning with version 22.1, Emacs supports Mac OS X natively. 3606Beginning with version 22.1, Emacs supports Mac OS X natively.
3645 3607
3646@node Modes for various languages
3647@section Where can I get modes for Lex, Yacc/Bison, Bourne shell, csh, C@t{++}, Objective-C, Pascal, Java, and Awk?
3648@cindex Awk, mode for
3649@cindex @code{awk-mode}
3650@cindex Bison, mode for
3651@cindex Bourne Shell, mode for
3652@cindex C@t{++}, mode for
3653@cindex Java, mode for
3654@cindex Lex mode
3655@cindex Objective-C, mode for
3656@cindex @code{pascal-mode}
3657@cindex Shell mode
3658@cindex Yacc mode
3659@cindex @file{csh} mode
3660@cindex @code{sh-mode}
3661@cindex @code{cc-mode}
3662
3663Most of these modes are now available in standard Emacs distribution.
3664To get additional modes, see @ref{Finding a package with particular
3665functionality}.
3666
3667Barry Warsaw's @code{cc-mode} now works for C, C@t{++}, Objective-C, and
3668Java code. It is distributed with Emacs, but has
3669@uref{http://cc-mode.sourceforge.net/, its own homepage}.
3670 3608
3671@c ------------------------------------------------------------ 3609@c ------------------------------------------------------------
3672@node Major packages and programs 3610@node Major packages and programs
@@ -3677,12 +3615,10 @@ Java code. It is distributed with Emacs, but has
3677* VM:: 3615* VM::
3678* AUCTeX:: 3616* AUCTeX::
3679* BBDB:: 3617* BBDB::
3680* Ispell:: 3618* Spell-checkers::
3681* Emacs/W3:: 3619* Emacs/W3::
3682* EDB:: 3620* EDB::
3683* Mailcrypt::
3684* JDE:: 3621* JDE::
3685* Patch::
3686@end menu 3622@end menu
3687 3623
3688@node VM 3624@node VM
@@ -3694,12 +3630,6 @@ Java code. It is distributed with Emacs, but has
3694 3630
3695@table @b 3631@table @b
3696 3632
3697@item Maintainer
3698@email{hack@@robf.de, Robert Widhopf-Fenk}
3699
3700@item Latest version
37018.0
3702
3703@item Web site 3633@item Web site
3704@uref{http://www.nongnu.org/viewmail/} 3634@uref{http://www.nongnu.org/viewmail/}
3705 3635
@@ -3732,29 +3662,7 @@ Current versions of AUC@TeX{} include the
3732package for WYSIWYG previews of various LaTeX constructs in the Emacs 3662package for WYSIWYG previews of various LaTeX constructs in the Emacs
3733source buffer. 3663source buffer.
3734 3664
3735@table @b 3665@uref{http://www.gnu.org/software/auctex/, AUCTeX}
3736
3737@item Authors
3738@email{krab@@iesd.auc.dk, Kresten Krab Thorup}, @*
3739@email{abraham@@dina.kvl.dk, Per Abrahamsen}, @* and others.
3740
3741@item Maintainer
3742@email{dak@@gnu.org, David Kastrup}
3743
3744@item Latest version
374511.85
3746
3747@item Distribution
3748@uref{ftp://ftp.gnu.org/pub/gnu/auctex/}
3749
3750@item Web site
3751@uref{http://www.gnu.org/software/auctex/}
3752
3753@item Mailing list:
3754Subscription requests to @email{auctex-request@@gnu.org}@*
3755Submissions to @email{auctex@@gnu.org}
3756
3757@end table
3758 3666
3759@node BBDB 3667@node BBDB
3760@section BBDB --- personal Info Rolodex integrated with mail/news readers 3668@section BBDB --- personal Info Rolodex integrated with mail/news readers
@@ -3765,48 +3673,30 @@ Submissions to @email{auctex@@gnu.org}
3765@cindex Big Brother Database 3673@cindex Big Brother Database
3766@cindex Address book 3674@cindex Address book
3767 3675
3768@table @b 3676@uref{http://bbdb.sourceforge.net/, The Insidious Big Brother Database}
3769
3770@item Maintainer
3771@email{hack@@robf.de, Robert Widhopf-Fenk}
3772 3677
3773@item Latest version 3678@node Spell-checkers
37742.35 3679@section Spell-checkers
3775
3776@item Distribution
3777@uref{http://bbdb.sourceforge.net/}
3778
3779@item Mailing lists
3780Subscription requests to @email{bbdb-info-request@@lists.sourceforge.net}@*
3781Submissions to @email{bbdb-info@@lists.sourceforge.net}@*
3782Release announcements: @email{bbdb-announce-request@@lists.sourceforge.net}
3783
3784@end table
3785
3786@node Ispell
3787@section Ispell --- spell checker in C with interface for Emacs
3788@cindex Spell-checker 3680@cindex Spell-checker
3789@cindex Checking spelling 3681@cindex Checking spelling
3790@cindex Ispell 3682@cindex Ispell
3683@cindex Aspell
3684@cindex Hunspell
3791 3685
3792@table @b 3686Various spell-checkers are compatible with Emacs, including:
3793
3794@item Author
3795@email{geoff@@cs.hmc.edu, Geoff Kuenning}
3796 3687
3797@item Latest version 3688@table @b
37983.3.02
3799 3689
3800@item Distribution 3690@item GNU Aspell
3801@uref{http://fmg-www.cs.ucla.edu/geoff/tars/ispell-3.3.02.tar.gz}@* 3691@uref{http://aspell.net/}
3802 3692
3803@item Web site 3693@item Ispell
3804@uref{http://fmg-www.cs.ucla.edu/geoff/ispell.html} 3694@uref{http://fmg-www.cs.ucla.edu/geoff/ispell.html}
3805 3695
3806@end table 3696@item Hunspell
3697@uref{http://hunspell.sourceforge.net/}
3807 3698
3808This Ispell program is distinct from GNU Ispell 4.0. GNU Ispell 4.0 is 3699@end table
3809no longer a supported product.
3810 3700
3811@node Emacs/W3 3701@node Emacs/W3
3812@section Emacs/W3 --- A World Wide Web browser inside of Emacs 3702@section Emacs/W3 --- A World Wide Web browser inside of Emacs
@@ -3815,27 +3705,7 @@ no longer a supported product.
3815@cindex HTML browser in Emacs 3705@cindex HTML browser in Emacs
3816@cindex @code{w3-mode} 3706@cindex @code{w3-mode}
3817 3707
3818@table @b 3708@uref{http://www.gnu.org/software/w3/, Emacs/W3}
3819
3820@item Author
3821@email{wmperry@@gnu.org, Bill Perry}
3822
3823@item Maintainer
3824Emacs/W3 needs a maintainer. It has lain dormant for several years. If
3825you would like to take over the project, please contact
3826@email{maintainers@@gnu.org}.
3827
3828@item Latest version
38294.0pre.47
3830
3831@item Distribution
3832@uref{http://savannah.gnu.org/projects/w3}
3833
3834@item Mailing lists
3835Receive announcements from @email{w3-announce@@gnu.org}@*
3836Help to develop Emacs/W3 at @email{w3-dev@@gnu.org}
3837
3838@end table
3839 3709
3840@node EDB 3710@node EDB
3841@section EDB --- Database program for Emacs; replaces forms editing modes 3711@section EDB --- Database program for Emacs; replaces forms editing modes
@@ -3843,51 +3713,7 @@ Help to develop Emacs/W3 at @email{w3-dev@@gnu.org}
3843@cindex Database 3713@cindex Database
3844@cindex Forms mode 3714@cindex Forms mode
3845 3715
3846@table @b 3716@uref{http://gnuvola.org/software/edb/, the Emacs Database}
3847@item Author
3848@email{mernst@@theory.lcs.mit.edu, Michael Ernst}
3849
3850@item Latest version
38511.21
3852
3853@item Distribution
3854@uref{ftp://theory.lcs.mit.edu/pub/emacs/edb}
3855
3856@end table
3857
3858@node Mailcrypt
3859@section Mailcrypt --- PGP interface within Emacs mail and news
3860@cindex PGP
3861@cindex GPG
3862@cindex Interface to PGP from Emacs mail and news
3863@cindex News, interface to PGP from
3864@cindex Mail, interface to PGP from
3865@cindex Encryption software, interface to
3866
3867@table @b
3868
3869@item Authors
3870@email{patl@@lcs.mit.edu, Patrick J. LoPresti} and
3871@email{jin@@atype.com, Jin S. Choi}
3872
3873@item Maintainer
3874@email{warner-mailcrypt@@lothar.com, Brian Warner}
3875
3876@item Latest version
38773.5.8
3878
3879@item Distribution
3880@uref{http://dl.sourceforge.net/sourceforge/mailcrypt/mailcrypt-3.5.8.tar.gz}
3881
3882@item Web site
3883@uref{http://mailcrypt.sourceforge.net/}
3884
3885@end table
3886
3887Note that a new package called PGG is bundled with Emacs starting with
3888version 22.1. It is a modern interface to various PGP implementations,
3889including @uref{http://www.gnupg.org/, The GNU Privacy Guard} and
3890supports symmetric encryption.
3891 3717
3892@node JDE 3718@node JDE
3893@section JDE --- Integrated development environment for Java 3719@section JDE --- Integrated development environment for Java
@@ -3895,42 +3721,7 @@ supports symmetric encryption.
3895@cindex Integrated Java development environment 3721@cindex Integrated Java development environment
3896@cindex JDE 3722@cindex JDE
3897 3723
3898@table @b 3724@uref{http://jdee.sourceforge.net/, a Java Development Environment for Emacs}
3899
3900@item Author
3901@email{paulk@@mathworks.com, Paul Kinnucan}
3902
3903@item Latest version
39042.3.5
3905
3906@item Web site
3907@uref{http://jdee.sunsite.dk/}
3908
3909@item Mailing lists
3910Subscription requests to @email{jde-subscribe@@sunsite.dk}@*
3911Receive announcements from @email{jde-announce-subscribe@@sunsite.dk}
3912
3913@end table
3914
3915@node Patch
3916@section Patch --- program to apply ``diffs'' for updating files
3917@cindex Updating files with diffs
3918@cindex Patching source files with diffs
3919@cindex Diffs and patching
3920@cindex @file{patch}
3921
3922@table @b
3923
3924@item Author
3925@email{lwall@@wall.org, Larry Wall} (with GNU modifications)
3926
3927@item Latest version
39282.5.4
3929
3930@item Distribution
3931@xref{Current GNU distributions}.
3932
3933@end table
3934 3725
3935@c ------------------------------------------------------------ 3726@c ------------------------------------------------------------
3936@node Key bindings 3727@node Key bindings
@@ -3941,7 +3732,6 @@ Receive announcements from @email{jde-announce-subscribe@@sunsite.dk}
3941* Binding keys to commands:: 3732* Binding keys to commands::
3942* Invalid prefix characters:: 3733* Invalid prefix characters::
3943* Terminal setup code works after Emacs has begun:: 3734* Terminal setup code works after Emacs has begun::
3944* Using function keys under X::
3945* Working with function and arrow keys:: 3735* Working with function and arrow keys::
3946* X key translations for Emacs:: 3736* X key translations for Emacs::
3947* Handling C-s and C-q with flow control:: 3737* Handling C-s and C-q with flow control::
@@ -4071,14 +3861,6 @@ variable to this lambda function. For example,
4071For information on what Emacs does every time it is started, see the 3861For information on what Emacs does every time it is started, see the
4072@file{lisp/startup.el} file. 3862@file{lisp/startup.el} file.
4073 3863
4074@node Using function keys under X
4075@section How do I use function keys under X?
4076@cindex Function keys
4077@cindex X Window System and function keys
4078@cindex Binding function keys
4079
4080With Emacs 19, functions keys under X are bound like any other key. @xref{Binding keys to commands}, for details.
4081
4082@node Working with function and arrow keys 3864@node Working with function and arrow keys
4083@section How do I tell what characters or symbols my function or arrow keys emit? 3865@section How do I tell what characters or symbols my function or arrow keys emit?
4084@cindex Working with arrow keys 3866@cindex Working with arrow keys
@@ -4089,7 +3871,7 @@ With Emacs 19, functions keys under X are bound like any other key. @xref{Bindi
4089 3871
4090Type @kbd{C-h c} then the function or arrow keys. The command will 3872Type @kbd{C-h c} then the function or arrow keys. The command will
4091return either a function key symbol or character sequence (see the 3873return either a function key symbol or character sequence (see the
4092Emacs on-line documentation for an explanation). This works for other 3874Emacs documentation for an explanation). This works for other
4093keys as well. 3875keys as well.
4094 3876
4095@node X key translations for Emacs 3877@node X key translations for Emacs
@@ -4501,7 +4283,7 @@ command.
4501 4283
4502With Emacs 19 and later, you can represent modified function keys in 4284With Emacs 19 and later, you can represent modified function keys in
4503vector format by adding prefixes to the function key symbol. For 4285vector format by adding prefixes to the function key symbol. For
4504example (from the on-line documentation): 4286example (from the Emacs documentation):
4505 4287
4506@lisp 4288@lisp
4507(global-set-key [?\C-x right] 'forward-page) 4289(global-set-key [?\C-x right] 'forward-page)