# HG changeset patch # User Glenn Morris # Date 1244792949 0 # Node ID 7f9fa78fd502537e2d252667e65def59026daf3f # Parent fe446daa7a49924762c0486364d38b49c9df4cdc (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. diff -r fe446daa7a49 -r 7f9fa78fd502 doc/misc/ChangeLog --- a/doc/misc/ChangeLog Fri Jun 12 07:42:49 2009 +0000 +++ b/doc/misc/ChangeLog Fri Jun 12 07:49:09 2009 +0000 @@ -15,6 +15,11 @@ (Removing flashing messages): Remove section about non-existent Gnus option. + * faq.texi (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. + 2009-06-11 Glenn Morris * faq.texi (Common acronyms): Remove no-longer-existing OSF. diff -r fe446daa7a49 -r 7f9fa78fd502 doc/misc/faq.texi --- a/doc/misc/faq.texi Fri Jun 12 07:42:49 2009 +0000 +++ b/doc/misc/faq.texi Fri Jun 12 07:49:09 2009 +0000 @@ -56,7 +56,8 @@ @contents -@node Top, FAQ notation, (dir), (dir) +@node Top, FAQ notation, (dir), (dir) +@top The GNU Emacs FAQ This is the GNU Emacs FAQ, last updated on @today{}. @@ -85,7 +86,7 @@ @end menu @c ------------------------------------------------------------ -@node FAQ notation, General questions, Top, Top +@node FAQ notation @chapter FAQ notation @cindex FAQ notation @@ -102,7 +103,7 @@ * Common acronyms:: @end menu -@node Basic keys, Extended commands, FAQ notation, FAQ notation +@node Basic keys @section What do these mean: @kbd{C-h}, @kbd{C-M-a}, @key{RET}, @kbd{@key{ESC} a}, etc.? @cindex Basic keys @cindex Control key, notation for @@ -185,7 +186,7 @@ Keys, emacs}, for more information. (@xref{On-line manual}, for more information about Info.) -@node Extended commands, On-line manual, Basic keys, FAQ notation +@node Extended commands @section What does @file{M-x @var{command}} mean? @cindex Extended commands @cindex Commands, extended @@ -212,7 +213,7 @@ If you need to run non-interactive Emacs functions, see @ref{Evaluating Emacs Lisp code}. -@node On-line manual, File-name conventions, Extended commands, FAQ notation +@node On-line manual @section How do I read topic XXX in the on-line manual? @cindex On-line manual, reading topics in @cindex Reading topics in the on-line manual @@ -236,7 +237,7 @@ @xref{Getting a printed manual}, if you would like a paper copy of the Emacs manual. -@node File-name conventions, Common acronyms, On-line manual, FAQ notation +@node File-name conventions @section What are @file{etc/SERVICE}, @file{src/config.h}, and @file{lisp/default.el}? @cindex File-name conventions @cindex Conventions for file names @@ -269,7 +270,7 @@ Your system administrator may have removed the @file{src} directory and many files from the @file{etc} directory. -@node Common acronyms, , File-name conventions, FAQ notation +@node Common acronyms @section What are FSF, LPF, GNU, RMS, FTP, and GPL? @cindex FSF, definition of @cindex LPF, definition of @@ -316,7 +317,7 @@ the right to resell or give away GPL-covered software. @c ------------------------------------------------------------ -@node General questions, Getting help, FAQ notation, Top +@node General questions @chapter General questions @cindex General questions @@ -333,7 +334,7 @@ * Contacting the FSF:: @end menu -@node The LPF, Real meaning of copyleft, General questions, General questions +@node The LPF @section What is the LPF? @cindex LPF, description of @cindex League for Programming Freedom @@ -344,7 +345,7 @@ look-and-feel copyrights. More information on the LPF's views is available at @uref{http://progfree.org/, the LPF home page}. -@node Real meaning of copyleft, Guidelines for newsgroup postings, The LPF, General questions +@node Real meaning of copyleft @section What is the real legal meaning of the GNU copyleft? @cindex Copyleft, real meaning of @cindex GPL, real meaning of @@ -370,7 +371,7 @@ recipients the same freedom that you enjoyed. @end quotation -@node Guidelines for newsgroup postings, Newsgroup archives, Real meaning of copyleft, General questions +@node Guidelines for newsgroup postings @section What are appropriate messages for @uref{news:gnu.emacs.help}, @uref{news:gnu.emacs.bug}, @uref{news:comp.emacs}, etc.? @cindex Newsgroups, appropriate messages for @cindex GNU newsgroups, appropriate messages for @@ -405,7 +406,7 @@ @uref{news:gnu.emacs.bug} is a place where bug reports appear, but avoid posting bug reports to this newsgroup directly (@pxref{Reporting bugs}). -@node Newsgroup archives, Reporting bugs, Guidelines for newsgroup postings, General questions +@node Newsgroup archives @section Where can I get old postings to @uref{news:gnu.emacs.help} and other GNU groups? @cindex Archived postings from @code{gnu.emacs.help} @cindex Usenet archives for GNU groups @@ -428,7 +429,7 @@ You can read the archives of the @code{gnu.*} groups and post new messages at @uref{http://gmane.org/, Gmane}. -@node Reporting bugs, Unsubscribing from Emacs lists, Newsgroup archives, General questions +@node Reporting bugs @section Where should I report bugs and other problems with Emacs? @cindex Bug reporting @cindex Good bug reports @@ -479,7 +480,7 @@ does, that is a bug. @end quotation -@node Unsubscribing from Emacs lists, Contacting the FSF, Reporting bugs, General questions +@node Unsubscribing from Emacs lists @section How do I unsubscribe from this mailing list? @cindex Unsubscribing from GNU mailing lists @cindex Removing yourself from GNU mailing lists @@ -495,7 +496,7 @@ smtp}. Ask your postmaster for help, if you cannot figure out these details. -@node Contacting the FSF, , Unsubscribing from Emacs lists, General questions +@node Contacting the FSF @section What is the current address of the FSF? @cindex Snail mail address of the FSF @cindex Postal address of the FSF @@ -529,7 +530,7 @@ @uref{http://www.gnu.org/order/order.html, GNU Web site}. @c ------------------------------------------------------------ -@node Getting help, Status of Emacs, General questions, Top +@node Getting help @chapter Getting help @cindex Getting help @@ -548,7 +549,7 @@ * Obtaining the FAQ:: @end menu -@node Basic editing, Learning how to do something, Getting help, Getting help +@node Basic editing @section I'm just starting Emacs; how do I do basic editing? @cindex Basic editing with Emacs @cindex Beginning editing @@ -573,7 +574,7 @@ Emacs help works best if it is invoked by a single key whose value should be stored in the variable @code{help-char}. -@node Learning how to do something, Getting a printed manual, Basic editing, Getting help +@node Learning how to do something @section How do I find out how to do something in Emacs? @cindex Help for Emacs @cindex Learning to do something in Emacs @@ -649,7 +650,7 @@ @end itemize -@node Getting a printed manual, Emacs Lisp documentation, Learning how to do something, Getting help +@node Getting a printed manual @section How do I get a printed copy of the Emacs manual? @cindex Printed Emacs manual, obtaining @cindex Manual, obtaining a printed or HTML copy of @@ -671,7 +672,7 @@ @xref{Learning how to do something}, for how to view the manual on-line. -@node Emacs Lisp documentation, Installing Texinfo documentation, Getting a printed manual, Getting help +@node Emacs Lisp documentation @section Where can I get documentation on Emacs Lisp? @cindex Documentation on Emacs Lisp @cindex Function documentation @@ -693,7 +694,7 @@ @uref{http://www.gnu.org/software/emacs/elisp-manual/elisp.html} -@node Installing Texinfo documentation, Printing a Texinfo file, Emacs Lisp documentation, Getting help +@node Installing Texinfo documentation @section How do I install a piece of Texinfo documentation? @cindex Texinfo documentation, installing @cindex Installing Texinfo documentation @@ -797,7 +798,7 @@ @end itemize -@node Printing a Texinfo file, Viewing Info files outside of Emacs, Installing Texinfo documentation, Getting help +@node Printing a Texinfo file @section How do I print a Texinfo file? @cindex Printing a Texinfo file @cindex Texinfo file, printing @@ -840,7 +841,7 @@ To get more general instructions, retrieve the latest Texinfo package (@pxref{Installing Texinfo documentation}). -@node Viewing Info files outside of Emacs, Informational files for Emacs, Printing a Texinfo file, Getting help +@node Viewing Info files outside of Emacs @section Can I view Info files without using Emacs? @cindex Viewing Info files @cindex Info file viewers @@ -862,7 +863,7 @@ @end itemize -@node Informational files for Emacs, Help installing Emacs, Viewing Info files outside of Emacs, Getting help +@node Informational files for Emacs @section What informational files are available for Emacs? @cindex Informational files included with Emacs @cindex Files included with Emacs @@ -923,7 +924,7 @@ @uref{http://www.cs.pdx.edu/~trent/gnu/gnu.html} -@node Help installing Emacs, Obtaining the FAQ, Informational files for Emacs, Getting help +@node Help installing Emacs @section Where can I get help in installing Emacs? @cindex Installation help @cindex Help installing Emacs @@ -935,7 +936,7 @@ companies and individuals willing to sell you help in installing or using Emacs. -@node Obtaining the FAQ, , Help installing Emacs, Getting help +@node Obtaining the FAQ @section Where can I get the latest version of this FAQ? @cindex FAQ, obtaining the @cindex Latest FAQ version, obtaining the @@ -947,7 +948,7 @@ @c ------------------------------------------------------------ -@node Status of Emacs, Common requests, Getting help, Top +@node Status of Emacs @chapter Status of Emacs @cindex Status of Emacs @@ -962,7 +963,7 @@ * New in Emacs 22:: @end menu -@node Origin of the term Emacs, Latest version of Emacs, Status of Emacs, Status of Emacs +@node Origin of the term Emacs @section Where does the name ``Emacs'' come from? @cindex Origin of the term ``Emacs'' @cindex Emacs name origin @@ -990,14 +991,14 @@ name, check out the file @file{etc/JOKES} (@pxref{File-name conventions}). -@node Latest version of Emacs, New in Emacs 20, Origin of the term Emacs, Status of Emacs +@node Latest version of Emacs @section What is the latest version of Emacs? @cindex Version, latest @cindex Latest version of Emacs Emacs @value{VER} is the current version as of this writing. -@node New in Emacs 20, New in Emacs 21, Latest version of Emacs, Status of Emacs +@node New in Emacs 20 @section What is different about Emacs 20? @cindex Differences between Emacs 19 and Emacs 20 @cindex Emacs 20, new features in @@ -1023,7 +1024,7 @@ and are now included with the standard distribution. -@node New in Emacs 21, New in Emacs 22, New in Emacs 20, Status of Emacs +@node New in Emacs 21 @section What is different about Emacs 21? @cindex Differences between Emacs 20 and Emacs 21 @cindex Emacs 21, new features in @@ -1045,7 +1046,7 @@ that you can now have colors when you run Emacs on a GNU/Linux console and on @code{xterm} with @kbd{emacs -nw}. -@node New in Emacs 22, , New in Emacs 21, Status of Emacs +@node New in Emacs 22 @section What is different about Emacs 22? @cindex Differences between Emacs 21 and Emacs 22 @cindex Emacs 22, new features in @@ -1146,7 +1147,7 @@ full list. @c ------------------------------------------------------------ -@node Common requests, Bugs and problems, Status of Emacs, Top +@node Common requests @chapter Common requests @cindex Common requests @@ -1205,7 +1206,7 @@ * Fullscreen mode on MS-Windows:: @end menu -@node Setting up a customization file, Using Customize, Common requests, Common requests +@node Setting up a customization file @section How do I set up a @file{.emacs} file properly? @cindex @file{.emacs} file, setting up @cindex @file{.emacs} file, locating @@ -1235,7 +1236,7 @@ be found. Visiting the file as @file{~/.emacs} from Emacs will find the correct file. -@node Using Customize, Colors on a TTY, Setting up a customization file, Common requests +@node Using Customize @section How do I start using Customize? @cindex Customize groups @cindex Customizing variables @@ -1254,7 +1255,7 @@ @key{RET}}. This command prompts you for the name of the option to customize, with completion. -@node Colors on a TTY, Debugging a customization file, Using Customize, Common requests +@node Colors on a TTY @section How do I get colors and syntax highlighting on a TTY? @cindex Colors on a TTY @cindex Syntax highlighting on a TTY @@ -1274,7 +1275,7 @@ Syntax highlighting is on by default since version 22.1. -@node Debugging a customization file, Displaying the current line or column, Colors on a TTY, Common requests +@node Debugging a customization file @section How do I debug a @file{.emacs} file? @cindex Debugging @file{.emacs} file @cindex @file{.emacs} debugging @@ -1296,7 +1297,7 @@ Use @kbd{C-h v} (@kbd{M-x describe-variable}) to check the value of variables which you are trying to set or use. -@node Displaying the current line or column, Displaying the current file name in the titlebar, Debugging a customization file, Common requests +@node Displaying the current line or column @section How do I make Emacs display the current line (or column) number? @cindex @code{line-number-mode} @cindex Displaying the current line or column @@ -1347,7 +1348,7 @@ feature. So too does @samp{wb-line-number}, written by @email{naoki.y.nakamura@@nifty.com, Naoki Nakamura}. -@node Displaying the current file name in the titlebar, Turning on abbrevs by default, Displaying the current line or column, Common requests +@node Displaying the current file name in the titlebar @section How can I modify the titlebar to contain the current file name? @cindex Titlebar, displaying the current file name in @cindex File name, displaying in the titlebar @@ -1377,7 +1378,7 @@ (setq frame-title-format "%b") @end lisp -@node Turning on abbrevs by default, Associating modes with files, Displaying the current file name in the titlebar, Common requests +@node Turning on abbrevs by default @section How do I turn on abbrevs by default just in mode @var{mymode}? @cindex Abbrevs, turning on by default @@ -1396,7 +1397,7 @@ Starting with Emacs 22, the standard abbrevs file is read automatically at startup, so the first of these two forms becomes unnecessary. -@node Associating modes with files, Highlighting a region, Turning on abbrevs by default, Common requests +@node Associating modes with files @section How do I make Emacs use a certain major mode for certain files? @cindex Associating modes with files @cindex File extensions and modes @@ -1425,7 +1426,7 @@ the script.) Use @kbd{C-h v} (or @kbd{M-x describe-variable}) on @code{interpreter-mode-alist} to learn more. -@node Highlighting a region, Replacing highlighted text, Associating modes with files, Common requests +@node Highlighting a region @section How can I highlight a region of text in Emacs? @cindex Highlighting text @cindex Text, highlighting @@ -1442,7 +1443,7 @@ @noindent in your @file{.emacs} file. -@node Replacing highlighted text, Controlling case sensitivity, Highlighting a region, Common requests +@node Replacing highlighted text @section How can I replace highlighted text with what I type? @cindex @code{delete-selection-mode} @cindex Replacing highlighted text @@ -1467,7 +1468,7 @@ This mode also allows you to delete (not kill) the highlighted region by pressing @key{DEL}. -@node Controlling case sensitivity, Working with unprintable characters, Replacing highlighted text, Common requests +@node Controlling case sensitivity @section How do I control Emacs's case-sensitivity when searching/replacing? @cindex @code{case-fold-search} @cindex Case sensitivity of searches @@ -1499,7 +1500,7 @@ (setq case-fold-search nil))) @end lisp -@node Working with unprintable characters, Searching for/replacing newlines, Controlling case sensitivity, Common requests +@node Working with unprintable characters @section How do I search for, delete, or replace unprintable (eight-bit or control) characters? @cindex Unprintable characters, working with @cindex Working with unprintable characters @@ -1547,7 +1548,7 @@ M-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} -@node Searching for/replacing newlines, Yanking text in isearch, Working with unprintable characters, Common requests +@node Searching for/replacing newlines @section How do I input a newline character in isearch or query-replace? @cindex Searching for newlines @cindex Replacing newlines @@ -1556,14 +1557,14 @@ Special Input for Incremental Search, emacs}. -@node Yanking text in isearch, Wrapping words automatically, Searching for/replacing newlines, Common requests +@node Yanking text in isearch @section How do I copy text from the kill ring into the search string? @cindex Yanking text into the search string @cindex isearch yanking Use @kbd{M-y}. @inforef{Isearch Yank, Isearch Yanking, emacs}. -@node Wrapping words automatically, Turning on auto-fill by default, Yanking text in isearch, Common requests +@node Wrapping words automatically @section How do I make Emacs wrap words for me? @cindex Wrapping word automatically @cindex Wrapping lines @@ -1577,7 +1578,7 @@ @code{fill-column}. To learn how to turn this on automatically, see @ref{Turning on auto-fill by default}. -@node Turning on auto-fill by default, Spell-checkers, Wrapping words automatically, Common requests +@node Turning on auto-fill by default @section How do I turn on @code{auto-fill-mode} by default? @cindex @code{auto-fill-mode}, activating automatically @cindex Filling automatically @@ -1600,14 +1601,14 @@ (setq-default auto-fill-function 'do-auto-fill) @end lisp -@node Spell-checkers, Checking TeX and *roff documents, Turning on auto-fill by default, Common requests +@node Spell-checkers @section Where can I get a better spelling checker for Emacs? @cindex Checking spelling @cindex Spelling, checking text documents Use Ispell. @xref{Ispell}. -@node Checking TeX and *roff documents, Changing load-path, Spell-checkers, Common requests +@node Checking TeX and *roff documents @section How can I spell-check @TeX{} or *roff documents? @cindex Spelling, checking @TeX{} documents @cindex @TeX{} documents, checking spelling in @@ -1615,7 +1616,7 @@ Use Ispell. Ispell can handle @TeX{} and *roff documents. @xref{Ispell}. -@node Changing load-path, Using an already running Emacs process, Checking TeX and *roff documents, Common requests +@node Changing load-path @section How do I change @code{load-path}? @cindex @code{load-path}, modifying @cindex Modifying @code{load-path} @@ -1634,7 +1635,7 @@ (setq load-path (cons "~/mysubdir/" load-path)) @end lisp -@node Using an already running Emacs process, Compiler error messages, Changing load-path, Common requests +@node Using an already running Emacs process @section How do I use an already running Emacs from another window? @cindex @code{emacsclient} @cindex Emacs server functions @@ -1709,7 +1710,7 @@ @end itemize -@node Compiler error messages, Indenting switch statements, Using an already running Emacs process, Common requests +@node Compiler error messages @section How do I make Emacs recognize my compiler's funny error messages? @cindex Compiler error messages, recognizing @cindex Recognizing non-standard compiler errors @@ -1718,7 +1719,7 @@ Customize the @code{compilation-error-regexp-alist} variable. -@node Indenting switch statements, Customizing C and C++ indentation, Compiler error messages, Common requests +@node Indenting switch statements @section How do I change the indentation for @code{switch}? @cindex @code{switch}, indenting @cindex Indenting of @code{switch} @@ -1755,7 +1756,7 @@ There appears to be no way to do this with the old @code{c-mode}. -@node Customizing C and C++ indentation, Horizontal scrolling, Indenting switch statements, Common requests +@node Customizing C and C++ indentation @section How to customize indentation in C, C@t{++}, and Java buffers? @cindex Indentation, how to customize @cindex Customize indentation @@ -1839,7 +1840,7 @@ effect in @emph{all} languages supported by @code{cc-mode}, use @code{c-mode-common-hook}. -@node Horizontal scrolling, Overwrite mode, Customizing C and C++ indentation, Common requests +@node Horizontal scrolling @section How can I make Emacs automatically scroll horizontally? @cindex @code{hscroll-mode} @cindex Horizontal scrolling @@ -1882,7 +1883,7 @@ @code{hscroll-step-percent} controls how far to jump once we decide to do so. @end itemize -@node Overwrite mode, Turning off beeping, Horizontal scrolling, Common requests +@node Overwrite mode @section How do I make Emacs ``typeover'' or ``overwrite'' instead of inserting? @cindex @key{Insert} @cindex @code{overwrite-mode} @@ -1895,7 +1896,7 @@ On some systems, @key{Insert} toggles @code{overwrite-mode} on and off. -@node Turning off beeping, Turning the volume down, Overwrite mode, Common requests +@node Turning off beeping @section How do I stop Emacs from beeping on a terminal? @cindex Beeping, turning off @cindex Visible bell @@ -1919,7 +1920,7 @@ (setq visible-bell t) @end example -@node Turning the volume down, Automatic indentation, Turning off beeping, Common requests +@node Turning the volume down @section How do I turn down the bell volume in Emacs running under X? @cindex Bell, volume of @cindex Volume of bell @@ -1938,7 +1939,7 @@ b [vol [pitch [dur]]] b on @end example -@node Automatic indentation, Matching parentheses, Turning the volume down, Common requests +@node Automatic indentation @section How do I tell Emacs to automatically indent a new line to the indentation of the previous line? @cindex Indenting new lines @cindex New lines, indenting of @@ -1979,7 +1980,7 @@ (@pxref{Packages that do not come with Emacs}). Look for ``fill'' and ``indent'' keywords for guidance. -@node Matching parentheses, Hiding #ifdef lines, Automatic indentation, Common requests +@node Matching parentheses @section How do I show which parenthesis matches the one I'm looking at? @cindex Parentheses, matching @cindex @file{paren.el} @@ -2033,7 +2034,7 @@ @end itemize -@node Hiding #ifdef lines, Repeating commands, Matching parentheses, Common requests +@node Hiding #ifdef lines @section In C mode, can I show just the lines that will be left after @code{#ifdef} commands are handled by the compiler? @cindex @code{#ifdef}, selective display of @cindex @code{hide-ifdef-mode} @@ -2043,7 +2044,7 @@ @kbd{M-x hide-ifdef-mode}. (This is a minor mode.) You might also want to investigate @file{cpp.el}, which is distributed with Emacs. -@node Repeating commands, Valid X resources, Hiding #ifdef lines, Common requests +@node Repeating commands @section How do I repeat a command as many times as possible? @cindex Repeating commands many times @cindex Commands, repeating many times @@ -2068,7 +2069,7 @@ redoes the last insertion/deletion, use VIPER, a @code{vi} emulation mode which comes with Emacs, and which appears to support it. -@node Valid X resources, Evaluating Emacs Lisp code, Repeating commands, Common requests +@node Valid X resources @section What are the valid X resource settings (i.e., stuff in .Xdefaults)? @cindex Resources, X @cindex X resources @@ -2080,7 +2081,7 @@ onwards), to look at the resource names for the menu bar, assuming Emacs was compiled with the X toolkit. -@node Evaluating Emacs Lisp code, Changing the length of a Tab, Valid X resources, Common requests +@node Evaluating Emacs Lisp code @section How do I execute (``evaluate'') a piece of Emacs Lisp code? @cindex Evaluating Lisp code @cindex Lisp forms, evaluating @@ -2124,7 +2125,7 @@ @end itemize -@node Changing the length of a Tab, Inserting text at the beginning of each line, Evaluating Emacs Lisp code, Common requests +@node Changing the length of a Tab @section How do I change Emacs's idea of the @key{TAB} character's length? @cindex Tab length @cindex Length of tab character @@ -2143,7 +2144,7 @@ @key{TAB} characters. The latter controls what characters are inserted when you press the @key{TAB} character in certain modes. -@node Inserting text at the beginning of each line, Underlining paragraphs, Changing the length of a Tab, Common requests +@node Inserting text at the beginning of each line @section How do I insert at the beginning of every line? @cindex Prefixing a region with some text @cindex Prefix character, inserting in mail/news replies @@ -2167,14 +2168,14 @@ runs the function @code{comment-region}, it is a general-purpose mechanism to comment regions) (@pxref{Changing the included text prefix}). -@node Underlining paragraphs, Forcing the cursor to remain in the same column, Inserting text at the beginning of each line, Common requests +@node Underlining paragraphs @section How do I insert @samp{_^H} before each character in a region to get an underlined paragraph? @cindex Underlining a region of text @cindex @code{underline-region} Mark the region and then type @kbd{M-x underline-region @key{RET}}. -@node Forcing the cursor to remain in the same column, Forcing Emacs to iconify itself, Underlining paragraphs, Common requests +@node Forcing the cursor to remain in the same column @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? @cindex @code{picture-mode} @cindex Remaining in the same column, regardless of contents @@ -2186,7 +2187,7 @@ @code{set-goal-column} bound to @kbd{C-x C-n} (@pxref{Moving Point, , , emacs, The GNU Emacs Manual}). -@node Forcing Emacs to iconify itself, Using regular expressions, Forcing the cursor to remain in the same column, Common requests +@node Forcing Emacs to iconify itself @section How do I tell Emacs to iconify itself? @cindex Iconification under the X Window System @cindex X Window System and iconification @@ -2195,7 +2196,7 @@ @kbd{C-z} iconifies Emacs when running under X and suspends Emacs otherwise. @inforef{Frame Commands, Frame Commands, emacs}. -@node Using regular expressions, Replacing text across multiple files, Forcing Emacs to iconify itself, Common requests +@node Using regular expressions @section How do I use regexps (regular expressions) in Emacs? @cindex Regexps @cindex Regular expressions @@ -2227,7 +2228,7 @@ @end itemize -@node Replacing text across multiple files, Documentation for etags, Using regular expressions, Common requests +@node Replacing text across multiple files @section How do I perform a replace operation across more than one file? @cindex Replacing strings across files @cindex Multiple files, replacing across @@ -2262,7 +2263,7 @@ a query-replace across all the files mentioned in the @file{TAGS} file. @inforef{Tags Search, Tags Search, emacs}. -@node Documentation for etags, Disabling backups, Replacing text across multiple files, Common requests +@node Documentation for etags @section Where is the documentation for @code{etags}? @cindex Documentation for @code{etags} @cindex @code{etags}, documentation for @@ -2273,7 +2274,7 @@ Quick command-line switch descriptions are also available. For example, @samp{etags -H}. -@node Disabling backups, Disabling auto-save-mode, Documentation for etags, Common requests +@node Disabling backups @section How do I disable backup files? @cindex Backups, disabling @cindex Disabling backups @@ -2314,7 +2315,7 @@ to add the element @code{("." . @var{dir})} to force Emacs to put @strong{all} backup files in the directory @file{dir}. -@node Disabling auto-save-mode, Going to a line by number, Disabling backups, Common requests +@node Disabling auto-save-mode @section How do I disable @code{auto-save-mode}? @cindex Disabling @code{auto-save-mode} @cindex Auto-saving @@ -2337,7 +2338,7 @@ To disable or change how @code{auto-save-mode} works, @inforef{Auto Save, , emacs}. -@node Going to a line by number, Modifying pull-down menus, Disabling auto-save-mode, Common requests +@node Going to a line by number @section How can I go to a certain line given its number? @cindex Going to a line by number @cindex Compilation error messages @@ -2366,7 +2367,7 @@ argument that is the line's number. For example, @kbd{C-u 286 M-g M-g} will jump to line number 286 in the current buffer. -@node Modifying pull-down menus, Deleting menus and menu options, Going to a line by number, Common requests +@node Modifying pull-down menus @section How can I create or modify new pull-down menu options? @cindex Pull-down menus, creating or modifying @cindex Menus, creating or modifying @@ -2455,7 +2456,7 @@ ``Menu Keymaps.'' (@xref{Emacs Lisp documentation}, for information on this manual.) -@node Deleting menus and menu options, Turning on syntax highlighting, Modifying pull-down menus, Common requests +@node Deleting menus and menu options @section How do I delete menus and menu options? @cindex Deleting menus and menu options @cindex Menus, deleting @@ -2477,7 +2478,7 @@ (define-key global-map [menu-bar edit forward] nil) @end lisp -@node Turning on syntax highlighting, Scrolling only one line, Deleting menus and menu options, Common requests +@node Turning on syntax highlighting @section How do I turn on syntax highlighting? @cindex Syntax highlighting @cindex @code{font-lock-mode} @@ -2555,7 +2556,7 @@ consult the documentation of the variables @code{ps-printer-name}, @code{ps-lpr-command}, and @code{ps-lpr-switches} for more details. -@node Scrolling only one line, Editing MS-DOS files, Turning on syntax highlighting, Common requests +@node Scrolling only one line @section How can I force Emacs to scroll only one line when I move past the bottom of the screen? @cindex Scrolling only one line @cindex Reducing the increment when scrolling @@ -2571,7 +2572,7 @@ (setq scroll-conservatively most-positive-fixnum) @end lisp -@node Editing MS-DOS files, Filling paragraphs with a single space, Scrolling only one line, Common requests +@node Editing MS-DOS files @section How can I edit MS-DOS files using Emacs? @cindex Editing MS-DOS files @cindex MS-DOS files, editing @@ -2594,7 +2595,7 @@ and saved, allowing you to ignore the different conventions that Unix and MS-DOS have for delineating the end of a line. -@node Filling paragraphs with a single space, Escape sequences in shell output, Editing MS-DOS files, Common requests +@node Filling paragraphs with a single space @section How can I tell Emacs to fill paragraphs with a single space after each period? @cindex One space following periods @cindex Single space following periods @@ -2606,7 +2607,7 @@ (setq sentence-end-double-space nil) @end lisp -@node Escape sequences in shell output, Fullscreen mode on MS-Windows, Filling paragraphs with a single space, Common requests +@node Escape sequences in shell output @section Why these strange escape sequences from @code{ls} from the Shell mode? @cindex Escape sequences in @code{ls} output @cindex @code{ls} in Shell mode @@ -2628,7 +2629,7 @@ later), which converts these ANSI escape sequences into colors. @end itemize -@node Fullscreen mode on MS-Windows, , Escape sequences in shell output, Common requests +@node Fullscreen mode on MS-Windows @section How can I start Emacs in fullscreen mode on MS-Windows? @cindex Maximize frame @cindex Fullscreen mode @@ -2651,7 +2652,7 @@ @code{(frame-width)} with @kbd{M-:}. @c ------------------------------------------------------------ -@node Bugs and problems, Compiling and installing Emacs, Common requests, Top +@node Bugs and problems @chapter Bugs and problems @cindex Bugs and problems @@ -2684,7 +2685,7 @@ * Dired claims that no file is on this line:: @end menu -@node Problems with very large files, ^M in the shell buffer, Bugs and problems, Bugs and problems +@node Problems with very large files @section Does Emacs have problems with files larger than 8 megabytes? @cindex Very large files, opening @cindex Large files, opening @@ -2698,7 +2699,7 @@ And in Emacs 22, the maximum buffer size has been increased to 268,435,455 bytes (or 256 MBytes) on 32-bit machines. -@node ^M in the shell buffer, Shell process exits abnormally, Problems with very large files, Bugs and problems +@node ^M in the shell buffer @section How do I get rid of @samp{^M} or echoed commands in my shell buffer? @cindex Shell buffer, echoed commands and @samp{^M} in @cindex Echoed commands in @code{shell-mode} @@ -2770,7 +2771,7 @@ stty -icrnl -onlcr -echo susp ^Z @end example -@node Shell process exits abnormally, Problems with Shell Mode on MS-Windows, ^M in the shell buffer, Bugs and problems +@node Shell process exits abnormally @section Why do I get ``Process shell exited abnormally with code 1''? @cindex Abnormal exits from @code{shell-mode} @cindex @code{shell-mode} exits @@ -2799,7 +2800,7 @@ top-level directory when you unpack the Emacs source) for other possible causes of this message. -@node Problems with Shell Mode on MS-Windows, Termcap/Terminfo entries for Emacs, Shell process exits abnormally, Bugs and problems +@node Problems with Shell Mode on MS-Windows @section Why do I get an error message when I try to run @kbd{M-x shell}? @cindex Shell Mode, and MS-Windows @@ -2827,7 +2828,7 @@ antivirus software; disabling the resident antivirus program solves the problems in those cases. -@node Termcap/Terminfo entries for Emacs, Spontaneous entry into isearch-mode, Problems with Shell Mode on MS-Windows, Bugs and problems +@node Termcap/Terminfo entries for Emacs @section Where is the termcap/terminfo entry for terminal type @samp{emacs}? @cindex Termcap @cindex Terminfo @@ -2861,7 +2862,7 @@ if ("$term" == emacs) set term=dumb @end example -@node Spontaneous entry into isearch-mode, Problems talking to certain hosts, Termcap/Terminfo entries for Emacs, Bugs and problems +@node Spontaneous entry into isearch-mode @section Why does Emacs spontaneously start displaying @samp{I-search:} and beeping? @cindex Spontaneous entry into isearch-mode @cindex isearch-mode, spontaneous entry into @@ -2873,7 +2874,7 @@ character normally invokes the @code{isearch-forward} command.) For possible solutions, see @ref{Handling C-s and C-q with flow control}. -@node Problems talking to certain hosts, Errors with init files, Spontaneous entry into isearch-mode, Bugs and problems +@node Problems talking to certain hosts @section Why can't Emacs talk to certain hosts (or certain hostnames)? @cindex Hosts, Emacs cannot talk to @cindex @code{gethostbyname}, problematic version @@ -2918,7 +2919,7 @@ @end itemize -@node Errors with init files, Emacs ignores X resources, Problems talking to certain hosts, Bugs and problems +@node Errors with init files @section Why does Emacs say @samp{Error in init file}? @cindex Error in @file{.emacs} @cindex Error in init file @@ -2939,7 +2940,7 @@ of this is explained in @ref{Terminal setup code works after Emacs has begun}. -@node Emacs ignores X resources, Emacs ignores frame parameters, Errors with init files, Bugs and problems +@node Emacs ignores X resources @section Why does Emacs ignore my X resources (my .Xdefaults file)? @cindex X resources being ignored @cindex Ignored X resources @@ -3018,7 +3019,7 @@ @end enumerate -@node Emacs ignores frame parameters, Emacs takes a long time to visit files, Emacs ignores X resources, Bugs and problems +@node Emacs ignores frame parameters @section Why don't my customizations of the frame parameters work? @cindex Frame parameters @@ -3034,7 +3035,7 @@ other frames by individually positioning each one of them. -@node Emacs takes a long time to visit files, Editing files with $ in the name, Emacs ignores frame parameters, Bugs and problems +@node Emacs takes a long time to visit files @section Why does Emacs take 20 seconds to visit a file? @cindex Visiting files takes a long time @cindex Delay when visiting files @@ -3050,7 +3051,7 @@ over NFS anyway, the best solution is to recompile Emacs with @code{CLASH_DETECTION} undefined. -@node Editing files with $ in the name, Shell mode loses the current directory, Emacs takes a long time to visit files, Bugs and problems +@node Editing files with $ in the name @section How do I edit a file with a @samp{$} in its name? @cindex Editing files with @samp{$} in the name @cindex @samp{$} in file names @@ -3060,7 +3061,7 @@ a @samp{$} followed by a word as an environment variable. To suppress this behavior, type @kbd{$$} instead. -@node Shell mode loses the current directory, Security risks with Emacs, Editing files with $ in the name, Bugs and problems +@node Shell mode loses the current directory @section Why does shell mode lose track of the shell's current directory? @cindex Current directory and @code{shell-mode} @cindex @code{shell-mode} and current directory @@ -3079,7 +3080,7 @@ You can tell Emacs the shell's current directory with the command @kbd{M-x dirs}. -@node Security risks with Emacs, Dired claims that no file is on this line, Shell mode loses the current directory, Bugs and problems +@node Security risks with Emacs @section Are there any security risks in Emacs? @cindex Security with Emacs @cindex @samp{movemail} and security @@ -3182,7 +3183,7 @@ @end itemize -@node Dired claims that no file is on this line, , Security risks with Emacs, Bugs and problems +@node Dired claims that no file is on this line @section Dired says, @samp{no file on this line} when I try to do something. @cindex Dired does not see a file @@ -3206,7 +3207,7 @@ dired, @code{directory-listing-before-filename-regexp}. @c ------------------------------------------------------------ -@node Compiling and installing Emacs, Finding Emacs and related packages, Bugs and problems, Top +@node Compiling and installing Emacs @chapter Compiling and installing Emacs @cindex Compiling and installing Emacs @@ -3216,7 +3217,7 @@ * Problems building Emacs:: @end menu -@node Installing Emacs, Updating Emacs, Compiling and installing Emacs, Compiling and installing Emacs +@node Installing Emacs @section How do I install Emacs? @cindex Installing Emacs @cindex Unix systems, installing Emacs on @@ -3341,7 +3342,7 @@ Much more verbose instructions (with many more hints and suggestions) come with the Emacs sources, in the file @file{INSTALL}. -@node Updating Emacs, Problems building Emacs, Installing Emacs, Compiling and installing Emacs +@node Updating Emacs @section How do I update Emacs to the latest version? @cindex Updating Emacs @@ -3356,7 +3357,7 @@ binary) and documentation in @file{/usr/local/info}. Back up these files before you upgrade, and you shouldn't have too much trouble. -@node Problems building Emacs, , Updating Emacs, Compiling and installing Emacs +@node Problems building Emacs @section What should I do if I have trouble building Emacs? @cindex Problems building Emacs @cindex Errors when building Emacs @@ -3378,7 +3379,7 @@ @c ------------------------------------------------------------ -@node Finding Emacs and related packages, Major packages and programs, Compiling and installing Emacs, Top +@node Finding Emacs and related packages @chapter Finding Emacs and related packages @cindex Finding Emacs and related packages @@ -3396,7 +3397,7 @@ * Modes for various languages:: @end menu -@node Finding Emacs on the Internet, Finding a package with particular functionality, Finding Emacs and related packages, Finding Emacs and related packages +@node Finding Emacs on the Internet @section Where can I get Emacs on the net (or by snail mail)? @cindex Finding Emacs on the Internet @cindex Snail mail, ordering Emacs via @@ -3412,7 +3413,7 @@ version of Emacs, and see @ref{Current GNU distributions}, for a list of archive sites that make GNU software available. -@node Finding a package with particular functionality, Packages that do not come with Emacs, Finding Emacs on the Internet, Finding Emacs and related packages +@node Finding a package with particular functionality @section How do I find a Emacs Lisp package that does XXX? @cindex Package, finding @cindex Finding an Emacs Lisp package @@ -3437,7 +3438,7 @@ For advice on how to find extra packages that are not part of Emacs, see @ref{Packages that do not come with Emacs}. -@node Packages that do not come with Emacs, Current GNU distributions, Finding a package with particular functionality, Finding Emacs and related packages +@node Packages that do not come with Emacs @section Where can I get Emacs Lisp packages that don't come with Emacs? @cindex Unbundled packages @cindex Finding other packages @@ -3464,7 +3465,7 @@ Read the file @file{etc/MORE.STUFF} for more information about external packages. -@node Current GNU distributions, Difference between Emacs and XEmacs, Packages that do not come with Emacs, Finding Emacs and related packages +@node Current GNU distributions @section Where can I get other up-to-date GNU stuff? @cindex Current GNU distributions @cindex Sources for current GNU distributions @@ -3484,7 +3485,7 @@ @uref{http://www.gnu.org/order/ftp.html} -@node Difference between Emacs and XEmacs, Emacs for minimalists, Current GNU distributions, Finding Emacs and related packages +@node Difference between Emacs and XEmacs @section What is the difference between Emacs and XEmacs (formerly Lucid Emacs)? @cindex XEmacs @cindex Difference Emacs and XEmacs @@ -3517,7 +3518,7 @@ ``(X)Emacs'' are not wrong, but they are not very clear, so it is better to write ``Emacs and XEmacs.'' -@node Emacs for minimalists, Emacs for MS-DOS, Difference between Emacs and XEmacs, Finding Emacs and related packages +@node Emacs for minimalists @section I don't have enough disk space to install Emacs @cindex Zile @cindex Not enough disk space to install Emacs @@ -3531,7 +3532,7 @@ @uref{http://www.gnu.org/software/zile/} -@node Emacs for MS-DOS, Emacs for Windows, Emacs for minimalists, Finding Emacs and related packages +@node Emacs for MS-DOS @section Where can I get Emacs for my PC running MS-DOS? @cindex MS-DOS, Emacs for @cindex DOS, Emacs for @@ -3613,7 +3614,7 @@ Note that while many of these programs look similar to Emacs, they often lack certain features, such as the Emacs Lisp extension language. -@node Emacs for Windows, Emacs for GNUstep, Emacs for MS-DOS, Finding Emacs and related packages +@node Emacs for Windows @section Where can I get Emacs for Microsoft Windows? @cindex FAQ for NT Emacs @cindex Emacs for MS-Windows @@ -3629,20 +3630,20 @@ @xref{Emacs for MS-DOS}, for Windows 3.1. -@node Emacs for GNUstep, Emacs for Apple computers, Emacs for Windows, Finding Emacs and related packages +@node Emacs for GNUstep @section Where can I get Emacs for GNUstep? @cindex GNUSTEP, Emacs for Beginning with version 23.1, Emacs supports GNUstep natively. -@node Emacs for Apple computers, Modes for various languages, Emacs for GNUstep, Finding Emacs and related packages +@node Emacs for Apple computers @section Where can I get Emacs for my Apple computer? @cindex Apple computers, Emacs for @cindex Macintosh, Emacs for Beginning with version 22.1, Emacs supports Mac OS X natively. -@node Modes for various languages, , Emacs for Apple computers, Finding Emacs and related packages +@node Modes for various languages @section Where can I get modes for Lex, Yacc/Bison, Bourne shell, csh, C@t{++}, Objective-C, Pascal, Java, and Awk? @cindex Awk, mode for @cindex @code{awk-mode} @@ -3668,7 +3669,7 @@ @uref{http://cc-mode.sourceforge.net/, its own homepage}. @c ------------------------------------------------------------ -@node Major packages and programs, Key bindings, Finding Emacs and related packages, Top +@node Major packages and programs @chapter Major packages and programs @cindex Major packages and programs @@ -3684,7 +3685,7 @@ * Patch:: @end menu -@node VM, AUCTeX, Major packages and programs, Major packages and programs +@node VM @section VM (View Mail) --- another mail reader within Emacs, with MIME support @cindex VM @cindex Alternative mail software @@ -3714,7 +3715,7 @@ available. -@node AUCTeX, BBDB, VM, Major packages and programs +@node AUCTeX @section AUC@TeX{} --- enhanced @TeX{} modes with debugging facilities @cindex Mode for @TeX{} @cindex @TeX{} mode @@ -3755,7 +3756,7 @@ @end table -@node BBDB, Ispell, AUCTeX, Major packages and programs +@node BBDB @section BBDB --- personal Info Rolodex integrated with mail/news readers @cindex BBDB @cindex Rolodex-like functionality @@ -3782,7 +3783,7 @@ @end table -@node Ispell, Emacs/W3, BBDB, Major packages and programs +@node Ispell @section Ispell --- spell checker in C with interface for Emacs @cindex Spell-checker @cindex Checking spelling @@ -3807,7 +3808,7 @@ This Ispell program is distinct from GNU Ispell 4.0. GNU Ispell 4.0 is no longer a supported product. -@node Emacs/W3, EDB, Ispell, Major packages and programs +@node Emacs/W3 @section Emacs/W3 --- A World Wide Web browser inside of Emacs @cindex WWW browser @cindex Web browser @@ -3836,7 +3837,7 @@ @end table -@node EDB, Mailcrypt, Emacs/W3, Major packages and programs +@node EDB @section EDB --- Database program for Emacs; replaces forms editing modes @cindex EDB @cindex Database @@ -3854,7 +3855,7 @@ @end table -@node Mailcrypt, JDE, EDB, Major packages and programs +@node Mailcrypt @section Mailcrypt --- PGP interface within Emacs mail and news @cindex PGP @cindex GPG @@ -3888,7 +3889,7 @@ including @uref{http://www.gnupg.org/, The GNU Privacy Guard} and supports symmetric encryption. -@node JDE, Patch, Mailcrypt, Major packages and programs +@node JDE @section JDE --- Integrated development environment for Java @cindex Java development environment @cindex Integrated Java development environment @@ -3911,7 +3912,7 @@ @end table -@node Patch, , JDE, Major packages and programs +@node Patch @section Patch --- program to apply ``diffs'' for updating files @cindex Updating files with diffs @cindex Patching source files with diffs @@ -3932,7 +3933,7 @@ @end table @c ------------------------------------------------------------ -@node Key bindings, Alternate character sets, Major packages and programs, Top +@node Key bindings @chapter Key bindings @cindex Key bindings @@ -3958,7 +3959,7 @@ * SPC no longer completes file names:: @end menu -@node Binding keys to commands, Invalid prefix characters, Key bindings, Key bindings +@node Binding keys to commands @section How do I bind keys (including function keys) to commands? @cindex Binding keys to commands @cindex Keys, binding to commands @@ -4025,7 +4026,7 @@ @end itemize -@node Invalid prefix characters, Terminal setup code works after Emacs has begun, Binding keys to commands, Key bindings +@node Invalid prefix characters @section Why does Emacs say @samp{Key sequence XXX uses invalid prefix characters}? @cindex Prefix characters, invalid @cindex Invalid prefix characters @@ -4044,7 +4045,7 @@ (global-unset-key "\e[") @end lisp -@node Terminal setup code works after Emacs has begun, Using function keys under X, Invalid prefix characters, Key bindings +@node Terminal setup code works after Emacs has begun @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? @cindex Terminal setup code in @file{.emacs} @@ -4070,7 +4071,7 @@ For information on what Emacs does every time it is started, see the @file{lisp/startup.el} file. -@node Using function keys under X, Working with function and arrow keys, Terminal setup code works after Emacs has begun, Key bindings +@node Using function keys under X @section How do I use function keys under X? @cindex Function keys @cindex X Window System and function keys @@ -4078,7 +4079,7 @@ With Emacs 19, functions keys under X are bound like any other key. @xref{Binding keys to commands}, for details. -@node Working with function and arrow keys, X key translations for Emacs, Using function keys under X, Key bindings +@node Working with function and arrow keys @section How do I tell what characters or symbols my function or arrow keys emit? @cindex Working with arrow keys @cindex Arrow keys, symbols generated by @@ -4091,7 +4092,7 @@ Emacs on-line documentation for an explanation). This works for other keys as well. -@node X key translations for Emacs, Handling C-s and C-q with flow control, Working with function and arrow keys, Key bindings +@node X key translations for Emacs @section How do I set the X key ``translations'' for Emacs? @cindex X key translations @cindex Key translations under X @@ -4113,7 +4114,7 @@ @noindent defines the @kbd{M-@key{TAB}} key sequence. -@node Handling C-s and C-q with flow control, Binding C-s and C-q, X key translations for Emacs, Key bindings +@node Handling C-s and C-q with flow control @section How do I handle @kbd{C-s} and @kbd{C-q} being used for flow control? @cindex Flow control, @kbd{C-s} and @kbd{C-q} with @cindex @kbd{C-s} and @kbd{C-q} with flow control @@ -4241,7 +4242,7 @@ For further discussion of this issue, read the file @file{etc/PROBLEMS} (in the Emacs source directory when you unpack the Emacs distribution). -@node Binding C-s and C-q, Backspace invokes help, Handling C-s and C-q with flow control, Key bindings +@node Binding C-s and C-q @section How do I bind @kbd{C-s} and @kbd{C-q} (or any key) if these keys are filtered out? @cindex Binding @kbd{C-s} and @kbd{C-q} @cindex @kbd{C-s} and @kbd{C-q}, binding @@ -4265,7 +4266,7 @@ @end itemize -@node Backspace invokes help, stty and Backspace key, Binding C-s and C-q, Key bindings +@node Backspace invokes help @section Why does the @key{Backspace} key invoke help? @cindex Backspace key invokes help @cindex Help invoked by Backspace @@ -4374,7 +4375,7 @@ Does Not Delete, , If @key{DEL} Fails to Delete, emacs, The GNU Emacs Manual}. -@node stty and Backspace key, Swapping keys, Backspace invokes help, Key bindings +@node stty and Backspace key @section Why doesn't Emacs look at the @file{stty} settings for @key{Backspace} vs. @key{Delete}? @cindex @file{stty} and Emacs @cindex Backspace and @file{stty} @@ -4385,7 +4386,7 @@ @c FIXME: RMS explained the reasons for this on emacs-hackers. It's @c probably worth putting that explanation here. -@node Swapping keys, Producing C-XXX with the keyboard, stty and Backspace key, Key bindings +@node Swapping keys @section How do I swap two keys? @cindex Swapping keys @cindex Keys, swapping @@ -4418,7 +4419,7 @@ looked up in keymaps contain the characters that result from keyboard translation. -@node Producing C-XXX with the keyboard, No Meta key, Swapping keys, Key bindings +@node Producing C-XXX with the keyboard @section How do I produce C-XXX with my keyboard? @cindex Producing control characters @cindex Generating control characters @@ -4453,7 +4454,7 @@ generated. You can also try the @kbd{C-h w} command if you know the name of the command. -@node No Meta key, No Escape key, Producing C-XXX with the keyboard, Key bindings +@node No Meta key @section What if I don't have a @key{Meta} key? @cindex No @key{Meta} key @cindex @key{Meta} key, what to do if you lack it @@ -4466,7 +4467,7 @@ press @key{Meta} and @key{a} together, but with @key{ESC}, you press @key{ESC}, release it, and then press @key{a}. -@node No Escape key, Compose Character, No Meta key, Key bindings +@node No Escape key @section What if I don't have an @key{Escape} key? @cindex No Escape key @cindex Lacking an Escape key @@ -4482,7 +4483,7 @@ (define-key function-key-map [f11] [?\e]) @end lisp -@node Compose Character, Binding combinations of modifiers and function keys, No Escape key, Key bindings +@node Compose Character @section Can I make my @key{Compose Character} key behave like a @key{Meta} key? @cindex @key{Compose Character} key, using as @key{Meta} @cindex @key{Meta}, using @key{Compose Character} for @@ -4492,7 +4493,7 @@ you're using X, you might be able to do this with the @code{xmodmap} command. -@node Binding combinations of modifiers and function keys, Meta key does not work in xterm, Compose Character, Key bindings +@node Binding combinations of modifiers and function keys @section How do I bind a combination of modifier key and function key? @cindex Modifiers and function keys @cindex Function keys and modifiers @@ -4531,7 +4532,7 @@ @xref{Binding keys to commands}, for general key binding instructions. -@node Meta key does not work in xterm, ExtendChar key does not work as Meta, Binding combinations of modifiers and function keys, Key bindings +@node Meta key does not work in xterm @section Why doesn't my @key{Meta} key work in an @code{xterm} window? @cindex @key{Meta} key and @code{xterm} @cindex Xterm and @key{Meta} key @@ -4601,7 +4602,7 @@ @end itemize -@node ExtendChar key does not work as Meta, SPC no longer completes file names, Meta key does not work in xterm, Key bindings +@node ExtendChar key does not work as Meta @section Why doesn't my @key{ExtendChar} key work as a @key{Meta} key under HP-UX 8.0 and 9.x? @cindex @key{ExtendChar} key as @key{Meta} @cindex @key{Meta}, using @key{ExtendChar} for @@ -4624,7 +4625,7 @@ This will disable the use of the extra keysyms systemwide, which may be undesirable if you actually intend to use them. -@node SPC no longer completes file names, , ExtendChar key does not work as Meta, Key bindings +@node SPC no longer completes file names @section Why doesn't SPC complete file names anymore? @cindex @kbd{SPC} file name completion @@ -4644,7 +4645,7 @@ @end lisp @c ------------------------------------------------------------ -@node Alternate character sets, Mail and news, Key bindings, Top +@node Alternate character sets @chapter Alternate character sets @cindex Alternate character sets @@ -4656,7 +4657,7 @@ * How to add fonts:: @end menu -@node Emacs does not display 8-bit characters, Inputting eight-bit characters, Alternate character sets, Alternate character sets +@node Emacs does not display 8-bit characters @section How do I make Emacs display 8-bit characters? @cindex Displaying eight-bit characters @cindex Eight-bit characters, displaying @@ -4671,7 +4672,7 @@ character set supported by the display, and sets up the required terminal coding system automatically. -@node Inputting eight-bit characters, Kanji and Chinese characters, Emacs does not display 8-bit characters, Alternate character sets +@node Inputting eight-bit characters @section How do I input eight-bit characters? @cindex Entering eight-bit characters @cindex Eight-bit characters, entering @@ -4682,7 +4683,7 @@ Support, emacs}. For more sophisticated methods, @inforef{Input Methods, Input Methods, emacs}. -@node Kanji and Chinese characters, Right-to-left alphabets, Inputting eight-bit characters, Alternate character sets +@node Kanji and Chinese characters @section Where can I get an Emacs that handles kanji, Chinese, or other Far-Eastern character sets? @cindex Kanji, handling with Emacs @cindex Chinese, handling with Emacs @@ -4693,7 +4694,7 @@ Enhancement to Emacs. @xref{Installing Emacs}, for information on where to find and download the latest version of Emacs. -@node Right-to-left alphabets, How to add fonts, Kanji and Chinese characters, Alternate character sets +@node Right-to-left alphabets @section Where is an Emacs that can handle Semitic (right-to-left) alphabets? @cindex Right-to-left alphabets @cindex Hebrew, handling with Emacs @@ -4717,7 +4718,7 @@ @file{hebrew}; several ftp sites in Israel may also have the necessary files. -@node How to add fonts, , Right-to-left alphabets, Alternate character sets +@node How to add fonts @section How do I add fonts for use with Emacs? @cindex add fonts for use with Emacs @cindex intlfonts @@ -4837,7 +4838,7 @@ @c ------------------------------------------------------------ -@node Mail and news, Concept index, Alternate character sets, Top +@node Mail and news @chapter Mail and news @cindex Mail and news @@ -4862,7 +4863,7 @@ * Learning more about Gnus:: @end menu -@node Changing the included text prefix, Saving a copy of outgoing mail, Mail and news, Mail and news +@node Changing the included text prefix @section How do I change the included text prefix in mail/news followups? @cindex Prefix in mail/news followups, changing @cindex Included text prefix, changing @@ -4879,7 +4880,7 @@ message, set the value of @code{mail-yank-ignored-headers} to an appropriate regexp. -@node Saving a copy of outgoing mail, Expanding aliases when sending mail, Changing the included text prefix, Mail and news +@node Saving a copy of outgoing mail @section How do I save a copy of outgoing mail? @cindex Saving a copy of outgoing mail @cindex Copying outgoing mail to a file @@ -4916,7 +4917,7 @@ It does not work to put @samp{set record filename} in the @file{.mailrc} file. -@node Expanding aliases when sending mail, Sorting the messages in an Rmail folder, Saving a copy of outgoing mail, Mail and news +@node Expanding aliases when sending mail @section Why doesn't Emacs expand my aliases when sending mail? @cindex Expanding aliases when sending mail @cindex Mail alias expansion @@ -4958,7 +4959,7 @@ (@kbd{M-x expand-abbrev}). @end itemize -@node Sorting the messages in an Rmail folder, Rmail writes to /usr/spool/mail, Expanding aliases when sending mail, Mail and news +@node Sorting the messages in an Rmail folder @section How can I sort the messages in my Rmail folder? @cindex Rmail, sorting messages in @cindex Folder, sorting messages in an Rmail @@ -4967,7 +4968,7 @@ In Rmail, type @kbd{C-c C-s C-h} to get a list of sorting functions and their key bindings. -@node Rmail writes to /usr/spool/mail, Replying to the sender of a message, Sorting the messages in an Rmail folder, Mail and news +@node Rmail writes to /usr/spool/mail @section Why does Rmail need to write to @file{/usr/spool/mail}? @cindex Rmail and @file{/usr/spool/mail} @cindex @file{/usr/spool/mail} and Rmail @@ -4986,7 +4987,7 @@ these systems, you should configure @code{movemail} to use @code{flock}. @end quotation -@node Replying to the sender of a message, MIME with Emacs mail packages, Rmail writes to /usr/spool/mail, Mail and news +@node Replying to the sender of a message @section How can I force Rmail to reply to the sender of a message, but not the other recipients? @cindex Replying only to the sender of a message @cindex Sender, replying only to @@ -5012,7 +5013,7 @@ (define-key rmail-mode-map "R" 'rmail-reply))) @end lisp -@node MIME with Emacs mail packages, Automatically starting a mail or news reader, Replying to the sender of a message, Mail and news +@node MIME with Emacs mail packages @section How can I get my favorite Emacs mail package to support MIME? @cindex MIME and Emacs mail packages @cindex Mail packages and MIME @@ -5022,7 +5023,7 @@ and news messages as of version 5.8.1 (Pterodactyl). Rmail has limited support for single-part MIME messages beginning with Emacs 20.3. -@node Automatically starting a mail or news reader, Reading news with Emacs, MIME with Emacs mail packages, Mail and news +@node Automatically starting a mail or news reader @section How do I make Emacs automatically start my mail/news reader? @cindex Mail reader, starting automatically @cindex News reader, starting automatically @@ -5053,7 +5054,7 @@ two copies of Emacs at the same time. Also, this would make it difficult for you to start Emacs quickly when you needed to. -@node Reading news with Emacs, Gnus does not work with NNTP, Automatically starting a mail or news reader, Mail and news +@node Reading news with Emacs @section How do I read news under Emacs? @cindex Reading news under Emacs @cindex Usenet reader in Emacs @@ -5062,7 +5063,7 @@ Use @kbd{M-x gnus}. It is documented in Info (@pxref{Learning how to do something}). -@node Gnus does not work with NNTP, Viewing articles with embedded underlining, Reading news with Emacs, Mail and news +@node Gnus does not work with NNTP @section Why doesn't Gnus work via NNTP? @cindex Gnus and NNTP @cindex NNTP, Gnus fails to work with @@ -5085,7 +5086,7 @@ @xref{Spontaneous entry into isearch-mode}, for some additional ideas. -@node Viewing articles with embedded underlining, Saving a multi-part Gnus posting, Gnus does not work with NNTP, Mail and news +@node Viewing articles with embedded underlining @section How do I view news articles with embedded underlining (e.g., ClariNews)? @cindex Underlining, embedded in news articles @cindex News articles with embedded underlining @@ -5138,7 +5139,7 @@ (lambda () (ununderline-region (point-min) (point-max)))) @end lisp -@node Saving a multi-part Gnus posting, Starting Gnus faster, Viewing articles with embedded underlining, Mail and news +@node Saving a multi-part Gnus posting @section How do I save all the items of a multi-part posting in Gnus? @cindex Multi-part postings in Gnus, saving @cindex Saving multi-part postings in Gnus @@ -5147,7 +5148,7 @@ Use @code{gnus-uu}. Type @kbd{C-c C-v C-h} in the Gnus summary buffer to see a list of available commands. -@node Starting Gnus faster, Catching up in all newsgroups, Saving a multi-part Gnus posting, Mail and news +@node Starting Gnus faster @section How do I make Gnus start up faster? @cindex Faster, starting Gnus @cindex Starting Gnus faster @@ -5170,7 +5171,7 @@ @end lisp @end quotation -@node Catching up in all newsgroups, Killing based on nonstandard headers, Starting Gnus faster, Mail and news +@node Catching up in all newsgroups @section How do I catch up all newsgroups in Gnus? @cindex Catching up all newsgroups in Gnus @cindex Gnus, Catching up all newsgroups in @@ -5180,7 +5181,7 @@ Leave off the initial @kbd{M-<} if you only want to catch up from point to the end of the @file{*Newsgroup*} buffer. -@node Killing based on nonstandard headers, Catch-up is slow in Gnus, Catching up in all newsgroups, Mail and news +@node Killing based on nonstandard headers @section Why can't I kill in Gnus based on the Newsgroups/Keywords/Control headers? @cindex Killing articles based on nonstandard headers @cindex Newsgroups header, killing articles based on @@ -5201,7 +5202,7 @@ (gnus-kill nil "^Newsgroups: .*\\(bad\\.group\\|worse\\.group\\)") @end lisp -@node Catch-up is slow in Gnus, Gnus hangs for a long time, Killing based on nonstandard headers, Mail and news +@node Catch-up is slow in Gnus @section Why is catch up slow in Gnus? @cindex Slow catch up in Gnus @cindex Gnus is slow when catching up @@ -5210,7 +5211,7 @@ Because Gnus is marking crosspostings read. You can control this with the variable @code{gnus-use-cross-reference}. -@node Gnus hangs for a long time, Learning more about Gnus, Catch-up is slow in Gnus, Mail and news +@node Gnus hangs for a long time @section Why does Gnus hang for a long time when posting? @cindex Hangs in Gnus @cindex Gnus hangs while posting @@ -5236,7 +5237,7 @@ most folks as that update propagates around. @end quotation -@node Learning more about Gnus, , Gnus hangs for a long time, Mail and news +@node Learning more about Gnus @section Where can I find out more about Gnus? @cindex FAQ for Gnus @cindex Gnus FAQ @@ -5245,7 +5246,7 @@ For more information on Gnus, consult the Gnus manual and FAQ, which are part of the Gnus distribution. -@node Concept index, , Mail and news, Top +@node Concept index @unnumbered Concept Index @printindex cp