From f0bf7708dfb591793cf813749b1e4fadcebe44c4 Mon Sep 17 00:00:00 2001 From: Glenn Morris Date: Fri, 12 Jun 2009 07:49:09 +0000 Subject: [PATCH] (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. --- doc/misc/ChangeLog | 5 + doc/misc/faq.texi | 347 +++++++++++++++++++++++---------------------- 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 @@ (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 --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.] @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 @@ them. @end menu @c ------------------------------------------------------------ -@node FAQ notation, General questions, Top, Top +@node FAQ notation @chapter FAQ notation @cindex FAQ notation @@ -102,7 +103,7 @@ used in the FAQ. * 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 @@ Also, on very few keyboards does @kbd{C-?} generate @acronym{ASCII} code 127. 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 @@ good candidate for this, on keyboards that have such a key. 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 @@ improperly. In this case you should complain. @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 @@ also available via the Emacs @samp{Help} menu, or by typing @kbd{C-h ?} 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 @@ get the software for less money from someone else, since everyone has 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 @@ Free Software Foundation, and related organizations. * 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 @@ The LPF opposes the expanding danger of software patents and 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 @@ distribute any version of Emacs or a related program, and give the 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 @@ posting a followup that recommends such software. @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 @@ archive the @code{gnu.*} groups. 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 @@ is a bug. If Lisp code does not do what the documentation says it 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 @@ on the mail messages may help, along with liberal use of the @samp{EXPN} or 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 @@ For details on how to order items directly from the FSF, see the @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 @@ This chapter tells you how to get help with Emacs * 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 @@ sequence listed. Each of the resulting key sequences invokes help. 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 @@ information. To get a list of these commands, type @samp{?} after @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 @@ you can get a PostScript or PDF (or HTML) version from @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 @@ An HTML version of the Emacs Lisp Reference Manual is available at @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 @@ files. The node lists from all @file{dir} files in @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 @@ printer. 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 @@ You can get Tkinfo at @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 @@ Bulletin}, are at @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 @@ The web-page @uref{http://www.fsf.org/resources/service/} lists 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-f} (@kbd{M-x view-emacs-FAQ}). @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 @@ latest version status. * 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 @@ For some not-so-serious alternative reasons for Emacs to have that 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 @@ calendar/diary, have been updated and enhanced to work with Emacs 20, 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 @@ In addition, Emacs 21 supports faces on text-only terminals. This means 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 @@ Many other changes have been made in Emacs 22, use @kbd{C-h n} to get a 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 @@ full list. * 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 @@ Sometimes users are unsure as to where their @file{.emacs} file should 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 @@ If you wish to customize a single option, use @kbd{M-x customize-option @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 @@ exhibits all the colors Emacs knows about on the current display. 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 @@ eval-last-sexp}). 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 @@ written by @email{kyle@@wonderworks.com, Kyle Jones} provides this 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 @@ in your @file{.emacs}: (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 @@ Put this in your @file{.emacs} file: 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 @@ determines which interpreter you're using by examining the first line of 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 @@ including @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 @@ When OFF, typed text is just inserted at point. 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 @@ mode's hook. For example: (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 @@ characters with a colon, use: 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 @@ Use @kbd{C-q C-j}. For more information, see @inforef{Special Isearch, 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 @@ The default maximum line width is 70, determined by the variable @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 @@ If you want @code{auto-fill} mode on in all major modes, do this: (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. @xref{Ispell}. 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 @@ To do this relative to your home directory: (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 @@ The most recent @samp{gnuserv} package is available at @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 @@ The most recent @samp{gnuserv} package is available at 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 @@ C programming in Emacs 20 and later) and add the following line to your 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 @@ Java sources, etc. If you want the same customizations to be in 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 @@ edge of the window. @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 @@ is as easy as another @kbd{M-x overwrite-mode}. 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 @@ And evaluate the following Lisp form: (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 @@ usage: xset [-display host:dpy] option ... 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 @@ new paragraph. There are many packages available to deal with this (@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 @@ parenthesis, it simply inserts a % like normal. @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 @@ parenthesis, it simply inserts a % like normal. @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 @@ If you're really desperate for the @code{.} command in @code{vi} that 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 @@ You can also use a resource editor, such as editres (for X11R5 and 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 @@ about them. @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 @@ Do not confuse variable @code{tab-width} with variable @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 @@ buffers, you can even use @kbd{M-;} to cite yanked messages (@kbd{M-;} 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 @@ See also the variable @code{track-eol} and the command @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 @@ See also the variable @code{track-eol} and the command @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 @@ is actually typical for regexp syntax.) @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 @@ Emacs: it includes the command @code{tags-query-replace} which performs 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 @@ The @code{etags} man page should be in the same place as the 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 @@ should have their backups put in certain directories. A typical use is 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 @@ such as @file{/tmp}. 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 @@ You can do this faster by invoking @code{goto-line} with a numeric 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 @@ modify menu options---are in the @cite{Emacs Lisp Reference Manual}, under ``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 @@ menus}), use: (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 @@ PostScript printer, or a PostScript interpreter such as Ghostscript; 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 @@ Alternatively, use the following Lisp form in your @file{.emacs}: (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 @@ If you are running a version of Emacs before 20.1, get @code{crypt++} 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 @@ Add the following line to your @file{.emacs} file: (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 @@ Install the @code{ansi-color} package (bundled with Emacs 21.1 and 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 @@ Emacs frame and then evaluate @code{(frame-height)} and @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 @@ type @kbd{C-h C-e} to read it. * 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 @@ buffer size is at least 2^27-1, or 134,217,727 bytes, or 132 MBytes. 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 @@ shell start-up file: 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 @@ See also @samp{PROBLEMS} (in the @file{etc} subdirectory of the 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 @@ Some people have trouble with Shell Mode because of intrusive 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 @@ in your shell start up file. @code{csh} users could put this in their 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 @@ these characters and interpreting them as commands. (The @kbd{C-s} 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 @@ properly told to do DNS lookups with the correct command line switch. @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 @@ hook that will be evaluated after the package is loaded. A common case 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 @@ then in the files listed in @code{XFILESEARCHPATH}. @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 @@ size of the initial frame, but would like to control the geometry of the 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 @@ can cause the same problem. Since Emacs's file locking doesn't work 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 @@ When entering a file name in the minibuffer, Emacs will attempt to expand 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 @@ functionality}). 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 @@ access control enabled, only authorized clients can connect @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 @@ The second approach involves changing the regular expression used by 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 @@ dired, @code{directory-listing-before-filename-regexp}. * 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 @@ and any Emacs Info files that might be in @file{/usr/local/info}. 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 @@ Upgrading should overwrite only, @file{/usr/local/bin/emacs} (the Emacs 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 @@ Please don't post it to @uref{news:gnu.emacs.help} or send e-mail to @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 @@ Please don't post it to @uref{news:gnu.emacs.help} or send e-mail to * 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 @@ see @ref{Informational files for Emacs}, for how to get these files. 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 @@ the constituent Emacs packages. 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 @@ Several packages are stored in 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 @@ A list of sites mirroring @samp{ftp.gnu.org} can be found at @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 @@ origin in the work of the GNU Project. Terms such as ``Emacsen'' and ``(X)Emacs'' are not wrong, but they are not very clear, so it is better to write ``Emacs and XEmacs.'' -@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 @@ information is available from @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 @@ available at 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 @@ by @email{ramprasad@@gnu.org, Ramprasad B}, available at @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 @@ Java code. It is distributed with Emacs, but has @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 @@ Java code. It is distributed with Emacs, but has * 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 @@ VM was originally written by @uref{http://www.wonderworks.com/vm/,Kyle Jones}. 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 @@ Submissions to @email{auctex@@gnu.org} @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 @@ Release announcements: @email{bbdb-announce-request@@lists.sourceforge.net} @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 @@ Release announcements: @email{bbdb-announce-request@@lists.sourceforge.net} 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 @@ Help to develop Emacs/W3 at @email{w3-dev@@gnu.org} @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 @@ Help to develop Emacs/W3 at @email{w3-dev@@gnu.org} @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 @@ version 22.1. It is a modern interface to various PGP implementations, 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 @@ Receive announcements from @email{jde-announce-subscribe@@sunsite.dk} @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 @@ Receive announcements from @email{jde-announce-subscribe@@sunsite.dk} @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 @@ Receive announcements from @email{jde-announce-subscribe@@sunsite.dk} * 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 @@ can be bound to a key and thus treated as a macro. For example: @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 @@ of these forms before attempting to bind the key sequence: (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 @@ variable to this lambda function. For example, 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 @@ For information on what Emacs does every time it is started, see the 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 @@ return either a function key symbol or character sequence (see the 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 @@ The only way to affect the behavior of keys within Emacs is through @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 @@ smart enough to move it to another name). 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 @@ actually behaves. @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 @@ For more information about troubleshooting this problem, see @ref{DEL 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 @@ Good question! @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 @@ take place at the lowest level of input processing; the keys that are 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 @@ Often other aliases exist; use the @kbd{C-h c} command and try 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 @@ Emacs converts @kbd{M-a} internally into @kbd{@key{ESC} a} anyway 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 @@ generates @key{ESC}. If not, the following form can be used to bind it: (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 @@ VT220 clones could have their @key{Compose} key configured this way. If 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 @@ terminals. Non-@acronym{ASCII} keys and mouse events (e.g. @kbd{C-=} and @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 @@ You might have to replace @samp{Meta} with @samp{Alt}. @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 @@ xmodmap -e 'remove mod1 = Mode_switch' 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 @@ You can get the old behavior by binding @kbd{SPC} to @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 @@ You can get the old behavior by binding @kbd{SPC} to * 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 @@ systems, such as MS-DOS and MS-Windows, Emacs queries the OS about the 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 @@ Various methods are available for input of eight-bit characters. See 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 @@ Emacs 20 and later includes many of the features of MULE, the MULtilingual 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 @@ You might also try querying @code{archie} for files named with @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 @@ fontset, or you can select it by setting the default font in your @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 @@ fontset, or you can select it by setting the default font in your * 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 @@ To prevent Emacs from including various headers of the replied-to 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 @@ components file. 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 @@ expansion by moving point to the end of the alias and typing @kbd{C-x a e} (@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 @@ expansion by moving point to the end of the alias and typing @kbd{C-x a e} 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 @@ Other systems use the @code{flock} system call to interlock access. On 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 @@ best fix I've been able to come up with: (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 @@ Version 6.x of VM supports MIME. @xref{VM}. Gnus supports MIME in mail 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 @@ from your @file{.emacs} file. This would cause problems if you needed to run 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 @@ you to start Emacs quickly when you needed to. 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 @@ version number in the welcome message. Type @kbd{quit} to get out. @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 @@ automatically via (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 @@ automatically via 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 @@ following settings: @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 @@ In the @file{*Newsgroup*} buffer, type @kbd{M-< C-x ( c y C-x ) M-0 C-x e} 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 @@ this: (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 @@ this: 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 @@ folks have sped up @code{inews}, too, so speed should look better to 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 @@ most folks as that update propagates around. 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 -- 2.39.2