Mercurial > emacs

--- a/man/faq.texi	Sat Jan 25 08:09:16 2003 +0000
+++ b/man/faq.texi	Sat Jan 25 10:29:29 2003 +0000
@@ -62,19 +62,19 @@
 @email{emacs-faq@@lerner.co.il, the FAQ maintainers}.

 @menu
-* FAQ notation::
-* General questions::
-* Getting help::
-* Status of Emacs::
-* Common requests::
-* Bugs and problems::
-* Compiling and installing Emacs::
-* Finding Emacs and related packages::
-* Major packages and programs::
-* Key bindings::
-* Alternate character sets::
-* Mail and news::
-* Concept index::
+* FAQ notation::
+* General questions::
+* Getting help::
+* Status of Emacs::
+* Common requests::
+* Bugs and problems::
+* Compiling and installing Emacs::
+* Finding Emacs and related packages::
+* Major packages and programs::
+* Key bindings::
+* Alternate character sets::
+* Mail and news::
+* Concept index::
 @end menu

 @c ------------------------------------------------------------
@@ -88,11 +88,11 @@
 used in the FAQ.

 @menu
-* Basic keys::
-* Extended commands::
-* On-line manual::
-* File-name conventions::
-* Common acronyms::
+* Basic keys::
+* Extended commands::
+* On-line manual::
+* File-name conventions::
+* Common acronyms::
 @end menu

 @node Basic keys, Extended commands, FAQ notation, FAQ notation
@@ -323,13 +323,13 @@
 Free Software Foundation, and related organizations.

 @menu
-* The LPF::
-* Real meaning of copyleft::
-* Guidelines for newsgroup postings::
-* Newsgroup archives::
-* Reporting bugs::
-* Unsubscribing from Emacs lists::
-* Contacting the FSF::
+* The LPF::
+* Real meaning of copyleft::
+* Guidelines for newsgroup postings::
+* Newsgroup archives::
+* Reporting bugs::
+* Unsubscribing from Emacs lists::
+* Contacting the FSF::
 @end menu

 @node The LPF, Real meaning of copyleft, General questions, General questions
@@ -535,16 +535,16 @@
 This chapter tells you how to get help with Emacs

 @menu
-* Basic editing::
-* Learning how to do something::
-* Getting a printed manual::
-* Emacs Lisp documentation::
-* Installing Texinfo documentation::
-* Printing a Texinfo file::
-* Viewing Info files outside of Emacs::
-* Informational files for Emacs::
-* Help installing Emacs::
-* Obtaining the FAQ::
+* Basic editing::
+* Learning how to do something::
+* Getting a printed manual::
+* Emacs Lisp documentation::
+* Installing Texinfo documentation::
+* Printing a Texinfo file::
+* Viewing Info files outside of Emacs::
+* Informational files for Emacs::
+* Help installing Emacs::
+* Obtaining the FAQ::
 @end menu

 @node Basic editing, Learning how to do something, Getting help, Getting help
@@ -766,7 +766,7 @@
 * Topic: (relative-pathname).  Short description of topic.
 @end example

-@end enumerate
+@end enumerate

 If you want to install Info files and you don't have the necessary
 privileges, you have several options:
@@ -1065,10 +1065,10 @@
 latest version status.

 @menu
-* Origin of the term Emacs::
-* Latest version of Emacs::
-* New in Emacs 20::
-* New in Emacs 21::
+* Origin of the term Emacs::
+* Latest version of Emacs::
+* New in Emacs 20::
+* New in Emacs 21::
 @end menu

 @node Origin of the term Emacs, Latest version of Emacs, Status of Emacs, Status of Emacs
@@ -1160,55 +1160,55 @@
 @cindex Common requests

 @menu
-* Setting up a customization file::
-* Debugging a customization file::
-* Colors on a TTY::
-* Displaying the current line or column::
-* Displaying the current file name in the titlebar::
-* Turning on abbrevs by default::
-* Turning on auto-fill by default::
-* Associating modes with files::
-* Working with unprintable characters::
-* Highlighting a region::
-* Controlling case sensitivity::
-* Wrapping words automatically::
-* Spell-checkers::
-* Checking TeX and *roff documents::
-* Changing load-path::
-* Using an already running Emacs process::
-* Compiler error messages::
-* Indenting switch statements::
-* Customizing C and C++ indentation::
-* Horizontal scrolling::
-* Overwrite mode::
-* Turning off beeping::
-* Turning the volume down::
-* Automatic indentation::
-* Matching parentheses::
-* Hiding #ifdef lines::
-* Repeating commands::
-* Valid X resources::
-* Evaluating Emacs Lisp code::
-* Changing the length of a Tab::
-* Inserting > at the beginning of each line::
-* Underlining paragraphs::
-* Repeating a command as many times as possible::
-* Forcing the cursor to remain in the same column::
-* Forcing Emacs to iconify itself::
-* Using regular expressions::
-* Replacing text across multiple files::
-* Documentation for etags::
-* Disabling backups::
-* Disabling auto-save-mode::
-* Going to a line by number::
-* Modifying pull-down menus::
-* Deleting menus and menu options::
-* Turning on syntax highlighting::
-* Scrolling only one line::
-* Replacing highlighted text::
-* Editing MS-DOS files::
-* Filling paragraphs with a single space::
-* Escape sequences in shell output::
+* Setting up a customization file::
+* Debugging a customization file::
+* Colors on a TTY::
+* Displaying the current line or column::
+* Displaying the current file name in the titlebar::
+* Turning on abbrevs by default::
+* Turning on auto-fill by default::
+* Associating modes with files::
+* Working with unprintable characters::
+* Highlighting a region::
+* Controlling case sensitivity::
+* Wrapping words automatically::
+* Spell-checkers::
+* Checking TeX and *roff documents::
+* Changing load-path::
+* Using an already running Emacs process::
+* Compiler error messages::
+* Indenting switch statements::
+* Customizing C and C++ indentation::
+* Horizontal scrolling::
+* Overwrite mode::
+* Turning off beeping::
+* Turning the volume down::
+* Automatic indentation::
+* Matching parentheses::
+* Hiding #ifdef lines::
+* Repeating commands::
+* Valid X resources::
+* Evaluating Emacs Lisp code::
+* Changing the length of a Tab::
+* Inserting > at the beginning of each line::
+* Underlining paragraphs::
+* Repeating a command as many times as possible::
+* Forcing the cursor to remain in the same column::
+* Forcing Emacs to iconify itself::
+* Using regular expressions::
+* Replacing text across multiple files::
+* Documentation for etags::
+* Disabling backups::
+* Disabling auto-save-mode::
+* Going to a line by number::
+* Modifying pull-down menus::
+* Deleting menus and menu options::
+* Turning on syntax highlighting::
+* Scrolling only one line::
+* Replacing highlighted text::
+* Editing MS-DOS files::
+* Filling paragraphs with a single space::
+* Escape sequences in shell output::
 @end menu

 @node Setting up a customization file, Colors on a TTY, Common requests, Common requests
@@ -1307,7 +1307,7 @@
 @kbd{M-x column-number-mode}, or by putting the form

 @lisp
-(setq column-number-mode t)
+(setq column-number-mode t)
 @end lisp

 @noindent
@@ -1612,7 +1612,7 @@
 When this is done, Emacs creates a Unix domain socket.
 The socket is either named @file{.emacs_server}, in the user's home directory,
 or @file{esrv-@var{userid}-@var{systemname}}, in the @file{/tmp}
-directory, depending on your system.  See @var{server-socket-name}.
+directory, depending on your system.  See @code{server-socket-name}.

 To get your news reader, mail reader, etc., to invoke
 @samp{emacsclient}, try setting the environment variable @code{EDITOR}
@@ -1625,7 +1625,7 @@
 setenv EDITOR emacsclient

 # using full pathname
-setenv EDITOR /usr/local/emacs/etc/emacsclient
+setenv EDITOR /usr/local/emacs/etc/emacsclient

 # sh command:
 EDITOR=emacsclient ; export EDITOR
@@ -1830,7 +1830,7 @@
 the documentation, available by typing @kbd{C-h f hscroll-mode @key{RET}}:

 Automatically scroll horizontally when the point moves off the
-left or right edge of the window.
+left or right edge of the window.

 @itemize @minus
 @item
@@ -1848,7 +1848,7 @@

 @item
 @code{hscroll-margin} controls how close the cursor can get to the
-edge of the window.
+edge of the window.

 @item
 @code{hscroll-step-percent} controls how far to jump once we decide to do so.
@@ -1882,7 +1882,7 @@
 (assuming you have one):

 @example
-... :vb=: ...
+... :vb=: ...
 @end example

 And evaluate the following Lisp form:
@@ -2115,7 +2115,7 @@
 @section How do I change Emacs's idea of the @key{TAB} character's length?
 @cindex Tab length
 @cindex Length of tab character
-@cindex @code{default-tab-width}
+@cindex @code{default-tab-width}

 Set the variable @code{default-tab-width}.  For example, to set
 @key{TAB} stops every 10 characters, insert the following in your
@@ -2368,8 +2368,8 @@
 item to the @samp{Edit} menu thus requires the following Lisp code:

 @lisp
-(define-key global-map
-  [menu-bar edit forward]
+(define-key global-map
+  [menu-bar edit forward]
   '("Forward word" . forward-word))
 @end lisp

@@ -2685,21 +2685,21 @@
 type @kbd{C-h P} to read it.

 @menu
-* Problems with very large files::
-* ^M in the shell buffer::
-* Shell process exits abnormally::
-* Problems with Shell Mode on MS-Windows::
-* Termcap/Terminfo entries for Emacs::
-* Spontaneous entry into isearch-mode::
-* Problems talking to certain hosts::
-* Errors with init files::
-* Emacs ignores X resources::
-* Emacs ignores frame parameters::
-* Emacs takes a long time to visit files::
-* Editing files with $ in the name::
-* Shell mode loses the current directory::
-* Security risks with Emacs::
-* Dired claims that no file is on this line::
+* Problems with very large files::
+* ^M in the shell buffer::
+* Shell process exits abnormally::
+* Problems with Shell Mode on MS-Windows::
+* Termcap/Terminfo entries for Emacs::
+* Spontaneous entry into isearch-mode::
+* Problems talking to certain hosts::
+* Errors with init files::
+* Emacs ignores X resources::
+* Emacs ignores frame parameters::
+* Emacs takes a long time to visit files::
+* Editing files with $ in the name::
+* Shell mode loses the current directory::
+* Security risks with Emacs::
+* 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
@@ -3000,7 +3000,7 @@

 @item @code{XFILESEARCHPATH}
 @item @code{XUSERFILESEARCHPATH}
-@item @code{XAPPLRESDIR}
+@item @code{XAPPLRESDIR}

 @end itemize

@@ -3021,7 +3021,7 @@
 @item
 then in the value of the @samp{XENVIRONMENT} environment variable,

-@itemize @minus
+@itemize @minus

 @item
 or if that is unset, in the file named
@@ -3050,13 +3050,13 @@
 @item
 or in files named @file{@var{lang}/Emacs} in directories listed in
 @samp{XAPPLRESDIR} (where @var{lang} is the value of the @code{LANG}
-environment variable), if the @samp{LANG} environment variable is set,
+environment variable), if the @samp{LANG} environment variable is set,
 @item
 or in files named Emacs in the directories listed in @samp{XAPPLRESDIR}
 @item
 or in @file{~/@var{lang}/Emacs} (if the @code{LANG} environment variable
 is set),
-@item
+@item
 or in @file{~/Emacs},

 @end itemize
@@ -3261,10 +3261,10 @@
 @cindex    Compiling and installing Emacs

 @menu
-* Installing Emacs::
-* Updating Emacs::
-* Problems building Emacs::
-* Linking with -lX11 fails::
+* Installing Emacs::
+* Updating Emacs::
+* Problems building Emacs::
+* Linking with -lX11 fails::
 @end menu

 @node Installing Emacs, Updating Emacs, Compiling and installing Emacs, Compiling and installing Emacs
@@ -3320,7 +3320,7 @@
 @code{gunzip} has finished doing its job, a file by the name of
 @file{emacs-@value{VER}.tar} should be in your build directory.

-@item
+@item
 @code{tar}, the @dfn{tape archiving} program, which moves multiple files
 into and out of archive files, or @dfn{tarfiles}.  All of the files
 comprising the Emacs source come in a single tarfile, and must be
@@ -3358,8 +3358,8 @@

 @example
 cd emacs-@value{VER}       # change directory to emacs-@value{VER}
-./configure         # configure Emacs for your particular system
-make                # use Makefile to build components, then Emacs
+./configure         # configure Emacs for your particular system
+make                # use Makefile to build components, then Emacs
 @end example

 If the @code{make} completes successfully, the odds are fairly good that
@@ -3467,22 +3467,22 @@
 @cindex Finding Emacs and related packages

 @menu
-* Finding Emacs on the Internet::
-* Finding a package with particular functionality::
-* Packages that do not come with Emacs::
-* Submitting to the Emacs Lisp Archive::
-* Current GNU distributions::
-* Difference between Emacs and XEmacs::
-* Emacs for MS-DOS::
-* Emacs for Windows::
-* Emacs for OS/2::
-* Emacs for Atari ST::
-* Emacs for the Amiga ::
-* Emacs for NeXTSTEP::
-* Emacs for Apple computers::
-* Emacs for VMS and DECwindows::
-* Modes for various languages::
-* Translating names to IP addresses::
+* Finding Emacs on the Internet::
+* Finding a package with particular functionality::
+* Packages that do not come with Emacs::
+* Submitting to the Emacs Lisp Archive::
+* Current GNU distributions::
+* Difference between Emacs and XEmacs::
+* Emacs for MS-DOS::
+* Emacs for Windows::
+* Emacs for OS/2::
+* Emacs for Atari ST::
+* Emacs for the Amiga ::
+* Emacs for NeXTSTEP::
+* Emacs for Apple computers::
+* Emacs for VMS and DECwindows::
+* Modes for various languages::
+* Translating names to IP addresses::
 @end menu

 @node Finding Emacs on the Internet, Finding a package with particular functionality, Finding Emacs and related packages, Finding Emacs and related packages
@@ -3490,7 +3490,7 @@
 @cindex Finding Emacs on the Internet
 @cindex Snail mail, ordering Emacs via
 @cindex Postal service, ordering Emacs via
-@cindex Distribution, retrieving Emacs
+@cindex Distribution, retrieving Emacs
 @cindex Internet, retrieving from

 Look in the files @file{etc/DISTRIB} and @file{etc/FTP} for information
@@ -3506,7 +3506,7 @@
 @section How do I find a Emacs Lisp package that does XXX?
 @cindex Package, finding
 @cindex Finding an Emacs Lisp package
-@cindex Functionality, finding a particular package
+@cindex Functionality, finding a particular package

 First of all, you should check to make sure that the package isn't
 already available.  For example, typing @kbd{M-x apropos @key{RET}
@@ -3923,8 +3923,8 @@

 @example
 To: dns@@[134.214.84.25]    (to grasp.insa-lyon.fr)
-Body: ip XXX.YYY.ZZZ        (or "help" for more information
-                             and options - no quotes)
+Body: ip XXX.YYY.ZZZ        (or "help" for more information
+                             and options - no quotes)
 @end example

 @noindent
@@ -3941,18 +3941,18 @@
 @cindex Major packages and programs

 @menu
-* VM::
-* Supercite::
-* Calc::
-* VIPER::
-* AUC-TeX::
-* BBDB::
-* Ispell::
-* w3-mode::
-* EDB::
-* Mailcrypt::
-* JDE::
-* Patch::
+* VM::
+* Supercite::
+* Calc::
+* VIPER::
+* AUC-TeX::
+* BBDB::
+* Ispell::
+* w3-mode::
+* EDB::
+* Mailcrypt::
+* JDE::
+* Patch::
 @end menu

 @node VM, Supercite, Major packages and programs, Major packages and programs
@@ -4281,24 +4281,24 @@
 @cindex Key bindings

 @menu
-* Binding keys to commands::
-* Invalid prefix characters::
-* Terminal setup code works after Emacs has begun::
-* Using function keys under X::
-* Working with function and arrow keys::
-* X key translations for Emacs::
-* Handling C-s and C-q with flow control::
-* Binding C-s and C-q::
-* Backspace invokes help::
-* stty and Backspace key::
-* Swapping keys::
-* Producing C-XXX with the keyboard::
-* No Meta key::
-* No Escape key::
-* Compose Character::
-* Binding combinations of modifiers and function keys::
-* Meta key does not work in xterm::
-* ExtendChar key does not work as Meta::
+* Binding keys to commands::
+* Invalid prefix characters::
+* Terminal setup code works after Emacs has begun::
+* Using function keys under X::
+* Working with function and arrow keys::
+* X key translations for Emacs::
+* Handling C-s and C-q with flow control::
+* Binding C-s and C-q::
+* Backspace invokes help::
+* stty and Backspace key::
+* Swapping keys::
+* Producing C-XXX with the keyboard::
+* No Meta key::
+* No Escape key::
+* Compose Character::
+* Binding combinations of modifiers and function keys::
+* Meta key does not work in xterm::
+* ExtendChar key does not work as Meta::
 @end menu

 @node Binding keys to commands, Invalid prefix characters, Key bindings, Key bindings
@@ -4690,7 +4690,7 @@
 (global-set-key "\C-h" 'delete-backward-char)

 ;;; overrides mark-whole-buffer
-(global-set-key "\C-xh" 'help-command)
+(global-set-key "\C-xh" 'help-command)
 @end lisp

 @noindent
@@ -4819,7 +4819,7 @@

 @lisp
 ;;; F11 is the documented ESC replacement on DEC terminals.
-(define-key function-key-map [f11] [?\e])
+(define-key function-key-map [f11] [?\e])
 @end lisp

 @node Compose Character, Binding combinations of modifiers and function keys, No Escape key, Key bindings
@@ -4971,10 +4971,10 @@
 @cindex Alternate character sets

 @menu
-* Emacs does not display 8-bit characters::
-* Inputting eight-bit characters::
-* Kanji and Chinese characters::
-* Right-to-left alphabets::
+* Emacs does not display 8-bit characters::
+* Inputting eight-bit characters::
+* Kanji and Chinese characters::
+* Right-to-left alphabets::
 @end menu

 @node Emacs does not display 8-bit characters, Inputting eight-bit characters, Alternate character sets, Alternate character sets
@@ -5043,27 +5043,27 @@
 @cindex Mail and news

 @menu
-* Changing the included text prefix::
-* Saving a copy of outgoing mail::
-* Expanding aliases when sending mail::
-* Rmail thinks all messages are one big one::
-* Sorting the messages in an Rmail folder::
-* Rmail writes to /usr/spool/mail::
-* Recovering mail files when Rmail munges them::
-* Replying to the sender of a message::
-* MIME with Emacs mail packages::
-* Automatically starting a mail or news reader::
-* Reading news with Emacs::
-* Gnus does not work with NNTP::
-* Viewing articles with embedded underlining::
-* Saving a multi-part Gnus posting::
-* Starting Gnus faster::
-* Catching up in all newsgroups::
-* Killing based on nonstandard headers::
-* Removing flashing messages::
-* Catch-up is slow in Gnus::
-* Gnus hangs for a long time::
-* Learning more about Gnus::
+* Changing the included text prefix::
+* Saving a copy of outgoing mail::
+* Expanding aliases when sending mail::
+* Rmail thinks all messages are one big one::
+* Sorting the messages in an Rmail folder::
+* Rmail writes to /usr/spool/mail::
+* Recovering mail files when Rmail munges them::
+* Replying to the sender of a message::
+* MIME with Emacs mail packages::
+* Automatically starting a mail or news reader::
+* Reading news with Emacs::
+* Gnus does not work with NNTP::
+* Viewing articles with embedded underlining::
+* Saving a multi-part Gnus posting::
+* Starting Gnus faster::
+* Catching up in all newsgroups::
+* Killing based on nonstandard headers::
+* Removing flashing messages::
+* Catch-up is slow in Gnus::
+* Gnus hangs for a long time::
+* Learning more about Gnus::
 @end menu

 @node Changing the included text prefix, Saving a copy of outgoing mail, Mail and news, Mail and news
@@ -5262,7 +5262,7 @@
 @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
-@section How can I get my favorite Emacs mail package to support MIME?
+@section How can I get my favorite Emacs mail package to support MIME?
 @cindex MIME and Emacs mail packages
 @cindex Mail packages and MIME
 @cindex FAQ for MIME and Emacs