@c This is used in many places
@set VER 21.3
-@c The @ifinfo stuff only appears in the Info version
-@ifinfo
-@dircategory Emacs
-@direntry
-* Emacs FAQ: (efaq). Frequently Asked Questions about Emacs.
-@end direntry
-
-Copyright 2001, 2002 Free Software Foundation, Inc.
+@copying
+Copyright 2001, 2002, 2003 Free Software Foundation, Inc.
Copyright 1994,1995,1996,1997,1998,1999,2000 Reuven M. Lerner@*
Copyright 1992,1993 Steven Byrnes@*
Copyright 1990,1991,1992 Joseph Brian Wells@*
+@quotation
This list of frequently asked questions about GNU Emacs with answers
("FAQ") may be translated into other languages, transformed into other
formats (e.g. Texinfo, Info, WWW, WAIS), and updated with new information.
[This version has been somewhat edited from the last-posted version
(as of August 1999) for inclusion in the Emacs distribution.]
+@end quotation
+@end copying
-@end ifinfo
+@dircategory Emacs
+@direntry
+* Emacs FAQ: (efaq). Frequently Asked Questions about Emacs.
+@end direntry
@c The @titlepage stuff only appears in the printed version
@titlepage
@c The following two commands start the copyright page.
@page
@vskip 0pt plus 1filll
-Copyright @copyright{} 2001,2002 Free Software Foundation, inc.@*
-Copyright @copyright{} 1994,1995,1996,1997,1998,1999,2000 Reuven M. Lerner@*
-Copyright @copyright{} 1992,1993 Steven Byrnes@*
-Copyright @copyright{} 1990,1991,1992 Joseph Brian Wells@*
-
-This list of frequently asked questions about GNU Emacs with answers
-("FAQ") may be translated into other languages, transformed into other
-formats (e.g. Texinfo, Info, WWW, WAIS), and updated with new information.
-
-The same conditions apply to any derivative of the FAQ as apply to the FAQ
-itself. Every copy of the FAQ must include this notice or an approved
-translation, information on who is currently maintaining the FAQ and how to
-contact them (including their e-mail address), and information on where the
-latest version of the FAQ is archived (including FTP information).
-
-The FAQ may be copied and redistributed under these conditions, except that
-the FAQ may not be embedded in a larger literary work unless that work
-itself allows free copying and redistribution.
-
-[This version has been somewhat edited from the last-posted version
-(as of August 1999) for inclusion in the Emacs distribution.]
+@insertcopying
@end titlepage
@node Top, FAQ notation, (dir), (dir)
The FAQ is maintained as a Texinfo document, allowing us to create HTML,
Info, and TeX documents from a single source file, and is slowly but
surely being improved. Please bear with us as we improve on this
-format. If you have any suggestions or questions, please contact
-@email{emacs-faq@@lerner.co.il, the FAQ maintainers}.
+format. This FAQ is maintained as a part of GNU Emacs. If you find
+any errors, or have any suggestions, please use @kbd{M-x report-emacs-bug}
+to report them.
@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 ------------------------------------------------------------
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
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
The archive is at @uref{ftp://ftp-mailing-list-archives.gnu.org}.
-As of this writing, the archives are not yet working.
+The archive can be browsed over the web at
+@uref{http://mail.gnu.org/archive/html/, the GNU mail archive}.
Web-based Usenet search services, such as
-@uref{http://www.dejanews.com, DejaNews}, also archive the
+@uref{http://groups.google.com, Google}, also archive the
@code{gnu.*} groups.
@node Reporting bugs, Unsubscribing from Emacs lists, Newsgroup archives, General questions
@cindex Ordering GNU software
For details on how to order items directly from the FSF, see the
-@uref{http://www.gnu.org/order/order.html, GNU Web site}, and also the
-files @file{etc/ORDERS}, @file{ORDERS.EUROPE}, and @file{ORDERS.JAPAN}.
+@uref{http://www.gnu.org/order/order.html, GNU Web site}.
@c ------------------------------------------------------------
@node Getting help, Status of Emacs, General questions, Top
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
@cindex Emacs manual, obtaining a printed or HTML copy of
You can order a printed copy of the Emacs manual from the FSF. For
-details see the @uref{http://www.gnu.org/order/order.html, GNU Web site}
-and the file @file{etc/ORDERS}.
+details see the @uref{http://www.gnu.org/order/order.html, GNU Web site}.
@c The number 620 below is version-dependent!
The full Texinfo source for the manual also comes in the @file{man}
For more information, obtain the Emacs Lisp Reference Manual. Details
on ordering it from FSF are on the
-@uref{http://www.gnu.org/order/order.html, GNU Web site} and in the file
-@file{etc/ORDERS}.
+@uref{http://www.gnu.org/order/order.html, GNU Web site}.
The Emacs Lisp Reference Manual is also available on-line, in Info
format. Texinfo source for the manual (along with pregenerated Info
* 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:
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
@cindex Toolbar support
Emacs 21 features a thorough rewrite of the display engine. The new
display engine supports variable-size fonts, images, and can play sounds
-on platforms which support that. As a result, the visual appearence of
+on platforms which support that. As a result, the visual appearance of
Emacs, when it runs on a windowed display, is much more reminiscent of
modern GUI programs, and includes 3D widgets (used for the mode line and
the scroll bars), a configurable and extensible toolbar, tooltips
@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
@section How do I set up a @file{.emacs} file properly?
@cindex @file{.emacs} file, setting up
+@cindex @file{.emacs} file, locating
@cindex Init file, setting up
@cindex Customization file, setting up
-@inforef{Init File, Init File, emacs}
+@inforef{Init File, Init File, emacs}.
In general, new Emacs users should not have @file{.emacs} files, because
it causes confusing non-standard behavior. Then they send questions to
rather completely in @inforef{Init File, Init File, emacs}, for users
interested in performing frequently requested, basic tasks.
+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 Colors on a TTY, Debugging a customization file, Setting up a customization file, Common requests
@section How do I get colors and syntax highlighting on a TTY?
@cindex Colors on a TTY
@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
@cindex Set number capability in @code{vi} emulators
None of the @code{vi} emulation modes provide the ``set number''
-capability of @code{vi} (as far as we know).
+capability of @code{vi} (as far as we know). The @samp{setnu} package
+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
@section How can I modify the titlebar to contain the current file name?
(if (@var{some conditions are met}) (server-start))
@end lisp
-When this is done, Emacs starts a subprocess running a program called
-@samp{emacsserver}. @samp{emacsserver} creates a Unix domain socket.
+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 how @samp{emacsserver} was compiled.
+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}
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
@cindex @code{gnuserv}
There is an enhanced version of @samp{emacsclient}/server called
@samp{gnuserv}, written by @email{ange@@hplb.hpl.hp.com, Andy Norman}
-which is available in the Emacs Lisp Archive (@pxref{Packages that do
-not come with Emacs}). @samp{gnuserv} uses Internet domain sockets, so
-it can work across most network connections. It also supports the
-execution of arbitrary Emacs Lisp forms and does not require the client
-program to wait for completion.
+(@pxref{Packages that do not come with Emacs}). @samp{gnuserv} uses
+Internet domain sockets, so it can work across most network connections.
+It also supports the execution of arbitrary Emacs Lisp forms and does
+not require the client program to wait for completion.
The alpha version of an enhanced @samp{gnuserv} is available at
@uref{ftp://ftp.wellfleet.com/netman/psmith/emacs/gnuserv-2.1alpha.tar.gz}
+The version available from @uref{http://meltin.net/hacks/emacs/} is
+more recent, and has been tested with Emacs 21.2.
+
@end itemize
@node Compiler error messages, Indenting switch statements, Using an already running Emacs process, Common requests
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
@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.
(assuming you have one):
@example
-... :vb=: ...
+... :vb=: ...
@end example
And evaluate the following Lisp form:
If you have paragraphs with different levels of indentation, you will
have to set the fill prefix to the correct value each time you move to a
-new paragraph. To avoid this hassle, try one of the many packages
-available from the Emacs Lisp Archive (@pxref{Packages that do not come
-with Emacs}.) Look up ``fill'' and ``indent'' in the Lisp Code
-Directory for guidance.
+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
@section How do I show which parenthesis matches the one I'm looking at?
@cindex Selectively displaying @code{#ifdef} code
@kbd{M-x hide-ifdef-mode}. (This is a minor mode.) You might also want
-to try @file{cpp.el}, available at the Emacs Lisp Archive
-(@pxref{Packages that do not come with Emacs}).
+to investigate @file{cpp.el}, which is distributed with Emacs.
@node Repeating commands, Valid X resources, Hiding #ifdef lines, Common requests
@section Is there an equivalent to the @code{.} (dot) command of vi?
@cindex X resources
@cindex Setting X resources
-@inforef{Resources X, Resources X, emacs}.
+@inforef{X Resources, X Resources, emacs}.
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
@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
@cindex Suspending Emacs
@kbd{C-z} iconifies Emacs when running under X and suspends Emacs
-otherwise. @inforef{Misc X, Misc X, emacs}.
+otherwise. @inforef{Frame Commands, Frame Commands, emacs}.
@node Using regular expressions, Replacing text across multiple files, Forcing Emacs to iconify itself, Common requests
@section How do I use regexps (regular expressions) in Emacs?
longer between auto-saves, which might annoy you less.
You might also want to look into Sebastian Kremer's @code{auto-save}
-package, available from the Lisp Code Archive (@pxref{Packages that do not come
-with Emacs}). This
+package (@pxref{Packages that do not come with Emacs}). This
package also allows you to place all auto-save files in one directory,
such as @file{/tmp}.
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
@node Scrolling only one line, Replacing highlighted text, Turning on syntax highlighting, Common requests
@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 scrollng
+@cindex Reducing the increment when scrolling
Place the following Lisp form in your @file{.emacs} file:
@section How can I replace highlighted text with what I type?
@cindex @code{delete-selection-mode}
@cindex Replacing highlighted text
-@cindex Highlighing and replacing text
+@cindex Highlighting and replacing text
Use @code{delete-selection-mode}, which you can start automatically by
placing the following Lisp form in your @file{.emacs} file:
default, a backslash (@samp{\}) will appear in the mode line.
If you are running a version of Emacs before 20.1, get @code{crypt++}
-from the Emacs Lisp Archive (@pxref{Packages that do not come with
-Emacs}). Among other things, @code{crypt++} transparently modifies
-MS-DOS files as they are loaded and saved, allowing you to ignore the
-different conventions that Unix and MS-DOS have for delineating the end
-of a line.
+(@pxref{Packages that do not come with Emacs}). Among other things,
+@code{crypt++} transparently modifies MS-DOS files as they are loaded
+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
@section How can I tell Emacs to fill paragraphs with a single space after each period?
@end lisp
@node Escape sequences in shell output, , Filling paragraphs with a single space, Common requests
-@section Why do I get these strange escape sequences when I run
-@code{ls} from the Shell mode?
+@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
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
@item @code{XFILESEARCHPATH}
@item @code{XUSERFILESEARCHPATH}
-@item @code{XAPPLRESDIR}
+@item @code{XAPPLRESDIR}
@end itemize
@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
@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
with a shell metacharacter (@kbd{cd ../lib*}), Emacs will fail to
correctly guess the shell's new current directory. A huge variety of
fixes and enhancements to shell mode for this problem have been written
-to handle this problem. Check the Lisp Code Directory (@pxref{Finding a
-package with particular functionality}).
+to handle this problem (@pxref{Finding a package with particular
+functionality}).
You can tell Emacs the shell's current directory with the command
@kbd{M-x dirs}.
@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
@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
@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
@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::
+* 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
@cindex Finding Emacs on the Internet
@cindex Snail mail, ordering Emacs via
@cindex Postal service, ordering Emacs via
-@cindex Distribution, retrieving Emacs
-@cindex Internet, retreiving from
+@cindex Distribution, retrieving Emacs
+@cindex Internet, retrieving from
-Look in the files @file{etc/DISTRIB} and @file{etc/FTP} for information
-on nearby archive sites and @file{etc/ORDERS} for mail orders. If you
-don't already have Emacs, see @ref{Informational files for Emacs}, for how
-to get these files.
+Look in the files @file{etc/DISTRIB} and @file{etc/FTP} for
+information on nearby archive sites. If you don't already have Emacs,
+see @ref{Informational files for Emacs}, for how to get these files.
@xref{Installing Emacs}, for information on how to obtain and build the latest
version of Emacs, and see @ref{Current GNU distributions}, for a list of
@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}
modify a Lisp package, see if the author has provided any hints in the
source code.
-If a package does not come with Emacs, check the Lisp Code Directory.
-The LCD was originally maintained by @email{brennan@@hal.com, Dave
-Brennan}, but was recently taken over by @email{toby@@world.std.com,
-toby knudsen}, who maintains @uref{http://www.emacs.org}. The LCD is
-currently being reorganized and updated, but you can meanwhile find many
-packages at @uref{ftp://ftp.emacs.org/pub}.
+The command @kbd{C-h p} (@code{finder-by-keyword}) allows you to browse
+the constituent Emacs packages.
-For now, you can search through the LCD with @file{lispdir.el}, which is
-in the process of being updated. Download it from the LCD, in the
-@file{emacs-lisp-attic/misc} directory, and then evaluate the following
-Lisp form (@pxref{Evaluating Emacs Lisp code}):
+For advice on how to find extra packages that are not part of Emacs,
+see @ref{Packages that do not come with Emacs}.
-@lisp
-(setq lisp-code-directory
- "/anonymous@@ftp.emacs.org:pub/emacs-lisp-attic/emacs-lisp/LCD-datafile.gz"
- elisp-archive-host "ftp.emacs.org"
- elisp-archive-directory "/pub/emacs-lisp-attic/emacs-lisp/")
-@end lisp
-
-Once you have installed @file{lispdir.el}, you can use @kbd{M-x
-lisp-dir-apropos} to search the listing. For example, @kbd{M-x
-lisp-dir-apropos @key{RET} ange-ftp @key{RET}} produces this output:
-
-@example
- GNU Emacs Lisp Code Directory Apropos --- "ange-ftp"
-"~/" refers to archive.cis.ohio-state.edu:pub/elisp-archive/
-
- ange-ftp (4.18) 15-Jul-1992
- Andy Norman, <ange@@hplb.hpl.hp.com>
- ~/packages/ange-ftp.tar.Z
- transparent FTP Support for GNU Emacs
- auto-save (1.19) 01-May-1992
- Sebastian Kremer, <sk@@thp.uni-koeln.de>
- ~/misc/auto-save.el.Z
- Safer autosaving with support for ange-ftp and /tmp
- ftp-quik (1.0) 28-Jul-1993
- Terrence Brannon, <tb06@@pl122f.eecs.lehigh.edu>
- ~/modes/ftp-quik.el.Z
- Quik access to dired'ing of ange-ftp and normal paths
-@end example
-
-@node Packages that do not come with Emacs, Submitting to the Emacs Lisp Archive, Finding a package with particular functionality, Finding Emacs and related packages
+@node Packages that do not come with Emacs, Current GNU distributions, Finding a package with particular functionality, Finding Emacs and related packages
@section Where can I get Emacs Lisp packages that don't come with Emacs?
@cindex Unbundled packages
@cindex Finding other packages
@cindex Lisp packages that do not come with Emacs
@cindex Packages, those that do not come with Emacs
-@cindex Emacs Lisp Archive, description of
-@cindex Archive, description of the Emacs Lisp
+@cindex Emacs Lisp List
+@cindex Emacs Lisp Archive
-First, check the Lisp Code Directory to find the name of the package you
-are looking for (@pxref{Finding a package with particular
-functionality}). Next, check local archives and the Emacs Lisp Archive
-to find a copy of the relevant files. If you still haven't found it,
-you can send e-mail to the author asking for a copy. If you find Emacs
-Lisp code that doesn't appear in the LCD, please submit a copy to the
-LCD (@pxref{Submitting to the Emacs Lisp Archive}).
+@uref{http://www.anc.ed.ac.uk/~stephen/emacs/ell.html, The Emacs Lisp
+List (ELL)}, maintained by @email{stephen@@anc.ed.ac.uk, Stephen Eglen},
+aims to provide one compact list with links to all of the current Emacs
+lisp files on the internet. The ELL can be browsed over the web, or
+from Emacs with @uref{http://www.anc.ed.ac.uk/~stephen/emacs/ell.el,
+the @file{ell} package}.
-You can access the Emacs Lisp Archive at
+Many authors post their packages to the @uref{news:gnu.emacs.sources,
+Emacs sources newsgroup}. You can search the archives of this
+group with @uref{http://groups.google.com, Google}, for example.
-@uref{ftp://archive.cis.ohio-state.edu/pub/emacs-lisp/}
+Several packages are stored in
+@uref{http://emacswiki.org/elisp/, the Lisp area of the Emacs Wiki}.
-@noindent
-or at
+For a long time, the Emacs Lisp Archive provided a central repository
+for Emacs packages. Sadly, it has not been active for some time,
+although you can still access the old files at
-@uref{http://www.cis.ohio-state.edu/emacs-lisp}
+@uref{ftp://ftp.cis.ohio-state.edu/pub/emacs-lisp/WWW/index.html}
-@noindent
-Retrieve and read the file @file{README} first.
-
-@itemize @bullet
-
-@item
-The archive maintainers do not have time to answer individual
-requests for packages or the list of packages in the archive. If you
-cannot use FTP or UUCP to access the archive yourself, try to find a
-friend who can, but please don't ask the maintainers.
-
-@item
-Any files with names ending in @file{.Z}, @file{.z}, or @file{.gz} are
-compressed, so you should use "binary" mode in FTP to retrieve them.
-You should also use binary mode whenever you retrieve any files with
-names ending in @file{.elc}.
-
-@end itemize
-
-@node Submitting to the Emacs Lisp Archive, Current GNU distributions, Packages that do not come with Emacs, Finding Emacs and related packages
-@section How do I submit code to the Emacs Lisp Archive?
-@cindex Submitting code to the Emacs Lisp Archive
-@cindex Emacs Lisp Archive, submissions to
-@cindex Lisp Archive, submissions to
-@cindex Archive, submitting to the Emacs Lisp
-
-Guidelines and procedures for submission to the archive can be found in
-the file @file{GUIDELINES} in the archive directory (@pxref{Packages that
-do not come with Emacs}). It covers documentation, copyrights,
-packaging, submission, and the Lisp Code Directory Record. Anonymous
-FTP uploads are not permitted. Instead, all submissions are mailed to
-@email{elisp-archive@@cis.ohio-state.edu}. The @file{lispdir.el}
-package has a function named @code{submit-lcd-entry} which will help you
-with this.
-
-@node Current GNU distributions, Difference between Emacs and XEmacs, Submitting to the Emacs Lisp Archive, Finding Emacs and related packages
+@node Current GNU distributions, Difference between Emacs and XEmacs, Packages that do not come with Emacs, Finding Emacs and related packages
@section Where can I get other up-to-date GNU stuff?
@cindex Current GNU distributions
@cindex Sources for current GNU distributions
and more features can be expected in the future, but there are still many
differences between the two.
-The latest stable branch of XEmacs as of this writing is 21.1; you can
+The latest stable branch of XEmacs as of this writing is 21.4; you can
get it at
-@uref{ftp://ftp.xemacs.org/pub/xemacs/xemacs-21.1.14.tar.gz}
+@uref{ftp://ftp.xemacs.org/pub/xemacs/xemacs-21.4/xemacs-21.4.12.tar.gz}
More information about XEmacs, including a list of frequently asked
questions (FAQ), is available at
Windows 9X, Windows ME, and Windows 2000. More information is available
from
-@uref{http://www.simtel.net/pub/gnu/djgpp/v2gnu/emacs.README}
+@uref{http://www.simtel.net/pub/djgpp/v2gnu/emacs.README}
The binary itself is available in the files @file{em*.zip} in the
directory
-@uref{http://www.simtel.net/pub/gnu/djgpp/v2gnu/}
+@uref{http://www.simtel.net/pub/djgpp/v2gnu/}
If you prefer to compile Emacs for yourself, you can do so with the
current distribution directly. You will need a 386 (or
16-bit utilities can be found in GNUish, at
-@uref{http://www.simtel.net/pub/gnu/gnuish}
+@uref{http://www.simtel.net/pub/gnuish/}
@noindent
(@code{mv} and @code{rm} are in the Fileutils package, @code{sed} and
@cindex @code{cc-mode}
Most of these modes are now available in standard Emacs distribution.
-To get additional modes, look in the Lisp Code Directory (@pxref{Finding
-a package with particular functionality}). For C@t{++}, if you use
-@code{lisp-dir-apropos}, you must specify the pattern with something
-like @kbd{M-x lisp-dir-apropos @key{RET} c\+\+ @key{RET}}.@footnote{
-The backslashes in @samp{\+\+} are required because @kbd{M-x
-lisp-dir-apropos} expects a regular expression as its argument
-(@pxref{Using regular expressions}), and @samp{+} has a special meaning
-in regular expressions.}
+To get additional modes, see @ref{Finding a package with particular
+functionality}.
Barry Warsaw's @code{cc-mode} now works for C, C@t{++}, Objective-C, and
-Java code. You can get the latest version from the Emacs Lisp Archive;
-@pxref{Packages that do not come with Emacs} for details. A FAQ for
-@code{cc-mode} is available at
-@uref{http://www.python.org/emacs/cc-mode/}.
+Java code. It is distributed with Emacs, but has
+@uref{http://cc-mode.sourceforge.net/, its own homepage}.
@node Translating names to IP addresses, , Modes for various languages, Finding Emacs and related packages
@section What is the IP address of XXX.YYY.ZZZ?
@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
@cindex Major packages and programs
@menu
-* VM::
-* Supercite::
-* Calc::
-* VIPER::
-* AUC-TeX::
-* BBDB::
-* Ispell::
-* w3-mode::
-* EDB::
-* Mailcrypt::
-* JDE::
-* Patch::
+* VM::
+* Supercite::
+* Calc::
+* VIPER::
+* AUCTeX::
+* BBDB::
+* Ispell::
+* w3-mode::
+* EDB::
+* Mailcrypt::
+* JDE::
+* Patch::
@end menu
@node VM, Supercite, Major packages and programs, Major packages and programs
@table @b
@item Author
-@email{kyle@@uunet.uu.net, Kyle Jones}
+@email{kyle_jones@@wonderworks.com, Kyle Jones}
@item Latest version
-6.72
+7.15
@item Distribution
@uref{ftp://ftp.wonderworks.com/pub/vm/vm.tar.gz}
-@item Informational newsgroup/mailing list
+@item Informational newsgroup
@uref{news:gnu.emacs.vm.info}@*
-Subscription requests to @email{info-vm-request@@uunet.uu.net}@*
-Submissions to @email{info-vm@@uunet.uu.net}
-@item Bug reports newsgroup/mailing list
+@item Bug reports newsgroup
@uref{news:gnu.emacs.vm.bug}@*
-Subscription requests to @email{bug-vm-request@@uunet.uu.net}@*
-Submissions to @email{bug-vm@@uunet.uu.net}
+Or send reports to @email{bug-vm@@wonderworks.com}
@end table
-VM 6 works with Emacs 20.4, and may cause problems with Emacs 20.3 and
-below. (But note that many people seem to use Emacs 20.3 with VM 6,
-without any problems.) Risk-averse users might wish to try VM 5.97,
-available from @uref{ftp://ftp.wonderworks.com/pub/vm/, the same FTP
-site}.
+VM 7 works well with Emacs 21. Older versions of VM suitable for use
+with older versions of Emacs are available from
+@uref{ftp://ftp.wonderworks.com/pub/vm/, the same FTP site}.
+
@node Supercite, Calc, VM, Major packages and programs
@section Supercite --- mail and news citation package within Emacs
@table @b
@item Author
-@email{bwarsaw@@cen.com, Barry Warsaw}
+@email{barry@@python.org, Barry Warsaw}
@item Latest version
-3.54 (comes bundled with Emacs 20)
+3.54 (comes bundled with Emacs since version 20)
@item Distribution
@uref{http://www.python.org/emacs/supercite.tar.gz}
as matrices, special functions, and statistics, but is more than
adequate as a replacement for @code{xcalc} and similar programs.
-@node VIPER, AUC-TeX, Calc, Major packages and programs
+@node VIPER, AUCTeX, Calc, Major packages and programs
@section VIPER --- @code{vi} emulation for Emacs
@cindex @code{vi} emulation
@cindex VIPER
4.3
@item Distribution
-@uref{ftp://archive.cis.ohio-state.edu/pub/emacs-lisp/modes/vip-mode.tar.Z}
+@uref{ftp://archive.cis.ohio-state.edu/pub/emacs-lisp/old-archive/modes/vip-mode.tar.Z}
@end table
-@node AUC-TeX, BBDB, VIPER, Major packages and programs
-@section AUC TeX --- enhanced LaTeX mode with debugging facilities
+@node AUCTeX, BBDB, VIPER, Major packages and programs
+@section AUCTeX --- enhanced LaTeX mode with debugging facilities
@cindex Mode for @TeX{}
@cindex @TeX{} mode
-@cindex AUC-TeX mode for editing @TeX{}
+@cindex AUCTeX mode for editing @TeX{}
@cindex Writing and debugging @TeX{}
@table @b
@email{krab@@iesd.auc.dk, Kresten Krab Thorup} and@*
@email{abraham@@dina.kvl.dk, Per Abrahamsen}
+@item Maintainer
+@email{dak@@gnu.org, David Kastrup}
+
@item Latest version
-9.9p
+11.13
@item Distribution
-@uref{ftp://sunsite.auc.dk/packages/auctex/auctex.tar.gz}
+@uref{http://savannah.gnu.org/download/auctex/stable.pkg/11.13/auctex-11.13.tar.gz}
@item Web site
-@uref{http://sunsite.auc.dk/auctex/}
+@uref{http://www.gnu.org/software/auctex/}
@item Mailing list:
-Subscription requests to @email{auc-tex-request@@iesd.auc.dk}@*
-Submissions to @email{auc-tex@@iesd.auc.dk}@*
-Development team is at @email{auc-tex_mgr@@iesd.auc.dk}
+Subscription requests to @email{auc-tex-subscribe@@sunsite.dk}@*
+Submissions to @email{auc-tex@@sunsite.dk}@*
+Development team is at @email{auc-tex_mgr@@sunsite.dk}
@end table
-@node BBDB, Ispell, AUC-TeX, Major packages and programs
+@node BBDB, Ispell, AUCTeX, Major packages and programs
@section BBDB --- personal Info Rolodex integrated with mail/news readers
@cindex BBDB
@cindex Rolodex-like functionality
@table @b
@item Maintainer
-@email{simmonmt@@acm.org, Matt Simmons}
+@email{waider@@waider.ie, Ronan Waide}
@item Latest version
-2.00
+2.34
@item Distribution
-@uref{http://www.netcom.com/~simmonmt/bbdb/index.html}
+@uref{http://bbdb.sourceforge.net/}
@item Mailing lists
-Subscription requests to @email{info-bbdb-request@@xemacs.org}@*
-Submissions to @email{info-bbdb@@xemacs.org}@*
-Release announcements: @email{bbdb-announce-request@@xemacs.org}
+Subscription requests to @email{bbdb-info-request@@lists.sourceforge.net}@*
+Submissions to @email{bbdb-info@@lists.sourceforge.net}@*
+Release announcements: @email{bbdb-announce-request@@lists.sourceforge.net}
@end table
@email{jin@@atype.com, Jin S. Choi}
@item Maintainer
-@email{lbudney@@pobox.com, Len Budney}
+@email{warner-mailcrypt@@lothar.com, Brian Warner}
@item Latest version
-3.5.3
+3.5.8
@item Distribution
-@uref{http://www.nb.net/~lbudney/linux/software/mailcrypt/mailcrypt-3.5.3.tar.gz}
+@uref{http://dl.sourceforge.net/sourceforge/mailcrypt/mailcrypt-3.5.8.tar.gz}
@item Web site
-@uref{http://www.nb.net/~lbudney/linux/software/mailcrypt.html}
+@uref{http://mailcrypt.sourceforge.net/}
@end table
@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
(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
@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
@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
@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
@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
@section Where can I find out more about Gnus?
@cindex FAQ for Gnus
@cindex Gnus FAQ
-@cindex Learning more about GNU
-
-Look for the Gnus FAQ, available at
+@cindex Learning more about Gnus
-@uref{http://www.ccs.neu.edu/software/contrib/gnus/}
+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
@unnumbered Concept Index
@contents
@bye
+
+@ignore
+ arch-tag: fee0d62d-06cf-43d8-ac21-123408eaf10f
+@end ignore