comparison doc/misc/faq.texi @ 103384:1a60127fa212

(Viewing Info files outside of Emacs): Xinfo is no more. (Help installing Emacs): Remove reference to deleted X11 node. (Associating modes with files): Interpreter-mode-alist is no longer subservient to auto-mode-alist. (Installing Emacs): Change future Emacs version. (Linking with -lX11 fails): Remove old section. (Packages that do not come with Emacs): Update ELL location. Emacs Lisp archive is dead. (Emacs for Windows): Remove reference to old CE port. (Emacs for OS/2, Emacs for Atari ST, Emacs for the Amiga ): Remove old ports. (Emacs for GNUstep): Rename from "Emacs for NeXTSTEP" and update. (Removing flashing messages): Remove section about non-existent Gnus option.
author Glenn Morris <rgm@gnu.org>
date Fri, 12 Jun 2009 02:47:25 +0000
parents 288ef1280a95
children 7f9fa78fd502
comparison
equal deleted inserted replaced
103383:288ef1280a95 103384:1a60127fa212
854 @code{info}, a stand-alone version of the Info program, comes as part of 854 @code{info}, a stand-alone version of the Info program, comes as part of
855 the Texinfo package. @xref{Installing Texinfo documentation}, for 855 the Texinfo package. @xref{Installing Texinfo documentation}, for
856 details. 856 details.
857 857
858 @item 858 @item
859 Xinfo, a stand-alone version of the Info program that runs under X
860 Window system. You can get it at
861 @uref{ftp://ftp.gnu.org/pub/gnu/xinfo/xinfo-1.01.01.tar.gz} and all
862 mirrors of @samp{ftp.gnu.org} (see @ref{Current GNU distributions}, for a
863 list of mirrors).
864
865 @item
866 Tkinfo, an Info viewer that runs under X Window system and uses Tcl/Tk. 859 Tkinfo, an Info viewer that runs under X Window system and uses Tcl/Tk.
867 You can get Tkinfo at 860 You can get Tkinfo at
868 @uref{http://math-www.uni-paderborn.de/~axel/tkinfo/}. 861 @uref{http://math-www.uni-paderborn.de/~axel/tkinfo/}.
869 862
870 @end itemize 863 @end itemize
934 @section Where can I get help in installing Emacs? 927 @section Where can I get help in installing Emacs?
935 @cindex Installation help 928 @cindex Installation help
936 @cindex Help installing Emacs 929 @cindex Help installing Emacs
937 930
938 @xref{Installing Emacs}, for some basic installation hints, and see 931 @xref{Installing Emacs}, for some basic installation hints, and see
939 @ref{Problems building Emacs}, or @ref{Linking with -lX11 fails}, if you 932 @ref{Problems building Emacs}, if you have problems with the installation.
940 have problems with the installation.
941 933
942 The web-page @uref{http://www.fsf.org/resources/service/} lists 934 The web-page @uref{http://www.fsf.org/resources/service/} lists
943 companies and individuals willing to sell you help in installing or 935 companies and individuals willing to sell you help in installing or
944 using Emacs. 936 using Emacs.
945 937
1428 1420
1429 @cindex Major mode for shell scripts 1421 @cindex Major mode for shell scripts
1430 Beginning with Emacs 19, the variable @code{interpreter-mode-alist} 1422 Beginning with Emacs 19, the variable @code{interpreter-mode-alist}
1431 specifies which mode to use when loading a shell script. (Emacs 1423 specifies which mode to use when loading a shell script. (Emacs
1432 determines which interpreter you're using by examining the first line of 1424 determines which interpreter you're using by examining the first line of
1433 the script.) This feature only applies when the file name doesn't 1425 the script.) Use @kbd{C-h v} (or @kbd{M-x describe-variable})
1434 indicate which mode to use. Use @kbd{C-h v} (or @kbd{M-x 1426 on @code{interpreter-mode-alist} to learn more.
1435 describe-variable}) on @code{interpreter-mode-alist} to learn more.
1436 1427
1437 @node Highlighting a region, Replacing highlighted text, Associating modes with files, Common requests 1428 @node Highlighting a region, Replacing highlighted text, Associating modes with files, Common requests
1438 @section How can I highlight a region of text in Emacs? 1429 @section How can I highlight a region of text in Emacs?
1439 @cindex Highlighting text 1430 @cindex Highlighting text
1440 @cindex Text, highlighting 1431 @cindex Text, highlighting
3221 3212
3222 @menu 3213 @menu
3223 * Installing Emacs:: 3214 * Installing Emacs::
3224 * Updating Emacs:: 3215 * Updating Emacs::
3225 * Problems building Emacs:: 3216 * Problems building Emacs::
3226 * Linking with -lX11 fails::
3227 @end menu 3217 @end menu
3228 3218
3229 @node Installing Emacs, Updating Emacs, Compiling and installing Emacs, Compiling and installing Emacs 3219 @node Installing Emacs, Updating Emacs, Compiling and installing Emacs, Compiling and installing Emacs
3230 @section How do I install Emacs? 3220 @section How do I install Emacs?
3231 @cindex Installing Emacs 3221 @cindex Installing Emacs
3252 distribution site, sources are available as 3242 distribution site, sources are available as
3253 3243
3254 @uref{ftp://ftp.gnu.org/pub/gnu/emacs/emacs-@value{VER}.tar.gz} 3244 @uref{ftp://ftp.gnu.org/pub/gnu/emacs/emacs-@value{VER}.tar.gz}
3255 3245
3256 The above will obviously change as new versions of Emacs come out. For 3246 The above will obviously change as new versions of Emacs come out. For
3257 instance, when Emacs 22.42 is released, it will most probably be 3247 instance, when Emacs 24.3 is released, it will most probably be
3258 available as 3248 available as
3259 3249
3260 @uref{ftp://ftp.gnu.org/pub/gnu/emacs/emacs-22.42.tar.gz} 3250 @uref{ftp://ftp.gnu.org/pub/gnu/emacs/emacs-24.3.tar.gz}
3261 3251
3262 Again, you should use one of the GNU mirror sites (see @ref{Current GNU 3252 Again, you should use one of the GNU mirror sites (see @ref{Current GNU
3263 distributions}, and adjust the URL accordingly) so as to reduce load on 3253 distributions}, and adjust the URL accordingly) so as to reduce load on
3264 @file{ftp.gnu.org}. 3254 @file{ftp.gnu.org}.
3265 3255
3364 3354
3365 Upgrading should overwrite only, @file{/usr/local/bin/emacs} (the Emacs 3355 Upgrading should overwrite only, @file{/usr/local/bin/emacs} (the Emacs
3366 binary) and documentation in @file{/usr/local/info}. Back up these 3356 binary) and documentation in @file{/usr/local/info}. Back up these
3367 files before you upgrade, and you shouldn't have too much trouble. 3357 files before you upgrade, and you shouldn't have too much trouble.
3368 3358
3369 @node Problems building Emacs, Linking with -lX11 fails, Updating Emacs, Compiling and installing Emacs 3359 @node Problems building Emacs, , Updating Emacs, Compiling and installing Emacs
3370 @section What should I do if I have trouble building Emacs? 3360 @section What should I do if I have trouble building Emacs?
3371 @cindex Problems building Emacs 3361 @cindex Problems building Emacs
3372 @cindex Errors when building Emacs 3362 @cindex Errors when building Emacs
3373 3363
3374 First look in the file @file{etc/PROBLEMS} (where you unpack the Emacs 3364 First look in the file @file{etc/PROBLEMS} (where you unpack the Emacs
3384 3374
3385 Please don't post it to @uref{news:gnu.emacs.help} or send e-mail to 3375 Please don't post it to @uref{news:gnu.emacs.help} or send e-mail to
3386 @email{help-gnu-emacs@@gnu.org}. For further guidelines, see 3376 @email{help-gnu-emacs@@gnu.org}. For further guidelines, see
3387 @ref{Guidelines for newsgroup postings} and @ref{Reporting bugs}. 3377 @ref{Guidelines for newsgroup postings} and @ref{Reporting bugs}.
3388 3378
3389 @node Linking with -lX11 fails, , Problems building Emacs, Compiling and installing Emacs
3390 @section Why does linking Emacs with -lX11 fail?
3391 @cindex Linking with -lX11 fails
3392 @cindex lX11, linking fails with
3393
3394 Emacs needs to be linked with the static version of the X11 library,
3395 @file{libX11.a}. This may be missing.
3396
3397 On OpenWindows, you may need to use @code{add_services} to add the
3398 ``OpenWindows Programmers'' optional software category from the CD-ROM.
3399
3400 On HP-UX 8.0, you may need to run @code{update} again to load the
3401 X11-PRG ``fileset.'' This may be missing even if you specified ``all
3402 filesets'' the first time. If @file{libcurses.a} is missing, you may
3403 need to load the ``Berkeley Development Option.''
3404
3405 @email{zoo@@armadillo.com, David Zuhn} says that MIT X builds shared
3406 libraries by default, and only shared libraries, on those platforms that
3407 support them. These shared libraries can't be used when undumping
3408 @code{temacs} (the last stage of the Emacs build process). To get
3409 regular libraries in addition to shared libraries, add this to
3410 @file{site.cf}:
3411
3412 @example
3413 #define ForceNormalLib YES
3414 @end example
3415
3416 Other systems may have similar problems. You can always define
3417 @code{CANNOT_DUMP} and link with the shared libraries instead.
3418
3419 @cindex X Menus don't work
3420 To get the Xmenu stuff to work, you need to find a copy of MIT's
3421 @file{liboldX.a}.
3422 3379
3423 @c ------------------------------------------------------------ 3380 @c ------------------------------------------------------------
3424 @node Finding Emacs and related packages, Major packages and programs, Compiling and installing Emacs, Top 3381 @node Finding Emacs and related packages, Major packages and programs, Compiling and installing Emacs, Top
3425 @chapter Finding Emacs and related packages 3382 @chapter Finding Emacs and related packages
3426 @cindex Finding Emacs and related packages 3383 @cindex Finding Emacs and related packages
3432 * Current GNU distributions:: 3389 * Current GNU distributions::
3433 * Difference between Emacs and XEmacs:: 3390 * Difference between Emacs and XEmacs::
3434 * Emacs for minimalists:: 3391 * Emacs for minimalists::
3435 * Emacs for MS-DOS:: 3392 * Emacs for MS-DOS::
3436 * Emacs for Windows:: 3393 * Emacs for Windows::
3437 * Emacs for OS/2:: 3394 * Emacs for GNUstep::
3438 * Emacs for Atari ST::
3439 * Emacs for the Amiga ::
3440 * Emacs for NeXTSTEP::
3441 * Emacs for Apple computers:: 3395 * Emacs for Apple computers::
3442 * Emacs for VMS and DECwindows::
3443 * Modes for various languages:: 3396 * Modes for various languages::
3444 @end menu 3397 @end menu
3445 3398
3446 @node Finding Emacs on the Internet, Finding a package with particular functionality, Finding Emacs and related packages, Finding Emacs and related packages 3399 @node Finding Emacs on the Internet, Finding a package with particular functionality, Finding Emacs and related packages, Finding Emacs and related packages
3447 @section Where can I get Emacs on the net (or by snail mail)? 3400 @section Where can I get Emacs on the net (or by snail mail)?
3491 @cindex Lisp packages that do not come with Emacs 3444 @cindex Lisp packages that do not come with Emacs
3492 @cindex Packages, those that do not come with Emacs 3445 @cindex Packages, those that do not come with Emacs
3493 @cindex Emacs Lisp List 3446 @cindex Emacs Lisp List
3494 @cindex Emacs Lisp Archive 3447 @cindex Emacs Lisp Archive
3495 3448
3496 @uref{http://www.anc.ed.ac.uk/~stephen/emacs/ell.html, The Emacs Lisp 3449 @uref{http://www.damtp.cam.ac.uk/user/sje30/emacs/ell.html, The Emacs Lisp
3497 List (ELL)}, maintained by @email{stephen@@anc.ed.ac.uk, Stephen Eglen}, 3450 List (ELL)}, maintained by @email{S.J.Eglen@@damtp.cam.ac.uk, Stephen Eglen},
3498 aims to provide one compact list with links to all of the current Emacs 3451 aims to provide one compact list with links to all of the current Emacs
3499 Lisp files on the Internet. The ELL can be browsed over the web, or 3452 Lisp files on the Internet. The ELL can be browsed over the web, or
3500 from Emacs with @uref{http://www.anc.ed.ac.uk/~stephen/emacs/ell.el, 3453 from Emacs with @uref{http://www.damtp.cam.ac.uk/user/sje30/emacs/ell.el,
3501 the @file{ell} package}. 3454 the @file{ell} package}.
3502 3455
3503 Many authors post their packages to the @uref{news:gnu.emacs.sources, 3456 Many authors post their packages to the @uref{news:gnu.emacs.sources,
3504 Emacs sources newsgroup}. You can search the archives of this 3457 Emacs sources newsgroup}. You can search the archives of this
3505 group with @uref{http://groups.google.com/group/gnu.emacs.sources, Google}, 3458 group with @uref{http://groups.google.com/group/gnu.emacs.sources, Google},
3506 or @uref{http://dir.gmane.org/gmane.emacs.sources, Gmane}, for example. 3459 or @uref{http://dir.gmane.org/gmane.emacs.sources, Gmane}, for example.
3507 3460
3508 Several packages are stored in 3461 Several packages are stored in
3509 @uref{http://emacswiki.org/elisp/, the Lisp area of the Emacs Wiki}. 3462 @uref{http://emacswiki.org/elisp/, the Lisp area of the Emacs Wiki}.
3510
3511 For a long time, the Emacs Lisp Archive provided a central repository
3512 for Emacs packages. Sadly, it has not been active for some time,
3513 although you can still access the old files at
3514
3515 @uref{http://www.club.cc.cmu.edu/pub/gnu/elisp-archive/}
3516 3463
3517 Read the file @file{etc/MORE.STUFF} for more information about 3464 Read the file @file{etc/MORE.STUFF} for more information about
3518 external packages. 3465 external packages.
3519 3466
3520 @node Current GNU distributions, Difference between Emacs and XEmacs, Packages that do not come with Emacs, Finding Emacs and related packages 3467 @node Current GNU distributions, Difference between Emacs and XEmacs, Packages that do not come with Emacs, Finding Emacs and related packages
3664 @uref{ftp://rtfm.mit.edu/pub/usenet/comp.emacs/} 3611 @uref{ftp://rtfm.mit.edu/pub/usenet/comp.emacs/}
3665 3612
3666 Note that while many of these programs look similar to Emacs, they often 3613 Note that while many of these programs look similar to Emacs, they often
3667 lack certain features, such as the Emacs Lisp extension language. 3614 lack certain features, such as the Emacs Lisp extension language.
3668 3615
3669 @node Emacs for Windows, Emacs for OS/2, Emacs for MS-DOS, Finding Emacs and related packages 3616 @node Emacs for Windows, Emacs for GNUstep, Emacs for MS-DOS, Finding Emacs and related packages
3670 @section Where can I get Emacs for Microsoft Windows? 3617 @section Where can I get Emacs for Microsoft Windows?
3671 @cindex FAQ for NT Emacs 3618 @cindex FAQ for NT Emacs
3672 @cindex Emacs for MS-Windows 3619 @cindex Emacs for MS-Windows
3673 @cindex Microsoft Windows, Emacs for 3620 @cindex Microsoft Windows, Emacs for
3674 @cindex Windows 9X, ME, NT, 2K, and CE, Emacs for 3621 @cindex Windows 9X, ME, NT, 2K, and CE, Emacs for
3679 3626
3680 @uref{http://www.gnu.org/software/emacs/windows/ntemacs.html} 3627 @uref{http://www.gnu.org/software/emacs/windows/ntemacs.html}
3681 3628
3682 @xref{Emacs for MS-DOS}, for Windows 3.1. 3629 @xref{Emacs for MS-DOS}, for Windows 3.1.
3683 3630
3684 A port of Emacs 20.7 for Windows CE, based on NTEmacs, is available at 3631
3685 3632 @node Emacs for GNUstep, Emacs for Apple computers, Emacs for Windows, Finding Emacs and related packages
3686 @uref{http://www.rainer-keuchel.de/software.html} 3633 @section Where can I get Emacs for GNUstep?
3687 3634 @cindex GNUSTEP, Emacs for
3688 @noindent 3635
3689 This port was done by @email{coyxc@@rainer-keuchel.de, Rainer Keuchel}, 3636 Beginning with version 23.1, Emacs supports GNUstep natively.
3690 and supports all Emacs features except async subprocesses and menus. 3637
3691 You will need MSVC 6.0 and a Windows CE SDK to build this port. 3638 @node Emacs for Apple computers, Modes for various languages, Emacs for GNUstep, Finding Emacs and related packages
3692
3693 @node Emacs for OS/2, Emacs for Atari ST, Emacs for Windows, Finding Emacs and related packages
3694 @section Where can I get Emacs for my PC running OS/2?
3695 @cindex OS/2, Emacs for
3696
3697 Emacs 20.6 is ported for emx on OS/2 2.0 or 2.1, and is available at
3698
3699 @uref{ftp://hobbes.nmsu.edu/pub/os2/apps/editors/emacs/}
3700
3701 @noindent
3702 and also at
3703
3704 @uref{http://www.dotemacs.de/os2/emacs.html}
3705
3706 Instructions for installation, basic setup, and other useful information
3707 for OS/2 users of Emacs can be found at
3708
3709 @uref{http://home.snafu.de/ohei/emacs/emacs206-os2.html}
3710
3711 @node Emacs for Atari ST, Emacs for the Amiga , Emacs for OS/2, Finding Emacs and related packages
3712 @section Where can I get Emacs for my Atari ST?
3713 @cindex Atari ST, Emacs for
3714 @cindex TOS, Emacs for
3715
3716 Roland Sch@"auble reports that Emacs 18.58 running on plain TOS and MiNT
3717 is available at
3718 @uref{ftp://atari.archive.umich.edu/Editors/Emacs-18-58/1858b-d3.zoo}.
3719
3720 @node Emacs for the Amiga , Emacs for NeXTSTEP, Emacs for Atari ST, Finding Emacs and related packages
3721 @section Where can I get Emacs for my Amiga?
3722 @cindex Amiga, Emacs for
3723
3724 The files you need are available at
3725
3726 @uref{ftp://ftp.wustl.edu/pub/aminet/util/gnu/}
3727
3728 @email{dgilbert@@gamiga.guelphnet.dweomer.org, David Gilbert} has released a
3729 beta version of Emacs 19.25 for the Amiga. You can get the binary at
3730
3731 @uref{ftp://ftp.wustl.edu/pub/aminet/util/gnu/a2.0bEmacs-bin.lha}
3732
3733 @node Emacs for NeXTSTEP, Emacs for Apple computers, Emacs for the Amiga , Finding Emacs and related packages
3734 @section Where can I get Emacs for NeXTSTEP?
3735 @cindex NeXTSTEP, Emacs for
3736
3737 Emacs.app is a NeXTSTEP version of Emacs 19.34 which supports colors,
3738 menus, and multiple frames. You can get it from
3739
3740 @uref{ftp://next-ftp.peak.org/pub/next-ftp/next/apps/emacs/Emacs_for_NeXTstep.4.20a1.NIHS.b.tar.gz}
3741
3742 @node Emacs for Apple computers, Emacs for VMS and DECwindows, Emacs for NeXTSTEP, Finding Emacs and related packages
3743 @section Where can I get Emacs for my Apple computer? 3639 @section Where can I get Emacs for my Apple computer?
3744 @cindex Apple computers, Emacs for 3640 @cindex Apple computers, Emacs for
3745 @cindex Macintosh, Emacs for 3641 @cindex Macintosh, Emacs for
3746 3642
3747 Beginning with version 22.1, Emacs supports Mac OS X natively. 3643 Beginning with version 22.1, Emacs supports Mac OS X natively.
3748 3644
3749 @node Emacs for VMS and DECwindows, Modes for various languages, Emacs for Apple computers, Finding Emacs and related packages 3645 @node Modes for various languages, , Emacs for Apple computers, Finding Emacs and related packages
3750 @section Where do I get Emacs that runs on VMS under DECwindows?
3751 @cindex DECwindows, Emacs for
3752 @cindex VMS, Emacs for
3753
3754 Up-to-date information about GNU software (including Emacs) for VMS is
3755 available at @uref{http://www.lp.se/gnu-vms/}.
3756
3757 @node Modes for various languages, , Emacs for VMS and DECwindows, Finding Emacs and related packages
3758 @section Where can I get modes for Lex, Yacc/Bison, Bourne shell, csh, C@t{++}, Objective-C, Pascal, Java, and Awk? 3646 @section Where can I get modes for Lex, Yacc/Bison, Bourne shell, csh, C@t{++}, Objective-C, Pascal, Java, and Awk?
3759 @cindex Awk, mode for 3647 @cindex Awk, mode for
3760 @cindex @code{awk-mode} 3648 @cindex @code{awk-mode}
3761 @cindex Bison, mode for 3649 @cindex Bison, mode for
3762 @cindex Bourne Shell, mode for 3650 @cindex Bourne Shell, mode for
4967 * Viewing articles with embedded underlining:: 4855 * Viewing articles with embedded underlining::
4968 * Saving a multi-part Gnus posting:: 4856 * Saving a multi-part Gnus posting::
4969 * Starting Gnus faster:: 4857 * Starting Gnus faster::
4970 * Catching up in all newsgroups:: 4858 * Catching up in all newsgroups::
4971 * Killing based on nonstandard headers:: 4859 * Killing based on nonstandard headers::
4972 * Removing flashing messages::
4973 * Catch-up is slow in Gnus:: 4860 * Catch-up is slow in Gnus::
4974 * Gnus hangs for a long time:: 4861 * Gnus hangs for a long time::
4975 * Learning more about Gnus:: 4862 * Learning more about Gnus::
4976 @end menu 4863 @end menu
4977 4864
5291 In the @file{*Newsgroup*} buffer, type @kbd{M-< C-x ( c y C-x ) M-0 C-x e} 5178 In the @file{*Newsgroup*} buffer, type @kbd{M-< C-x ( c y C-x ) M-0 C-x e}
5292 5179
5293 Leave off the initial @kbd{M-<} if you only want to catch up from point 5180 Leave off the initial @kbd{M-<} if you only want to catch up from point
5294 to the end of the @file{*Newsgroup*} buffer. 5181 to the end of the @file{*Newsgroup*} buffer.
5295 5182
5296 @node Killing based on nonstandard headers, Removing flashing messages, Catching up in all newsgroups, Mail and news 5183 @node Killing based on nonstandard headers, Catch-up is slow in Gnus, Catching up in all newsgroups, Mail and news
5297 @section Why can't I kill in Gnus based on the Newsgroups/Keywords/Control headers? 5184 @section Why can't I kill in Gnus based on the Newsgroups/Keywords/Control headers?
5298 @cindex Killing articles based on nonstandard headers 5185 @cindex Killing articles based on nonstandard headers
5299 @cindex Newsgroups header, killing articles based on 5186 @cindex Newsgroups header, killing articles based on
5300 @cindex Keywords header, killing articles based on 5187 @cindex Keywords header, killing articles based on
5301 @cindex Control header, killing articles based on 5188 @cindex Control header, killing articles based on
5312 5199
5313 @lisp 5200 @lisp
5314 (gnus-kill nil "^Newsgroups: .*\\(bad\\.group\\|worse\\.group\\)") 5201 (gnus-kill nil "^Newsgroups: .*\\(bad\\.group\\|worse\\.group\\)")
5315 @end lisp 5202 @end lisp
5316 5203
5317 @node Removing flashing messages, Catch-up is slow in Gnus, Killing based on nonstandard headers, Mail and news 5204 @node Catch-up is slow in Gnus, Gnus hangs for a long time, Killing based on nonstandard headers, Mail and news
5318 @section How do I get rid of flashing messages in Gnus for slow connections?
5319 @cindex Flashing Gnus messages, removing
5320 @cindex Removing flashing Gnus messages
5321 @cindex Slow connections causing flashing messages in Gnus
5322 @cindex Gnus, flashing messages in
5323
5324 Set @code{nntp-debug-read} to @code{nil}.
5325
5326 @node Catch-up is slow in Gnus, Gnus hangs for a long time, Removing flashing messages, Mail and news
5327 @section Why is catch up slow in Gnus? 5205 @section Why is catch up slow in Gnus?
5328 @cindex Slow catch up in Gnus 5206 @cindex Slow catch up in Gnus
5329 @cindex Gnus is slow when catching up 5207 @cindex Gnus is slow when catching up
5330 @cindex Crosspostings make Gnus catching up slow 5208 @cindex Crosspostings make Gnus catching up slow
5331 5209