diff options
| author | Dave Love | 1999-09-01 11:14:20 +0000 |
|---|---|---|
| committer | Dave Love | 1999-09-01 11:14:20 +0000 |
| commit | 0d17cd5c7106db414fe71bb799bc9fd8adf2495d (patch) | |
| tree | 78e406deb340101cd6a97bda08a6adcc3277833e | |
| parent | 71e6882726cc7904f4e1852d6e703590748150d6 (diff) | |
| download | emacs-0d17cd5c7106db414fe71bb799bc9fd8adf2495d.tar.gz emacs-0d17cd5c7106db414fe71bb799bc9fd8adf2495d.zip | |
General changes sent to Lerner, plus some XEmacs expurgation.
| -rw-r--r-- | man/faq.texi | 167 |
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 | |||
| 11 | Copyright 1994-1999 Reuven M. Lerner@* | 16 | Copyright 1994-1999 Reuven M. Lerner@* |
| 12 | Copyright 1992-1993 Steven Byrnes@* | 17 | Copyright 1992-1993 Steven Byrnes@* |
| 13 | Copyright 1990-1992 Joseph Brian Wells@* | 18 | Copyright 1990-1992 Joseph Brian Wells@* |
| @@ -25,6 +30,10 @@ latest version of the FAQ is archived (including FTP information). | |||
| 25 | The FAQ may be copied and redistributed under these conditions, except that | 30 | The FAQ may be copied and redistributed under these conditions, except that |
| 26 | the FAQ may not be embedded in a larger literary work unless that work | 31 | the FAQ may not be embedded in a larger literary work unless that work |
| 27 | itself allows free copying and redistribution. | 32 | itself 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). | |||
| 52 | The FAQ may be copied and redistributed under these conditions, except that | 61 | The FAQ may be copied and redistributed under these conditions, except that |
| 53 | the FAQ may not be embedded in a larger literary work unless that work | 62 | the FAQ may not be embedded in a larger literary work unless that work |
| 54 | itself allows free copying and redistribution. | 63 | itself 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 | |||
| 167 | Also, on very few keyboards does @kbd{C-?} generate ASCII code 127. | 179 | Also, 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} |
| 170 | for more information. (@xref{On-line manual} for more information about | 182 | for more information. (@pxref{On-line manual} for more information about |
| 171 | Info.) | 183 | Info.) |
| 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 |
| 180 | command, then type @key{RET}. (@xref{Basic keys} if you're not sure | 192 | command, then type @key{RET}. (@pxref{Basic keys} if you're not sure |
| 181 | what @kbd{M-x} and @key{RET} mean.) | 193 | what @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 | |||
| 214 | Your system administrator may not have installed the Info files, or may | 226 | Your system administrator may not have installed the Info files, or may |
| 215 | have installed them improperly. In this case you should complain. | 227 | have 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 |
| 218 | Emacs manual. | 230 | Emacs 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 | ||
| 371 | The file @file{etc/MAILINGLISTS} discusses the purpose of each GNU | 383 | The file @file{etc/MAILINGLISTS} discusses the purpose of each GNU |
| 372 | mailing-list. (@xref{Informational files for Emacs} if you want a copy | 384 | mailing-list. (@pxref{Informational files for Emacs} if you want a copy |
| 373 | of the file.) For those lists which are gatewayed with newsgroups, it | 385 | of the file.) For those lists which are gatewayed with newsgroups, it |
| 374 | lists both the newsgroup name and the mailing list address. | 386 | lists 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 | ||
| 428 | Be sure to read the "Bugs" section of the Emacs manual before reporting | 440 | Be sure to read the "Bugs" section of the Emacs manual before reporting |
| 429 | a bug to bug-gnu-emacs! The manual describes in detail how to submit a | 441 | a bug to bug-gnu-emacs! The manual describes in detail how to submit a |
| 430 | useful bug report. (@xref{On-line manual} if you don't know how to read the | 442 | useful bug report. (@pxref{On-line manual} if you don't know how to read the |
| 431 | manual.) | 443 | manual.) |
| 432 | 444 | ||
| 433 | RMS says: | 445 | RMS says: |
| @@ -614,18 +626,13 @@ file}). | |||
| 614 | If you absolutely have to print your own copy, and you don't have @TeX{}, | 626 | If you absolutely have to print your own copy, and you don't have @TeX{}, |
| 615 | you can get a PostScript version from | 627 | you 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 | ||
| 619 | Note that the above document is somewhat out of date, although most | 631 | A WWW version of the manual is at |
| 620 | major concepts are still relevant. This site requests that you please | ||
| 621 | @emph{confine any major ftping to late evenings or early mornings, local | ||
| 622 | time} (Pacific time zone, GMT-8). | ||
| 623 | 632 | ||
| 624 | A 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 | ||
| 650 | and all mirrors of @samp{ftp.gnu.org} (@xref{Current GNU distributions} for a | 657 | and all mirrors of @samp{ftp.gnu.org} (@pxref{Current GNU distributions} for a |
| 651 | list). @xref{Installing Texinfo documentation} if you want to install | 658 | list). @xref{Installing Texinfo documentation}, if you want to install |
| 652 | the Info files, or @ref{Printing a Texinfo file} if you want to use the | 659 | the Info files, or @ref{Printing a Texinfo file} if you want to use the |
| 653 | Texinfo source to print the manual yourself. | 660 | Texinfo source to print the manual yourself. |
| 654 | 661 | ||
| 655 | WWW versions of the Emacs Lisp Reference Manual are available at | 662 | A 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 | |||
| 659 | and | ||
| 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 | ||
| 676 | and all mirrors of @samp{ftp.gnu.org} (@xref{Current GNU distributions} for a list). | 679 | and all mirrors of @samp{ftp.gnu.org} (@pxref{Current GNU distributions} for a list). |
| 677 | 680 | ||
| 678 | For information about the Texinfo format, read the Texinfo manual which | 681 | For information about the Texinfo format, read the Texinfo manual which |
| 679 | comes with Emacs. This manual also comes installed in Info format, so | 682 | comes 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 | ||
| 772 | To get more general instructions, retrieve the latest Texinfo package | 775 | To 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 |
| 786 | Texinfo package. @xref{Installing Texinfo documentation} for details. | 789 | Texinfo 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 |
| 789 | Windows. You can get it at | 792 | Windows. 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 |
| 791 | mirrors of @samp{ftp.gnu.org} (@xref{Current GNU distributions} for a list). | 794 | mirrors 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 |
| 794 | can get Tkinfo at @uref{http://math-www.uni-paderborn.de/~axel/tkinfo/}. | 797 | can 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 |
| 881 | 83 if you have problems with the installation. | 884 | 83 if you have problems with the installation. |
| 882 | 885 | ||
| 883 | The file @file{etc/SERVICE} (@pxref{Filename conventions} if you're not | 886 | The 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 | ||
| 1022 | Emacs 20.4 is the current version as of this writing. | 1025 | Emacs 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 | ||
| 1187 | Users of all Emacs versions can display the current column using | 1190 | Users 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 |
| 1190 | get it. | 1193 | get it. |
| 1191 | 1194 | ||
| 1192 | None of the vi emulation modes provide the "set number" capability of vi | 1195 | None of the vi emulation modes provide the "set number" capability of vi |
| @@ -1532,8 +1535,8 @@ at | |||
| 1532 | 1535 | ||
| 1533 | The variable @code{compilation-error-regexp-alist} helps control how | 1536 | The variable @code{compilation-error-regexp-alist} helps control how |
| 1534 | Emacs parses your compiler output. It is a list of triples of the form: | 1537 | Emacs 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 |
| 1537 | elements should be, load @file{compile.el} and then use @kbd{C-h v | 1540 | elements should be, load @file{compile.el} and then use @kbd{C-h v |
| 1538 | compilation-error-regexp-alist @key{RET}} | 1541 | compilation-error-regexp-alist @key{RET}} |
| 1539 | 1542 | ||
| @@ -1905,7 +1908,7 @@ If you are trying to prefix a yanked mail message with @samp{>}, you | |||
| 1905 | might want to set the variable @code{mail-yank-prefix}. Better yet, get | 1908 | might want to set the variable @code{mail-yank-prefix}. Better yet, get |
| 1906 | the Supercite package (@pxref{Supercite}), which provides flexible | 1909 | the Supercite package (@pxref{Supercite}), which provides flexible |
| 1907 | citation for yanked mail and news messages. @xref{Changing the included | 1910 | citation for yanked mail and news messages. @xref{Changing the included |
| 1908 | text prefix} for additional information. | 1911 | text 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 | ||
| 2135 | More detailed information --- and more examples of how to create and | 2138 | More detailed information --- and more examples of how to create and |
| 2136 | modify menu options --- are in the Emacs Lisp Reference Manual, under | 2139 | modify 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 |
| 2138 | manual.) | 2141 | manual.) |
| 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 |
| 2832 | Emacs sources. @xref{Current GNU distributions} for a list of ftp sites | 2835 | Emacs sources. @xref{Current GNU distributions}, for a list of ftp sites |
| 2833 | that make them available. On @file{ftp.gnu.org}, the main GNU | 2836 | that make them available. On @file{ftp.gnu.org}, the main GNU |
| 2834 | distribution site, sources are available at | 2837 | distribution 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 | ||
| 2838 | The above will obviously change as new versions of Emacs come out. For | 2841 | The above will obviously change as new versions of Emacs come out. For |
| 2839 | instance, when Emacs 20.5 is released, it will most probably be | 2842 | instance, when Emacs 21 is released, it will most probably be |
| 2840 | available at | 2843 | available 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 | ||
| 2844 | Again, you should use one of the GNU mirror sites (@xref{Current GNU | 2847 | Again, you should use one of the GNU mirror sites (@xref{Current GNU |
| 2845 | distributions} and adjust the URL accordingly) so as to reduce load on | 2848 | distributions}, 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 | |||
| 2853 | them with the command | 2856 | them with the command |
| 2854 | 2857 | ||
| 2855 | @example | 2858 | @example |
| 2856 | gunzip --verbose emacs-20.4.tar.gz | 2859 | gunzip --verbose emacs-20.5.tar.gz |
| 2857 | @end example | 2860 | @end example |
| 2858 | 2861 | ||
| 2859 | changing the Emacs version (20.4), as necessary. Once gunzip has | 2862 | changing the Emacs version (20.5), as necessary. Once gunzip has |
| 2860 | finished doing its job, a file by the name of "emacs-20.4.tar" should | 2863 | finished doing its job, a file by the name of "emacs-20.5.tar" should |
| 2861 | be in your build directory. | 2864 | be 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 | |||
| 2868 | extraction command would look like | 2871 | extraction command would look like |
| 2869 | 2872 | ||
| 2870 | @example | 2873 | @example |
| 2871 | tar -xvvf emacs-20.4.tar | 2874 | tar -xvvf emacs-20.5.tar |
| 2872 | @end example | 2875 | @end example |
| 2873 | 2876 | ||
| 2874 | The @samp{x} indicates that we want to extract files from this tarfile, | 2877 | The @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 | |||
| 2880 | using the command | 2883 | using the command |
| 2881 | 2884 | ||
| 2882 | @example | 2885 | @example |
| 2883 | tar -zxvvf emacs-20.4.tar.gz | 2886 | tar -zxvvf emacs-20.5.tar.gz |
| 2884 | @end example | 2887 | @end example |
| 2885 | 2888 | ||
| 2886 | The additional @samp{z} at the beginning of the options list tells GNU tar | 2889 | The 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 | ||
| 2892 | At this point, the Emacs sources (all 25+ megabytes of them) should be | 2895 | At this point, the Emacs sources (all 25+ megabytes of them) should be |
| 2893 | sitting in a directory called @file{emacs-20.4}. On most common Unix and | 2896 | sitting in a directory called @file{emacs-20.5}. On most common Unix and |
| 2894 | Unix-like systems, you should be able to compile Emacs (with X Windows | 2897 | Unix-like systems, you should be able to compile Emacs (with X Windows |
| 2895 | support) with the following commands: | 2898 | support) with the following commands: |
| 2896 | 2899 | ||
| 2897 | @example | 2900 | @example |
| 2898 | cd emacs-20.4 # change directory to emacs-20.4 | 2901 | cd 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 |
| 2900 | make # use Makefile to build components, then Emacs | 2903 | make # use Makefile to build components, then Emacs |
| 2901 | @end example | 2904 | @end example |
| 2902 | 2905 | ||
| 2903 | If the @code{make} completes successfully, the odds are fairly good that | 2906 | If the @code{make} completes successfully, the odds are fairly good that |
| 2904 | the build has gone well. (@xref{Problems building Emacs} if you weren't | 2907 | the build has gone well. (@pxref{Problems building Emacs} if you weren't |
| 2905 | successful.) | 2908 | successful.) |
| 2906 | 2909 | ||
| 2907 | By default, Emacs is installed in the following directories: | 2910 | By 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 |
| 2940 | installation. | 2943 | installation. |
| 2941 | 2944 | ||
| 2942 | Most files are placed in version-specific directories. Emacs 20.4, for | 2945 | Most files are placed in version-specific directories. Emacs 20.5, for |
| 2943 | instance, places files in @file{/usr/local/share/emacs/20.4}. | 2946 | instance, places files in @file{/usr/local/share/emacs/20.5}. |
| 2944 | 2947 | ||
| 2945 | Upgrading should overwrite only, @file{/usr/local/bin/emacs} (the Emacs | 2948 | Upgrading should overwrite only, @file{/usr/local/bin/emacs} (the Emacs |
| 2946 | binary) and documentation in @file{/usr/local/info}. Back up these | 2949 | binary) 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 | |||
| 3035 | don't already have Emacs, @pxref{Informational files for Emacs} for how | 3038 | don't already have Emacs, @pxref{Informational files for Emacs} for how |
| 3036 | to get these files. | 3039 | to 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 |
| 3039 | version of Emacs, and @pxref{Current GNU distributions} for a list of | 3042 | version of Emacs, and @pxref{Current GNU distributions} for a list of |
| 3040 | archive sites that make GNU software available. | 3043 | archive 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 | |||
| 3191 | Emacs 19 and Epoch, an X-aware version of Emacs 18. | 3194 | Emacs 19 and Epoch, an X-aware version of Emacs 18. |
| 3192 | 3195 | ||
| 3193 | Emacs (i.e., the version distributed by the FSF) has a larger installed | 3196 | Emacs (i.e., the version distributed by the FSF) has a larger installed |
| 3194 | base, while XEmacs can do some clever tricks with X Windows, such as | 3197 | base and now always contains the MULE multilingual facilities. |
| 3195 | putting arbitrary graphics in a buffer. Emacs and XEmacs each come with | 3198 | XEmacs can do some clever tricks with X Windows, such as |
| 3199 | putting arbitrary graphics in a buffer. Similar facilities have been | ||
| 3200 | implemented for Emacs as part of a new redisplay implementation for | ||
| 3201 | Emacs 21, expected to be released after Emacs 20.5. | ||
| 3202 | Emacs and XEmacs each come with | ||
| 3196 | Lisp packages that are lacking in the other; RMS says that the FSF would | 3203 | Lisp packages that are lacking in the other; RMS says that the FSF would |
| 3197 | include more packages that come with XEmacs, but that the XEmacs | 3204 | include more packages that come with XEmacs, but that the XEmacs |
| 3198 | maintainers don't always keep track of the authors of contributed code, | 3205 | maintainers don't always keep track of the authors of contributed code, |
| 3199 | which makes it impossible for the FSF to have certain legal papers | 3206 | which makes it impossible for the FSF to have certain legal papers |
| 3200 | signed. (Without these legal papers, the FSF will not distribute Lisp | 3207 | signed. (Without these legal papers, the FSF will not distribute Lisp |
| 3201 | packages with Emacs.) | 3208 | packages with Emacs.) The two versions have some |
| 3209 | significant differences at the Lisp programming level. | ||
| 3202 | 3210 | ||
| 3203 | Many XEmacs features have found their way into recent versions of Emacs, | 3211 | Many XEmacs features have found their way into recent versions of Emacs, |
| 3204 | and more features can be expected in the future, but there are still many | 3212 | and more features can be expected in the future, but there are still many |
| 3205 | differences between the two. | 3213 | differences between the two. |
| 3206 | 3214 | ||
| 3207 | The latest version of XEmacs as of this writing is 21.1; you can get it | ||
| 3208 | at | ||
| 3209 | |||
| 3210 | @uref{ftp://ftp.xemacs.org/pub/xemacs/current/xemacs-21.1.4.tar.gz} | ||
| 3211 | |||
| 3212 | More information about XEmacs, including a list of frequently asked | ||
| 3213 | questions (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 | ||
| 3225 | A pre-built binary distribution of Emacs is available from the Simtel | 3223 | A pre-built binary distribution of Emacs is available from the Simtel |
| 3226 | archives. This version apparently works under MS-DOS and Windows (3.x, | 3224 | archives. This version apparently works under MS-DOS and Windows (3.x, |
| 3227 | 95, and NT) and supports long file names. More information is availble | 3225 | 95x, and NT) and supports long file names under Windows 9x. More |
| 3228 | from | 3226 | information 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 | ||
| 3237 | If you prefer to compile Emacs for yourself, you will need a 386 (or | 3235 | If you prefer to compile Emacs for yourself, you can do so with the |
| 3238 | better) processor, and are running MS-DOS 3.0 or later. According to | 3236 | current distribution directly. You will need a 386 (or |
| 3237 | better) 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 |
| 3241 | following: | 3240 | following: |
| @@ -3245,7 +3244,7 @@ following: | |||
| 3245 | @item Compiler | 3244 | @item Compiler |
| 3246 | djgpp version 1.12 maint 1 or later. Djgpp 2.0 or later is | 3245 | djgpp version 1.12 maint 1 or later. Djgpp 2.0 or later is |
| 3247 | recommended, since 1.x is being phased out. Djgpp 2 supports | 3246 | recommended, since 1.x is being phased out. Djgpp 2 supports |
| 3248 | long filenames under Windows 95. | 3247 | long filenames under Windows 9x. |
| 3249 | 3248 | ||
| 3250 | You can get the latest release of djgpp by retrieving all of | 3249 | You can get the latest release of djgpp by retrieving all of |
| 3251 | the files in | 3250 | the files in |
| @@ -3292,9 +3291,9 @@ lack certain features, such as the Emacs Lisp extension language. | |||
| 3292 | For information on Emacs for Windows 95 and NT, read the FAQ produced by | 3291 | For 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 | |||
| 3343 | number of ftp sites, the home being | 3342 | number 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 | ||
| 3346 | To the best of our knowledge, Emacs 19 has not been ported to the | 3345 | A port of Emacs 20.4 is available at |
| 3347 | Macintosh. | 3346 | @uref{http://www.cs.hku.hk/~choi/emacs/index.html}. |
| 3348 | 3347 | ||
| 3349 | Apple's forthcoming "OS X" is based largely on NeXTSTEP and OpenStep. | 3348 | Apple'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 | |||
| 3740 | 2.5 | 3739 | 2.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 | ||
| 3888 | With Emacs 19, functions keys under X are bound like any other key. @xref{Binding keys to commands} for details. | 3887 | With 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 | ||
| 4045 | To bind @kbd{C-s} and @kbd{C-q}, use either @code{enable-flow-control} | 4044 | To bind @kbd{C-s} and @kbd{C-q}, use either @code{enable-flow-control} |
| 4046 | or @sc{enable-flow-control-on}. @xref{Handling C-s and C-q with flow | 4045 | or @sc{enable-flow-control-on}. @xref{Handling C-s and C-q with flow |
| 4047 | control} for usage and implementation details. | 4046 | control}, for usage and implementation details. |
| 4048 | 4047 | ||
| 4049 | To bind other keys, use @code{keyboard-translate}. @xref{Swapping keys} | 4048 | To bind other keys, use @code{keyboard-translate}. @xref{Swapping keys}, |
| 4050 | for usage details. To do this for an entire site, you should swap the | 4049 | for usage details. To do this for an entire site, you should swap the |
| 4051 | keys in @file{lisp/site-start.el}. @xref{Handling C-s and C-q with flow | 4050 | keys in @file{lisp/site-start.el}. @xref{Handling C-s and C-q with flow |
| 4052 | control} for an explanation of why @file{lisp/default.el} should not be | 4051 | control}, for an explanation of why @file{lisp/default.el} should not be |
| 4053 | used. | 4052 | used. |
| 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 |
| 4114 | Another approach is to switch key bindings and put help on @kbd{C-x h} | 4113 | Another 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 | ||
| 4424 | Emacs 20 now includes many of the features of MULE, the Multilingual | 4423 | Emacs 20 now includes many of the features of MULE, the Multilingual |
| 4425 | Enhancement of Emacs. @xref{Installing Emacs} for information on where | 4424 | Enhancement of Emacs. @xref{Installing Emacs}, for information on where |
| 4426 | to find and download Emacs. | 4425 | to 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 |
| 4722 | number in the welcome message. Type "quit" to get out. | 4721 | number 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)? |