comparison man/faq.texi @ 50780:3c9a6397c579

Update copyright and maintenance details. Update some package URLs, versions, and maintainers. Remove many references to the Emacs Lisp Archive as it is no longer being updated.

50779:02455099d549

@c This is used in many places
@set VER 21.3

@copying
Copyright 2001, 2002 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 is the GNU Emacs FAQ, last updated on @today{}.

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}.

@menu
* FAQ notation::
* General questions::
* Getting help::

archive is not particularly well organized or easy to retrieve
individual postings from, but pretty much everything is there.

The archive is at @uref{ftp://ftp-mailing-list-archives.gnu.org}.

As of this writing, the archives are not yet working.

Web-based Usenet search services, such as
@uref{http://www.dejanews.com, DejaNews}, also archive the
@code{gnu.*} groups.

@node Reporting bugs, Unsubscribing from Emacs lists, Newsgroup archives, General questions
@section Where should I report bugs and other problems with Emacs?
@cindex Bug reporting

consider taking a bit of time to learn Emacs Lisp and modifying your
@file{.emacs} directly.  Simple configuration options are described
rather completely in @inforef{Init File, Init File, emacs}, for users
interested in performing frequently requested, basic tasks.

@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
@cindex Syntax highlighting on a TTY
@cindex Console, colors

Abrahamsen}.  @xref{Packages that do not come with Emacs}, for
instructions on how to get it.

@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).

@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?
@cindex Titlebar, displaying the current file name in
@cindex File name, displaying in the titlebar

session, e.g., by means of a @code{screen} program.

@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.

The alpha version of an enhanced @samp{gnuserv} is available at

@uref{ftp://ftp.wellfleet.com/netman/psmith/emacs/gnuserv-2.1alpha.tar.gz}

@end itemize

@node Compiler error messages, Indenting switch statements, Using an already running Emacs process, Common requests
@section How do I make Emacs recognize my compiler's funny error messages?

new lines, and @kbd{M-q} (@code{fill-paragraph}) will maintain any fill
prefix when refilling the paragraph.

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.

@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 Parentheses, matching
@cindex @file{paren.el}

@cindex @code{hide-ifdef-mode}
@cindex Hiding @code{#ifdef} text
@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}).

@node Repeating commands, Valid X resources, Hiding #ifdef lines, Common requests
@section Is there an equivalent to the @code{.} (dot) command of vi?
@cindex Repeating commands as with @code{vi}
@cindex Command, repeat last

@code{auto-save-interval}, which specifies how many keystrokes Emacs
waits before auto-saving.  Increasing this value forces Emacs to wait
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 also allows you to place all auto-save files in one directory,
such as @file{/tmp}.

To disable or change how @code{auto-save-mode} works, @inforef{Auto
Save, , emacs}.

the string @samp{(DOS)} will appear near the left edge of the mode line;
on DOS and Windows, where the DOS end-of-line (EOL) format is the
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.

@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?
@cindex One space following periods
@cindex Single space following periods

guess by recognizing @samp{cd} commands.  If you type @kbd{cd} followed
by a directory name with a variable reference (@kbd{cd $HOME/bin}) or
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}).

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

@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::

source to most packages contains a short description of how they
should be loaded, invoked, and configured---so before you use or
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}.

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}):

@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
@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

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}).

You can access the Emacs Lisp Archive at

@uref{ftp://archive.cis.ohio-state.edu/pub/emacs-lisp/}

@noindent
or at

@uref{http://www.cis.ohio-state.edu/emacs-lisp}

@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
@section Where can I get other up-to-date GNU stuff?
@cindex Current GNU distributions
@cindex Sources for current GNU distributions
@cindex Stuff, current GNU
@cindex Up-to-date GNU stuff

Many XEmacs features have found their way into recent versions of Emacs,
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
get it at

@uref{ftp://ftp.xemacs.org/pub/xemacs/xemacs-21.1.14.tar.gz}

More information about XEmacs, including a list of frequently asked
questions (FAQ), is available at

@uref{http://www.xemacs.org/}

@cindex @file{csh} mode
@cindex @code{sh-mode}
@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.}

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/}.

@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?
@cindex Translating names to IP addresses
@cindex IP addresses from names

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

@cindex E-mail reader, VM

@table @b

@item Author
@email{kyle@@uunet.uu.net, Kyle Jones}

@item Latest version
6.72

@item Distribution
@uref{ftp://ftp.wonderworks.com/pub/vm/vm.tar.gz}

@item Informational newsgroup/mailing list
@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
@uref{news:gnu.emacs.vm.bug}@*
Subscription requests to @email{bug-vm-request@@uunet.uu.net}@*
Submissions to @email{bug-vm@@uunet.uu.net}
@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}.

@node Supercite, Calc, VM, Major packages and programs
@section Supercite --- mail and news citation package within Emacs
@cindex Supercite
@cindex Superyank

@cindex Citations in mail and news

@table @b

@item Author
@email{bwarsaw@@cen.com, Barry Warsaw}

@item Latest version
3.54 (comes bundled with Emacs 20)

@item Distribution
@uref{http://www.python.org/emacs/supercite.tar.gz}

@item Mailing list

Emacs 21.1 and later comes with a package called @file{calculator.el}.
It doesn't support all the mathematical wizardry offered by Calc, such
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
@section VIPER --- @code{vi} emulation for Emacs
@cindex @code{vi} emulation
@cindex VIPER
@cindex Emulation of @code{vi}

@item Distribution
@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
@cindex Mode for @TeX{}
@cindex @TeX{} mode
@cindex AUC-TeX mode for editing @TeX{}
@cindex Writing and debugging @TeX{}

@table @b

@item Authors
@email{krab@@iesd.auc.dk, Kresten Krab Thorup} and@*
@email{abraham@@dina.kvl.dk, Per Abrahamsen}

@item Latest version
9.9p

@item Distribution
@uref{ftp://sunsite.auc.dk/packages/auctex/auctex.tar.gz}

@item Web site
@uref{http://sunsite.auc.dk/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}

@end table

@node BBDB, Ispell, AUC-TeX, Major packages and programs
@section BBDB --- personal Info Rolodex integrated with mail/news readers
@cindex BBDB
@cindex Rolodex-like functionality
@cindex Integrated contact database
@cindex Contact database

@cindex Address book

@table @b

@item Maintainer
@email{simmonmt@@acm.org, Matt Simmons}

@item Latest version
2.00

@item Distribution
@uref{http://bbdb.sf.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}

@end table

@node Ispell, w3-mode, BBDB, Major packages and programs
@section Ispell --- spell checker in C with interface for Emacs

@item Authors
@email{patl@@lcs.mit.edu, Patrick J. LoPresti} and
@email{jin@@atype.com, Jin S. Choi}

@item Maintainer
@email{lbudney@@pobox.com, Len Budney}

@item Latest version
3.5.3

@item Distribution
@uref{http://www.nb.net/~lbudney/linux/software/mailcrypt/mailcrypt-3.5.3.tar.gz}

@item Web site
@uref{http://www.nb.net/~lbudney/linux/software/mailcrypt.html}

@end table

@node JDE, Patch, Mailcrypt, Major packages and programs
@section JDE --- Integrated development environment for Java

@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

@uref{http://www.ccs.neu.edu/software/contrib/gnus/}

@node Concept index,  , Mail and news, Top
@unnumbered Concept Index
@printindex cp

50780:3c9a6397c579

@c This is used in many places
@set VER 21.3

@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 is the GNU Emacs FAQ, last updated on @today{}.

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.  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::

archive is not particularly well organized or easy to retrieve
individual postings from, but pretty much everything is there.

The archive is at @uref{ftp://ftp-mailing-list-archives.gnu.org}.

A web-based interface to the mail archives is available at
@uref{http://mail.gnu.org/archive/html/}.

Web-based Usenet search services, such as
@uref{http://groups.google.com, Google}, also archive the
@code{gnu.*} groups.

@node Reporting bugs, Unsubscribing from Emacs lists, Newsgroup archives, General questions
@section Where should I report bugs and other problems with Emacs?
@cindex Bug reporting

consider taking a bit of time to learn Emacs Lisp and modifying your
@file{.emacs} directly.  Simple configuration options are described
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
@cindex Syntax highlighting on a TTY
@cindex Console, colors

Abrahamsen}.  @xref{Packages that do not come with Emacs}, for
instructions on how to get it.

@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).  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?
@cindex Titlebar, displaying the current file name in
@cindex File name, displaying in the titlebar

session, e.g., by means of a @code{screen} program.

@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}
(@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 under Emacs 21.2.

@end itemize

@node Compiler error messages, Indenting switch statements, Using an already running Emacs process, Common requests
@section How do I make Emacs recognize my compiler's funny error messages?

new lines, and @kbd{M-q} (@code{fill-paragraph}) will maintain any fill
prefix when refilling the paragraph.

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.  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 Parentheses, matching
@cindex @file{paren.el}

@cindex @code{hide-ifdef-mode}
@cindex Hiding @code{#ifdef} text
@cindex Selectively displaying @code{#ifdef} code

@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
@section Is there an equivalent to the @code{.} (dot) command of vi?
@cindex Repeating commands as with @code{vi}
@cindex Command, repeat last

@code{auto-save-interval}, which specifies how many keystrokes Emacs
waits before auto-saving.  Increasing this value forces Emacs to wait
longer between auto-saves, which might annoy you less.

You might also want to look into Sebastian Kremer's @code{auto-save}
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}.

To disable or change how @code{auto-save-mode} works, @inforef{Auto
Save, , emacs}.

the string @samp{(DOS)} will appear near the left edge of the mode line;
on DOS and Windows, where the DOS end-of-line (EOL) format is the
default, a backslash (@samp{\}) will appear in the mode line.

If you are running a version of Emacs before 20.1, get @code{crypt++}
(@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?
@cindex One space following periods
@cindex Single space following periods

guess by recognizing @samp{cd} commands.  If you type @kbd{cd} followed
by a directory name with a variable reference (@kbd{cd $HOME/bin}) or
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 (@pxref{Finding a package with particular
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

@menu
* 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::

source to most packages contains a short description of how they
should be loaded, invoked, and configured---so before you use or
modify a Lisp package, see if the author has provided any hints in the
source code.

The command @kbd{C-h p} (@code{finder-by-keyword}) allows you to browse
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
@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

The Emacs Lisp List (ELL),
@uref{http://www.anc.ed.ac.uk/~stephen/emacs/ell.html}, 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 using the
@file{ell} package, @uref{http://www.anc.ed.ac.uk/~stephen/emacs/ell.el}.

Many authors post their packages to the newsgroup
@uref{news:gnu.emacs.sources}.  You can search the archives of this
group with @uref{http://groups.google.com, Google}, for example.

Several packages are stored in the Lisp area of the Emacs Wiki,
@uref{http://emacswiki.org/elisp/}.

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{ftp://ftp.cis.ohio-state.edu/pub/emacs-lisp/WWW/index.html}

@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
@cindex Stuff, current GNU
@cindex Up-to-date GNU stuff

Many XEmacs features have found their way into recent versions of Emacs,
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.4; you can
get it at

@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

@uref{http://www.xemacs.org/}

@cindex @file{csh} mode
@cindex @code{sh-mode}
@cindex @code{cc-mode}

Most of these modes are now available in standard Emacs distribution.
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.  It is distributed with Emacs, but has its own homepage at
@uref{http://cc-mode.sourceforge.net/}.

@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?
@cindex Translating names to IP addresses
@cindex IP addresses from names

@menu
* VM::
* Supercite::
* Calc::
* VIPER::
* AUCTeX::
* BBDB::
* Ispell::
* w3-mode::
* EDB::
* Mailcrypt::

@cindex E-mail reader, VM

@table @b

@item Author
@email{kyle_jones@@wonderworks.com, Kyle Jones}

@item Latest version
7.14

@item Distribution
@uref{ftp://ftp.wonderworks.com/pub/vm/vm.tar.gz}

@item Informational newsgroup
@uref{news:gnu.emacs.vm.info}@*

@item Bug reports newsgroup
@uref{news:gnu.emacs.vm.bug}@*
Or send reports to @email{bug-vm@@wonderworks.com}
@end table

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
@cindex Supercite
@cindex Superyank

@cindex Citations in mail and news

@table @b

@item Author
@email{barry@@python.org, Barry Warsaw}

@item Latest version
3.54 (comes bundled with Emacs since version 20)

@item Distribution
@uref{http://www.python.org/emacs/supercite.tar.gz}

@item Mailing list

Emacs 21.1 and later comes with a package called @file{calculator.el}.
It doesn't support all the mathematical wizardry offered by Calc, such
as matrices, special functions, and statistics, but is more than
adequate as a replacement for @code{xcalc} and similar programs.

@node VIPER, AUCTeX, Calc, Major packages and programs
@section VIPER --- @code{vi} emulation for Emacs
@cindex @code{vi} emulation
@cindex VIPER
@cindex Emulation of @code{vi}

@item Distribution
@uref{ftp://archive.cis.ohio-state.edu/pub/emacs-lisp/old-archive/modes/vip-mode.tar.Z}

@end table

@node AUCTeX, BBDB, VIPER, Major packages and programs
@section AUCTeX --- enhanced LaTeX mode with debugging facilities
@cindex Mode for @TeX{}
@cindex @TeX{} mode
@cindex AUCTeX mode for editing @TeX{}
@cindex Writing and debugging @TeX{}

@table @b

@item Authors
@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
11.13

@item Distribution
@uref{http://savannah.gnu.org/download/auctex/stable.pkg/11.13/auctex-11.13.tar.gz}

@item Web site
@uref{http://www.gnu.org/software/auctex/}

@item Mailing list:
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, AUCTeX, Major packages and programs
@section BBDB --- personal Info Rolodex integrated with mail/news readers
@cindex BBDB
@cindex Rolodex-like functionality
@cindex Integrated contact database
@cindex Contact database

@cindex Address book

@table @b

@item Maintainer
@email{waider@@waider.ie, Ronan Waide}

@item Latest version
2.34

@item Distribution
@uref{http://bbdb.sourceforge.net/}

@item Mailing lists
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

@node Ispell, w3-mode, BBDB, Major packages and programs
@section Ispell --- spell checker in C with interface for Emacs

@item Authors
@email{patl@@lcs.mit.edu, Patrick J. LoPresti} and
@email{jin@@atype.com, Jin S. Choi}

@item Maintainer
@email{warner-mailcrypt@@lothar.com, Brian Warner}

@item Latest version
3.5.8

@item Distribution
@uref{http://dl.sourceforge.net/sourceforge/mailcrypt/mailcrypt-3.5.8.tar.gz}

@item Web site
@uref{http://mailcrypt.sourceforge.net/}

@end table

@node JDE, Patch, Mailcrypt, Major packages and programs
@section JDE --- Integrated development environment for Java

@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 (along with a great deal of information
and tips) at
  
@uref{http://my.gnus.org/}

@node Concept index,  , Mail and news, Top
@unnumbered Concept Index
@printindex cp