aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorDave Love1999-09-01 11:14:20 +0000
committerDave Love1999-09-01 11:14:20 +0000
commit0d17cd5c7106db414fe71bb799bc9fd8adf2495d (patch)
tree78e406deb340101cd6a97bda08a6adcc3277833e
parent71e6882726cc7904f4e1852d6e703590748150d6 (diff)
downloademacs-0d17cd5c7106db414fe71bb799bc9fd8adf2495d.tar.gz
emacs-0d17cd5c7106db414fe71bb799bc9fd8adf2495d.zip
General changes sent to Lerner, plus some XEmacs expurgation.
-rw-r--r--man/faq.texi167
1 files changed, 83 insertions, 84 deletions
diff --git a/man/faq.texi b/man/faq.texi
index f4427b45cbe..d0137791434 100644
--- a/man/faq.texi
+++ b/man/faq.texi
@@ -8,6 +8,11 @@
8 8
9@c The @ifinfo stuff only appears in the Info version 9@c The @ifinfo stuff only appears in the Info version
10@ifinfo 10@ifinfo
11@dircategory Editors
12@direntry
13* Emacs FAQ: (emacs-faq). Frequently Asked Questions about Emacs.
14@end direntry
15
11Copyright 1994-1999 Reuven M. Lerner@* 16Copyright 1994-1999 Reuven M. Lerner@*
12Copyright 1992-1993 Steven Byrnes@* 17Copyright 1992-1993 Steven Byrnes@*
13Copyright 1990-1992 Joseph Brian Wells@* 18Copyright 1990-1992 Joseph Brian Wells@*
@@ -25,6 +30,10 @@ latest version of the FAQ is archived (including FTP information).
25The FAQ may be copied and redistributed under these conditions, except that 30The FAQ may be copied and redistributed under these conditions, except that
26the FAQ may not be embedded in a larger literary work unless that work 31the FAQ may not be embedded in a larger literary work unless that work
27itself allows free copying and redistribution. 32itself allows free copying and redistribution.
33
34[This version has been somewhat edited from the last-posted version
35(as of August 1999) for inclusion in the Emacs distribution.]
36
28@end ifinfo 37@end ifinfo
29 38
30@c The @titlepage stuff only appears in the printed version 39@c The @titlepage stuff only appears in the printed version
@@ -52,6 +61,9 @@ latest version of the FAQ is archived (including FTP information).
52The FAQ may be copied and redistributed under these conditions, except that 61The FAQ may be copied and redistributed under these conditions, except that
53the FAQ may not be embedded in a larger literary work unless that work 62the FAQ may not be embedded in a larger literary work unless that work
54itself allows free copying and redistribution. 63itself allows free copying and redistribution.
64
65[This version has been somewhat edited from the last-posted version
66(as of August 1999) for inclusion in the Emacs distribution.]
55@end titlepage 67@end titlepage
56 68
57@node Top, FAQ notation, (dir), (dir) 69@node Top, FAQ notation, (dir), (dir)
@@ -120,7 +132,7 @@ used in the FAQ.
120 132
121@item 133@item
122@kbd{M-x}: press the @key{x} key while holding down the @key{Meta} key 134@kbd{M-x}: press the @key{x} key while holding down the @key{Meta} key
123(if your computer doesn't have a @key{Meta} key, see @xref{No Meta key}) 135(if your computer doesn't have a @key{Meta} key, see @pxref{No Meta key})
124 136
125@item 137@item
126@kbd{M-C-x}: press the @key{x} key while holding down both @key{Control} 138@kbd{M-C-x}: press the @key{x} key while holding down both @key{Control}
@@ -137,7 +149,7 @@ and @key{Meta}
137 149
138@item 150@item
139@key{DEL}: @key{Delete}, usually not the same as @key{Backspace}; same 151@key{DEL}: @key{Delete}, usually not the same as @key{Backspace}; same
140 as @kbd{C-?} (@xref{Backspace invokes help} if deleting invokes Emacs help) 152 as @kbd{C-?} (@pxref{Backspace invokes help} if deleting invokes Emacs help)
141 153
142@item 154@item
143@key{ESC}: Escape; same as @kbd{C-[} 155@key{ESC}: Escape; same as @kbd{C-[}
@@ -167,7 +179,7 @@ pressing just @key{x}. Essentially, @key{Control} turns off bits 5 and
167Also, on very few keyboards does @kbd{C-?} generate ASCII code 127. 179Also, on very few keyboards does @kbd{C-?} generate ASCII code 127.
168 180
169@inforef{Characters, Characters, emacs} and @inforef{Keys, Keys, emacs} 181@inforef{Characters, Characters, emacs} and @inforef{Keys, Keys, emacs}
170for more information. (@xref{On-line manual} for more information about 182for more information. (@pxref{On-line manual} for more information about
171Info.) 183Info.)
172 184
173@node Extended commands, On-line manual, Basic keys, FAQ notation 185@node Extended commands, On-line manual, Basic keys, FAQ notation
@@ -177,7 +189,7 @@ Info.)
177@cindex M-x, meaning of 189@cindex M-x, meaning of
178 190
179@kbd{M-x @var{command}} means type @kbd{M-x}, then type the name of the 191@kbd{M-x @var{command}} means type @kbd{M-x}, then type the name of the
180command, then type @key{RET}. (@xref{Basic keys} if you're not sure 192command, then type @key{RET}. (@pxref{Basic keys} if you're not sure
181what @kbd{M-x} and @key{RET} mean.) 193what @kbd{M-x} and @key{RET} mean.)
182 194
183@kbd{M-x} (by default) invokes the command 195@kbd{M-x} (by default) invokes the command
@@ -214,7 +226,7 @@ If we refer to topic XXX:YYY, type @kbd{C-h i m emacs @key{RET} m XXX
214Your system administrator may not have installed the Info files, or may 226Your system administrator may not have installed the Info files, or may
215have installed them improperly. In this case you should complain. 227have installed them improperly. In this case you should complain.
216 228
217@xref{Getting a printed manual} if you would like a paper copy of the 229@xref{Getting a printed manual}, if you would like a paper copy of the
218Emacs manual. 230Emacs manual.
219 231
220@node Filename conventions, Common acronyms, On-line manual, FAQ notation 232@node Filename conventions, Common acronyms, On-line manual, FAQ notation
@@ -369,7 +381,7 @@ same freedom that you enjoyed.
369@cindex Mailing lists, appropriate messages for 381@cindex Mailing lists, appropriate messages for
370 382
371The file @file{etc/MAILINGLISTS} discusses the purpose of each GNU 383The file @file{etc/MAILINGLISTS} discusses the purpose of each GNU
372mailing-list. (@xref{Informational files for Emacs} if you want a copy 384mailing-list. (@pxref{Informational files for Emacs} if you want a copy
373of the file.) For those lists which are gatewayed with newsgroups, it 385of the file.) For those lists which are gatewayed with newsgroups, it
374lists both the newsgroup name and the mailing list address. 386lists both the newsgroup name and the mailing list address.
375 387
@@ -427,7 +439,7 @@ so you can be contacted for further details.
427 439
428Be sure to read the "Bugs" section of the Emacs manual before reporting 440Be sure to read the "Bugs" section of the Emacs manual before reporting
429a bug to bug-gnu-emacs! The manual describes in detail how to submit a 441a bug to bug-gnu-emacs! The manual describes in detail how to submit a
430useful bug report. (@xref{On-line manual} if you don't know how to read the 442useful bug report. (@pxref{On-line manual} if you don't know how to read the
431manual.) 443manual.)
432 444
433RMS says: 445RMS says:
@@ -614,18 +626,13 @@ file}).
614If you absolutely have to print your own copy, and you don't have @TeX{}, 626If you absolutely have to print your own copy, and you don't have @TeX{},
615you can get a PostScript version from 627you can get a PostScript version from
616 628
617@uref{ftp://ftp.cs.ubc.ca/pub/archive/gnu/manuals_ps/emacs-19.21.ps.gz} 629@uref{http://www.gnu.org/manual/emacs/ps/emacs.ps.gz}
618 630
619Note that the above document is somewhat out of date, although most 631A WWW version of the manual is at
620major concepts are still relevant. This site requests that you please
621@emph{confine any major ftping to late evenings or early mornings, local
622time} (Pacific time zone, GMT-8).
623 632
624A WWW version of the (somewhat outdated) Emacs 19.34 manual is at 633@uref{www.gnu.org/manual/emacs/index.html}
625 634
626@uref{http://www.cl.cam.ac.uk/texinfodoc/emacs_toc.html} 635@xref{Learning how to do something}, for how to view the manual on-line.
627
628@xref{Learning how to do something} for how to view the manual on-line.
629 636
630@node Emacs Lisp documentation, Installing Texinfo documentation, Getting a printed manual, Getting help 637@node Emacs Lisp documentation, Installing Texinfo documentation, Getting a printed manual, Getting help
631@section Where can I get documentation on Emacs Lisp? 638@section Where can I get documentation on Emacs Lisp?
@@ -647,18 +654,14 @@ files) is available at
647 654
648@uref{ftp://ftp.gnu.org/pub/gnu/emacs/elisp-manual-20-2.5.tar.gz} 655@uref{ftp://ftp.gnu.org/pub/gnu/emacs/elisp-manual-20-2.5.tar.gz}
649 656
650and all mirrors of @samp{ftp.gnu.org} (@xref{Current GNU distributions} for a 657and all mirrors of @samp{ftp.gnu.org} (@pxref{Current GNU distributions} for a
651list). @xref{Installing Texinfo documentation} if you want to install 658list). @xref{Installing Texinfo documentation}, if you want to install
652the Info files, or @ref{Printing a Texinfo file} if you want to use the 659the Info files, or @ref{Printing a Texinfo file} if you want to use the
653Texinfo source to print the manual yourself. 660Texinfo source to print the manual yourself.
654 661
655WWW versions of the Emacs Lisp Reference Manual are available at 662A WWW version of the Emacs Lisp Reference Manual is available at
656
657@uref{http://www.cl.cam.ac.uk/texinfodoc/elisp_1.html}
658
659and
660 663
661@uref{http://www.cs.indiana.edu/usr/local/www/elisp/lispref/elisp_toc.html} 664@uref{http://www.gnu.org/manual/elisp-manual-20-2.5/elisp.html}
662 665
663@node Installing Texinfo documentation, Printing a Texinfo file, Emacs Lisp documentation, Getting help 666@node Installing Texinfo documentation, Printing a Texinfo file, Emacs Lisp documentation, Getting help
664@section How do I install a piece of Texinfo documentation? 667@section How do I install a piece of Texinfo documentation?
@@ -673,7 +676,7 @@ Texinfo package at
673 676
674@uref{ftp://ftp.gnu.org/pub/gnu/texinfo/texinfo-3.12.tar.gz} 677@uref{ftp://ftp.gnu.org/pub/gnu/texinfo/texinfo-3.12.tar.gz}
675 678
676and all mirrors of @samp{ftp.gnu.org} (@xref{Current GNU distributions} for a list). 679and all mirrors of @samp{ftp.gnu.org} (@pxref{Current GNU distributions} for a list).
677 680
678For information about the Texinfo format, read the Texinfo manual which 681For information about the Texinfo format, read the Texinfo manual which
679comes with Emacs. This manual also comes installed in Info format, so 682comes with Emacs. This manual also comes installed in Info format, so
@@ -685,7 +688,7 @@ resulting Info files in Emacs's Info tree. To install Info files:
685@enumerate 688@enumerate
686 689
687@item Move the files to the @file{info} directory in the installed Emacs 690@item Move the files to the @file{info} directory in the installed Emacs
688 distribution. @xref{Filename conventions} if you don't know where that is. 691 distribution. @xref{Filename conventions}, if you don't know where that is.
689 692
690@item Edit the file @file{info/dir} in the installed Emacs distribution, 693@item Edit the file @file{info/dir} in the installed Emacs distribution,
691 and add a line for the top level node in the Info package that you are 694 and add a line for the top level node in the Info package that you are
@@ -770,7 +773,7 @@ Assuming you have @TeX{} installed on your system, follow these steps:
770@end enumerate 773@end enumerate
771 774
772To get more general instructions, retrieve the latest Texinfo package 775To get more general instructions, retrieve the latest Texinfo package
773(@xref{Installing Texinfo documentation}). 776(@pxref{Installing Texinfo documentation}).
774 777
775@node Viewing Info files outside of Emacs, Informational files for Emacs, Printing a Texinfo file, Getting help 778@node Viewing Info files outside of Emacs, Informational files for Emacs, Printing a Texinfo file, Getting help
776@section Can I view Info files without using Emacs? 779@section Can I view Info files without using Emacs?
@@ -783,12 +786,12 @@ Yes. Here are some alternative programs:
783@itemize @bullet 786@itemize @bullet
784 787
785@item Info, a stand-alone version of the Info program, comes as part of the 788@item Info, a stand-alone version of the Info program, comes as part of the
786Texinfo package. @xref{Installing Texinfo documentation} for details. 789Texinfo package. @xref{Installing Texinfo documentation}, for details.
787 790
788@item Xinfo, a stand-alone version of the Info program that runs under X 791@item Xinfo, a stand-alone version of the Info program that runs under X
789Windows. You can get it at 792Windows. You can get it at
790@uref{ftp://ftp.gnu.org/pub/gnu/xinfo/xinfo-1.01.01.tar.gz} and all 793@uref{ftp://ftp.gnu.org/pub/gnu/xinfo/xinfo-1.01.01.tar.gz} and all
791mirrors of @samp{ftp.gnu.org} (@xref{Current GNU distributions} for a list). 794mirrors of @samp{ftp.gnu.org} (@pxref{Current GNU distributions} for a list).
792 795
793@item Tkinfo, an Info viewer that runs under X Windows and uses Tcl/Tk. You 796@item Tkinfo, an Info viewer that runs under X Windows and uses Tcl/Tk. You
794can get Tkinfo at @uref{http://math-www.uni-paderborn.de/~axel/tkinfo/}. 797can get Tkinfo at @uref{http://math-www.uni-paderborn.de/~axel/tkinfo/}.
@@ -877,7 +880,7 @@ at
877@cindex Installation help 880@cindex Installation help
878@cindex Help installing Emacs 881@cindex Help installing Emacs
879 882
880@xref{Installing Emacs} for some basic installation hints, and question 883@xref{Installing Emacs}, for some basic installation hints, and question
88183 if you have problems with the installation. 88483 if you have problems with the installation.
882 885
883The file @file{etc/SERVICE} (@pxref{Filename conventions} if you're not 886The file @file{etc/SERVICE} (@pxref{Filename conventions} if you're not
@@ -1019,7 +1022,7 @@ name, check out @file{etc/JOKES} (@pxref{Filename conventions}).
1019@cindex Version, latest 1022@cindex Version, latest
1020@cindex Latest version 1023@cindex Latest version
1021 1024
1022Emacs 20.4 is the current version as of this writing. 1025Emacs 20.5 is the current version as of this writing.
1023 1026
1024@node New in Emacs 20, , Latest version of Emacs, Status of Emacs 1027@node New in Emacs 20, , Latest version of Emacs, Status of Emacs
1025@section What is different about Emacs 20? 1028@section What is different about Emacs 20?
@@ -1186,7 +1189,7 @@ this variable.
1186 1189
1187Users of all Emacs versions can display the current column using 1190Users of all Emacs versions can display the current column using
1188@email{abraham@@iesd.auc.dk, Per Abrahamsen's} "column" package. 1191@email{abraham@@iesd.auc.dk, Per Abrahamsen's} "column" package.
1189@xref{Packages that do not come with Emacs} for instructions on how to 1192@xref{Packages that do not come with Emacs}, for instructions on how to
1190get it. 1193get it.
1191 1194
1192None of the vi emulation modes provide the "set number" capability of vi 1195None of the vi emulation modes provide the "set number" capability of vi
@@ -1532,8 +1535,8 @@ at
1532 1535
1533The variable @code{compilation-error-regexp-alist} helps control how 1536The variable @code{compilation-error-regexp-alist} helps control how
1534Emacs parses your compiler output. It is a list of triples of the form: 1537Emacs parses your compiler output. It is a list of triples of the form:
1535@var{(REGEXP FILE-IDX LINE-IDX)}, where @var{REGEXP}, @var{FILE-IDX} and 1538@code{(@var{regexp} @var{file-idx} @var{line-idx})}, where @var{regexp}, @var{file-idx} and
1536@var{LINE-IDX} are strings. To help determine what the constituent 1539@var{line-idx} are strings. To help determine what the constituent
1537elements should be, load @file{compile.el} and then use @kbd{C-h v 1540elements should be, load @file{compile.el} and then use @kbd{C-h v
1538compilation-error-regexp-alist @key{RET}} 1541compilation-error-regexp-alist @key{RET}}
1539 1542
@@ -1905,7 +1908,7 @@ If you are trying to prefix a yanked mail message with @samp{>}, you
1905might want to set the variable @code{mail-yank-prefix}. Better yet, get 1908might want to set the variable @code{mail-yank-prefix}. Better yet, get
1906the Supercite package (@pxref{Supercite}), which provides flexible 1909the Supercite package (@pxref{Supercite}), which provides flexible
1907citation for yanked mail and news messages. @xref{Changing the included 1910citation for yanked mail and news messages. @xref{Changing the included
1908text prefix} for additional information. 1911text prefix}, for additional information.
1909 1912
1910@node Underlining paragraphs, Repeating a command as many times as possible, Inserting > at the beginning of each line, Common requests 1913@node Underlining paragraphs, Repeating a command as many times as possible, Inserting > at the beginning of each line, Common requests
1911@section How do I insert "_^H" before each character in a region to get an underlined paragraph? 1914@section How do I insert "_^H" before each character in a region to get an underlined paragraph?
@@ -2134,7 +2137,7 @@ To move a menu option from one position to another, simply evaluate
2134 2137
2135More detailed information --- and more examples of how to create and 2138More detailed information --- and more examples of how to create and
2136modify menu options --- are in the Emacs Lisp Reference Manual, under 2139modify menu options --- are in the Emacs Lisp Reference Manual, under
2137"Keymaps." (@xref{Emacs Lisp documentation} for information on this 2140"Keymaps". (@pxref{Emacs Lisp documentation} for information on this
2138manual.) 2141manual.)
2139 2142
2140@node Deleting menus and menu options, Turning on syntax highlighting, Modifying pull-down menus, Common requests 2143@node Deleting menus and menu options, Turning on syntax highlighting, Modifying pull-down menus, Common requests
@@ -2829,20 +2832,20 @@ from scratch. You will need:
2829@itemize @bullet 2832@itemize @bullet
2830 2833
2831@item 2834@item
2832Emacs sources. @xref{Current GNU distributions} for a list of ftp sites 2835Emacs sources. @xref{Current GNU distributions}, for a list of ftp sites
2833that make them available. On @file{ftp.gnu.org}, the main GNU 2836that make them available. On @file{ftp.gnu.org}, the main GNU
2834distribution site, sources are available at 2837distribution site, sources are available at
2835 2838
2836@uref{ftp://ftp.gnu.org/pub/gnu/emacs/emacs-20.4.tar.gz} 2839@uref{ftp://ftp.gnu.org/pub/gnu/emacs/emacs-20.5.tar.gz}
2837 2840
2838The above will obviously change as new versions of Emacs come out. For 2841The above will obviously change as new versions of Emacs come out. For
2839instance, when Emacs 20.5 is released, it will most probably be 2842instance, when Emacs 21 is released, it will most probably be
2840available at 2843available at
2841 2844
2842@uref{ftp://ftp.gnu.org/pub/gnu/emacs/emacs-20.5.tar.gz} 2845@uref{ftp://ftp.gnu.org/pub/gnu/emacs/emacs-21.1.tar.gz}
2843 2846
2844Again, you should use one of the GNU mirror sites (@xref{Current GNU 2847Again, you should use one of the GNU mirror sites (@xref{Current GNU
2845distributions} and adjust the URL accordingly) so as to reduce load on 2848distributions}, and adjust the URL accordingly) so as to reduce load on
2846@file{ftp.gnu.org}. 2849@file{ftp.gnu.org}.
2847 2850
2848@item 2851@item
@@ -2853,11 +2856,11 @@ retrieved the Emacs sources, you will probably be able to uncompress
2853them with the command 2856them with the command
2854 2857
2855@example 2858@example
2856gunzip --verbose emacs-20.4.tar.gz 2859gunzip --verbose emacs-20.5.tar.gz
2857@end example 2860@end example
2858 2861
2859changing the Emacs version (20.4), as necessary. Once gunzip has 2862changing the Emacs version (20.5), as necessary. Once gunzip has
2860finished doing its job, a file by the name of "emacs-20.4.tar" should 2863finished doing its job, a file by the name of "emacs-20.5.tar" should
2861be in your build directory. 2864be in your build directory.
2862 2865
2863@item 2866@item
@@ -2868,7 +2871,7 @@ extracted using @file{tar} before you can build Emacs. Typically, the
2868extraction command would look like 2871extraction command would look like
2869 2872
2870@example 2873@example
2871tar -xvvf emacs-20.4.tar 2874tar -xvvf emacs-20.5.tar
2872@end example 2875@end example
2873 2876
2874The @samp{x} indicates that we want to extract files from this tarfile, 2877The @samp{x} indicates that we want to extract files from this tarfile,
@@ -2880,7 +2883,7 @@ If you're using GNU @file{tar} (available at mirrors of
2880using the command 2883using the command
2881 2884
2882@example 2885@example
2883tar -zxvvf emacs-20.4.tar.gz 2886tar -zxvvf emacs-20.5.tar.gz
2884@end example 2887@end example
2885 2888
2886The additional @samp{z} at the beginning of the options list tells GNU tar 2889The additional @samp{z} at the beginning of the options list tells GNU tar
@@ -2890,18 +2893,18 @@ components.
2890@end itemize 2893@end itemize
2891 2894
2892At this point, the Emacs sources (all 25+ megabytes of them) should be 2895At this point, the Emacs sources (all 25+ megabytes of them) should be
2893sitting in a directory called @file{emacs-20.4}. On most common Unix and 2896sitting in a directory called @file{emacs-20.5}. On most common Unix and
2894Unix-like systems, you should be able to compile Emacs (with X Windows 2897Unix-like systems, you should be able to compile Emacs (with X Windows
2895support) with the following commands: 2898support) with the following commands:
2896 2899
2897@example 2900@example
2898cd emacs-20.4 # change directory to emacs-20.4 2901cd emacs-20.5 # change directory to emacs-20.5
2899./configure # configure Emacs for your particular system 2902./configure # configure Emacs for your particular system
2900make # use Makefile to build components, then Emacs 2903make # use Makefile to build components, then Emacs
2901@end example 2904@end example
2902 2905
2903If the @code{make} completes successfully, the odds are fairly good that 2906If the @code{make} completes successfully, the odds are fairly good that
2904the build has gone well. (@xref{Problems building Emacs} if you weren't 2907the build has gone well. (@pxref{Problems building Emacs} if you weren't
2905successful.) 2908successful.)
2906 2909
2907By default, Emacs is installed in the following directories: 2910By default, Emacs is installed in the following directories:
@@ -2939,8 +2942,8 @@ come with the Emacs sources, in the file @file{INSTALL}.
2939@xref{Installing Emacs}, and follow the instructions there for 2942@xref{Installing Emacs}, and follow the instructions there for
2940installation. 2943installation.
2941 2944
2942Most files are placed in version-specific directories. Emacs 20.4, for 2945Most files are placed in version-specific directories. Emacs 20.5, for
2943instance, places files in @file{/usr/local/share/emacs/20.4}. 2946instance, places files in @file{/usr/local/share/emacs/20.5}.
2944 2947
2945Upgrading should overwrite only, @file{/usr/local/bin/emacs} (the Emacs 2948Upgrading should overwrite only, @file{/usr/local/bin/emacs} (the Emacs
2946binary) and documentation in @file{/usr/local/info}. Back up these 2949binary) and documentation in @file{/usr/local/info}. Back up these
@@ -3035,7 +3038,7 @@ on nearby archive sites and @file{etc/ORDERS} for mail orders. If you
3035don't already have Emacs, @pxref{Informational files for Emacs} for how 3038don't already have Emacs, @pxref{Informational files for Emacs} for how
3036to get these files. 3039to get these files.
3037 3040
3038@xref{Installing Emacs} for information on how to obtain and build the latest 3041@xref{Installing Emacs}, for information on how to obtain and build the latest
3039version of Emacs, and @pxref{Current GNU distributions} for a list of 3042version of Emacs, and @pxref{Current GNU distributions} for a list of
3040archive sites that make GNU software available. 3043archive sites that make GNU software available.
3041 3044
@@ -3191,29 +3194,24 @@ XEmacs, which began life as Lucid Emacs, is based on an early version of
3191Emacs 19 and Epoch, an X-aware version of Emacs 18. 3194Emacs 19 and Epoch, an X-aware version of Emacs 18.
3192 3195
3193Emacs (i.e., the version distributed by the FSF) has a larger installed 3196Emacs (i.e., the version distributed by the FSF) has a larger installed
3194base, while XEmacs can do some clever tricks with X Windows, such as 3197base and now always contains the MULE multilingual facilities.
3195putting arbitrary graphics in a buffer. Emacs and XEmacs each come with 3198XEmacs can do some clever tricks with X Windows, such as
3199putting arbitrary graphics in a buffer. Similar facilities have been
3200implemented for Emacs as part of a new redisplay implementation for
3201Emacs 21, expected to be released after Emacs 20.5.
3202Emacs and XEmacs each come with
3196Lisp packages that are lacking in the other; RMS says that the FSF would 3203Lisp packages that are lacking in the other; RMS says that the FSF would
3197include more packages that come with XEmacs, but that the XEmacs 3204include more packages that come with XEmacs, but that the XEmacs
3198maintainers don't always keep track of the authors of contributed code, 3205maintainers don't always keep track of the authors of contributed code,
3199which makes it impossible for the FSF to have certain legal papers 3206which makes it impossible for the FSF to have certain legal papers
3200signed. (Without these legal papers, the FSF will not distribute Lisp 3207signed. (Without these legal papers, the FSF will not distribute Lisp
3201packages with Emacs.) 3208packages with Emacs.) The two versions have some
3209significant differences at the Lisp programming level.
3202 3210
3203Many XEmacs features have found their way into recent versions of Emacs, 3211Many XEmacs features have found their way into recent versions of Emacs,
3204and more features can be expected in the future, but there are still many 3212and more features can be expected in the future, but there are still many
3205differences between the two. 3213differences between the two.
3206 3214
3207The latest version of XEmacs as of this writing is 21.1; you can get it
3208at
3209
3210@uref{ftp://ftp.xemacs.org/pub/xemacs/current/xemacs-21.1.4.tar.gz}
3211
3212More information about XEmacs, including a list of frequently asked
3213questions (FAQ), is available at
3214
3215@uref{http://www.xemacs.org/faq/}
3216
3217@node Emacs for MS-DOS, Emacs for Windows, Difference between Emacs and XEmacs, Finding Emacs and related packages 3215@node Emacs for MS-DOS, Emacs for Windows, Difference between Emacs and XEmacs, Finding Emacs and related packages
3218@section Where can I get Emacs for my PC running MS-DOS? 3216@section Where can I get Emacs for my PC running MS-DOS?
3219@cindex MS-DOS, Emacs for 3217@cindex MS-DOS, Emacs for
@@ -3224,8 +3222,8 @@ questions (FAQ), is available at
3224 3222
3225A pre-built binary distribution of Emacs is available from the Simtel 3223A pre-built binary distribution of Emacs is available from the Simtel
3226archives. This version apparently works under MS-DOS and Windows (3.x, 3224archives. This version apparently works under MS-DOS and Windows (3.x,
322795, and NT) and supports long file names. More information is availble 322595x, and NT) and supports long file names under Windows 9x. More
3228from 3226information is available from
3229 3227
3230@uref{ftp://ftp.simtel.net/pub/simtelnet/gnu/djgpp/v2gnu/emacs.README} 3228@uref{ftp://ftp.simtel.net/pub/simtelnet/gnu/djgpp/v2gnu/emacs.README}
3231 3229
@@ -3234,8 +3232,9 @@ directory
3234 3232
3235@uref{ftp://ftp.simtel.net/pub/simtelnet/gnu/djgpp/v2gnu/} 3233@uref{ftp://ftp.simtel.net/pub/simtelnet/gnu/djgpp/v2gnu/}
3236 3234
3237If you prefer to compile Emacs for yourself, you will need a 386 (or 3235If you prefer to compile Emacs for yourself, you can do so with the
3238better) processor, and are running MS-DOS 3.0 or later. According to 3236current distribution directly. You will need a 386 (or
3237better) processor, and to be running MS-DOS 3.0 or later. According to
3239@email{eliz@@is.elta.co.il, Eli Zaretskii} and 3238@email{eliz@@is.elta.co.il, Eli Zaretskii} and
3240@email{hankedr@@dms.auburn.edu, Darrel Hankerson}, you will need the 3239@email{hankedr@@dms.auburn.edu, Darrel Hankerson}, you will need the
3241following: 3240following:
@@ -3245,7 +3244,7 @@ following:
3245@item Compiler 3244@item Compiler
3246djgpp version 1.12 maint 1 or later. Djgpp 2.0 or later is 3245djgpp version 1.12 maint 1 or later. Djgpp 2.0 or later is
3247recommended, since 1.x is being phased out. Djgpp 2 supports 3246recommended, since 1.x is being phased out. Djgpp 2 supports
3248long filenames under Windows 95. 3247long filenames under Windows 9x.
3249 3248
3250You can get the latest release of djgpp by retrieving all of 3249You can get the latest release of djgpp by retrieving all of
3251the files in 3250the files in
@@ -3292,9 +3291,9 @@ lack certain features, such as the Emacs Lisp extension language.
3292For information on Emacs for Windows 95 and NT, read the FAQ produced by 3291For information on Emacs for Windows 95 and NT, read the FAQ produced by
3293@email{voelker@@cs.washington.edu, Geoff Voelker}, available at 3292@email{voelker@@cs.washington.edu, Geoff Voelker}, available at
3294 3293
3295@uref{http://www.cs.washington.edu/homes/voelker/ntemacs.html} 3294@uref{http://www.gnu.org/software/emacs/windows/ntemacs.html}
3296 3295
3297@xref{Emacs for MS-DOS} for Windows 3.1. 3296@xref{Emacs for MS-DOS}, for Windows 3.1.
3298 3297
3299@node Emacs for OS/2, Emacs for Atari ST, Emacs for Windows, Finding Emacs and related packages 3298@node Emacs for OS/2, Emacs for Atari ST, Emacs for Windows, Finding Emacs and related packages
3300@section Where can I get Emacs for my PC running OS/2? 3299@section Where can I get Emacs for my PC running OS/2?
@@ -3343,11 +3342,11 @@ An unofficial port of GNU Emacs 18.59 to the Macintosh is available at a
3343number of ftp sites, the home being 3342number of ftp sites, the home being
3344@uref{ftp://ftp.cs.cornell.edu/pub/parmet/Emacs-1.17.sit.bin}. 3343@uref{ftp://ftp.cs.cornell.edu/pub/parmet/Emacs-1.17.sit.bin}.
3345 3344
3346To the best of our knowledge, Emacs 19 has not been ported to the 3345A port of Emacs 20.4 is available at
3347Macintosh. 3346@uref{http://www.cs.hku.hk/~choi/emacs/index.html}.
3348 3347
3349Apple's forthcoming "OS X" is based largely on NeXTSTEP and OpenStep. 3348Apple's forthcoming "OS X" is based largely on NeXTSTEP and OpenStep.
3350@xref{Emacs for NeXTSTEP} for more details about that version. 3349@xref{Emacs for NeXTSTEP}, for more details about that version.
3351 3350
3352@node Emacs for VMS and DECwindows, Modes for various languages, Emacs for Apple computers, Finding Emacs and related packages 3351@node Emacs for VMS and DECwindows, Modes for various languages, Emacs for Apple computers, Finding Emacs and related packages
3353@section Where do I get Emacs that runs on VMS under DECwindows? 3352@section Where do I get Emacs that runs on VMS under DECwindows?
@@ -3740,7 +3739,7 @@ jde-subscribe@@sunsite.auc.dk
37402.5 37392.5
3741 3740
3742@item Distribution 3741@item Distribution
3743@xref{Current GNU distributions} 3742@xref{Current GNU distributions}.
3744 3743
3745@end table 3744@end table
3746 3745
@@ -3885,7 +3884,7 @@ For information on what Emacs does every time it is started, see the
3885@cindex X Windows and function keys 3884@cindex X Windows and function keys
3886@cindex Binding function keys 3885@cindex Binding function keys
3887 3886
3888With Emacs 19, functions keys under X are bound like any other key. @xref{Binding keys to commands} for details. 3887With Emacs 19, functions keys under X are bound like any other key. @xref{Binding keys to commands}, for details.
3889 3888
3890@node Working with function and arrow keys, X key translations for Emacs, Using function keys under X, Key bindings 3889@node Working with function and arrow keys, X key translations for Emacs, Using function keys under X, Key bindings
3891@section How do I tell what characters or symbols my function or arrow keys emit? 3890@section How do I tell what characters or symbols my function or arrow keys emit?
@@ -4044,12 +4043,12 @@ the top-level directory when you unpack the Emacs source).
4044 4043
4045To bind @kbd{C-s} and @kbd{C-q}, use either @code{enable-flow-control} 4044To bind @kbd{C-s} and @kbd{C-q}, use either @code{enable-flow-control}
4046or @sc{enable-flow-control-on}. @xref{Handling C-s and C-q with flow 4045or @sc{enable-flow-control-on}. @xref{Handling C-s and C-q with flow
4047control} for usage and implementation details. 4046control}, for usage and implementation details.
4048 4047
4049To bind other keys, use @code{keyboard-translate}. @xref{Swapping keys} 4048To bind other keys, use @code{keyboard-translate}. @xref{Swapping keys},
4050for usage details. To do this for an entire site, you should swap the 4049for usage details. To do this for an entire site, you should swap the
4051keys in @file{lisp/site-start.el}. @xref{Handling C-s and C-q with flow 4050keys in @file{lisp/site-start.el}. @xref{Handling C-s and C-q with flow
4052control} for an explanation of why @file{lisp/default.el} should not be 4051control}, for an explanation of why @file{lisp/default.el} should not be
4053used. 4052used.
4054 4053
4055@itemize @bullet 4054@itemize @bullet
@@ -4108,7 +4107,7 @@ Under X or on a dumb terminal, it is possible to swap the
4108(keyboard-translate ?\C-h ?\C-?) 4107(keyboard-translate ?\C-h ?\C-?)
4109@end lisp 4108@end lisp
4110 4109
4111@xref{Swapping keys} for further details of "keyboard-translate". 4110@xref{Swapping keys}, for further details of "keyboard-translate".
4112 4111
4113@item 4112@item
4114Another approach is to switch key bindings and put help on @kbd{C-x h} 4113Another approach is to switch key bindings and put help on @kbd{C-x h}
@@ -4271,7 +4270,7 @@ are such keys). Non-ASCII keys and mouse events (e.g. @kbd{C-=} and
4271 4270
4272@end itemize 4271@end itemize
4273 4272
4274@xref{Binding keys to commands} for general key binding instructions. 4273@xref{Binding keys to commands}, for general key binding instructions.
4275 4274
4276@node Meta key does not work in xterm, ExtendChar key does not work as Meta, Binding combinations of modifiers and function keys, Key bindings 4275@node Meta key does not work in xterm, ExtendChar key does not work as Meta, Binding combinations of modifiers and function keys, Key bindings
4277@section Why doesn't my @key{Meta} key work in an xterm window? 4276@section Why doesn't my @key{Meta} key work in an xterm window?
@@ -4422,7 +4421,7 @@ code 0264).
4422@cindex Korean, handling with Emacs 4421@cindex Korean, handling with Emacs
4423 4422
4424Emacs 20 now includes many of the features of MULE, the Multilingual 4423Emacs 20 now includes many of the features of MULE, the Multilingual
4425Enhancement of Emacs. @xref{Installing Emacs} for information on where 4424Enhancement of Emacs. @xref{Installing Emacs}, for information on where
4426to find and download Emacs. 4425to find and download Emacs.
4427 4426
4428@node Right-to-left alphabets, , Kanji and Chinese characters, Alternate character sets 4427@node Right-to-left alphabets, , Kanji and Chinese characters, Alternate character sets
@@ -4721,7 +4720,7 @@ telnetting to the NNTP port (usually 119) on the news server machine
4721(i.e., "telnet server-machine 119"). The server should give its version 4720(i.e., "telnet server-machine 119"). The server should give its version
4722number in the welcome message. Type "quit" to get out. 4721number in the welcome message. Type "quit" to get out.
4723 4722
4724@xref{Spontaneous entry into isearch-mode} for some additional ideas. 4723@xref{Spontaneous entry into isearch-mode}, for some additional ideas.
4725 4724
4726@node Viewing articles with embedded underlining, Saving a multi-part Gnus posting, Gnus does not work with NNTP, Mail and news 4725@node Viewing articles with embedded underlining, Saving a multi-part Gnus posting, Gnus does not work with NNTP, Mail and news
4727@section How do I view news articles with embedded underlining (e.g., ClariNews)? 4726@section How do I view news articles with embedded underlining (e.g., ClariNews)?