aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorGlenn Morris2009-06-12 07:49:09 +0000
committerGlenn Morris2009-06-12 07:49:09 +0000
commitf0bf7708dfb591793cf813749b1e4fadcebe44c4 (patch)
treeb63e8db40517b8b428f7a0cc34fa6afebff3b8a8
parent6c73ae8bbabe8c8096a3dfd589c942862bf1cc77 (diff)
downloademacs-f0bf7708dfb591793cf813749b1e4fadcebe44c4.tar.gz
emacs-f0bf7708dfb591793cf813749b1e4fadcebe44c4.zip
(Top): Add @top command.
Remove the optional arguments from all @node commands: makeinfo can generate these automatically, and it is easier to edit and rearrange nodes without them.
-rw-r--r--doc/misc/ChangeLog5
-rw-r--r--doc/misc/faq.texi347
2 files changed, 179 insertions, 173 deletions
diff --git a/doc/misc/ChangeLog b/doc/misc/ChangeLog
index decd1a47b93..27399be011b 100644
--- a/doc/misc/ChangeLog
+++ b/doc/misc/ChangeLog
@@ -15,6 +15,11 @@
15 (Removing flashing messages): Remove section about non-existent Gnus 15 (Removing flashing messages): Remove section about non-existent Gnus
16 option. 16 option.
17 17
18 * faq.texi (Top): Add @top command.
19 Remove the optional arguments from all @node commands: makeinfo can
20 generate these automatically, and it is easier to edit and rearrange
21 nodes without them.
22
182009-06-11 Glenn Morris <rgm@gnu.org> 232009-06-11 Glenn Morris <rgm@gnu.org>
19 24
20 * faq.texi (Common acronyms): Remove no-longer-existing OSF. 25 * faq.texi (Common acronyms): Remove no-longer-existing OSF.
diff --git a/doc/misc/faq.texi b/doc/misc/faq.texi
index 751cbacfe35..1af7625c18e 100644
--- a/doc/misc/faq.texi
+++ b/doc/misc/faq.texi
@@ -56,7 +56,8 @@ distribution.]
56 56
57@contents 57@contents
58 58
59@node Top, FAQ notation, (dir), (dir) 59@node Top, FAQ notation, (dir), (dir)
60@top The GNU Emacs FAQ
60 61
61This is the GNU Emacs FAQ, last updated on @today{}. 62This is the GNU Emacs FAQ, last updated on @today{}.
62 63
@@ -85,7 +86,7 @@ them.
85@end menu 86@end menu
86 87
87@c ------------------------------------------------------------ 88@c ------------------------------------------------------------
88@node FAQ notation, General questions, Top, Top 89@node FAQ notation
89@chapter FAQ notation 90@chapter FAQ notation
90@cindex FAQ notation 91@cindex FAQ notation
91 92
@@ -102,7 +103,7 @@ used in the FAQ.
102* Common acronyms:: 103* Common acronyms::
103@end menu 104@end menu
104 105
105@node Basic keys, Extended commands, FAQ notation, FAQ notation 106@node Basic keys
106@section What do these mean: @kbd{C-h}, @kbd{C-M-a}, @key{RET}, @kbd{@key{ESC} a}, etc.? 107@section What do these mean: @kbd{C-h}, @kbd{C-M-a}, @key{RET}, @kbd{@key{ESC} a}, etc.?
107@cindex Basic keys 108@cindex Basic keys
108@cindex Control key, notation for 109@cindex Control key, notation for
@@ -185,7 +186,7 @@ Also, on very few keyboards does @kbd{C-?} generate @acronym{ASCII} code 127.
185Keys, emacs}, for more information. (@xref{On-line manual}, for more 186Keys, emacs}, for more information. (@xref{On-line manual}, for more
186information about Info.) 187information about Info.)
187 188
188@node Extended commands, On-line manual, Basic keys, FAQ notation 189@node Extended commands
189@section What does @file{M-x @var{command}} mean? 190@section What does @file{M-x @var{command}} mean?
190@cindex Extended commands 191@cindex Extended commands
191@cindex Commands, extended 192@cindex Commands, extended
@@ -212,7 +213,7 @@ good candidate for this, on keyboards that have such a key.
212If you need to run non-interactive Emacs functions, see @ref{Evaluating 213If you need to run non-interactive Emacs functions, see @ref{Evaluating
213Emacs Lisp code}. 214Emacs Lisp code}.
214 215
215@node On-line manual, File-name conventions, Extended commands, FAQ notation 216@node On-line manual
216@section How do I read topic XXX in the on-line manual? 217@section How do I read topic XXX in the on-line manual?
217@cindex On-line manual, reading topics in 218@cindex On-line manual, reading topics in
218@cindex Reading topics in the on-line manual 219@cindex Reading topics in the on-line manual
@@ -236,7 +237,7 @@ improperly. In this case you should complain.
236@xref{Getting a printed manual}, if you would like a paper copy of the 237@xref{Getting a printed manual}, if you would like a paper copy of the
237Emacs manual. 238Emacs manual.
238 239
239@node File-name conventions, Common acronyms, On-line manual, FAQ notation 240@node File-name conventions
240@section What are @file{etc/SERVICE}, @file{src/config.h}, and @file{lisp/default.el}? 241@section What are @file{etc/SERVICE}, @file{src/config.h}, and @file{lisp/default.el}?
241@cindex File-name conventions 242@cindex File-name conventions
242@cindex Conventions for file names 243@cindex Conventions for file names
@@ -269,7 +270,7 @@ also available via the Emacs @samp{Help} menu, or by typing @kbd{C-h ?}
269Your system administrator may have removed the @file{src} directory and 270Your system administrator may have removed the @file{src} directory and
270many files from the @file{etc} directory. 271many files from the @file{etc} directory.
271 272
272@node Common acronyms, , File-name conventions, FAQ notation 273@node Common acronyms
273@section What are FSF, LPF, GNU, RMS, FTP, and GPL? 274@section What are FSF, LPF, GNU, RMS, FTP, and GPL?
274@cindex FSF, definition of 275@cindex FSF, definition of
275@cindex LPF, definition of 276@cindex LPF, definition of
@@ -316,7 +317,7 @@ get the software for less money from someone else, since everyone has
316the right to resell or give away GPL-covered software. 317the right to resell or give away GPL-covered software.
317 318
318@c ------------------------------------------------------------ 319@c ------------------------------------------------------------
319@node General questions, Getting help, FAQ notation, Top 320@node General questions
320@chapter General questions 321@chapter General questions
321@cindex General questions 322@cindex General questions
322 323
@@ -333,7 +334,7 @@ Free Software Foundation, and related organizations.
333* Contacting the FSF:: 334* Contacting the FSF::
334@end menu 335@end menu
335 336
336@node The LPF, Real meaning of copyleft, General questions, General questions 337@node The LPF
337@section What is the LPF? 338@section What is the LPF?
338@cindex LPF, description of 339@cindex LPF, description of
339@cindex League for Programming Freedom 340@cindex League for Programming Freedom
@@ -344,7 +345,7 @@ The LPF opposes the expanding danger of software patents and
344look-and-feel copyrights. More information on the LPF's views is 345look-and-feel copyrights. More information on the LPF's views is
345available at @uref{http://progfree.org/, the LPF home page}. 346available at @uref{http://progfree.org/, the LPF home page}.
346 347
347@node Real meaning of copyleft, Guidelines for newsgroup postings, The LPF, General questions 348@node Real meaning of copyleft
348@section What is the real legal meaning of the GNU copyleft? 349@section What is the real legal meaning of the GNU copyleft?
349@cindex Copyleft, real meaning of 350@cindex Copyleft, real meaning of
350@cindex GPL, real meaning of 351@cindex GPL, real meaning of
@@ -370,7 +371,7 @@ distribute any version of Emacs or a related program, and give the
370recipients the same freedom that you enjoyed. 371recipients the same freedom that you enjoyed.
371@end quotation 372@end quotation
372 373
373@node Guidelines for newsgroup postings, Newsgroup archives, Real meaning of copyleft, General questions 374@node Guidelines for newsgroup postings
374@section What are appropriate messages for @uref{news:gnu.emacs.help}, @uref{news:gnu.emacs.bug}, @uref{news:comp.emacs}, etc.? 375@section What are appropriate messages for @uref{news:gnu.emacs.help}, @uref{news:gnu.emacs.bug}, @uref{news:comp.emacs}, etc.?
375@cindex Newsgroups, appropriate messages for 376@cindex Newsgroups, appropriate messages for
376@cindex GNU newsgroups, appropriate messages for 377@cindex GNU newsgroups, appropriate messages for
@@ -405,7 +406,7 @@ posting a followup that recommends such software.
405@uref{news:gnu.emacs.bug} is a place where bug reports appear, but avoid 406@uref{news:gnu.emacs.bug} is a place where bug reports appear, but avoid
406posting bug reports to this newsgroup directly (@pxref{Reporting bugs}). 407posting bug reports to this newsgroup directly (@pxref{Reporting bugs}).
407 408
408@node Newsgroup archives, Reporting bugs, Guidelines for newsgroup postings, General questions 409@node Newsgroup archives
409@section Where can I get old postings to @uref{news:gnu.emacs.help} and other GNU groups? 410@section Where can I get old postings to @uref{news:gnu.emacs.help} and other GNU groups?
410@cindex Archived postings from @code{gnu.emacs.help} 411@cindex Archived postings from @code{gnu.emacs.help}
411@cindex Usenet archives for GNU groups 412@cindex Usenet archives for GNU groups
@@ -428,7 +429,7 @@ archive the @code{gnu.*} groups.
428You can read the archives of the @code{gnu.*} groups and post new 429You can read the archives of the @code{gnu.*} groups and post new
429messages at @uref{http://gmane.org/, Gmane}. 430messages at @uref{http://gmane.org/, Gmane}.
430 431
431@node Reporting bugs, Unsubscribing from Emacs lists, Newsgroup archives, General questions 432@node Reporting bugs
432@section Where should I report bugs and other problems with Emacs? 433@section Where should I report bugs and other problems with Emacs?
433@cindex Bug reporting 434@cindex Bug reporting
434@cindex Good bug reports 435@cindex Good bug reports
@@ -479,7 +480,7 @@ is a bug. If Lisp code does not do what the documentation says it
479does, that is a bug. 480does, that is a bug.
480@end quotation 481@end quotation
481 482
482@node Unsubscribing from Emacs lists, Contacting the FSF, Reporting bugs, General questions 483@node Unsubscribing from Emacs lists
483@section How do I unsubscribe from this mailing list? 484@section How do I unsubscribe from this mailing list?
484@cindex Unsubscribing from GNU mailing lists 485@cindex Unsubscribing from GNU mailing lists
485@cindex Removing yourself from GNU mailing lists 486@cindex Removing yourself from GNU mailing lists
@@ -495,7 +496,7 @@ on the mail messages may help, along with liberal use of the @samp{EXPN} or
495smtp}. Ask your postmaster for help, if you cannot figure out these 496smtp}. Ask your postmaster for help, if you cannot figure out these
496details. 497details.
497 498
498@node Contacting the FSF, , Unsubscribing from Emacs lists, General questions 499@node Contacting the FSF
499@section What is the current address of the FSF? 500@section What is the current address of the FSF?
500@cindex Snail mail address of the FSF 501@cindex Snail mail address of the FSF
501@cindex Postal address of the FSF 502@cindex Postal address of the FSF
@@ -529,7 +530,7 @@ For details on how to order items directly from the FSF, see the
529@uref{http://www.gnu.org/order/order.html, GNU Web site}. 530@uref{http://www.gnu.org/order/order.html, GNU Web site}.
530 531
531@c ------------------------------------------------------------ 532@c ------------------------------------------------------------
532@node Getting help, Status of Emacs, General questions, Top 533@node Getting help
533@chapter Getting help 534@chapter Getting help
534@cindex Getting help 535@cindex Getting help
535 536
@@ -548,7 +549,7 @@ This chapter tells you how to get help with Emacs
548* Obtaining the FAQ:: 549* Obtaining the FAQ::
549@end menu 550@end menu
550 551
551@node Basic editing, Learning how to do something, Getting help, Getting help 552@node Basic editing
552@section I'm just starting Emacs; how do I do basic editing? 553@section I'm just starting Emacs; how do I do basic editing?
553@cindex Basic editing with Emacs 554@cindex Basic editing with Emacs
554@cindex Beginning editing 555@cindex Beginning editing
@@ -573,7 +574,7 @@ sequence listed. Each of the resulting key sequences invokes help.
573Emacs help works best if it is invoked by a single key whose value 574Emacs help works best if it is invoked by a single key whose value
574should be stored in the variable @code{help-char}. 575should be stored in the variable @code{help-char}.
575 576
576@node Learning how to do something, Getting a printed manual, Basic editing, Getting help 577@node Learning how to do something
577@section How do I find out how to do something in Emacs? 578@section How do I find out how to do something in Emacs?
578@cindex Help for Emacs 579@cindex Help for Emacs
579@cindex Learning to do something in Emacs 580@cindex Learning to do something in Emacs
@@ -649,7 +650,7 @@ information. To get a list of these commands, type @samp{?} after
649 650
650@end itemize 651@end itemize
651 652
652@node Getting a printed manual, Emacs Lisp documentation, Learning how to do something, Getting help 653@node Getting a printed manual
653@section How do I get a printed copy of the Emacs manual? 654@section How do I get a printed copy of the Emacs manual?
654@cindex Printed Emacs manual, obtaining 655@cindex Printed Emacs manual, obtaining
655@cindex Manual, obtaining a printed or HTML copy of 656@cindex Manual, obtaining a printed or HTML copy of
@@ -671,7 +672,7 @@ you can get a PostScript or PDF (or HTML) version from
671 672
672@xref{Learning how to do something}, for how to view the manual on-line. 673@xref{Learning how to do something}, for how to view the manual on-line.
673 674
674@node Emacs Lisp documentation, Installing Texinfo documentation, Getting a printed manual, Getting help 675@node Emacs Lisp documentation
675@section Where can I get documentation on Emacs Lisp? 676@section Where can I get documentation on Emacs Lisp?
676@cindex Documentation on Emacs Lisp 677@cindex Documentation on Emacs Lisp
677@cindex Function documentation 678@cindex Function documentation
@@ -693,7 +694,7 @@ An HTML version of the Emacs Lisp Reference Manual is available at
693 694
694@uref{http://www.gnu.org/software/emacs/elisp-manual/elisp.html} 695@uref{http://www.gnu.org/software/emacs/elisp-manual/elisp.html}
695 696
696@node Installing Texinfo documentation, Printing a Texinfo file, Emacs Lisp documentation, Getting help 697@node Installing Texinfo documentation
697@section How do I install a piece of Texinfo documentation? 698@section How do I install a piece of Texinfo documentation?
698@cindex Texinfo documentation, installing 699@cindex Texinfo documentation, installing
699@cindex Installing Texinfo documentation 700@cindex Installing Texinfo documentation
@@ -797,7 +798,7 @@ files. The node lists from all @file{dir} files in
797 798
798@end itemize 799@end itemize
799 800
800@node Printing a Texinfo file, Viewing Info files outside of Emacs, Installing Texinfo documentation, Getting help 801@node Printing a Texinfo file
801@section How do I print a Texinfo file? 802@section How do I print a Texinfo file?
802@cindex Printing a Texinfo file 803@cindex Printing a Texinfo file
803@cindex Texinfo file, printing 804@cindex Texinfo file, printing
@@ -840,7 +841,7 @@ printer.
840To get more general instructions, retrieve the latest Texinfo package 841To get more general instructions, retrieve the latest Texinfo package
841(@pxref{Installing Texinfo documentation}). 842(@pxref{Installing Texinfo documentation}).
842 843
843@node Viewing Info files outside of Emacs, Informational files for Emacs, Printing a Texinfo file, Getting help 844@node Viewing Info files outside of Emacs
844@section Can I view Info files without using Emacs? 845@section Can I view Info files without using Emacs?
845@cindex Viewing Info files 846@cindex Viewing Info files
846@cindex Info file viewers 847@cindex Info file viewers
@@ -862,7 +863,7 @@ You can get Tkinfo at
862 863
863@end itemize 864@end itemize
864 865
865@node Informational files for Emacs, Help installing Emacs, Viewing Info files outside of Emacs, Getting help 866@node Informational files for Emacs
866@section What informational files are available for Emacs? 867@section What informational files are available for Emacs?
867@cindex Informational files included with Emacs 868@cindex Informational files included with Emacs
868@cindex Files included with Emacs 869@cindex Files included with Emacs
@@ -923,7 +924,7 @@ Bulletin}, are at
923 924
924@uref{http://www.cs.pdx.edu/~trent/gnu/gnu.html} 925@uref{http://www.cs.pdx.edu/~trent/gnu/gnu.html}
925 926
926@node Help installing Emacs, Obtaining the FAQ, Informational files for Emacs, Getting help 927@node Help installing Emacs
927@section Where can I get help in installing Emacs? 928@section Where can I get help in installing Emacs?
928@cindex Installation help 929@cindex Installation help
929@cindex Help installing Emacs 930@cindex Help installing Emacs
@@ -935,7 +936,7 @@ The web-page @uref{http://www.fsf.org/resources/service/} lists
935companies and individuals willing to sell you help in installing or 936companies and individuals willing to sell you help in installing or
936using Emacs. 937using Emacs.
937 938
938@node Obtaining the FAQ, , Help installing Emacs, Getting help 939@node Obtaining the FAQ
939@section Where can I get the latest version of this FAQ? 940@section Where can I get the latest version of this FAQ?
940@cindex FAQ, obtaining the 941@cindex FAQ, obtaining the
941@cindex Latest FAQ version, obtaining the 942@cindex Latest FAQ version, obtaining the
@@ -947,7 +948,7 @@ C-f} (@kbd{M-x view-emacs-FAQ}).
947 948
948 949
949@c ------------------------------------------------------------ 950@c ------------------------------------------------------------
950@node Status of Emacs, Common requests, Getting help, Top 951@node Status of Emacs
951@chapter Status of Emacs 952@chapter Status of Emacs
952@cindex Status of Emacs 953@cindex Status of Emacs
953 954
@@ -962,7 +963,7 @@ latest version status.
962* New in Emacs 22:: 963* New in Emacs 22::
963@end menu 964@end menu
964 965
965@node Origin of the term Emacs, Latest version of Emacs, Status of Emacs, Status of Emacs 966@node Origin of the term Emacs
966@section Where does the name ``Emacs'' come from? 967@section Where does the name ``Emacs'' come from?
967@cindex Origin of the term ``Emacs'' 968@cindex Origin of the term ``Emacs''
968@cindex Emacs name origin 969@cindex Emacs name origin
@@ -990,14 +991,14 @@ For some not-so-serious alternative reasons for Emacs to have that
990name, check out the file @file{etc/JOKES} (@pxref{File-name 991name, check out the file @file{etc/JOKES} (@pxref{File-name
991conventions}). 992conventions}).
992 993
993@node Latest version of Emacs, New in Emacs 20, Origin of the term Emacs, Status of Emacs 994@node Latest version of Emacs
994@section What is the latest version of Emacs? 995@section What is the latest version of Emacs?
995@cindex Version, latest 996@cindex Version, latest
996@cindex Latest version of Emacs 997@cindex Latest version of Emacs
997 998
998Emacs @value{VER} is the current version as of this writing. 999Emacs @value{VER} is the current version as of this writing.
999 1000
1000@node New in Emacs 20, New in Emacs 21, Latest version of Emacs, Status of Emacs 1001@node New in Emacs 20
1001@section What is different about Emacs 20? 1002@section What is different about Emacs 20?
1002@cindex Differences between Emacs 19 and Emacs 20 1003@cindex Differences between Emacs 19 and Emacs 20
1003@cindex Emacs 20, new features in 1004@cindex Emacs 20, new features in
@@ -1023,7 +1024,7 @@ calendar/diary, have been updated and enhanced to work with Emacs 20,
1023and are now included with the standard distribution. 1024and are now included with the standard distribution.
1024 1025
1025 1026
1026@node New in Emacs 21, New in Emacs 22, New in Emacs 20, Status of Emacs 1027@node New in Emacs 21
1027@section What is different about Emacs 21? 1028@section What is different about Emacs 21?
1028@cindex Differences between Emacs 20 and Emacs 21 1029@cindex Differences between Emacs 20 and Emacs 21
1029@cindex Emacs 21, new features in 1030@cindex Emacs 21, new features in
@@ -1045,7 +1046,7 @@ In addition, Emacs 21 supports faces on text-only terminals. This means
1045that you can now have colors when you run Emacs on a GNU/Linux console 1046that you can now have colors when you run Emacs on a GNU/Linux console
1046and on @code{xterm} with @kbd{emacs -nw}. 1047and on @code{xterm} with @kbd{emacs -nw}.
1047 1048
1048@node New in Emacs 22, , New in Emacs 21, Status of Emacs 1049@node New in Emacs 22
1049@section What is different about Emacs 22? 1050@section What is different about Emacs 22?
1050@cindex Differences between Emacs 21 and Emacs 22 1051@cindex Differences between Emacs 21 and Emacs 22
1051@cindex Emacs 22, new features in 1052@cindex Emacs 22, new features in
@@ -1146,7 +1147,7 @@ Many other changes have been made in Emacs 22, use @kbd{C-h n} to get a
1146full list. 1147full list.
1147 1148
1148@c ------------------------------------------------------------ 1149@c ------------------------------------------------------------
1149@node Common requests, Bugs and problems, Status of Emacs, Top 1150@node Common requests
1150@chapter Common requests 1151@chapter Common requests
1151@cindex Common requests 1152@cindex Common requests
1152 1153
@@ -1205,7 +1206,7 @@ full list.
1205* Fullscreen mode on MS-Windows:: 1206* Fullscreen mode on MS-Windows::
1206@end menu 1207@end menu
1207 1208
1208@node Setting up a customization file, Using Customize, Common requests, Common requests 1209@node Setting up a customization file
1209@section How do I set up a @file{.emacs} file properly? 1210@section How do I set up a @file{.emacs} file properly?
1210@cindex @file{.emacs} file, setting up 1211@cindex @file{.emacs} file, setting up
1211@cindex @file{.emacs} file, locating 1212@cindex @file{.emacs} file, locating
@@ -1235,7 +1236,7 @@ Sometimes users are unsure as to where their @file{.emacs} file should
1235be found. Visiting the file as @file{~/.emacs} from Emacs will find 1236be found. Visiting the file as @file{~/.emacs} from Emacs will find
1236the correct file. 1237the correct file.
1237 1238
1238@node Using Customize, Colors on a TTY, Setting up a customization file, Common requests 1239@node Using Customize
1239@section How do I start using Customize? 1240@section How do I start using Customize?
1240@cindex Customize groups 1241@cindex Customize groups
1241@cindex Customizing variables 1242@cindex Customizing variables
@@ -1254,7 +1255,7 @@ If you wish to customize a single option, use @kbd{M-x customize-option
1254@key{RET}}. This command prompts you for the name of the option to 1255@key{RET}}. This command prompts you for the name of the option to
1255customize, with completion. 1256customize, with completion.
1256 1257
1257@node Colors on a TTY, Debugging a customization file, Using Customize, Common requests 1258@node Colors on a TTY
1258@section How do I get colors and syntax highlighting on a TTY? 1259@section How do I get colors and syntax highlighting on a TTY?
1259@cindex Colors on a TTY 1260@cindex Colors on a TTY
1260@cindex Syntax highlighting on a TTY 1261@cindex Syntax highlighting on a TTY
@@ -1274,7 +1275,7 @@ exhibits all the colors Emacs knows about on the current display.
1274 1275
1275Syntax highlighting is on by default since version 22.1. 1276Syntax highlighting is on by default since version 22.1.
1276 1277
1277@node Debugging a customization file, Displaying the current line or column, Colors on a TTY, Common requests 1278@node Debugging a customization file
1278@section How do I debug a @file{.emacs} file? 1279@section How do I debug a @file{.emacs} file?
1279@cindex Debugging @file{.emacs} file 1280@cindex Debugging @file{.emacs} file
1280@cindex @file{.emacs} debugging 1281@cindex @file{.emacs} debugging
@@ -1296,7 +1297,7 @@ eval-last-sexp}).
1296Use @kbd{C-h v} (@kbd{M-x describe-variable}) to check the value of 1297Use @kbd{C-h v} (@kbd{M-x describe-variable}) to check the value of
1297variables which you are trying to set or use. 1298variables which you are trying to set or use.
1298 1299
1299@node Displaying the current line or column, Displaying the current file name in the titlebar, Debugging a customization file, Common requests 1300@node Displaying the current line or column
1300@section How do I make Emacs display the current line (or column) number? 1301@section How do I make Emacs display the current line (or column) number?
1301@cindex @code{line-number-mode} 1302@cindex @code{line-number-mode}
1302@cindex Displaying the current line or column 1303@cindex Displaying the current line or column
@@ -1347,7 +1348,7 @@ written by @email{kyle@@wonderworks.com, Kyle Jones} provides this
1347feature. So too does @samp{wb-line-number}, written by 1348feature. So too does @samp{wb-line-number}, written by
1348@email{naoki.y.nakamura@@nifty.com, Naoki Nakamura}. 1349@email{naoki.y.nakamura@@nifty.com, Naoki Nakamura}.
1349 1350
1350@node Displaying the current file name in the titlebar, Turning on abbrevs by default, Displaying the current line or column, Common requests 1351@node Displaying the current file name in the titlebar
1351@section How can I modify the titlebar to contain the current file name? 1352@section How can I modify the titlebar to contain the current file name?
1352@cindex Titlebar, displaying the current file name in 1353@cindex Titlebar, displaying the current file name in
1353@cindex File name, displaying in the titlebar 1354@cindex File name, displaying in the titlebar
@@ -1377,7 +1378,7 @@ in your @file{.emacs}:
1377(setq frame-title-format "%b") 1378(setq frame-title-format "%b")
1378@end lisp 1379@end lisp
1379 1380
1380@node Turning on abbrevs by default, Associating modes with files, Displaying the current file name in the titlebar, Common requests 1381@node Turning on abbrevs by default
1381@section How do I turn on abbrevs by default just in mode @var{mymode}? 1382@section How do I turn on abbrevs by default just in mode @var{mymode}?
1382@cindex Abbrevs, turning on by default 1383@cindex Abbrevs, turning on by default
1383 1384
@@ -1396,7 +1397,7 @@ Put this in your @file{.emacs} file:
1396Starting with Emacs 22, the standard abbrevs file is read automatically 1397Starting with Emacs 22, the standard abbrevs file is read automatically
1397at startup, so the first of these two forms becomes unnecessary. 1398at startup, so the first of these two forms becomes unnecessary.
1398 1399
1399@node Associating modes with files, Highlighting a region, Turning on abbrevs by default, Common requests 1400@node Associating modes with files
1400@section How do I make Emacs use a certain major mode for certain files? 1401@section How do I make Emacs use a certain major mode for certain files?
1401@cindex Associating modes with files 1402@cindex Associating modes with files
1402@cindex File extensions and modes 1403@cindex File extensions and modes
@@ -1425,7 +1426,7 @@ determines which interpreter you're using by examining the first line of
1425the script.) Use @kbd{C-h v} (or @kbd{M-x describe-variable}) 1426the script.) Use @kbd{C-h v} (or @kbd{M-x describe-variable})
1426on @code{interpreter-mode-alist} to learn more. 1427on @code{interpreter-mode-alist} to learn more.
1427 1428
1428@node Highlighting a region, Replacing highlighted text, Associating modes with files, Common requests 1429@node Highlighting a region
1429@section How can I highlight a region of text in Emacs? 1430@section How can I highlight a region of text in Emacs?
1430@cindex Highlighting text 1431@cindex Highlighting text
1431@cindex Text, highlighting 1432@cindex Text, highlighting
@@ -1442,7 +1443,7 @@ including
1442@noindent 1443@noindent
1443in your @file{.emacs} file. 1444in your @file{.emacs} file.
1444 1445
1445@node Replacing highlighted text, Controlling case sensitivity, Highlighting a region, Common requests 1446@node Replacing highlighted text
1446@section How can I replace highlighted text with what I type? 1447@section How can I replace highlighted text with what I type?
1447@cindex @code{delete-selection-mode} 1448@cindex @code{delete-selection-mode}
1448@cindex Replacing highlighted text 1449@cindex Replacing highlighted text
@@ -1467,7 +1468,7 @@ When OFF, typed text is just inserted at point.
1467This mode also allows you to delete (not kill) the highlighted region by 1468This mode also allows you to delete (not kill) the highlighted region by
1468pressing @key{DEL}. 1469pressing @key{DEL}.
1469 1470
1470@node Controlling case sensitivity, Working with unprintable characters, Replacing highlighted text, Common requests 1471@node Controlling case sensitivity
1471@section How do I control Emacs's case-sensitivity when searching/replacing? 1472@section How do I control Emacs's case-sensitivity when searching/replacing?
1472@cindex @code{case-fold-search} 1473@cindex @code{case-fold-search}
1473@cindex Case sensitivity of searches 1474@cindex Case sensitivity of searches
@@ -1499,7 +1500,7 @@ mode's hook. For example:
1499 (setq case-fold-search nil))) 1500 (setq case-fold-search nil)))
1500@end lisp 1501@end lisp
1501 1502
1502@node Working with unprintable characters, Searching for/replacing newlines, Controlling case sensitivity, Common requests 1503@node Working with unprintable characters
1503@section How do I search for, delete, or replace unprintable (eight-bit or control) characters? 1504@section How do I search for, delete, or replace unprintable (eight-bit or control) characters?
1504@cindex Unprintable characters, working with 1505@cindex Unprintable characters, working with
1505@cindex Working with unprintable characters 1506@cindex Working with unprintable characters
@@ -1547,7 +1548,7 @@ characters with a colon, use:
1547 1548
1548M-x replace-regexp @key{RET} [^ @key{TAB} C-q @key{LFD} C-q @key{RET} C-q C-l @key{SPC} -~] @key{RET} : @key{RET} 1549M-x replace-regexp @key{RET} [^ @key{TAB} C-q @key{LFD} C-q @key{RET} C-q C-l @key{SPC} -~] @key{RET} : @key{RET}
1549 1550
1550@node Searching for/replacing newlines, Yanking text in isearch, Working with unprintable characters, Common requests 1551@node Searching for/replacing newlines
1551@section How do I input a newline character in isearch or query-replace? 1552@section How do I input a newline character in isearch or query-replace?
1552@cindex Searching for newlines 1553@cindex Searching for newlines
1553@cindex Replacing newlines 1554@cindex Replacing newlines
@@ -1556,14 +1557,14 @@ Use @kbd{C-q C-j}. For more information, see @inforef{Special Isearch,
1556Special Input for Incremental Search, emacs}. 1557Special Input for Incremental Search, emacs}.
1557 1558
1558 1559
1559@node Yanking text in isearch, Wrapping words automatically, Searching for/replacing newlines, Common requests 1560@node Yanking text in isearch
1560@section How do I copy text from the kill ring into the search string? 1561@section How do I copy text from the kill ring into the search string?
1561@cindex Yanking text into the search string 1562@cindex Yanking text into the search string
1562@cindex isearch yanking 1563@cindex isearch yanking
1563 1564
1564Use @kbd{M-y}. @inforef{Isearch Yank, Isearch Yanking, emacs}. 1565Use @kbd{M-y}. @inforef{Isearch Yank, Isearch Yanking, emacs}.
1565 1566
1566@node Wrapping words automatically, Turning on auto-fill by default, Yanking text in isearch, Common requests 1567@node Wrapping words automatically
1567@section How do I make Emacs wrap words for me? 1568@section How do I make Emacs wrap words for me?
1568@cindex Wrapping word automatically 1569@cindex Wrapping word automatically
1569@cindex Wrapping lines 1570@cindex Wrapping lines
@@ -1577,7 +1578,7 @@ The default maximum line width is 70, determined by the variable
1577@code{fill-column}. To learn how to turn this on automatically, see 1578@code{fill-column}. To learn how to turn this on automatically, see
1578@ref{Turning on auto-fill by default}. 1579@ref{Turning on auto-fill by default}.
1579 1580
1580@node Turning on auto-fill by default, Spell-checkers, Wrapping words automatically, Common requests 1581@node Turning on auto-fill by default
1581@section How do I turn on @code{auto-fill-mode} by default? 1582@section How do I turn on @code{auto-fill-mode} by default?
1582@cindex @code{auto-fill-mode}, activating automatically 1583@cindex @code{auto-fill-mode}, activating automatically
1583@cindex Filling automatically 1584@cindex Filling automatically
@@ -1600,14 +1601,14 @@ If you want @code{auto-fill} mode on in all major modes, do this:
1600(setq-default auto-fill-function 'do-auto-fill) 1601(setq-default auto-fill-function 'do-auto-fill)
1601@end lisp 1602@end lisp
1602 1603
1603@node Spell-checkers, Checking TeX and *roff documents, Turning on auto-fill by default, Common requests 1604@node Spell-checkers
1604@section Where can I get a better spelling checker for Emacs? 1605@section Where can I get a better spelling checker for Emacs?
1605@cindex Checking spelling 1606@cindex Checking spelling
1606@cindex Spelling, checking text documents 1607@cindex Spelling, checking text documents
1607 1608
1608Use Ispell. @xref{Ispell}. 1609Use Ispell. @xref{Ispell}.
1609 1610
1610@node Checking TeX and *roff documents, Changing load-path, Spell-checkers, Common requests 1611@node Checking TeX and *roff documents
1611@section How can I spell-check @TeX{} or *roff documents? 1612@section How can I spell-check @TeX{} or *roff documents?
1612@cindex Spelling, checking @TeX{} documents 1613@cindex Spelling, checking @TeX{} documents
1613@cindex @TeX{} documents, checking spelling in 1614@cindex @TeX{} documents, checking spelling in
@@ -1615,7 +1616,7 @@ Use Ispell. @xref{Ispell}.
1615Use Ispell. Ispell can handle @TeX{} and *roff documents. 1616Use Ispell. Ispell can handle @TeX{} and *roff documents.
1616@xref{Ispell}. 1617@xref{Ispell}.
1617 1618
1618@node Changing load-path, Using an already running Emacs process, Checking TeX and *roff documents, Common requests 1619@node Changing load-path
1619@section How do I change @code{load-path}? 1620@section How do I change @code{load-path}?
1620@cindex @code{load-path}, modifying 1621@cindex @code{load-path}, modifying
1621@cindex Modifying @code{load-path} 1622@cindex Modifying @code{load-path}
@@ -1634,7 +1635,7 @@ To do this relative to your home directory:
1634(setq load-path (cons "~/mysubdir/" load-path)) 1635(setq load-path (cons "~/mysubdir/" load-path))
1635@end lisp 1636@end lisp
1636 1637
1637@node Using an already running Emacs process, Compiler error messages, Changing load-path, Common requests 1638@node Using an already running Emacs process
1638@section How do I use an already running Emacs from another window? 1639@section How do I use an already running Emacs from another window?
1639@cindex @code{emacsclient} 1640@cindex @code{emacsclient}
1640@cindex Emacs server functions 1641@cindex Emacs server functions
@@ -1709,7 +1710,7 @@ The most recent @samp{gnuserv} package is available at
1709 1710
1710@end itemize 1711@end itemize
1711 1712
1712@node Compiler error messages, Indenting switch statements, Using an already running Emacs process, Common requests 1713@node Compiler error messages
1713@section How do I make Emacs recognize my compiler's funny error messages? 1714@section How do I make Emacs recognize my compiler's funny error messages?
1714@cindex Compiler error messages, recognizing 1715@cindex Compiler error messages, recognizing
1715@cindex Recognizing non-standard compiler errors 1716@cindex Recognizing non-standard compiler errors
@@ -1718,7 +1719,7 @@ The most recent @samp{gnuserv} package is available at
1718 1719
1719Customize the @code{compilation-error-regexp-alist} variable. 1720Customize the @code{compilation-error-regexp-alist} variable.
1720 1721
1721@node Indenting switch statements, Customizing C and C++ indentation, Compiler error messages, Common requests 1722@node Indenting switch statements
1722@section How do I change the indentation for @code{switch}? 1723@section How do I change the indentation for @code{switch}?
1723@cindex @code{switch}, indenting 1724@cindex @code{switch}, indenting
1724@cindex Indenting of @code{switch} 1725@cindex Indenting of @code{switch}
@@ -1755,7 +1756,7 @@ C programming in Emacs 20 and later) and add the following line to your
1755 1756
1756There appears to be no way to do this with the old @code{c-mode}. 1757There appears to be no way to do this with the old @code{c-mode}.
1757 1758
1758@node Customizing C and C++ indentation, Horizontal scrolling, Indenting switch statements, Common requests 1759@node Customizing C and C++ indentation
1759@section How to customize indentation in C, C@t{++}, and Java buffers? 1760@section How to customize indentation in C, C@t{++}, and Java buffers?
1760@cindex Indentation, how to customize 1761@cindex Indentation, how to customize
1761@cindex Customize indentation 1762@cindex Customize indentation
@@ -1839,7 +1840,7 @@ Java sources, etc. If you want the same customizations to be in
1839effect in @emph{all} languages supported by @code{cc-mode}, use 1840effect in @emph{all} languages supported by @code{cc-mode}, use
1840@code{c-mode-common-hook}. 1841@code{c-mode-common-hook}.
1841 1842
1842@node Horizontal scrolling, Overwrite mode, Customizing C and C++ indentation, Common requests 1843@node Horizontal scrolling
1843@section How can I make Emacs automatically scroll horizontally? 1844@section How can I make Emacs automatically scroll horizontally?
1844@cindex @code{hscroll-mode} 1845@cindex @code{hscroll-mode}
1845@cindex Horizontal scrolling 1846@cindex Horizontal scrolling
@@ -1882,7 +1883,7 @@ edge of the window.
1882@code{hscroll-step-percent} controls how far to jump once we decide to do so. 1883@code{hscroll-step-percent} controls how far to jump once we decide to do so.
1883@end itemize 1884@end itemize
1884 1885
1885@node Overwrite mode, Turning off beeping, Horizontal scrolling, Common requests 1886@node Overwrite mode
1886@section How do I make Emacs ``typeover'' or ``overwrite'' instead of inserting? 1887@section How do I make Emacs ``typeover'' or ``overwrite'' instead of inserting?
1887@cindex @key{Insert} 1888@cindex @key{Insert}
1888@cindex @code{overwrite-mode} 1889@cindex @code{overwrite-mode}
@@ -1895,7 +1896,7 @@ is as easy as another @kbd{M-x overwrite-mode}.
1895 1896
1896On some systems, @key{Insert} toggles @code{overwrite-mode} on and off. 1897On some systems, @key{Insert} toggles @code{overwrite-mode} on and off.
1897 1898
1898@node Turning off beeping, Turning the volume down, Overwrite mode, Common requests 1899@node Turning off beeping
1899@section How do I stop Emacs from beeping on a terminal? 1900@section How do I stop Emacs from beeping on a terminal?
1900@cindex Beeping, turning off 1901@cindex Beeping, turning off
1901@cindex Visible bell 1902@cindex Visible bell
@@ -1919,7 +1920,7 @@ And evaluate the following Lisp form:
1919(setq visible-bell t) 1920(setq visible-bell t)
1920@end example 1921@end example
1921 1922
1922@node Turning the volume down, Automatic indentation, Turning off beeping, Common requests 1923@node Turning the volume down
1923@section How do I turn down the bell volume in Emacs running under X? 1924@section How do I turn down the bell volume in Emacs running under X?
1924@cindex Bell, volume of 1925@cindex Bell, volume of
1925@cindex Volume of bell 1926@cindex Volume of bell
@@ -1938,7 +1939,7 @@ usage: xset [-display host:dpy] option ...
1938 b [vol [pitch [dur]]] b on 1939 b [vol [pitch [dur]]] b on
1939@end example 1940@end example
1940 1941
1941@node Automatic indentation, Matching parentheses, Turning the volume down, Common requests 1942@node Automatic indentation
1942@section How do I tell Emacs to automatically indent a new line to the indentation of the previous line? 1943@section How do I tell Emacs to automatically indent a new line to the indentation of the previous line?
1943@cindex Indenting new lines 1944@cindex Indenting new lines
1944@cindex New lines, indenting of 1945@cindex New lines, indenting of
@@ -1979,7 +1980,7 @@ new paragraph. There are many packages available to deal with this
1979(@pxref{Packages that do not come with Emacs}). Look for ``fill'' and 1980(@pxref{Packages that do not come with Emacs}). Look for ``fill'' and
1980``indent'' keywords for guidance. 1981``indent'' keywords for guidance.
1981 1982
1982@node Matching parentheses, Hiding #ifdef lines, Automatic indentation, Common requests 1983@node Matching parentheses
1983@section How do I show which parenthesis matches the one I'm looking at? 1984@section How do I show which parenthesis matches the one I'm looking at?
1984@cindex Parentheses, matching 1985@cindex Parentheses, matching
1985@cindex @file{paren.el} 1986@cindex @file{paren.el}
@@ -2033,7 +2034,7 @@ parenthesis, it simply inserts a % like normal.
2033 2034
2034@end itemize 2035@end itemize
2035 2036
2036@node Hiding #ifdef lines, Repeating commands, Matching parentheses, Common requests 2037@node Hiding #ifdef lines
2037@section In C mode, can I show just the lines that will be left after @code{#ifdef} commands are handled by the compiler? 2038@section In C mode, can I show just the lines that will be left after @code{#ifdef} commands are handled by the compiler?
2038@cindex @code{#ifdef}, selective display of 2039@cindex @code{#ifdef}, selective display of
2039@cindex @code{hide-ifdef-mode} 2040@cindex @code{hide-ifdef-mode}
@@ -2043,7 +2044,7 @@ parenthesis, it simply inserts a % like normal.
2043@kbd{M-x hide-ifdef-mode}. (This is a minor mode.) You might also want 2044@kbd{M-x hide-ifdef-mode}. (This is a minor mode.) You might also want
2044to investigate @file{cpp.el}, which is distributed with Emacs. 2045to investigate @file{cpp.el}, which is distributed with Emacs.
2045 2046
2046@node Repeating commands, Valid X resources, Hiding #ifdef lines, Common requests 2047@node Repeating commands
2047@section How do I repeat a command as many times as possible? 2048@section How do I repeat a command as many times as possible?
2048@cindex Repeating commands many times 2049@cindex Repeating commands many times
2049@cindex Commands, repeating many times 2050@cindex Commands, repeating many times
@@ -2068,7 +2069,7 @@ If you're really desperate for the @code{.} command in @code{vi} that
2068redoes the last insertion/deletion, use VIPER, a @code{vi} emulation 2069redoes the last insertion/deletion, use VIPER, a @code{vi} emulation
2069mode which comes with Emacs, and which appears to support it. 2070mode which comes with Emacs, and which appears to support it.
2070 2071
2071@node Valid X resources, Evaluating Emacs Lisp code, Repeating commands, Common requests 2072@node Valid X resources
2072@section What are the valid X resource settings (i.e., stuff in .Xdefaults)? 2073@section What are the valid X resource settings (i.e., stuff in .Xdefaults)?
2073@cindex Resources, X 2074@cindex Resources, X
2074@cindex X resources 2075@cindex X resources
@@ -2080,7 +2081,7 @@ You can also use a resource editor, such as editres (for X11R5 and
2080onwards), to look at the resource names for the menu bar, assuming Emacs 2081onwards), to look at the resource names for the menu bar, assuming Emacs
2081was compiled with the X toolkit. 2082was compiled with the X toolkit.
2082 2083
2083@node Evaluating Emacs Lisp code, Changing the length of a Tab, Valid X resources, Common requests 2084@node Evaluating Emacs Lisp code
2084@section How do I execute (``evaluate'') a piece of Emacs Lisp code? 2085@section How do I execute (``evaluate'') a piece of Emacs Lisp code?
2085@cindex Evaluating Lisp code 2086@cindex Evaluating Lisp code
2086@cindex Lisp forms, evaluating 2087@cindex Lisp forms, evaluating
@@ -2124,7 +2125,7 @@ about them.
2124 2125
2125@end itemize 2126@end itemize
2126 2127
2127@node Changing the length of a Tab, Inserting text at the beginning of each line, Evaluating Emacs Lisp code, Common requests 2128@node Changing the length of a Tab
2128@section How do I change Emacs's idea of the @key{TAB} character's length? 2129@section How do I change Emacs's idea of the @key{TAB} character's length?
2129@cindex Tab length 2130@cindex Tab length
2130@cindex Length of tab character 2131@cindex Length of tab character
@@ -2143,7 +2144,7 @@ Do not confuse variable @code{tab-width} with variable
2143@key{TAB} characters. The latter controls what characters are inserted 2144@key{TAB} characters. The latter controls what characters are inserted
2144when you press the @key{TAB} character in certain modes. 2145when you press the @key{TAB} character in certain modes.
2145 2146
2146@node Inserting text at the beginning of each line, Underlining paragraphs, Changing the length of a Tab, Common requests 2147@node Inserting text at the beginning of each line
2147@section How do I insert <some text> at the beginning of every line? 2148@section How do I insert <some text> at the beginning of every line?
2148@cindex Prefixing a region with some text 2149@cindex Prefixing a region with some text
2149@cindex Prefix character, inserting in mail/news replies 2150@cindex Prefix character, inserting in mail/news replies
@@ -2167,14 +2168,14 @@ buffers, you can even use @kbd{M-;} to cite yanked messages (@kbd{M-;}
2167runs the function @code{comment-region}, it is a general-purpose 2168runs the function @code{comment-region}, it is a general-purpose
2168mechanism to comment regions) (@pxref{Changing the included text prefix}). 2169mechanism to comment regions) (@pxref{Changing the included text prefix}).
2169 2170
2170@node Underlining paragraphs, Forcing the cursor to remain in the same column, Inserting text at the beginning of each line, Common requests 2171@node Underlining paragraphs
2171@section How do I insert @samp{_^H} before each character in a region to get an underlined paragraph? 2172@section How do I insert @samp{_^H} before each character in a region to get an underlined paragraph?
2172@cindex Underlining a region of text 2173@cindex Underlining a region of text
2173@cindex @code{underline-region} 2174@cindex @code{underline-region}
2174 2175
2175Mark the region and then type @kbd{M-x underline-region @key{RET}}. 2176Mark the region and then type @kbd{M-x underline-region @key{RET}}.
2176 2177
2177@node Forcing the cursor to remain in the same column, Forcing Emacs to iconify itself, Underlining paragraphs, Common requests 2178@node Forcing the cursor to remain in the same column
2178@section How do I make Emacs behave like this: when I go up or down, the cursor should stay in the same column even if the line is too short? 2179@section How do I make Emacs behave like this: when I go up or down, the cursor should stay in the same column even if the line is too short?
2179@cindex @code{picture-mode} 2180@cindex @code{picture-mode}
2180@cindex Remaining in the same column, regardless of contents 2181@cindex Remaining in the same column, regardless of contents
@@ -2186,7 +2187,7 @@ See also the variable @code{track-eol} and the command
2186@code{set-goal-column} bound to @kbd{C-x C-n} 2187@code{set-goal-column} bound to @kbd{C-x C-n}
2187(@pxref{Moving Point, , , emacs, The GNU Emacs Manual}). 2188(@pxref{Moving Point, , , emacs, The GNU Emacs Manual}).
2188 2189
2189@node Forcing Emacs to iconify itself, Using regular expressions, Forcing the cursor to remain in the same column, Common requests 2190@node Forcing Emacs to iconify itself
2190@section How do I tell Emacs to iconify itself? 2191@section How do I tell Emacs to iconify itself?
2191@cindex Iconification under the X Window System 2192@cindex Iconification under the X Window System
2192@cindex X Window System and iconification 2193@cindex X Window System and iconification
@@ -2195,7 +2196,7 @@ See also the variable @code{track-eol} and the command
2195@kbd{C-z} iconifies Emacs when running under X and suspends Emacs 2196@kbd{C-z} iconifies Emacs when running under X and suspends Emacs
2196otherwise. @inforef{Frame Commands, Frame Commands, emacs}. 2197otherwise. @inforef{Frame Commands, Frame Commands, emacs}.
2197 2198
2198@node Using regular expressions, Replacing text across multiple files, Forcing Emacs to iconify itself, Common requests 2199@node Using regular expressions
2199@section How do I use regexps (regular expressions) in Emacs? 2200@section How do I use regexps (regular expressions) in Emacs?
2200@cindex Regexps 2201@cindex Regexps
2201@cindex Regular expressions 2202@cindex Regular expressions
@@ -2227,7 +2228,7 @@ is actually typical for regexp syntax.)
2227 2228
2228@end itemize 2229@end itemize
2229 2230
2230@node Replacing text across multiple files, Documentation for etags, Using regular expressions, Common requests 2231@node Replacing text across multiple files
2231@section How do I perform a replace operation across more than one file? 2232@section How do I perform a replace operation across more than one file?
2232@cindex Replacing strings across files 2233@cindex Replacing strings across files
2233@cindex Multiple files, replacing across 2234@cindex Multiple files, replacing across
@@ -2262,7 +2263,7 @@ Emacs: it includes the command @code{tags-query-replace} which performs
2262a query-replace across all the files mentioned in the @file{TAGS} file. 2263a query-replace across all the files mentioned in the @file{TAGS} file.
2263@inforef{Tags Search, Tags Search, emacs}. 2264@inforef{Tags Search, Tags Search, emacs}.
2264 2265
2265@node Documentation for etags, Disabling backups, Replacing text across multiple files, Common requests 2266@node Documentation for etags
2266@section Where is the documentation for @code{etags}? 2267@section Where is the documentation for @code{etags}?
2267@cindex Documentation for @code{etags} 2268@cindex Documentation for @code{etags}
2268@cindex @code{etags}, documentation for 2269@cindex @code{etags}, documentation for
@@ -2273,7 +2274,7 @@ The @code{etags} man page should be in the same place as the
2273Quick command-line switch descriptions are also available. For example, 2274Quick command-line switch descriptions are also available. For example,
2274@samp{etags -H}. 2275@samp{etags -H}.
2275 2276
2276@node Disabling backups, Disabling auto-save-mode, Documentation for etags, Common requests 2277@node Disabling backups
2277@section How do I disable backup files? 2278@section How do I disable backup files?
2278@cindex Backups, disabling 2279@cindex Backups, disabling
2279@cindex Disabling backups 2280@cindex Disabling backups
@@ -2314,7 +2315,7 @@ should have their backups put in certain directories. A typical use is
2314to add the element @code{("." . @var{dir})} to force Emacs to put 2315to add the element @code{("." . @var{dir})} to force Emacs to put
2315@strong{all} backup files in the directory @file{dir}. 2316@strong{all} backup files in the directory @file{dir}.
2316 2317
2317@node Disabling auto-save-mode, Going to a line by number, Disabling backups, Common requests 2318@node Disabling auto-save-mode
2318@section How do I disable @code{auto-save-mode}? 2319@section How do I disable @code{auto-save-mode}?
2319@cindex Disabling @code{auto-save-mode} 2320@cindex Disabling @code{auto-save-mode}
2320@cindex Auto-saving 2321@cindex Auto-saving
@@ -2337,7 +2338,7 @@ such as @file{/tmp}.
2337To disable or change how @code{auto-save-mode} works, @inforef{Auto 2338To disable or change how @code{auto-save-mode} works, @inforef{Auto
2338Save, , emacs}. 2339Save, , emacs}.
2339 2340
2340@node Going to a line by number, Modifying pull-down menus, Disabling auto-save-mode, Common requests 2341@node Going to a line by number
2341@section How can I go to a certain line given its number? 2342@section How can I go to a certain line given its number?
2342@cindex Going to a line by number 2343@cindex Going to a line by number
2343@cindex Compilation error messages 2344@cindex Compilation error messages
@@ -2366,7 +2367,7 @@ You can do this faster by invoking @code{goto-line} with a numeric
2366argument that is the line's number. For example, @kbd{C-u 286 M-g M-g} 2367argument that is the line's number. For example, @kbd{C-u 286 M-g M-g}
2367will jump to line number 286 in the current buffer. 2368will jump to line number 286 in the current buffer.
2368 2369
2369@node Modifying pull-down menus, Deleting menus and menu options, Going to a line by number, Common requests 2370@node Modifying pull-down menus
2370@section How can I create or modify new pull-down menu options? 2371@section How can I create or modify new pull-down menu options?
2371@cindex Pull-down menus, creating or modifying 2372@cindex Pull-down menus, creating or modifying
2372@cindex Menus, creating or modifying 2373@cindex Menus, creating or modifying
@@ -2455,7 +2456,7 @@ modify menu options---are in the @cite{Emacs Lisp Reference Manual}, under
2455``Menu Keymaps.'' (@xref{Emacs Lisp documentation}, for information on 2456``Menu Keymaps.'' (@xref{Emacs Lisp documentation}, for information on
2456this manual.) 2457this manual.)
2457 2458
2458@node Deleting menus and menu options, Turning on syntax highlighting, Modifying pull-down menus, Common requests 2459@node Deleting menus and menu options
2459@section How do I delete menus and menu options? 2460@section How do I delete menus and menu options?
2460@cindex Deleting menus and menu options 2461@cindex Deleting menus and menu options
2461@cindex Menus, deleting 2462@cindex Menus, deleting
@@ -2477,7 +2478,7 @@ menus}), use:
2477(define-key global-map [menu-bar edit forward] nil) 2478(define-key global-map [menu-bar edit forward] nil)
2478@end lisp 2479@end lisp
2479 2480
2480@node Turning on syntax highlighting, Scrolling only one line, Deleting menus and menu options, Common requests 2481@node Turning on syntax highlighting
2481@section How do I turn on syntax highlighting? 2482@section How do I turn on syntax highlighting?
2482@cindex Syntax highlighting 2483@cindex Syntax highlighting
2483@cindex @code{font-lock-mode} 2484@cindex @code{font-lock-mode}
@@ -2555,7 +2556,7 @@ PostScript printer, or a PostScript interpreter such as Ghostscript;
2555consult the documentation of the variables @code{ps-printer-name}, 2556consult the documentation of the variables @code{ps-printer-name},
2556@code{ps-lpr-command}, and @code{ps-lpr-switches} for more details. 2557@code{ps-lpr-command}, and @code{ps-lpr-switches} for more details.
2557 2558
2558@node Scrolling only one line, Editing MS-DOS files, Turning on syntax highlighting, Common requests 2559@node Scrolling only one line
2559@section How can I force Emacs to scroll only one line when I move past the bottom of the screen? 2560@section How can I force Emacs to scroll only one line when I move past the bottom of the screen?
2560@cindex Scrolling only one line 2561@cindex Scrolling only one line
2561@cindex Reducing the increment when scrolling 2562@cindex Reducing the increment when scrolling
@@ -2571,7 +2572,7 @@ Alternatively, use the following Lisp form in your @file{.emacs}:
2571(setq scroll-conservatively most-positive-fixnum) 2572(setq scroll-conservatively most-positive-fixnum)
2572@end lisp 2573@end lisp
2573 2574
2574@node Editing MS-DOS files, Filling paragraphs with a single space, Scrolling only one line, Common requests 2575@node Editing MS-DOS files
2575@section How can I edit MS-DOS files using Emacs? 2576@section How can I edit MS-DOS files using Emacs?
2576@cindex Editing MS-DOS files 2577@cindex Editing MS-DOS files
2577@cindex MS-DOS files, editing 2578@cindex MS-DOS files, editing
@@ -2594,7 +2595,7 @@ If you are running a version of Emacs before 20.1, get @code{crypt++}
2594and saved, allowing you to ignore the different conventions that Unix 2595and saved, allowing you to ignore the different conventions that Unix
2595and MS-DOS have for delineating the end of a line. 2596and MS-DOS have for delineating the end of a line.
2596 2597
2597@node Filling paragraphs with a single space, Escape sequences in shell output, Editing MS-DOS files, Common requests 2598@node Filling paragraphs with a single space
2598@section How can I tell Emacs to fill paragraphs with a single space after each period? 2599@section How can I tell Emacs to fill paragraphs with a single space after each period?
2599@cindex One space following periods 2600@cindex One space following periods
2600@cindex Single space following periods 2601@cindex Single space following periods
@@ -2606,7 +2607,7 @@ Add the following line to your @file{.emacs} file:
2606(setq sentence-end-double-space nil) 2607(setq sentence-end-double-space nil)
2607@end lisp 2608@end lisp
2608 2609
2609@node Escape sequences in shell output, Fullscreen mode on MS-Windows, Filling paragraphs with a single space, Common requests 2610@node Escape sequences in shell output
2610@section Why these strange escape sequences from @code{ls} from the Shell mode? 2611@section Why these strange escape sequences from @code{ls} from the Shell mode?
2611@cindex Escape sequences in @code{ls} output 2612@cindex Escape sequences in @code{ls} output
2612@cindex @code{ls} in Shell mode 2613@cindex @code{ls} in Shell mode
@@ -2628,7 +2629,7 @@ Install the @code{ansi-color} package (bundled with Emacs 21.1 and
2628later), which converts these ANSI escape sequences into colors. 2629later), which converts these ANSI escape sequences into colors.
2629@end itemize 2630@end itemize
2630 2631
2631@node Fullscreen mode on MS-Windows, , Escape sequences in shell output, Common requests 2632@node Fullscreen mode on MS-Windows
2632@section How can I start Emacs in fullscreen mode on MS-Windows? 2633@section How can I start Emacs in fullscreen mode on MS-Windows?
2633@cindex Maximize frame 2634@cindex Maximize frame
2634@cindex Fullscreen mode 2635@cindex Fullscreen mode
@@ -2651,7 +2652,7 @@ Emacs frame and then evaluate @code{(frame-height)} and
2651@code{(frame-width)} with @kbd{M-:}. 2652@code{(frame-width)} with @kbd{M-:}.
2652 2653
2653@c ------------------------------------------------------------ 2654@c ------------------------------------------------------------
2654@node Bugs and problems, Compiling and installing Emacs, Common requests, Top 2655@node Bugs and problems
2655@chapter Bugs and problems 2656@chapter Bugs and problems
2656@cindex Bugs and problems 2657@cindex Bugs and problems
2657 2658
@@ -2684,7 +2685,7 @@ type @kbd{C-h C-e} to read it.
2684* Dired claims that no file is on this line:: 2685* Dired claims that no file is on this line::
2685@end menu 2686@end menu
2686 2687
2687@node Problems with very large files, ^M in the shell buffer, Bugs and problems, Bugs and problems 2688@node Problems with very large files
2688@section Does Emacs have problems with files larger than 8 megabytes? 2689@section Does Emacs have problems with files larger than 8 megabytes?
2689@cindex Very large files, opening 2690@cindex Very large files, opening
2690@cindex Large files, opening 2691@cindex Large files, opening
@@ -2698,7 +2699,7 @@ buffer size is at least 2^27-1, or 134,217,727 bytes, or 132 MBytes.
2698And in Emacs 22, the maximum buffer size has been increased to 2699And in Emacs 22, the maximum buffer size has been increased to
2699268,435,455 bytes (or 256 MBytes) on 32-bit machines. 2700268,435,455 bytes (or 256 MBytes) on 32-bit machines.
2700 2701
2701@node ^M in the shell buffer, Shell process exits abnormally, Problems with very large files, Bugs and problems 2702@node ^M in the shell buffer
2702@section How do I get rid of @samp{^M} or echoed commands in my shell buffer? 2703@section How do I get rid of @samp{^M} or echoed commands in my shell buffer?
2703@cindex Shell buffer, echoed commands and @samp{^M} in 2704@cindex Shell buffer, echoed commands and @samp{^M} in
2704@cindex Echoed commands in @code{shell-mode} 2705@cindex Echoed commands in @code{shell-mode}
@@ -2770,7 +2771,7 @@ shell start-up file:
2770stty -icrnl -onlcr -echo susp ^Z 2771stty -icrnl -onlcr -echo susp ^Z
2771@end example 2772@end example
2772 2773
2773@node Shell process exits abnormally, Problems with Shell Mode on MS-Windows, ^M in the shell buffer, Bugs and problems 2774@node Shell process exits abnormally
2774@section Why do I get ``Process shell exited abnormally with code 1''? 2775@section Why do I get ``Process shell exited abnormally with code 1''?
2775@cindex Abnormal exits from @code{shell-mode} 2776@cindex Abnormal exits from @code{shell-mode}
2776@cindex @code{shell-mode} exits 2777@cindex @code{shell-mode} exits
@@ -2799,7 +2800,7 @@ See also @samp{PROBLEMS} (in the @file{etc} subdirectory of the
2799top-level directory when you unpack the Emacs source) for other 2800top-level directory when you unpack the Emacs source) for other
2800possible causes of this message. 2801possible causes of this message.
2801 2802
2802@node Problems with Shell Mode on MS-Windows, Termcap/Terminfo entries for Emacs, Shell process exits abnormally, Bugs and problems 2803@node Problems with Shell Mode on MS-Windows
2803@section Why do I get an error message when I try to run @kbd{M-x shell}? 2804@section Why do I get an error message when I try to run @kbd{M-x shell}?
2804 2805
2805@cindex Shell Mode, and MS-Windows 2806@cindex Shell Mode, and MS-Windows
@@ -2827,7 +2828,7 @@ Some people have trouble with Shell Mode because of intrusive
2827antivirus software; disabling the resident antivirus program solves 2828antivirus software; disabling the resident antivirus program solves
2828the problems in those cases. 2829the problems in those cases.
2829 2830
2830@node Termcap/Terminfo entries for Emacs, Spontaneous entry into isearch-mode, Problems with Shell Mode on MS-Windows, Bugs and problems 2831@node Termcap/Terminfo entries for Emacs
2831@section Where is the termcap/terminfo entry for terminal type @samp{emacs}? 2832@section Where is the termcap/terminfo entry for terminal type @samp{emacs}?
2832@cindex Termcap 2833@cindex Termcap
2833@cindex Terminfo 2834@cindex Terminfo
@@ -2861,7 +2862,7 @@ in your shell start up file. @code{csh} users could put this in their
2861if ("$term" == emacs) set term=dumb 2862if ("$term" == emacs) set term=dumb
2862@end example 2863@end example
2863 2864
2864@node Spontaneous entry into isearch-mode, Problems talking to certain hosts, Termcap/Terminfo entries for Emacs, Bugs and problems 2865@node Spontaneous entry into isearch-mode
2865@section Why does Emacs spontaneously start displaying @samp{I-search:} and beeping? 2866@section Why does Emacs spontaneously start displaying @samp{I-search:} and beeping?
2866@cindex Spontaneous entry into isearch-mode 2867@cindex Spontaneous entry into isearch-mode
2867@cindex isearch-mode, spontaneous entry into 2868@cindex isearch-mode, spontaneous entry into
@@ -2873,7 +2874,7 @@ these characters and interpreting them as commands. (The @kbd{C-s}
2873character normally invokes the @code{isearch-forward} command.) For 2874character normally invokes the @code{isearch-forward} command.) For
2874possible solutions, see @ref{Handling C-s and C-q with flow control}. 2875possible solutions, see @ref{Handling C-s and C-q with flow control}.
2875 2876
2876@node Problems talking to certain hosts, Errors with init files, Spontaneous entry into isearch-mode, Bugs and problems 2877@node Problems talking to certain hosts
2877@section Why can't Emacs talk to certain hosts (or certain hostnames)? 2878@section Why can't Emacs talk to certain hosts (or certain hostnames)?
2878@cindex Hosts, Emacs cannot talk to 2879@cindex Hosts, Emacs cannot talk to
2879@cindex @code{gethostbyname}, problematic version 2880@cindex @code{gethostbyname}, problematic version
@@ -2918,7 +2919,7 @@ properly told to do DNS lookups with the correct command line switch.
2918 2919
2919@end itemize 2920@end itemize
2920 2921
2921@node Errors with init files, Emacs ignores X resources, Problems talking to certain hosts, Bugs and problems 2922@node Errors with init files
2922@section Why does Emacs say @samp{Error in init file}? 2923@section Why does Emacs say @samp{Error in init file}?
2923@cindex Error in @file{.emacs} 2924@cindex Error in @file{.emacs}
2924@cindex Error in init file 2925@cindex Error in init file
@@ -2939,7 +2940,7 @@ hook that will be evaluated after the package is loaded. A common case
2939of this is explained in @ref{Terminal setup code works after Emacs has 2940of this is explained in @ref{Terminal setup code works after Emacs has
2940begun}. 2941begun}.
2941 2942
2942@node Emacs ignores X resources, Emacs ignores frame parameters, Errors with init files, Bugs and problems 2943@node Emacs ignores X resources
2943@section Why does Emacs ignore my X resources (my .Xdefaults file)? 2944@section Why does Emacs ignore my X resources (my .Xdefaults file)?
2944@cindex X resources being ignored 2945@cindex X resources being ignored
2945@cindex Ignored X resources 2946@cindex Ignored X resources
@@ -3018,7 +3019,7 @@ then in the files listed in @code{XFILESEARCHPATH}.
3018 3019
3019@end enumerate 3020@end enumerate
3020 3021
3021@node Emacs ignores frame parameters, Emacs takes a long time to visit files, Emacs ignores X resources, Bugs and problems 3022@node Emacs ignores frame parameters
3022@section Why don't my customizations of the frame parameters work? 3023@section Why don't my customizations of the frame parameters work?
3023@cindex Frame parameters 3024@cindex Frame parameters
3024 3025
@@ -3034,7 +3035,7 @@ size of the initial frame, but would like to control the geometry of the
3034other frames by individually positioning each one of them. 3035other frames by individually positioning each one of them.
3035 3036
3036 3037
3037@node Emacs takes a long time to visit files, Editing files with $ in the name, Emacs ignores frame parameters, Bugs and problems 3038@node Emacs takes a long time to visit files
3038@section Why does Emacs take 20 seconds to visit a file? 3039@section Why does Emacs take 20 seconds to visit a file?
3039@cindex Visiting files takes a long time 3040@cindex Visiting files takes a long time
3040@cindex Delay when visiting files 3041@cindex Delay when visiting files
@@ -3050,7 +3051,7 @@ can cause the same problem. Since Emacs's file locking doesn't work
3050over NFS anyway, the best solution is to recompile Emacs with 3051over NFS anyway, the best solution is to recompile Emacs with
3051@code{CLASH_DETECTION} undefined. 3052@code{CLASH_DETECTION} undefined.
3052 3053
3053@node Editing files with $ in the name, Shell mode loses the current directory, Emacs takes a long time to visit files, Bugs and problems 3054@node Editing files with $ in the name
3054@section How do I edit a file with a @samp{$} in its name? 3055@section How do I edit a file with a @samp{$} in its name?
3055@cindex Editing files with @samp{$} in the name 3056@cindex Editing files with @samp{$} in the name
3056@cindex @samp{$} in file names 3057@cindex @samp{$} in file names
@@ -3060,7 +3061,7 @@ When entering a file name in the minibuffer, Emacs will attempt to expand
3060a @samp{$} followed by a word as an environment variable. To suppress 3061a @samp{$} followed by a word as an environment variable. To suppress
3061this behavior, type @kbd{$$} instead. 3062this behavior, type @kbd{$$} instead.
3062 3063
3063@node Shell mode loses the current directory, Security risks with Emacs, Editing files with $ in the name, Bugs and problems 3064@node Shell mode loses the current directory
3064@section Why does shell mode lose track of the shell's current directory? 3065@section Why does shell mode lose track of the shell's current directory?
3065@cindex Current directory and @code{shell-mode} 3066@cindex Current directory and @code{shell-mode}
3066@cindex @code{shell-mode} and current directory 3067@cindex @code{shell-mode} and current directory
@@ -3079,7 +3080,7 @@ functionality}).
3079You can tell Emacs the shell's current directory with the command 3080You can tell Emacs the shell's current directory with the command
3080@kbd{M-x dirs}. 3081@kbd{M-x dirs}.
3081 3082
3082@node Security risks with Emacs, Dired claims that no file is on this line, Shell mode loses the current directory, Bugs and problems 3083@node Security risks with Emacs
3083@section Are there any security risks in Emacs? 3084@section Are there any security risks in Emacs?
3084@cindex Security with Emacs 3085@cindex Security with Emacs
3085@cindex @samp{movemail} and security 3086@cindex @samp{movemail} and security
@@ -3182,7 +3183,7 @@ access control enabled, only authorized clients can connect
3182 3183
3183@end itemize 3184@end itemize
3184 3185
3185@node Dired claims that no file is on this line, , Security risks with Emacs, Bugs and problems 3186@node Dired claims that no file is on this line
3186@section Dired says, @samp{no file on this line} when I try to do something. 3187@section Dired says, @samp{no file on this line} when I try to do something.
3187@cindex Dired does not see a file 3188@cindex Dired does not see a file
3188 3189
@@ -3206,7 +3207,7 @@ The second approach involves changing the regular expression used by
3206dired, @code{directory-listing-before-filename-regexp}. 3207dired, @code{directory-listing-before-filename-regexp}.
3207 3208
3208@c ------------------------------------------------------------ 3209@c ------------------------------------------------------------
3209@node Compiling and installing Emacs, Finding Emacs and related packages, Bugs and problems, Top 3210@node Compiling and installing Emacs
3210@chapter Compiling and installing Emacs 3211@chapter Compiling and installing Emacs
3211@cindex Compiling and installing Emacs 3212@cindex Compiling and installing Emacs
3212 3213
@@ -3216,7 +3217,7 @@ dired, @code{directory-listing-before-filename-regexp}.
3216* Problems building Emacs:: 3217* Problems building Emacs::
3217@end menu 3218@end menu
3218 3219
3219@node Installing Emacs, Updating Emacs, Compiling and installing Emacs, Compiling and installing Emacs 3220@node Installing Emacs
3220@section How do I install Emacs? 3221@section How do I install Emacs?
3221@cindex Installing Emacs 3222@cindex Installing Emacs
3222@cindex Unix systems, installing Emacs on 3223@cindex Unix systems, installing Emacs on
@@ -3341,7 +3342,7 @@ and any Emacs Info files that might be in @file{/usr/local/info}.
3341Much more verbose instructions (with many more hints and suggestions) 3342Much more verbose instructions (with many more hints and suggestions)
3342come with the Emacs sources, in the file @file{INSTALL}. 3343come with the Emacs sources, in the file @file{INSTALL}.
3343 3344
3344@node Updating Emacs, Problems building Emacs, Installing Emacs, Compiling and installing Emacs 3345@node Updating Emacs
3345@section How do I update Emacs to the latest version? 3346@section How do I update Emacs to the latest version?
3346@cindex Updating Emacs 3347@cindex Updating Emacs
3347 3348
@@ -3356,7 +3357,7 @@ Upgrading should overwrite only, @file{/usr/local/bin/emacs} (the Emacs
3356binary) and documentation in @file{/usr/local/info}. Back up these 3357binary) and documentation in @file{/usr/local/info}. Back up these
3357files before you upgrade, and you shouldn't have too much trouble. 3358files before you upgrade, and you shouldn't have too much trouble.
3358 3359
3359@node Problems building Emacs, , Updating Emacs, Compiling and installing Emacs 3360@node Problems building Emacs
3360@section What should I do if I have trouble building Emacs? 3361@section What should I do if I have trouble building Emacs?
3361@cindex Problems building Emacs 3362@cindex Problems building Emacs
3362@cindex Errors when building Emacs 3363@cindex Errors when building Emacs
@@ -3378,7 +3379,7 @@ Please don't post it to @uref{news:gnu.emacs.help} or send e-mail to
3378 3379
3379 3380
3380@c ------------------------------------------------------------ 3381@c ------------------------------------------------------------
3381@node Finding Emacs and related packages, Major packages and programs, Compiling and installing Emacs, Top 3382@node Finding Emacs and related packages
3382@chapter Finding Emacs and related packages 3383@chapter Finding Emacs and related packages
3383@cindex Finding Emacs and related packages 3384@cindex Finding Emacs and related packages
3384 3385
@@ -3396,7 +3397,7 @@ Please don't post it to @uref{news:gnu.emacs.help} or send e-mail to
3396* Modes for various languages:: 3397* Modes for various languages::
3397@end menu 3398@end menu
3398 3399
3399@node Finding Emacs on the Internet, Finding a package with particular functionality, Finding Emacs and related packages, Finding Emacs and related packages 3400@node Finding Emacs on the Internet
3400@section Where can I get Emacs on the net (or by snail mail)? 3401@section Where can I get Emacs on the net (or by snail mail)?
3401@cindex Finding Emacs on the Internet 3402@cindex Finding Emacs on the Internet
3402@cindex Snail mail, ordering Emacs via 3403@cindex Snail mail, ordering Emacs via
@@ -3412,7 +3413,7 @@ see @ref{Informational files for Emacs}, for how to get these files.
3412version of Emacs, and see @ref{Current GNU distributions}, for a list of 3413version of Emacs, and see @ref{Current GNU distributions}, for a list of
3413archive sites that make GNU software available. 3414archive sites that make GNU software available.
3414 3415
3415@node Finding a package with particular functionality, Packages that do not come with Emacs, Finding Emacs on the Internet, Finding Emacs and related packages 3416@node Finding a package with particular functionality
3416@section How do I find a Emacs Lisp package that does XXX? 3417@section How do I find a Emacs Lisp package that does XXX?
3417@cindex Package, finding 3418@cindex Package, finding
3418@cindex Finding an Emacs Lisp package 3419@cindex Finding an Emacs Lisp package
@@ -3437,7 +3438,7 @@ the constituent Emacs packages.
3437For advice on how to find extra packages that are not part of Emacs, 3438For advice on how to find extra packages that are not part of Emacs,
3438see @ref{Packages that do not come with Emacs}. 3439see @ref{Packages that do not come with Emacs}.
3439 3440
3440@node Packages that do not come with Emacs, Current GNU distributions, Finding a package with particular functionality, Finding Emacs and related packages 3441@node Packages that do not come with Emacs
3441@section Where can I get Emacs Lisp packages that don't come with Emacs? 3442@section Where can I get Emacs Lisp packages that don't come with Emacs?
3442@cindex Unbundled packages 3443@cindex Unbundled packages
3443@cindex Finding other packages 3444@cindex Finding other packages
@@ -3464,7 +3465,7 @@ Several packages are stored in
3464Read the file @file{etc/MORE.STUFF} for more information about 3465Read the file @file{etc/MORE.STUFF} for more information about
3465external packages. 3466external packages.
3466 3467
3467@node Current GNU distributions, Difference between Emacs and XEmacs, Packages that do not come with Emacs, Finding Emacs and related packages 3468@node Current GNU distributions
3468@section Where can I get other up-to-date GNU stuff? 3469@section Where can I get other up-to-date GNU stuff?
3469@cindex Current GNU distributions 3470@cindex Current GNU distributions
3470@cindex Sources for current GNU distributions 3471@cindex Sources for current GNU distributions
@@ -3484,7 +3485,7 @@ A list of sites mirroring @samp{ftp.gnu.org} can be found at
3484 3485
3485@uref{http://www.gnu.org/order/ftp.html} 3486@uref{http://www.gnu.org/order/ftp.html}
3486 3487
3487@node Difference between Emacs and XEmacs, Emacs for minimalists, Current GNU distributions, Finding Emacs and related packages 3488@node Difference between Emacs and XEmacs
3488@section What is the difference between Emacs and XEmacs (formerly Lucid Emacs)? 3489@section What is the difference between Emacs and XEmacs (formerly Lucid Emacs)?
3489@cindex XEmacs 3490@cindex XEmacs
3490@cindex Difference Emacs and XEmacs 3491@cindex Difference Emacs and XEmacs
@@ -3517,7 +3518,7 @@ origin in the work of the GNU Project. Terms such as ``Emacsen'' and
3517``(X)Emacs'' are not wrong, but they are not very clear, so it 3518``(X)Emacs'' are not wrong, but they are not very clear, so it
3518is better to write ``Emacs and XEmacs.'' 3519is better to write ``Emacs and XEmacs.''
3519 3520
3520@node Emacs for minimalists, Emacs for MS-DOS, Difference between Emacs and XEmacs, Finding Emacs and related packages 3521@node Emacs for minimalists
3521@section I don't have enough disk space to install Emacs 3522@section I don't have enough disk space to install Emacs
3522@cindex Zile 3523@cindex Zile
3523@cindex Not enough disk space to install Emacs 3524@cindex Not enough disk space to install Emacs
@@ -3531,7 +3532,7 @@ information is available from
3531@uref{http://www.gnu.org/software/zile/} 3532@uref{http://www.gnu.org/software/zile/}
3532 3533
3533 3534
3534@node Emacs for MS-DOS, Emacs for Windows, Emacs for minimalists, Finding Emacs and related packages 3535@node Emacs for MS-DOS
3535@section Where can I get Emacs for my PC running MS-DOS? 3536@section Where can I get Emacs for my PC running MS-DOS?
3536@cindex MS-DOS, Emacs for 3537@cindex MS-DOS, Emacs for
3537@cindex DOS, Emacs for 3538@cindex DOS, Emacs for
@@ -3613,7 +3614,7 @@ available at
3613Note that while many of these programs look similar to Emacs, they often 3614Note that while many of these programs look similar to Emacs, they often
3614lack certain features, such as the Emacs Lisp extension language. 3615lack certain features, such as the Emacs Lisp extension language.
3615 3616
3616@node Emacs for Windows, Emacs for GNUstep, Emacs for MS-DOS, Finding Emacs and related packages 3617@node Emacs for Windows
3617@section Where can I get Emacs for Microsoft Windows? 3618@section Where can I get Emacs for Microsoft Windows?
3618@cindex FAQ for NT Emacs 3619@cindex FAQ for NT Emacs
3619@cindex Emacs for MS-Windows 3620@cindex Emacs for MS-Windows
@@ -3629,20 +3630,20 @@ by @email{ramprasad@@gnu.org, Ramprasad B}, available at
3629@xref{Emacs for MS-DOS}, for Windows 3.1. 3630@xref{Emacs for MS-DOS}, for Windows 3.1.
3630 3631
3631 3632
3632@node Emacs for GNUstep, Emacs for Apple computers, Emacs for Windows, Finding Emacs and related packages 3633@node Emacs for GNUstep
3633@section Where can I get Emacs for GNUstep? 3634@section Where can I get Emacs for GNUstep?
3634@cindex GNUSTEP, Emacs for 3635@cindex GNUSTEP, Emacs for
3635 3636
3636Beginning with version 23.1, Emacs supports GNUstep natively. 3637Beginning with version 23.1, Emacs supports GNUstep natively.
3637 3638
3638@node Emacs for Apple computers, Modes for various languages, Emacs for GNUstep, Finding Emacs and related packages 3639@node Emacs for Apple computers
3639@section Where can I get Emacs for my Apple computer? 3640@section Where can I get Emacs for my Apple computer?
3640@cindex Apple computers, Emacs for 3641@cindex Apple computers, Emacs for
3641@cindex Macintosh, Emacs for 3642@cindex Macintosh, Emacs for
3642 3643
3643Beginning with version 22.1, Emacs supports Mac OS X natively. 3644Beginning with version 22.1, Emacs supports Mac OS X natively.
3644 3645
3645@node Modes for various languages, , Emacs for Apple computers, Finding Emacs and related packages 3646@node Modes for various languages
3646@section Where can I get modes for Lex, Yacc/Bison, Bourne shell, csh, C@t{++}, Objective-C, Pascal, Java, and Awk? 3647@section Where can I get modes for Lex, Yacc/Bison, Bourne shell, csh, C@t{++}, Objective-C, Pascal, Java, and Awk?
3647@cindex Awk, mode for 3648@cindex Awk, mode for
3648@cindex @code{awk-mode} 3649@cindex @code{awk-mode}
@@ -3668,7 +3669,7 @@ Java code. It is distributed with Emacs, but has
3668@uref{http://cc-mode.sourceforge.net/, its own homepage}. 3669@uref{http://cc-mode.sourceforge.net/, its own homepage}.
3669 3670
3670@c ------------------------------------------------------------ 3671@c ------------------------------------------------------------
3671@node Major packages and programs, Key bindings, Finding Emacs and related packages, Top 3672@node Major packages and programs
3672@chapter Major packages and programs 3673@chapter Major packages and programs
3673@cindex Major packages and programs 3674@cindex Major packages and programs
3674 3675
@@ -3684,7 +3685,7 @@ Java code. It is distributed with Emacs, but has
3684* Patch:: 3685* Patch::
3685@end menu 3686@end menu
3686 3687
3687@node VM, AUCTeX, Major packages and programs, Major packages and programs 3688@node VM
3688@section VM (View Mail) --- another mail reader within Emacs, with MIME support 3689@section VM (View Mail) --- another mail reader within Emacs, with MIME support
3689@cindex VM 3690@cindex VM
3690@cindex Alternative mail software 3691@cindex Alternative mail software
@@ -3714,7 +3715,7 @@ VM was originally written by @uref{http://www.wonderworks.com/vm/,Kyle Jones}.
3714available. 3715available.
3715 3716
3716 3717
3717@node AUCTeX, BBDB, VM, Major packages and programs 3718@node AUCTeX
3718@section AUC@TeX{} --- enhanced @TeX{} modes with debugging facilities 3719@section AUC@TeX{} --- enhanced @TeX{} modes with debugging facilities
3719@cindex Mode for @TeX{} 3720@cindex Mode for @TeX{}
3720@cindex @TeX{} mode 3721@cindex @TeX{} mode
@@ -3755,7 +3756,7 @@ Submissions to @email{auctex@@gnu.org}
3755 3756
3756@end table 3757@end table
3757 3758
3758@node BBDB, Ispell, AUCTeX, Major packages and programs 3759@node BBDB
3759@section BBDB --- personal Info Rolodex integrated with mail/news readers 3760@section BBDB --- personal Info Rolodex integrated with mail/news readers
3760@cindex BBDB 3761@cindex BBDB
3761@cindex Rolodex-like functionality 3762@cindex Rolodex-like functionality
@@ -3782,7 +3783,7 @@ Release announcements: @email{bbdb-announce-request@@lists.sourceforge.net}
3782 3783
3783@end table 3784@end table
3784 3785
3785@node Ispell, Emacs/W3, BBDB, Major packages and programs 3786@node Ispell
3786@section Ispell --- spell checker in C with interface for Emacs 3787@section Ispell --- spell checker in C with interface for Emacs
3787@cindex Spell-checker 3788@cindex Spell-checker
3788@cindex Checking spelling 3789@cindex Checking spelling
@@ -3807,7 +3808,7 @@ Release announcements: @email{bbdb-announce-request@@lists.sourceforge.net}
3807This Ispell program is distinct from GNU Ispell 4.0. GNU Ispell 4.0 is 3808This Ispell program is distinct from GNU Ispell 4.0. GNU Ispell 4.0 is
3808no longer a supported product. 3809no longer a supported product.
3809 3810
3810@node Emacs/W3, EDB, Ispell, Major packages and programs 3811@node Emacs/W3
3811@section Emacs/W3 --- A World Wide Web browser inside of Emacs 3812@section Emacs/W3 --- A World Wide Web browser inside of Emacs
3812@cindex WWW browser 3813@cindex WWW browser
3813@cindex Web browser 3814@cindex Web browser
@@ -3836,7 +3837,7 @@ Help to develop Emacs/W3 at @email{w3-dev@@gnu.org}
3836 3837
3837@end table 3838@end table
3838 3839
3839@node EDB, Mailcrypt, Emacs/W3, Major packages and programs 3840@node EDB
3840@section EDB --- Database program for Emacs; replaces forms editing modes 3841@section EDB --- Database program for Emacs; replaces forms editing modes
3841@cindex EDB 3842@cindex EDB
3842@cindex Database 3843@cindex Database
@@ -3854,7 +3855,7 @@ Help to develop Emacs/W3 at @email{w3-dev@@gnu.org}
3854 3855
3855@end table 3856@end table
3856 3857
3857@node Mailcrypt, JDE, EDB, Major packages and programs 3858@node Mailcrypt
3858@section Mailcrypt --- PGP interface within Emacs mail and news 3859@section Mailcrypt --- PGP interface within Emacs mail and news
3859@cindex PGP 3860@cindex PGP
3860@cindex GPG 3861@cindex GPG
@@ -3888,7 +3889,7 @@ version 22.1. It is a modern interface to various PGP implementations,
3888including @uref{http://www.gnupg.org/, The GNU Privacy Guard} and 3889including @uref{http://www.gnupg.org/, The GNU Privacy Guard} and
3889supports symmetric encryption. 3890supports symmetric encryption.
3890 3891
3891@node JDE, Patch, Mailcrypt, Major packages and programs 3892@node JDE
3892@section JDE --- Integrated development environment for Java 3893@section JDE --- Integrated development environment for Java
3893@cindex Java development environment 3894@cindex Java development environment
3894@cindex Integrated Java development environment 3895@cindex Integrated Java development environment
@@ -3911,7 +3912,7 @@ Receive announcements from @email{jde-announce-subscribe@@sunsite.dk}
3911 3912
3912@end table 3913@end table
3913 3914
3914@node Patch, , JDE, Major packages and programs 3915@node Patch
3915@section Patch --- program to apply ``diffs'' for updating files 3916@section Patch --- program to apply ``diffs'' for updating files
3916@cindex Updating files with diffs 3917@cindex Updating files with diffs
3917@cindex Patching source files with diffs 3918@cindex Patching source files with diffs
@@ -3932,7 +3933,7 @@ Receive announcements from @email{jde-announce-subscribe@@sunsite.dk}
3932@end table 3933@end table
3933 3934
3934@c ------------------------------------------------------------ 3935@c ------------------------------------------------------------
3935@node Key bindings, Alternate character sets, Major packages and programs, Top 3936@node Key bindings
3936@chapter Key bindings 3937@chapter Key bindings
3937@cindex Key bindings 3938@cindex Key bindings
3938 3939
@@ -3958,7 +3959,7 @@ Receive announcements from @email{jde-announce-subscribe@@sunsite.dk}
3958* SPC no longer completes file names:: 3959* SPC no longer completes file names::
3959@end menu 3960@end menu
3960 3961
3961@node Binding keys to commands, Invalid prefix characters, Key bindings, Key bindings 3962@node Binding keys to commands
3962@section How do I bind keys (including function keys) to commands? 3963@section How do I bind keys (including function keys) to commands?
3963@cindex Binding keys to commands 3964@cindex Binding keys to commands
3964@cindex Keys, binding to commands 3965@cindex Keys, binding to commands
@@ -4025,7 +4026,7 @@ can be bound to a key and thus treated as a macro. For example:
4025 4026
4026@end itemize 4027@end itemize
4027 4028
4028@node Invalid prefix characters, Terminal setup code works after Emacs has begun, Binding keys to commands, Key bindings 4029@node Invalid prefix characters
4029@section Why does Emacs say @samp{Key sequence XXX uses invalid prefix characters}? 4030@section Why does Emacs say @samp{Key sequence XXX uses invalid prefix characters}?
4030@cindex Prefix characters, invalid 4031@cindex Prefix characters, invalid
4031@cindex Invalid prefix characters 4032@cindex Invalid prefix characters
@@ -4044,7 +4045,7 @@ of these forms before attempting to bind the key sequence:
4044(global-unset-key "\e[") 4045(global-unset-key "\e[")
4045@end lisp 4046@end lisp
4046 4047
4047@node Terminal setup code works after Emacs has begun, Using function keys under X, Invalid prefix characters, Key bindings 4048@node Terminal setup code works after Emacs has begun
4048@section Why doesn't this [terminal or window-system setup] code work in my @file{.emacs} file, but it works just fine after Emacs starts up? 4049@section Why doesn't this [terminal or window-system setup] code work in my @file{.emacs} file, but it works just fine after Emacs starts up?
4049@cindex Terminal setup code in @file{.emacs} 4050@cindex Terminal setup code in @file{.emacs}
4050 4051
@@ -4070,7 +4071,7 @@ variable to this lambda function. For example,
4070For information on what Emacs does every time it is started, see the 4071For information on what Emacs does every time it is started, see the
4071@file{lisp/startup.el} file. 4072@file{lisp/startup.el} file.
4072 4073
4073@node Using function keys under X, Working with function and arrow keys, Terminal setup code works after Emacs has begun, Key bindings 4074@node Using function keys under X
4074@section How do I use function keys under X? 4075@section How do I use function keys under X?
4075@cindex Function keys 4076@cindex Function keys
4076@cindex X Window System and function keys 4077@cindex X Window System and function keys
@@ -4078,7 +4079,7 @@ For information on what Emacs does every time it is started, see the
4078 4079
4079With Emacs 19, functions keys under X are bound like any other key. @xref{Binding keys to commands}, for details. 4080With Emacs 19, functions keys under X are bound like any other key. @xref{Binding keys to commands}, for details.
4080 4081
4081@node Working with function and arrow keys, X key translations for Emacs, Using function keys under X, Key bindings 4082@node Working with function and arrow keys
4082@section How do I tell what characters or symbols my function or arrow keys emit? 4083@section How do I tell what characters or symbols my function or arrow keys emit?
4083@cindex Working with arrow keys 4084@cindex Working with arrow keys
4084@cindex Arrow keys, symbols generated by 4085@cindex Arrow keys, symbols generated by
@@ -4091,7 +4092,7 @@ return either a function key symbol or character sequence (see the
4091Emacs on-line documentation for an explanation). This works for other 4092Emacs on-line documentation for an explanation). This works for other
4092keys as well. 4093keys as well.
4093 4094
4094@node X key translations for Emacs, Handling C-s and C-q with flow control, Working with function and arrow keys, Key bindings 4095@node X key translations for Emacs
4095@section How do I set the X key ``translations'' for Emacs? 4096@section How do I set the X key ``translations'' for Emacs?
4096@cindex X key translations 4097@cindex X key translations
4097@cindex Key translations under X 4098@cindex Key translations under X
@@ -4113,7 +4114,7 @@ The only way to affect the behavior of keys within Emacs is through
4113@noindent 4114@noindent
4114defines the @kbd{M-@key{TAB}} key sequence. 4115defines the @kbd{M-@key{TAB}} key sequence.
4115 4116
4116@node Handling C-s and C-q with flow control, Binding C-s and C-q, X key translations for Emacs, Key bindings 4117@node Handling C-s and C-q with flow control
4117@section How do I handle @kbd{C-s} and @kbd{C-q} being used for flow control? 4118@section How do I handle @kbd{C-s} and @kbd{C-q} being used for flow control?
4118@cindex Flow control, @kbd{C-s} and @kbd{C-q} with 4119@cindex Flow control, @kbd{C-s} and @kbd{C-q} with
4119@cindex @kbd{C-s} and @kbd{C-q} with flow control 4120@cindex @kbd{C-s} and @kbd{C-q} with flow control
@@ -4241,7 +4242,7 @@ smart enough to move it to another name).
4241For further discussion of this issue, read the file @file{etc/PROBLEMS} 4242For further discussion of this issue, read the file @file{etc/PROBLEMS}
4242(in the Emacs source directory when you unpack the Emacs distribution). 4243(in the Emacs source directory when you unpack the Emacs distribution).
4243 4244
4244@node Binding C-s and C-q, Backspace invokes help, Handling C-s and C-q with flow control, Key bindings 4245@node Binding C-s and C-q
4245@section How do I bind @kbd{C-s} and @kbd{C-q} (or any key) if these keys are filtered out? 4246@section How do I bind @kbd{C-s} and @kbd{C-q} (or any key) if these keys are filtered out?
4246@cindex Binding @kbd{C-s} and @kbd{C-q} 4247@cindex Binding @kbd{C-s} and @kbd{C-q}
4247@cindex @kbd{C-s} and @kbd{C-q}, binding 4248@cindex @kbd{C-s} and @kbd{C-q}, binding
@@ -4265,7 +4266,7 @@ actually behaves.
4265 4266
4266@end itemize 4267@end itemize
4267 4268
4268@node Backspace invokes help, stty and Backspace key, Binding C-s and C-q, Key bindings 4269@node Backspace invokes help
4269@section Why does the @key{Backspace} key invoke help? 4270@section Why does the @key{Backspace} key invoke help?
4270@cindex Backspace key invokes help 4271@cindex Backspace key invokes help
4271@cindex Help invoked by Backspace 4272@cindex Help invoked by Backspace
@@ -4374,7 +4375,7 @@ For more information about troubleshooting this problem, see @ref{DEL
4374Does Not Delete, , If @key{DEL} Fails to Delete, emacs, The GNU Emacs 4375Does Not Delete, , If @key{DEL} Fails to Delete, emacs, The GNU Emacs
4375Manual}. 4376Manual}.
4376 4377
4377@node stty and Backspace key, Swapping keys, Backspace invokes help, Key bindings 4378@node stty and Backspace key
4378@section Why doesn't Emacs look at the @file{stty} settings for @key{Backspace} vs. @key{Delete}? 4379@section Why doesn't Emacs look at the @file{stty} settings for @key{Backspace} vs. @key{Delete}?
4379@cindex @file{stty} and Emacs 4380@cindex @file{stty} and Emacs
4380@cindex Backspace and @file{stty} 4381@cindex Backspace and @file{stty}
@@ -4385,7 +4386,7 @@ Good question!
4385@c FIXME: RMS explained the reasons for this on emacs-hackers. It's 4386@c FIXME: RMS explained the reasons for this on emacs-hackers. It's
4386@c probably worth putting that explanation here. 4387@c probably worth putting that explanation here.
4387 4388
4388@node Swapping keys, Producing C-XXX with the keyboard, stty and Backspace key, Key bindings 4389@node Swapping keys
4389@section How do I swap two keys? 4390@section How do I swap two keys?
4390@cindex Swapping keys 4391@cindex Swapping keys
4391@cindex Keys, swapping 4392@cindex Keys, swapping
@@ -4418,7 +4419,7 @@ take place at the lowest level of input processing; the keys that are
4418looked up in keymaps contain the characters that result from keyboard 4419looked up in keymaps contain the characters that result from keyboard
4419translation. 4420translation.
4420 4421
4421@node Producing C-XXX with the keyboard, No Meta key, Swapping keys, Key bindings 4422@node Producing C-XXX with the keyboard
4422@section How do I produce C-XXX with my keyboard? 4423@section How do I produce C-XXX with my keyboard?
4423@cindex Producing control characters 4424@cindex Producing control characters
4424@cindex Generating control characters 4425@cindex Generating control characters
@@ -4453,7 +4454,7 @@ Often other aliases exist; use the @kbd{C-h c} command and try
4453generated. You can also try the @kbd{C-h w} command if you know the 4454generated. You can also try the @kbd{C-h w} command if you know the
4454name of the command. 4455name of the command.
4455 4456
4456@node No Meta key, No Escape key, Producing C-XXX with the keyboard, Key bindings 4457@node No Meta key
4457@section What if I don't have a @key{Meta} key? 4458@section What if I don't have a @key{Meta} key?
4458@cindex No @key{Meta} key 4459@cindex No @key{Meta} key
4459@cindex @key{Meta} key, what to do if you lack it 4460@cindex @key{Meta} key, what to do if you lack it
@@ -4466,7 +4467,7 @@ Emacs converts @kbd{M-a} internally into @kbd{@key{ESC} a} anyway
4466press @key{Meta} and @key{a} together, but with @key{ESC}, you press 4467press @key{Meta} and @key{a} together, but with @key{ESC}, you press
4467@key{ESC}, release it, and then press @key{a}. 4468@key{ESC}, release it, and then press @key{a}.
4468 4469
4469@node No Escape key, Compose Character, No Meta key, Key bindings 4470@node No Escape key
4470@section What if I don't have an @key{Escape} key? 4471@section What if I don't have an @key{Escape} key?
4471@cindex No Escape key 4472@cindex No Escape key
4472@cindex Lacking an Escape key 4473@cindex Lacking an Escape key
@@ -4482,7 +4483,7 @@ generates @key{ESC}. If not, the following form can be used to bind it:
4482(define-key function-key-map [f11] [?\e]) 4483(define-key function-key-map [f11] [?\e])
4483@end lisp 4484@end lisp
4484 4485
4485@node Compose Character, Binding combinations of modifiers and function keys, No Escape key, Key bindings 4486@node Compose Character
4486@section Can I make my @key{Compose Character} key behave like a @key{Meta} key? 4487@section Can I make my @key{Compose Character} key behave like a @key{Meta} key?
4487@cindex @key{Compose Character} key, using as @key{Meta} 4488@cindex @key{Compose Character} key, using as @key{Meta}
4488@cindex @key{Meta}, using @key{Compose Character} for 4489@cindex @key{Meta}, using @key{Compose Character} for
@@ -4492,7 +4493,7 @@ VT220 clones could have their @key{Compose} key configured this way. If
4492you're using X, you might be able to do this with the @code{xmodmap} 4493you're using X, you might be able to do this with the @code{xmodmap}
4493command. 4494command.
4494 4495
4495@node Binding combinations of modifiers and function keys, Meta key does not work in xterm, Compose Character, Key bindings 4496@node Binding combinations of modifiers and function keys
4496@section How do I bind a combination of modifier key and function key? 4497@section How do I bind a combination of modifier key and function key?
4497@cindex Modifiers and function keys 4498@cindex Modifiers and function keys
4498@cindex Function keys and modifiers 4499@cindex Function keys and modifiers
@@ -4531,7 +4532,7 @@ terminals. Non-@acronym{ASCII} keys and mouse events (e.g. @kbd{C-=} and
4531 4532
4532@xref{Binding keys to commands}, for general key binding instructions. 4533@xref{Binding keys to commands}, for general key binding instructions.
4533 4534
4534@node Meta key does not work in xterm, ExtendChar key does not work as Meta, Binding combinations of modifiers and function keys, Key bindings 4535@node Meta key does not work in xterm
4535@section Why doesn't my @key{Meta} key work in an @code{xterm} window? 4536@section Why doesn't my @key{Meta} key work in an @code{xterm} window?
4536@cindex @key{Meta} key and @code{xterm} 4537@cindex @key{Meta} key and @code{xterm}
4537@cindex Xterm and @key{Meta} key 4538@cindex Xterm and @key{Meta} key
@@ -4601,7 +4602,7 @@ You might have to replace @samp{Meta} with @samp{Alt}.
4601 4602
4602@end itemize 4603@end itemize
4603 4604
4604@node ExtendChar key does not work as Meta, SPC no longer completes file names, Meta key does not work in xterm, Key bindings 4605@node ExtendChar key does not work as Meta
4605@section Why doesn't my @key{ExtendChar} key work as a @key{Meta} key under HP-UX 8.0 and 9.x? 4606@section Why doesn't my @key{ExtendChar} key work as a @key{Meta} key under HP-UX 8.0 and 9.x?
4606@cindex @key{ExtendChar} key as @key{Meta} 4607@cindex @key{ExtendChar} key as @key{Meta}
4607@cindex @key{Meta}, using @key{ExtendChar} for 4608@cindex @key{Meta}, using @key{ExtendChar} for
@@ -4624,7 +4625,7 @@ xmodmap -e 'remove mod1 = Mode_switch'
4624This will disable the use of the extra keysyms systemwide, which may be 4625This will disable the use of the extra keysyms systemwide, which may be
4625undesirable if you actually intend to use them. 4626undesirable if you actually intend to use them.
4626 4627
4627@node SPC no longer completes file names, , ExtendChar key does not work as Meta, Key bindings 4628@node SPC no longer completes file names
4628@section Why doesn't SPC complete file names anymore? 4629@section Why doesn't SPC complete file names anymore?
4629@cindex @kbd{SPC} file name completion 4630@cindex @kbd{SPC} file name completion
4630 4631
@@ -4644,7 +4645,7 @@ You can get the old behavior by binding @kbd{SPC} to
4644@end lisp 4645@end lisp
4645 4646
4646@c ------------------------------------------------------------ 4647@c ------------------------------------------------------------
4647@node Alternate character sets, Mail and news, Key bindings, Top 4648@node Alternate character sets
4648@chapter Alternate character sets 4649@chapter Alternate character sets
4649@cindex Alternate character sets 4650@cindex Alternate character sets
4650 4651
@@ -4656,7 +4657,7 @@ You can get the old behavior by binding @kbd{SPC} to
4656* How to add fonts:: 4657* How to add fonts::
4657@end menu 4658@end menu
4658 4659
4659@node Emacs does not display 8-bit characters, Inputting eight-bit characters, Alternate character sets, Alternate character sets 4660@node Emacs does not display 8-bit characters
4660@section How do I make Emacs display 8-bit characters? 4661@section How do I make Emacs display 8-bit characters?
4661@cindex Displaying eight-bit characters 4662@cindex Displaying eight-bit characters
4662@cindex Eight-bit characters, displaying 4663@cindex Eight-bit characters, displaying
@@ -4671,7 +4672,7 @@ systems, such as MS-DOS and MS-Windows, Emacs queries the OS about the
4671character set supported by the display, and sets up the required 4672character set supported by the display, and sets up the required
4672terminal coding system automatically. 4673terminal coding system automatically.
4673 4674
4674@node Inputting eight-bit characters, Kanji and Chinese characters, Emacs does not display 8-bit characters, Alternate character sets 4675@node Inputting eight-bit characters
4675@section How do I input eight-bit characters? 4676@section How do I input eight-bit characters?
4676@cindex Entering eight-bit characters 4677@cindex Entering eight-bit characters
4677@cindex Eight-bit characters, entering 4678@cindex Eight-bit characters, entering
@@ -4682,7 +4683,7 @@ Various methods are available for input of eight-bit characters. See
4682Support, emacs}. For more sophisticated methods, @inforef{Input 4683Support, emacs}. For more sophisticated methods, @inforef{Input
4683Methods, Input Methods, emacs}. 4684Methods, Input Methods, emacs}.
4684 4685
4685@node Kanji and Chinese characters, Right-to-left alphabets, Inputting eight-bit characters, Alternate character sets 4686@node Kanji and Chinese characters
4686@section Where can I get an Emacs that handles kanji, Chinese, or other Far-Eastern character sets? 4687@section Where can I get an Emacs that handles kanji, Chinese, or other Far-Eastern character sets?
4687@cindex Kanji, handling with Emacs 4688@cindex Kanji, handling with Emacs
4688@cindex Chinese, handling with Emacs 4689@cindex Chinese, handling with Emacs
@@ -4693,7 +4694,7 @@ Emacs 20 and later includes many of the features of MULE, the MULtilingual
4693Enhancement to Emacs. @xref{Installing Emacs}, for information on where 4694Enhancement to Emacs. @xref{Installing Emacs}, for information on where
4694to find and download the latest version of Emacs. 4695to find and download the latest version of Emacs.
4695 4696
4696@node Right-to-left alphabets, How to add fonts, Kanji and Chinese characters, Alternate character sets 4697@node Right-to-left alphabets
4697@section Where is an Emacs that can handle Semitic (right-to-left) alphabets? 4698@section Where is an Emacs that can handle Semitic (right-to-left) alphabets?
4698@cindex Right-to-left alphabets 4699@cindex Right-to-left alphabets
4699@cindex Hebrew, handling with Emacs 4700@cindex Hebrew, handling with Emacs
@@ -4717,7 +4718,7 @@ You might also try querying @code{archie} for files named with
4717@file{hebrew}; several ftp sites in Israel may also have the necessary 4718@file{hebrew}; several ftp sites in Israel may also have the necessary
4718files. 4719files.
4719 4720
4720@node How to add fonts, , Right-to-left alphabets, Alternate character sets 4721@node How to add fonts
4721@section How do I add fonts for use with Emacs? 4722@section How do I add fonts for use with Emacs?
4722@cindex add fonts for use with Emacs 4723@cindex add fonts for use with Emacs
4723@cindex intlfonts 4724@cindex intlfonts
@@ -4837,7 +4838,7 @@ fontset, or you can select it by setting the default font in your
4837 4838
4838 4839
4839@c ------------------------------------------------------------ 4840@c ------------------------------------------------------------
4840@node Mail and news, Concept index, Alternate character sets, Top 4841@node Mail and news
4841@chapter Mail and news 4842@chapter Mail and news
4842@cindex Mail and news 4843@cindex Mail and news
4843 4844
@@ -4862,7 +4863,7 @@ fontset, or you can select it by setting the default font in your
4862* Learning more about Gnus:: 4863* Learning more about Gnus::
4863@end menu 4864@end menu
4864 4865
4865@node Changing the included text prefix, Saving a copy of outgoing mail, Mail and news, Mail and news 4866@node Changing the included text prefix
4866@section How do I change the included text prefix in mail/news followups? 4867@section How do I change the included text prefix in mail/news followups?
4867@cindex Prefix in mail/news followups, changing 4868@cindex Prefix in mail/news followups, changing
4868@cindex Included text prefix, changing 4869@cindex Included text prefix, changing
@@ -4879,7 +4880,7 @@ To prevent Emacs from including various headers of the replied-to
4879message, set the value of @code{mail-yank-ignored-headers} to an 4880message, set the value of @code{mail-yank-ignored-headers} to an
4880appropriate regexp. 4881appropriate regexp.
4881 4882
4882@node Saving a copy of outgoing mail, Expanding aliases when sending mail, Changing the included text prefix, Mail and news 4883@node Saving a copy of outgoing mail
4883@section How do I save a copy of outgoing mail? 4884@section How do I save a copy of outgoing mail?
4884@cindex Saving a copy of outgoing mail 4885@cindex Saving a copy of outgoing mail
4885@cindex Copying outgoing mail to a file 4886@cindex Copying outgoing mail to a file
@@ -4916,7 +4917,7 @@ components file.
4916It does not work to put @samp{set record filename} in the @file{.mailrc} 4917It does not work to put @samp{set record filename} in the @file{.mailrc}
4917file. 4918file.
4918 4919
4919@node Expanding aliases when sending mail, Sorting the messages in an Rmail folder, Saving a copy of outgoing mail, Mail and news 4920@node Expanding aliases when sending mail
4920@section Why doesn't Emacs expand my aliases when sending mail? 4921@section Why doesn't Emacs expand my aliases when sending mail?
4921@cindex Expanding aliases when sending mail 4922@cindex Expanding aliases when sending mail
4922@cindex Mail alias expansion 4923@cindex Mail alias expansion
@@ -4958,7 +4959,7 @@ expansion by moving point to the end of the alias and typing @kbd{C-x a e}
4958(@kbd{M-x expand-abbrev}). 4959(@kbd{M-x expand-abbrev}).
4959@end itemize 4960@end itemize
4960 4961
4961@node Sorting the messages in an Rmail folder, Rmail writes to /usr/spool/mail, Expanding aliases when sending mail, Mail and news 4962@node Sorting the messages in an Rmail folder
4962@section How can I sort the messages in my Rmail folder? 4963@section How can I sort the messages in my Rmail folder?
4963@cindex Rmail, sorting messages in 4964@cindex Rmail, sorting messages in
4964@cindex Folder, sorting messages in an Rmail 4965@cindex Folder, sorting messages in an Rmail
@@ -4967,7 +4968,7 @@ expansion by moving point to the end of the alias and typing @kbd{C-x a e}
4967In Rmail, type @kbd{C-c C-s C-h} to get a list of sorting functions 4968In Rmail, type @kbd{C-c C-s C-h} to get a list of sorting functions
4968and their key bindings. 4969and their key bindings.
4969 4970
4970@node Rmail writes to /usr/spool/mail, Replying to the sender of a message, Sorting the messages in an Rmail folder, Mail and news 4971@node Rmail writes to /usr/spool/mail
4971@section Why does Rmail need to write to @file{/usr/spool/mail}? 4972@section Why does Rmail need to write to @file{/usr/spool/mail}?
4972@cindex Rmail and @file{/usr/spool/mail} 4973@cindex Rmail and @file{/usr/spool/mail}
4973@cindex @file{/usr/spool/mail} and Rmail 4974@cindex @file{/usr/spool/mail} and Rmail
@@ -4986,7 +4987,7 @@ Other systems use the @code{flock} system call to interlock access. On
4986these systems, you should configure @code{movemail} to use @code{flock}. 4987these systems, you should configure @code{movemail} to use @code{flock}.
4987@end quotation 4988@end quotation
4988 4989
4989@node Replying to the sender of a message, MIME with Emacs mail packages, Rmail writes to /usr/spool/mail, Mail and news 4990@node Replying to the sender of a message
4990@section How can I force Rmail to reply to the sender of a message, but not the other recipients? 4991@section How can I force Rmail to reply to the sender of a message, but not the other recipients?
4991@cindex Replying only to the sender of a message 4992@cindex Replying only to the sender of a message
4992@cindex Sender, replying only to 4993@cindex Sender, replying only to
@@ -5012,7 +5013,7 @@ best fix I've been able to come up with:
5012 (define-key rmail-mode-map "R" 'rmail-reply))) 5013 (define-key rmail-mode-map "R" 'rmail-reply)))
5013@end lisp 5014@end lisp
5014 5015
5015@node MIME with Emacs mail packages, Automatically starting a mail or news reader, Replying to the sender of a message, Mail and news 5016@node MIME with Emacs mail packages
5016@section How can I get my favorite Emacs mail package to support MIME? 5017@section How can I get my favorite Emacs mail package to support MIME?
5017@cindex MIME and Emacs mail packages 5018@cindex MIME and Emacs mail packages
5018@cindex Mail packages and MIME 5019@cindex Mail packages and MIME
@@ -5022,7 +5023,7 @@ Version 6.x of VM supports MIME. @xref{VM}. Gnus supports MIME in mail
5022and news messages as of version 5.8.1 (Pterodactyl). Rmail has limited 5023and news messages as of version 5.8.1 (Pterodactyl). Rmail has limited
5023support for single-part MIME messages beginning with Emacs 20.3. 5024support for single-part MIME messages beginning with Emacs 20.3.
5024 5025
5025@node Automatically starting a mail or news reader, Reading news with Emacs, MIME with Emacs mail packages, Mail and news 5026@node Automatically starting a mail or news reader
5026@section How do I make Emacs automatically start my mail/news reader? 5027@section How do I make Emacs automatically start my mail/news reader?
5027@cindex Mail reader, starting automatically 5028@cindex Mail reader, starting automatically
5028@cindex News reader, starting automatically 5029@cindex News reader, starting automatically
@@ -5053,7 +5054,7 @@ from your @file{.emacs} file. This would cause problems if you needed to run
5053two copies of Emacs at the same time. Also, this would make it difficult for 5054two copies of Emacs at the same time. Also, this would make it difficult for
5054you to start Emacs quickly when you needed to. 5055you to start Emacs quickly when you needed to.
5055 5056
5056@node Reading news with Emacs, Gnus does not work with NNTP, Automatically starting a mail or news reader, Mail and news 5057@node Reading news with Emacs
5057@section How do I read news under Emacs? 5058@section How do I read news under Emacs?
5058@cindex Reading news under Emacs 5059@cindex Reading news under Emacs
5059@cindex Usenet reader in Emacs 5060@cindex Usenet reader in Emacs
@@ -5062,7 +5063,7 @@ you to start Emacs quickly when you needed to.
5062Use @kbd{M-x gnus}. It is documented in Info (@pxref{Learning how to do 5063Use @kbd{M-x gnus}. It is documented in Info (@pxref{Learning how to do
5063something}). 5064something}).
5064 5065
5065@node Gnus does not work with NNTP, Viewing articles with embedded underlining, Reading news with Emacs, Mail and news 5066@node Gnus does not work with NNTP
5066@section Why doesn't Gnus work via NNTP? 5067@section Why doesn't Gnus work via NNTP?
5067@cindex Gnus and NNTP 5068@cindex Gnus and NNTP
5068@cindex NNTP, Gnus fails to work with 5069@cindex NNTP, Gnus fails to work with
@@ -5085,7 +5086,7 @@ version number in the welcome message. Type @kbd{quit} to get out.
5085 5086
5086@xref{Spontaneous entry into isearch-mode}, for some additional ideas. 5087@xref{Spontaneous entry into isearch-mode}, for some additional ideas.
5087 5088
5088@node Viewing articles with embedded underlining, Saving a multi-part Gnus posting, Gnus does not work with NNTP, Mail and news 5089@node Viewing articles with embedded underlining
5089@section How do I view news articles with embedded underlining (e.g., ClariNews)? 5090@section How do I view news articles with embedded underlining (e.g., ClariNews)?
5090@cindex Underlining, embedded in news articles 5091@cindex Underlining, embedded in news articles
5091@cindex News articles with embedded underlining 5092@cindex News articles with embedded underlining
@@ -5138,7 +5139,7 @@ automatically via
5138 (lambda () (ununderline-region (point-min) (point-max)))) 5139 (lambda () (ununderline-region (point-min) (point-max))))
5139@end lisp 5140@end lisp
5140 5141
5141@node Saving a multi-part Gnus posting, Starting Gnus faster, Viewing articles with embedded underlining, Mail and news 5142@node Saving a multi-part Gnus posting
5142@section How do I save all the items of a multi-part posting in Gnus? 5143@section How do I save all the items of a multi-part posting in Gnus?
5143@cindex Multi-part postings in Gnus, saving 5144@cindex Multi-part postings in Gnus, saving
5144@cindex Saving multi-part postings in Gnus 5145@cindex Saving multi-part postings in Gnus
@@ -5147,7 +5148,7 @@ automatically via
5147Use @code{gnus-uu}. Type @kbd{C-c C-v C-h} in the Gnus summary buffer 5148Use @code{gnus-uu}. Type @kbd{C-c C-v C-h} in the Gnus summary buffer
5148to see a list of available commands. 5149to see a list of available commands.
5149 5150
5150@node Starting Gnus faster, Catching up in all newsgroups, Saving a multi-part Gnus posting, Mail and news 5151@node Starting Gnus faster
5151@section How do I make Gnus start up faster? 5152@section How do I make Gnus start up faster?
5152@cindex Faster, starting Gnus 5153@cindex Faster, starting Gnus
5153@cindex Starting Gnus faster 5154@cindex Starting Gnus faster
@@ -5170,7 +5171,7 @@ following settings:
5170@end lisp 5171@end lisp
5171@end quotation 5172@end quotation
5172 5173
5173@node Catching up in all newsgroups, Killing based on nonstandard headers, Starting Gnus faster, Mail and news 5174@node Catching up in all newsgroups
5174@section How do I catch up all newsgroups in Gnus? 5175@section How do I catch up all newsgroups in Gnus?
5175@cindex Catching up all newsgroups in Gnus 5176@cindex Catching up all newsgroups in Gnus
5176@cindex Gnus, Catching up all newsgroups in 5177@cindex Gnus, Catching up all newsgroups in
@@ -5180,7 +5181,7 @@ In the @file{*Newsgroup*} buffer, type @kbd{M-< C-x ( c y C-x ) M-0 C-x e}
5180Leave off the initial @kbd{M-<} if you only want to catch up from point 5181Leave off the initial @kbd{M-<} if you only want to catch up from point
5181to the end of the @file{*Newsgroup*} buffer. 5182to the end of the @file{*Newsgroup*} buffer.
5182 5183
5183@node Killing based on nonstandard headers, Catch-up is slow in Gnus, Catching up in all newsgroups, Mail and news 5184@node Killing based on nonstandard headers
5184@section Why can't I kill in Gnus based on the Newsgroups/Keywords/Control headers? 5185@section Why can't I kill in Gnus based on the Newsgroups/Keywords/Control headers?
5185@cindex Killing articles based on nonstandard headers 5186@cindex Killing articles based on nonstandard headers
5186@cindex Newsgroups header, killing articles based on 5187@cindex Newsgroups header, killing articles based on
@@ -5201,7 +5202,7 @@ this:
5201(gnus-kill nil "^Newsgroups: .*\\(bad\\.group\\|worse\\.group\\)") 5202(gnus-kill nil "^Newsgroups: .*\\(bad\\.group\\|worse\\.group\\)")
5202@end lisp 5203@end lisp
5203 5204
5204@node Catch-up is slow in Gnus, Gnus hangs for a long time, Killing based on nonstandard headers, Mail and news 5205@node Catch-up is slow in Gnus
5205@section Why is catch up slow in Gnus? 5206@section Why is catch up slow in Gnus?
5206@cindex Slow catch up in Gnus 5207@cindex Slow catch up in Gnus
5207@cindex Gnus is slow when catching up 5208@cindex Gnus is slow when catching up
@@ -5210,7 +5211,7 @@ this:
5210Because Gnus is marking crosspostings read. You can control this with 5211Because Gnus is marking crosspostings read. You can control this with
5211the variable @code{gnus-use-cross-reference}. 5212the variable @code{gnus-use-cross-reference}.
5212 5213
5213@node Gnus hangs for a long time, Learning more about Gnus, Catch-up is slow in Gnus, Mail and news 5214@node Gnus hangs for a long time
5214@section Why does Gnus hang for a long time when posting? 5215@section Why does Gnus hang for a long time when posting?
5215@cindex Hangs in Gnus 5216@cindex Hangs in Gnus
5216@cindex Gnus hangs while posting 5217@cindex Gnus hangs while posting
@@ -5236,7 +5237,7 @@ folks have sped up @code{inews}, too, so speed should look better to
5236most folks as that update propagates around. 5237most folks as that update propagates around.
5237@end quotation 5238@end quotation
5238 5239
5239@node Learning more about Gnus, , Gnus hangs for a long time, Mail and news 5240@node Learning more about Gnus
5240@section Where can I find out more about Gnus? 5241@section Where can I find out more about Gnus?
5241@cindex FAQ for Gnus 5242@cindex FAQ for Gnus
5242@cindex Gnus FAQ 5243@cindex Gnus FAQ
@@ -5245,7 +5246,7 @@ most folks as that update propagates around.
5245For more information on Gnus, consult the Gnus manual and FAQ, which are 5246For more information on Gnus, consult the Gnus manual and FAQ, which are
5246part of the Gnus distribution. 5247part of the Gnus distribution.
5247 5248
5248@node Concept index, , Mail and news, Top 5249@node Concept index
5249@unnumbered Concept Index 5250@unnumbered Concept Index
5250@printindex cp 5251@printindex cp
5251 5252