diff options
| author | Romain Francoise | 2005-12-10 21:21:30 +0000 |
|---|---|---|
| committer | Romain Francoise | 2005-12-10 21:21:30 +0000 |
| commit | b6f2e1f5b8148d98ad086c864280e31388977b24 (patch) | |
| tree | 4046c3a10c5aff069e1cee4d451fc2d1047b6df3 | |
| parent | d50d22f1f405d91ffdb3b828e97c165c184a125b (diff) | |
| download | emacs-b6f2e1f5b8148d98ad086c864280e31388977b24.tar.gz emacs-b6f2e1f5b8148d98ad086c864280e31388977b24.zip | |
Set VER to `22.1'.
(Basic editing): Explain how to use localized versions of the
Tutorial. Mention that `C-h r' displays the manual. Delete
obsolete WWW link to an Emacs 18 tutorial.
(Getting a printed manual): Point to the new locations of the
manuals on the GNU Web site.
(Emacs Lisp documentation): Explain that the Emacs Lisp manual is
available via Info (it was previously distributed separately).
(Installing Texinfo documentation): The latest version of Texinfo
is 4.8, not 4.0.
(Informational files for Emacs): COPYING is the GNU General Public
License, not the Emacs General Public License.
(Informational files for Emacs): Delete obsolete link to the
GNUinfo pages as they have been removed from the GNU Web site.
(New in Emacs 22): New node.
(Setting up a customization file): Say that most packages support
Customize nowadays.
(Colors on a TTY): Delete reference to instructions on how to
enable syntax highlighting, it is now enabled by default.
(Turning on abbrevs by default): Emacs now reads the abbrevs file
at startup automatically.
(Controlling case sensitivity): Mention `M-c' in isearch.
(Using an already running Emacs process): Emacs now creates the
socket in `/tmp/emacsUID'. Fix typos. Change default location of
gnuserv. As emacsclient can now run Lisp code as well, delete a
sentence praising gnuserv for that. Simplify description of how
the client/server operation works.
(Compiler error messages): Delete obsolete text (compile.el has
been rewritten).
(Indenting switch statements): Fix typo.
(Matching parentheses): Simplify setup instructions, mention the
menu bar item in the Options menu.
(Repeating a command as many times as possible): Mention `C-x e'.
(Going to a line by number): Mention new keymap and bindings
`M-g M-g', `M-g M-p' and `M-g M-n'.
(Turning on syntax highlighting): Now on by default. Simplify.
(Replacing highlighted text): Use `1', not `t'.
(Problems with very large files): The maximum size is now 256MB on
32-bit machines.
(^M in the shell buffer): Mention `comint-process-echoes'.
(Emacs for Apple computers): Emacs 22 has native support for Mac
OS X.
(Translating names to IP addresses): Delete node.
(Binding keys to commands): Fix typo.
(SPC no longer completes file names): New node.
(MIME with Emacs mail packages): Delete section about the Emacs
MIME FAQ (it's not reachable anymore).
| -rw-r--r-- | man/ChangeLog | 56 | ||||
| -rw-r--r-- | man/faq.texi | 377 |
2 files changed, 194 insertions, 239 deletions
diff --git a/man/ChangeLog b/man/ChangeLog index 73248c6ce37..52fa75c2187 100644 --- a/man/ChangeLog +++ b/man/ChangeLog | |||
| @@ -1,8 +1,60 @@ | |||
| 1 | 2005-12-10 Romain Francoise <romain@orebokech.com> | ||
| 2 | |||
| 3 | Update the Emacs FAQ for the 22.1 release. | ||
| 4 | |||
| 5 | * faq.texi: Set VER to `22.1'. | ||
| 6 | (Basic editing): Explain how to use localized versions of the | ||
| 7 | Tutorial. Mention that `C-h r' displays the manual. Delete | ||
| 8 | obsolete WWW link to an Emacs 18 tutorial. | ||
| 9 | (Getting a printed manual): Point to the new locations of the | ||
| 10 | manuals on the GNU Web site. | ||
| 11 | (Emacs Lisp documentation): Explain that the Emacs Lisp manual is | ||
| 12 | available via Info (it was previously distributed separately). | ||
| 13 | (Installing Texinfo documentation): The latest version of Texinfo | ||
| 14 | is 4.8, not 4.0. | ||
| 15 | (Informational files for Emacs): COPYING is the GNU General Public | ||
| 16 | License, not the Emacs General Public License. | ||
| 17 | (Informational files for Emacs): Delete obsolete link to the | ||
| 18 | GNUinfo pages as they have been removed from the GNU Web site. | ||
| 19 | (New in Emacs 22): New node. | ||
| 20 | (Setting up a customization file): Say that most packages support | ||
| 21 | Customize nowadays. | ||
| 22 | (Colors on a TTY): Delete reference to instructions on how to | ||
| 23 | enable syntax highlighting, it is now enabled by default. | ||
| 24 | (Turning on abbrevs by default): Emacs now reads the abbrevs file | ||
| 25 | at startup automatically. | ||
| 26 | (Controlling case sensitivity): Mention `M-c' in isearch. | ||
| 27 | (Using an already running Emacs process): Emacs now creates the | ||
| 28 | socket in `/tmp/emacsUID'. Fix typos. Change default location of | ||
| 29 | gnuserv. As emacsclient can now run Lisp code as well, delete a | ||
| 30 | sentence praising gnuserv for that. Simplify description of how | ||
| 31 | the client/server operation works. | ||
| 32 | (Compiler error messages): Delete obsolete text (compile.el has | ||
| 33 | been rewritten). | ||
| 34 | (Indenting switch statements): Fix typo. | ||
| 35 | (Matching parentheses): Simplify setup instructions, mention the | ||
| 36 | menu bar item in the Options menu. | ||
| 37 | (Repeating a command as many times as possible): Mention `C-x e'. | ||
| 38 | (Going to a line by number): Mention new keymap and bindings | ||
| 39 | `M-g M-g', `M-g M-p' and `M-g M-n'. | ||
| 40 | (Turning on syntax highlighting): Now on by default. Simplify. | ||
| 41 | (Replacing highlighted text): Use `1', not `t'. | ||
| 42 | (Problems with very large files): The maximum size is now 256MB on | ||
| 43 | 32-bit machines. | ||
| 44 | (^M in the shell buffer): Mention `comint-process-echoes'. | ||
| 45 | (Emacs for Apple computers): Emacs 22 has native support for Mac | ||
| 46 | OS X. | ||
| 47 | (Translating names to IP addresses): Delete node. | ||
| 48 | (Binding keys to commands): Fix typo. | ||
| 49 | (SPC no longer completes file names): New node. | ||
| 50 | (MIME with Emacs mail packages): Delete section about the Emacs | ||
| 51 | MIME FAQ (it's not reachable anymore). | ||
| 52 | |||
| 1 | 2005-12-10 David Koppelman <koppel@ece.lsu.edu> | 53 | 2005-12-10 David Koppelman <koppel@ece.lsu.edu> |
| 2 | 54 | ||
| 3 | * display.texi (Highlight Interactively): Include | 55 | * display.texi (Highlight Interactively): Include |
| 4 | global-hi-lock-mode. Add miscellaneous details and elaborations. | 56 | global-hi-lock-mode. Add miscellaneous details and elaborations. |
| 5 | 57 | ||
| 6 | 2005-12-09 Richard M. Stallman <rms@gnu.org> | 58 | 2005-12-09 Richard M. Stallman <rms@gnu.org> |
| 7 | 59 | ||
| 8 | * display.texi (Font Lock): Delete the Global FL menu item. | 60 | * display.texi (Font Lock): Delete the Global FL menu item. |
| @@ -120,7 +172,7 @@ | |||
| 120 | 172 | ||
| 121 | 2005-11-28 Jay Belanger <belanger@truman.edu> | 173 | 2005-11-28 Jay Belanger <belanger@truman.edu> |
| 122 | 174 | ||
| 123 | * calc.texi: Change references of `M-#' to `C-x *' prefix. | 175 | * calc.texi: Change references of `M-#' to `C-x *' prefix. |
| 124 | 176 | ||
| 125 | 2005-11-24 Carsten Dominik <dominik@science.uva.nl> | 177 | 2005-11-24 Carsten Dominik <dominik@science.uva.nl> |
| 126 | 178 | ||
diff --git a/man/faq.texi b/man/faq.texi index 4ac0bdc979c..df21cb7d79c 100644 --- a/man/faq.texi +++ b/man/faq.texi | |||
| @@ -7,7 +7,7 @@ | |||
| 7 | @setchapternewpage odd | 7 | @setchapternewpage odd |
| 8 | 8 | ||
| 9 | @c This is used in many places | 9 | @c This is used in many places |
| 10 | @set VER 21.3 | 10 | @set VER 22.1 |
| 11 | 11 | ||
| 12 | @copying | 12 | @copying |
| 13 | Copyright (C) 2001, 2002, 2003, 2004, 2005 Free Software Foundation, Inc. | 13 | Copyright (C) 2001, 2002, 2003, 2004, 2005 Free Software Foundation, Inc. |
| @@ -30,8 +30,8 @@ The FAQ may be copied and redistributed under these conditions, except that | |||
| 30 | the FAQ may not be embedded in a larger literary work unless that work | 30 | the FAQ may not be embedded in a larger literary work unless that work |
| 31 | itself allows free copying and redistribution. | 31 | itself allows free copying and redistribution. |
| 32 | 32 | ||
| 33 | [This version has been somewhat edited from the last-posted version | 33 | [This version has been heavily edited since it was included in the Emacs |
| 34 | (as of August 1999) for inclusion in the Emacs distribution.] | 34 | distribution.] |
| 35 | @end quotation | 35 | @end quotation |
| 36 | @end copying | 36 | @end copying |
| 37 | 37 | ||
| @@ -556,8 +556,11 @@ This chapter tells you how to get help with Emacs | |||
| 556 | @cindex Self-paced tutorial, invoking the | 556 | @cindex Self-paced tutorial, invoking the |
| 557 | @cindex Help system, entering the | 557 | @cindex Help system, entering the |
| 558 | 558 | ||
| 559 | Type @kbd{C-h t} to invoke the self-paced tutorial. Just typing @kbd{C-h} | 559 | Type @kbd{C-h t} to invoke the self-paced tutorial. Just typing |
| 560 | enters the help system. | 560 | @kbd{C-h} enters the help system. Starting with Emacs 22, the tutorial |
| 561 | is available in many foreign languages such as French, German, Japanese, | ||
| 562 | Russian, etc. Use @kbd{M-x help-with-tutorial-spec-language @key{RET}} | ||
| 563 | to choose your language and start the tutorial. | ||
| 561 | 564 | ||
| 562 | Your system administrator may have changed @kbd{C-h} to act like | 565 | Your system administrator may have changed @kbd{C-h} to act like |
| 563 | @key{DEL} to deal with local keyboards. You can use @kbd{M-x | 566 | @key{DEL} to deal with local keyboards. You can use @kbd{M-x |
| @@ -570,11 +573,6 @@ sequence listed. Each of the resulting key sequences invokes help. | |||
| 570 | Emacs help works best if it is invoked by a single key whose value | 573 | Emacs help works best if it is invoked by a single key whose value |
| 571 | should be stored in the variable @code{help-char}. | 574 | should be stored in the variable @code{help-char}. |
| 572 | 575 | ||
| 573 | There is also a WWW-based tutorial for Emacs 18, much of which is also | ||
| 574 | relevant for later versions of Emacs, available at | ||
| 575 | |||
| 576 | @uref{http://kufacts.cc.ukans.edu/cwis/writeups/misc/emacsguide.html} | ||
| 577 | |||
| 578 | @node Learning how to do something, Getting a printed manual, Basic editing, Getting help | 576 | @node Learning how to do something, Getting a printed manual, Basic editing, Getting help |
| 579 | @section How do I find out how to do something in Emacs? | 577 | @section How do I find out how to do something in Emacs? |
| 580 | @cindex Help for Emacs | 578 | @cindex Help for Emacs |
| @@ -589,9 +587,9 @@ There are several methods for finding out how to do things in Emacs. | |||
| 589 | @cindex Reading the Emacs manual | 587 | @cindex Reading the Emacs manual |
| 590 | @item | 588 | @item |
| 591 | The complete text of the Emacs manual is available on-line via the Info | 589 | The complete text of the Emacs manual is available on-line via the Info |
| 592 | hypertext reader. Type @kbd{C-h i} to invoke Info. Typing @key{h} | 590 | hypertext reader. Type @kbd{C-h r} to display the manual in Info mode. |
| 593 | immediately after entering Info will provide a short tutorial on how to | 591 | Typing @key{h} immediately after entering Info will provide a short |
| 594 | use it. | 592 | tutorial on how to use it. |
| 595 | 593 | ||
| 596 | @cindex Lookup a subject in a manual | 594 | @cindex Lookup a subject in a manual |
| 597 | @cindex Index search in a manual | 595 | @cindex Index search in a manual |
| @@ -668,12 +666,12 @@ file}). | |||
| 668 | If you absolutely have to print your own copy, and you don't have @TeX{}, | 666 | If you absolutely have to print your own copy, and you don't have @TeX{}, |
| 669 | you can get a PostScript version from | 667 | you can get a PostScript version from |
| 670 | 668 | ||
| 671 | @uref{http://www.gnu.org/manual/emacs/ps/emacs.ps.gz} | 669 | @uref{http://www.gnu.org/software/emacs/manual/emacs.ps.gz} |
| 672 | 670 | ||
| 673 | @cindex HTML version of Emacs manual, obtaining | 671 | @cindex HTML version of Emacs manual, obtaining |
| 674 | An HTML version of the manual is at | 672 | An HTML version of the manual is at |
| 675 | 673 | ||
| 676 | @uref{www.gnu.org/manual/emacs/index.html} | 674 | @uref{http://www.gnu.org/software/emacs/manual/emacs.html} |
| 677 | 675 | ||
| 678 | @xref{Learning how to do something}, for how to view the manual on-line. | 676 | @xref{Learning how to do something}, for how to view the manual on-line. |
| 679 | 677 | ||
| @@ -688,24 +686,16 @@ An HTML version of the manual is at | |||
| 688 | Within Emacs, you can type @kbd{C-h f} to get the documentation for a | 686 | Within Emacs, you can type @kbd{C-h f} to get the documentation for a |
| 689 | function, @kbd{C-h v} for a variable. | 687 | function, @kbd{C-h v} for a variable. |
| 690 | 688 | ||
| 691 | For more information, obtain the Emacs Lisp Reference Manual. Details | 689 | For more information, the Emacs Lisp Reference Manual is available |
| 692 | on ordering it from FSF are on the | 690 | on-line, in Info format. @xref{Top, Emacs Lisp,, elisp, The |
| 693 | @uref{http://www.gnu.org/order/order.html, GNU Web site}. | 691 | Emacs Lisp Reference Manual}. |
| 694 | 692 | ||
| 695 | The Emacs Lisp Reference Manual is also available on-line, in Info | 693 | You can also order a hardcopy of the manual, details on ordering it from |
| 696 | format. Texinfo source for the manual (along with pregenerated Info | 694 | FSF are on the @uref{http://www.gnu.org/order/order.html, GNU Web site}. |
| 697 | files) is available at | ||
| 698 | |||
| 699 | @uref{ftp://ftp.gnu.org/pub/gnu/emacs/elisp-manual-21-2.6.tar.gz} | ||
| 700 | |||
| 701 | and all mirrors of @samp{ftp.gnu.org} (for a list, @pxref{Current GNU | ||
| 702 | distributions}). @xref{Installing Texinfo documentation}, if you want | ||
| 703 | to install the Info files, or @ref{Printing a Texinfo file}, if you want | ||
| 704 | to use the Texinfo source to print the manual yourself. | ||
| 705 | 695 | ||
| 706 | An HTML version of the Emacs Lisp Reference Manual is available at | 696 | An HTML version of the Emacs Lisp Reference Manual is available at |
| 707 | 697 | ||
| 708 | @uref{http://www.gnu.org/manual/elisp-manual-21-2.6/elisp.html} | 698 | @uref{http://www.gnu.org/software/emacs/elisp-manual/elisp.html} |
| 709 | 699 | ||
| 710 | @node Installing Texinfo documentation, Printing a Texinfo file, Emacs Lisp documentation, Getting help | 700 | @node Installing Texinfo documentation, Printing a Texinfo file, Emacs Lisp documentation, Getting help |
| 711 | @section How do I install a piece of Texinfo documentation? | 701 | @section How do I install a piece of Texinfo documentation? |
| @@ -719,7 +709,7 @@ First, you must turn the Texinfo files into Info files. You may do this | |||
| 719 | using the stand-alone @file{makeinfo} program, available as part of the latest | 709 | using the stand-alone @file{makeinfo} program, available as part of the latest |
| 720 | Texinfo package at | 710 | Texinfo package at |
| 721 | 711 | ||
| 722 | @uref{ftp://ftp.gnu.org/pub/gnu/texinfo/texinfo-4.0.tar.gz} | 712 | @uref{ftp://ftp.gnu.org/pub/gnu/texinfo/texinfo-4.8.tar.gz} |
| 723 | 713 | ||
| 724 | and all mirrors of @samp{ftp.gnu.org} (for a list, @pxref{Current GNU | 714 | and all mirrors of @samp{ftp.gnu.org} (for a list, @pxref{Current GNU |
| 725 | distributions}). | 715 | distributions}). |
| @@ -903,7 +893,7 @@ where that is). | |||
| 903 | @table @file | 893 | @table @file |
| 904 | 894 | ||
| 905 | @item COPYING | 895 | @item COPYING |
| 906 | Emacs General Public License | 896 | GNU General Public License |
| 907 | 897 | ||
| 908 | @item DISTRIB | 898 | @item DISTRIB |
| 909 | Emacs Availability Information, including the popular Free Software | 899 | Emacs Availability Information, including the popular Free Software |
| @@ -939,10 +929,6 @@ including ``Using Emacstool with GNU Emacs'' | |||
| 939 | 929 | ||
| 940 | @end table | 930 | @end table |
| 941 | 931 | ||
| 942 | Latest versions of the above files also available at | ||
| 943 | |||
| 944 | @uref{ftp://ftp.gnu.org/pub/gnu/GNUinfo/} | ||
| 945 | |||
| 946 | More GNU information, including back issues of the @cite{GNU's | 932 | More GNU information, including back issues of the @cite{GNU's |
| 947 | Bulletin}, are at | 933 | Bulletin}, are at |
| 948 | 934 | ||
| @@ -1049,6 +1035,7 @@ latest version status. | |||
| 1049 | * Latest version of Emacs:: | 1035 | * Latest version of Emacs:: |
| 1050 | * New in Emacs 20:: | 1036 | * New in Emacs 20:: |
| 1051 | * New in Emacs 21:: | 1037 | * New in Emacs 21:: |
| 1038 | * New in Emacs 22:: | ||
| 1052 | @end menu | 1039 | @end menu |
| 1053 | 1040 | ||
| 1054 | @node Origin of the term Emacs, Latest version of Emacs, Status of Emacs, Status of Emacs | 1041 | @node Origin of the term Emacs, Latest version of Emacs, Status of Emacs, Status of Emacs |
| @@ -1112,7 +1099,7 @@ calendar/diary, have been updated and enhanced to work with Emacs 20, | |||
| 1112 | and are now included with the standard distribution. | 1099 | and are now included with the standard distribution. |
| 1113 | 1100 | ||
| 1114 | 1101 | ||
| 1115 | @node New in Emacs 21, , New in Emacs 20, Status of Emacs | 1102 | @node New in Emacs 21, New in Emacs 22, New in Emacs 20, Status of Emacs |
| 1116 | @section What is different about Emacs 21? | 1103 | @section What is different about Emacs 21? |
| 1117 | @cindex Differences between Emacs 20 and Emacs 21 | 1104 | @cindex Differences between Emacs 20 and Emacs 21 |
| 1118 | @cindex Emacs 21, new features in | 1105 | @cindex Emacs 21, new features in |
| @@ -1134,6 +1121,39 @@ In addition, Emacs 21 supports faces on text-only terminals. This means | |||
| 1134 | that you can now have colors when you run Emacs on a GNU/Linux console | 1121 | that you can now have colors when you run Emacs on a GNU/Linux console |
| 1135 | and on @code{xterm} with @kbd{emacs -nw}. | 1122 | and on @code{xterm} with @kbd{emacs -nw}. |
| 1136 | 1123 | ||
| 1124 | @node New in Emacs 22, , New in Emacs 21, Status of Emacs | ||
| 1125 | @section What is different about Emacs 22? | ||
| 1126 | @cindex Differences between Emacs 21 and Emacs 22 | ||
| 1127 | @cindex Emacs 22, new features in | ||
| 1128 | @cindex Recently introduced features | ||
| 1129 | |||
| 1130 | @c FIXME: Improve this node before the 22.1 release. | ||
| 1131 | @cindex Default features | ||
| 1132 | Font-lock mode, auto-compression mode, and file name shadow mode are now | ||
| 1133 | enabled by default. It is now possible to follow links with | ||
| 1134 | @kbd{mouse-1}. | ||
| 1135 | |||
| 1136 | @cindex Supported systems | ||
| 1137 | Emacs 22 features support for GNU/Linux systems on S390 and X86-64 | ||
| 1138 | machines, as well as support for the Mac OS X and Cygwin operating | ||
| 1139 | systems. | ||
| 1140 | |||
| 1141 | @cindex GTK+ Toolkit | ||
| 1142 | @cindex Drag-and-drop | ||
| 1143 | @cindex Mouse wheel | ||
| 1144 | Emacs can now be built with GTK+ widgets, and supports drag-and-drop | ||
| 1145 | operation on X. Mouse wheel support is now enabled by default. | ||
| 1146 | |||
| 1147 | @cindex New modes | ||
| 1148 | Many new modes and packages have been included in Emacs, such as Leim, | ||
| 1149 | Calc, Tramp and URL, as well as IDO, CUA, rcirc, conf-mode, | ||
| 1150 | python-mode, table, tumme, SES, ruler, Flymake, Org, etc. | ||
| 1151 | |||
| 1152 | @cindex Documentation | ||
| 1153 | @cindex Emacs Lisp Manual | ||
| 1154 | In addition, Emacs 22 now includes the Emacs Lisp Reference Manual | ||
| 1155 | (@pxref{Emacs Lisp documentation}) and the Emacs Lisp Intro. | ||
| 1156 | |||
| 1137 | @c ------------------------------------------------------------ | 1157 | @c ------------------------------------------------------------ |
| 1138 | @node Common requests, Bugs and problems, Status of Emacs, Top | 1158 | @node Common requests, Bugs and problems, Status of Emacs, Top |
| 1139 | @chapter Common requests | 1159 | @chapter Common requests |
| @@ -1205,12 +1225,11 @@ it causes confusing non-standard behavior. Then they send questions to | |||
| 1205 | @email{help-gnu-emacs@@gnu.org} asking why Emacs isn't behaving as | 1225 | @email{help-gnu-emacs@@gnu.org} asking why Emacs isn't behaving as |
| 1206 | documented. | 1226 | documented. |
| 1207 | 1227 | ||
| 1208 | Beginning with version 20.1, Emacs includes the new Customize | 1228 | Beginning with version 20.1, Emacs includes the new Customize facility, |
| 1209 | facility, which can be invoked using @kbd{M-x customize @key{RET}}. | 1229 | which can be invoked using @kbd{M-x customize @key{RET}}. This allows |
| 1210 | This allows users who are unfamiliar with Emacs Lisp to modify their | 1230 | users who are unfamiliar with Emacs Lisp to modify their @file{.emacs} |
| 1211 | @file{.emacs} files in a relatively straightforward way, using menus | 1231 | files in a relatively straightforward way, using menus rather than Lisp |
| 1212 | rather than Lisp code. Not all packages support Customize as of this | 1232 | code. Most packages support Customize as of this writing. |
| 1213 | writing, but the number is growing fairly steadily. | ||
| 1214 | 1233 | ||
| 1215 | While Customize might indeed make it easier to configure Emacs, | 1234 | While Customize might indeed make it easier to configure Emacs, |
| 1216 | consider taking a bit of time to learn Emacs Lisp and modifying your | 1235 | consider taking a bit of time to learn Emacs Lisp and modifying your |
| @@ -1240,8 +1259,7 @@ capabilities. | |||
| 1240 | The command @kbd{M-x list-colors-display} pops up a window which | 1259 | The command @kbd{M-x list-colors-display} pops up a window which |
| 1241 | exhibits all the colors Emacs knows about on the current display. | 1260 | exhibits all the colors Emacs knows about on the current display. |
| 1242 | 1261 | ||
| 1243 | Syntax highlighting is usually turned off by default; see @ref{Turning | 1262 | Syntax highlighting is on by default since version 22.1. |
| 1244 | on syntax highlighting}, for instructions how to turn it on. | ||
| 1245 | 1263 | ||
| 1246 | @node Debugging a customization file, Displaying the current line or column, Colors on a TTY, Common requests | 1264 | @node Debugging a customization file, Displaying the current line or column, Colors on a TTY, Common requests |
| 1247 | @section How do I debug a @file{.emacs} file? | 1265 | @section How do I debug a @file{.emacs} file? |
| @@ -1362,6 +1380,9 @@ Put this in your @file{.emacs} file: | |||
| 1362 | (setq abbrev-mode t))) | 1380 | (setq abbrev-mode t))) |
| 1363 | @end lisp | 1381 | @end lisp |
| 1364 | 1382 | ||
| 1383 | Starting with Emacs 22, the standard abbrevs file is read automatically | ||
| 1384 | at startup, so the first of these two forms becomes unnecessary. | ||
| 1385 | |||
| 1365 | @node Turning on auto-fill by default, Associating modes with files, Turning on abbrevs by default, Common requests | 1386 | @node Turning on auto-fill by default, Associating modes with files, Turning on abbrevs by default, Common requests |
| 1366 | @section How do I turn on @code{auto-fill-mode} by default? | 1387 | @section How do I turn on @code{auto-fill-mode} by default? |
| 1367 | @cindex @code{auto-fill-mode}, activating automatically | 1388 | @cindex @code{auto-fill-mode}, activating automatically |
| @@ -1510,6 +1531,8 @@ determines whether they are case sensitive: | |||
| 1510 | Similarly, for replacing, the variable @code{case-replace} determines | 1531 | Similarly, for replacing, the variable @code{case-replace} determines |
| 1511 | whether replacements preserve case. | 1532 | whether replacements preserve case. |
| 1512 | 1533 | ||
| 1534 | You can also toggle case sensitivity at will in isearch with @kbd{M-c}. | ||
| 1535 | |||
| 1513 | To change the case sensitivity just for one major mode, use the major | 1536 | To change the case sensitivity just for one major mode, use the major |
| 1514 | mode's hook. For example: | 1537 | mode's hook. For example: |
| 1515 | 1538 | ||
| @@ -1597,10 +1620,9 @@ or by invoking @code{server-start} from @file{.emacs}: | |||
| 1597 | (if (@var{some conditions are met}) (server-start)) | 1620 | (if (@var{some conditions are met}) (server-start)) |
| 1598 | @end lisp | 1621 | @end lisp |
| 1599 | 1622 | ||
| 1600 | When this is done, Emacs creates a Unix domain socket. | 1623 | When this is done, Emacs creates a Unix domain socket named |
| 1601 | The socket is either named @file{.emacs_server}, in the user's home directory, | 1624 | @file{server} in @file{/tmp/emacs@var{userid}}. See |
| 1602 | or @file{esrv-@var{userid}-@var{systemname}}, in the @file{/tmp} | 1625 | @code{server-socket-dir}. |
| 1603 | directory, depending on your system. See @code{server-socket-name}. | ||
| 1604 | 1626 | ||
| 1605 | To get your news reader, mail reader, etc., to invoke | 1627 | To get your news reader, mail reader, etc., to invoke |
| 1606 | @samp{emacsclient}, try setting the environment variable @code{EDITOR} | 1628 | @samp{emacsclient}, try setting the environment variable @code{EDITOR} |
| @@ -1622,40 +1644,24 @@ EDITOR=emacsclient ; export EDITOR | |||
| 1622 | @item | 1644 | @item |
| 1623 | Normal use: | 1645 | Normal use: |
| 1624 | 1646 | ||
| 1625 | When @samp{emacsclient} is run, it connects to the @file{.emacs_server} | 1647 | When @samp{emacsclient} is run, it connects to the socket and passes its |
| 1626 | socket and passes its command line options to @samp{server}. When | 1648 | command line options to Emacs, which at the next opportunity will visit |
| 1627 | @samp{server} receives these requests, it sends this information to the | 1649 | the files specified. (Line numbers can be specified just like with |
| 1628 | the Emacs process, which at the next opportunity will visit the files | 1650 | Emacs.) The user will have to switch to the Emacs window by hand. When |
| 1629 | specified. (Line numbers can be specified just like with Emacs.) The | 1651 | the user is done editing a file, the user can type @kbd{C-x #} (or |
| 1630 | user will have to switch to the Emacs window by hand. When the user is | 1652 | @kbd{M-x server-edit}) to indicate this. If there is another buffer |
| 1631 | done editing a file, the user can type @kbd{C-x #} (or @kbd{M-x | 1653 | requested by @code{emacsclient}, Emacs will switch to it; otherwise |
| 1632 | server-edit}) to indicate this. If there is another buffer requested by | ||
| 1633 | @code{emacsclient}, Emacs will switch to it; otherwise | ||
| 1634 | @code{emacsclient} will exit, signaling the calling program to continue. | 1654 | @code{emacsclient} will exit, signaling the calling program to continue. |
| 1635 | 1655 | ||
| 1636 | @samp{emacsclient} and @samp{server} must be running on machines which | ||
| 1637 | share the same filesystem for this to work. The pathnames that | ||
| 1638 | @samp{emacsclient} specifies should be correct for the filesystem that | ||
| 1639 | the Emacs process sees. The Emacs process should not be suspended at | ||
| 1640 | the time @samp{emacsclient} is invoked. On Unix and GNU/Linux systems, | ||
| 1641 | @samp{emacsclient} should either be invoked from another X window, or | ||
| 1642 | from a shell window inside Emacs itself, or from another interactive | ||
| 1643 | session, e.g., by means of a @code{screen} program. | ||
| 1644 | |||
| 1645 | @cindex @code{gnuserv} | 1656 | @cindex @code{gnuserv} |
| 1646 | There is an enhanced version of @samp{emacsclient}/server called | 1657 | There is an enhanced version of @samp{emacsclient} called |
| 1647 | @samp{gnuserv}, written by @email{ange@@hplb.hpl.hp.com, Andy Norman} | 1658 | @samp{gnuserv}, written by @email{ange@@hplb.hpl.hp.com, Andy Norman} |
| 1648 | (@pxref{Packages that do not come with Emacs}). @samp{gnuserv} uses | 1659 | (@pxref{Packages that do not come with Emacs}). @samp{gnuserv} uses |
| 1649 | Internet domain sockets, so it can work across most network connections. | 1660 | Internet domain sockets, so it can work across most network connections. |
| 1650 | It also supports the execution of arbitrary Emacs Lisp forms and does | ||
| 1651 | not require the client program to wait for completion. | ||
| 1652 | 1661 | ||
| 1653 | The alpha version of an enhanced @samp{gnuserv} is available at | 1662 | The most recent @samp{gnuserv} package is available at |
| 1654 | 1663 | ||
| 1655 | @uref{ftp://ftp.wellfleet.com/netman/psmith/emacs/gnuserv-2.1alpha.tar.gz} | 1664 | @uref{http://meltin.net/hacks/emacs/} |
| 1656 | |||
| 1657 | The version available from @uref{http://meltin.net/hacks/emacs/} is | ||
| 1658 | more recent, and has been tested with Emacs 21.2. | ||
| 1659 | 1665 | ||
| 1660 | @end itemize | 1666 | @end itemize |
| 1661 | 1667 | ||
| @@ -1666,23 +1672,7 @@ more recent, and has been tested with Emacs 21.2. | |||
| 1666 | @cindex Regexps for recognizing compiler errors | 1672 | @cindex Regexps for recognizing compiler errors |
| 1667 | @cindex Errors, recognizing compiler | 1673 | @cindex Errors, recognizing compiler |
| 1668 | 1674 | ||
| 1669 | The variable @code{compilation-error-regexp-alist} helps control how | 1675 | Customize the @code{compilation-error-regexp-alist} variable. |
| 1670 | Emacs parses your compiler output. It is a list of triplets of the form: | ||
| 1671 | @code{(@var{regexp} @var{file-idx} @var{line-idx})}, where @var{regexp}, | ||
| 1672 | @var{file-idx} and @var{line-idx} are strings. To help determine what | ||
| 1673 | the constituent elements should be, load @file{compile.el} and then type | ||
| 1674 | @kbd{C-h v compilation-error-regexp-alist @key{RET}} to see the current | ||
| 1675 | value. A good idea is to look at @file{compile.el} itself as the | ||
| 1676 | comments included for this variable are quite useful---the regular | ||
| 1677 | expressions required for your compiler's output may be very close to one | ||
| 1678 | already provided. Once you have determined the proper regexps, use the | ||
| 1679 | following to inform Emacs of your changes: | ||
| 1680 | |||
| 1681 | @lisp | ||
| 1682 | (setq compilation-error-regexp-alist | ||
| 1683 | (cons '(@var{regexp} @var{file-idx} @var{line-idx}) | ||
| 1684 | compilation-error-regexp-alist)) | ||
| 1685 | @end lisp | ||
| 1686 | 1676 | ||
| 1687 | @node Indenting switch statements, Customizing C and C++ indentation, Compiler error messages, Common requests | 1677 | @node Indenting switch statements, Customizing C and C++ indentation, Compiler error messages, Common requests |
| 1688 | @section How do I change the indentation for @code{switch}? | 1678 | @section How do I change the indentation for @code{switch}? |
| @@ -1712,7 +1702,7 @@ The solution at first appears to be: set @code{c-indent-level} to 4 and | |||
| 1712 | spacing of four instead of two. | 1702 | spacing of four instead of two. |
| 1713 | 1703 | ||
| 1714 | The @emph{real} solution is to use @code{cc-mode} (the default mode for | 1704 | The @emph{real} solution is to use @code{cc-mode} (the default mode for |
| 1715 | C programming in Emacs 20 and later) and add the following line to yoyr | 1705 | C programming in Emacs 20 and later) and add the following line to your |
| 1716 | @file{.emacs}: | 1706 | @file{.emacs}: |
| 1717 | 1707 | ||
| 1718 | @lisp | 1708 | @lisp |
| @@ -1949,28 +1939,17 @@ new paragraph. There are many packages available to deal with this | |||
| 1949 | @cindex Pairs of parentheses, highlighting | 1939 | @cindex Pairs of parentheses, highlighting |
| 1950 | @cindex Matching parentheses | 1940 | @cindex Matching parentheses |
| 1951 | 1941 | ||
| 1952 | As of version 19, Emacs comes with @file{paren.el}, which (when loaded) | 1942 | Call @code{show-paren-mode} in your @file{.emacs} file: |
| 1953 | will automatically highlight matching parentheses whenever point (i.e., | ||
| 1954 | the cursor) is located over one. To load @file{paren.el} automatically, | ||
| 1955 | include the line | ||
| 1956 | |||
| 1957 | @lisp | ||
| 1958 | (require 'paren) | ||
| 1959 | @end lisp | ||
| 1960 | |||
| 1961 | in your @file{.emacs} file. @email{shutkoa@@ugsolutions.com, Alan Shutko} | ||
| 1962 | reports that as of version 20.1, you must also call @code{show-paren-mode} in | ||
| 1963 | your @file{.emacs} file: | ||
| 1964 | 1943 | ||
| 1965 | @lisp | 1944 | @lisp |
| 1966 | (show-paren-mode 1) | 1945 | (show-paren-mode 1) |
| 1967 | @end lisp | 1946 | @end lisp |
| 1968 | 1947 | ||
| 1969 | Customize will let you turn on @code{show-paren-mode}. Use @kbd{M-x | 1948 | You can also enable this mode by selecting the @samp{Paren Match |
| 1970 | customize-group @key{RET} paren-showing @key{RET}}. From within | 1949 | Highlighting} option from the @samp{Options} menu of the Emacs menu bar |
| 1971 | Customize, you can also go directly to the ``paren-showing'' group. | 1950 | at the top of any Emacs frame. |
| 1972 | 1951 | ||
| 1973 | Alternatives to paren include: | 1952 | Alternatives to this mode include: |
| 1974 | 1953 | ||
| 1975 | @itemize @bullet | 1954 | @itemize @bullet |
| 1976 | 1955 | ||
| @@ -2160,7 +2139,7 @@ the command and then type @kbd{M-0 C-x e}. | |||
| 2160 | Any messages your command prints in the echo area will be suppressed. | 2139 | Any messages your command prints in the echo area will be suppressed. |
| 2161 | 2140 | ||
| 2162 | If you need to repeat a command a small number of times, you can use | 2141 | If you need to repeat a command a small number of times, you can use |
| 2163 | @kbd{C-x z}, see @ref{Repeating commands}. | 2142 | @kbd{C-x z} (@pxref{Repeating commands}) or @kbd{C-x e}. |
| 2164 | 2143 | ||
| 2165 | @node Forcing the cursor to remain in the same column, Forcing Emacs to iconify itself, Repeating a command as many times as possible, Common requests | 2144 | @node Forcing the cursor to remain in the same column, Forcing Emacs to iconify itself, Repeating a command as many times as possible, Common requests |
| 2166 | @section How do I make Emacs behave like this: when I go up or down, the cursor should stay in the same column even if the line is too short? | 2145 | @section How do I make Emacs behave like this: when I go up or down, the cursor should stay in the same column even if the line is too short? |
| @@ -2315,27 +2294,20 @@ effective way of doing that. Emacs automatically intercepts the compile | |||
| 2315 | error messages, inserts them into a special buffer called | 2294 | error messages, inserts them into a special buffer called |
| 2316 | @code{*compilation*}, and lets you visit the locus of each message in | 2295 | @code{*compilation*}, and lets you visit the locus of each message in |
| 2317 | the source. Type @kbd{C-x `} to step through the offending lines one by | 2296 | the source. Type @kbd{C-x `} to step through the offending lines one by |
| 2318 | one. Click @kbd{Mouse-2} or press @key{RET} on a message text in the | 2297 | one (starting with Emacs 22, you can also use @kbd{M-g M-p} and |
| 2298 | @kbd{M-g M-n} to go to the previous and next matches directly). Click | ||
| 2299 | @kbd{Mouse-2} or press @key{RET} on a message text in the | ||
| 2319 | @code{*compilation*} buffer to go to the line whose number is mentioned | 2300 | @code{*compilation*} buffer to go to the line whose number is mentioned |
| 2320 | in that message. | 2301 | in that message. |
| 2321 | 2302 | ||
| 2322 | But if you indeed need to go to a certain text line, type @kbd{M-x | 2303 | But if you indeed need to go to a certain text line, type @kbd{M-g M-g} |
| 2323 | goto-line @key{RET}}. Emacs will prompt you for the number of the line | 2304 | (which is the default binding of the @code{goto-line} function starting |
| 2324 | and go to that line. | 2305 | with Emacs 22). Emacs will prompt you for the number of the line and go |
| 2306 | to that line. | ||
| 2325 | 2307 | ||
| 2326 | You can do this faster by invoking @code{goto-line} with a numeric | 2308 | You can do this faster by invoking @code{goto-line} with a numeric |
| 2327 | argument that is the line's number. For example, @kbd{C-u 286 M-x | 2309 | argument that is the line's number. For example, @kbd{C-u 286 M-g M-g} |
| 2328 | goto-line @key{RET}} will jump to line number 286 in the current | 2310 | will jump to line number 286 in the current buffer. |
| 2329 | buffer. | ||
| 2330 | |||
| 2331 | If you need to use this command frequently, you might consider binding | ||
| 2332 | it to a key. The following snippet, if added to your @file{~/.emacs} | ||
| 2333 | file, will bind the sequence @kbd{C-x g} to @code{goto-line}: | ||
| 2334 | |||
| 2335 | @lisp | ||
| 2336 | (global-set-key "\C-xg" 'goto-line) | ||
| 2337 | @end lisp | ||
| 2338 | |||
| 2339 | 2311 | ||
| 2340 | @node Modifying pull-down menus, Deleting menus and menu options, Going to a line by number, Common requests | 2312 | @node Modifying pull-down menus, Deleting menus and menu options, Going to a line by number, Common requests |
| 2341 | @section How can I create or modify new pull-down menu options? | 2313 | @section How can I create or modify new pull-down menu options? |
| @@ -2457,9 +2429,11 @@ menus}), use: | |||
| 2457 | @cindex FAQ, @code{font-lock-mode} | 2429 | @cindex FAQ, @code{font-lock-mode} |
| 2458 | 2430 | ||
| 2459 | @code{font-lock-mode} is the standard way to have Emacs perform syntax | 2431 | @code{font-lock-mode} is the standard way to have Emacs perform syntax |
| 2460 | highlighting in the current buffer. With @code{font-lock-mode} turned | 2432 | highlighting in the current buffer. It is enabled by default in Emacs |
| 2461 | on, different types of text will appear in different colors. For | 2433 | 22.1 and later. |
| 2462 | instance, if you turn on @code{font-lock-mode} in a programming mode, | 2434 | |
| 2435 | With @code{font-lock-mode} turned on, different types of text will | ||
| 2436 | appear in different colors. For instance, in a programming mode, | ||
| 2463 | variables will appear in one face, keywords in a second, and comments in | 2437 | variables will appear in one face, keywords in a second, and comments in |
| 2464 | a third. | 2438 | a third. |
| 2465 | 2439 | ||
| @@ -2468,33 +2442,16 @@ Earlier versions of Emacs supported hilit19, a similar package. Use of | |||
| 2468 | hilit19 is now considered non-standard, although @file{hilit19.el} comes | 2442 | hilit19 is now considered non-standard, although @file{hilit19.el} comes |
| 2469 | with the stock Emacs distribution. It is no longer maintained. | 2443 | with the stock Emacs distribution. It is no longer maintained. |
| 2470 | 2444 | ||
| 2471 | To turn @code{font-lock-mode} on within an existing buffer, use @kbd{M-x | 2445 | To turn @code{font-lock-mode} off within an existing buffer, use |
| 2472 | font-lock-mode @key{RET}}. | 2446 | @kbd{M-x font-lock-mode @key{RET}}. |
| 2473 | |||
| 2474 | To automatically invoke @code{font-lock-mode} when a particular major | ||
| 2475 | mode is invoked, set the major mode's hook. For example, to fontify all | ||
| 2476 | @code{c-mode} buffers, add the following to your @file{.emacs} file: | ||
| 2477 | 2447 | ||
| 2478 | @lisp | 2448 | In Emacs 21 and earlier versions, you could use the following code in |
| 2479 | (add-hook 'c-mode-hook 'turn-on-font-lock) | 2449 | your @file{.emacs} file to turn on @code{font-lock-mode} globally: |
| 2480 | @end lisp | ||
| 2481 | |||
| 2482 | To automatically invoke @code{font-lock-mode} for all major modes, you | ||
| 2483 | can turn on @code{global-font-lock-mode} by including the following line | ||
| 2484 | in your @file{.emacs} file: | ||
| 2485 | 2450 | ||
| 2486 | @lisp | 2451 | @lisp |
| 2487 | (global-font-lock-mode 1) | 2452 | (global-font-lock-mode 1) |
| 2488 | @end lisp | 2453 | @end lisp |
| 2489 | 2454 | ||
| 2490 | @noindent | ||
| 2491 | This instructs Emacs to turn on font-lock mode in those buffers for | ||
| 2492 | which a font-lock mode definition has been provided (in the variable | ||
| 2493 | @code{font-lock-global-modes}). If you edit a file in | ||
| 2494 | @code{pie-ala-mode}, and no font-lock definitions have been provided for | ||
| 2495 | @code{pie-ala} files, then the above setting will have no effect on that | ||
| 2496 | particular buffer. | ||
| 2497 | |||
| 2498 | Highlighting a buffer with @code{font-lock-mode} can take quite a while, | 2455 | Highlighting a buffer with @code{font-lock-mode} can take quite a while, |
| 2499 | and cause an annoying delay in display, so several features exist to | 2456 | and cause an annoying delay in display, so several features exist to |
| 2500 | work around this. | 2457 | work around this. |
| @@ -2534,12 +2491,6 @@ Also see the documentation for the function @code{font-lock-mode}, | |||
| 2534 | available by typing @kbd{C-h f font-lock-mode} (@kbd{M-x | 2491 | available by typing @kbd{C-h f font-lock-mode} (@kbd{M-x |
| 2535 | describe-function @key{RET} font-lock-mode @key{RET}}). | 2492 | describe-function @key{RET} font-lock-mode @key{RET}}). |
| 2536 | 2493 | ||
| 2537 | For more information on font-lock mode, take a look at the | ||
| 2538 | @code{font-lock-mode} FAQ, maintained by | ||
| 2539 | @email{jari.aalto@@ntc.nokia.com, Jari Aalto} at | ||
| 2540 | |||
| 2541 | @uref{ftp://cs.uta.fi/pub/ssjaaa/ema-font.gui} | ||
| 2542 | |||
| 2543 | To print buffers with the faces (i.e., colors and fonts) intact, use | 2494 | To print buffers with the faces (i.e., colors and fonts) intact, use |
| 2544 | @kbd{M-x ps-print-buffer-with-faces} or @kbd{M-x | 2495 | @kbd{M-x ps-print-buffer-with-faces} or @kbd{M-x |
| 2545 | ps-print-region-with-faces}. You will need a way to send text to a | 2496 | ps-print-region-with-faces}. You will need a way to send text to a |
| @@ -2570,7 +2521,7 @@ Use @code{delete-selection-mode}, which you can start automatically by | |||
| 2570 | placing the following Lisp form in your @file{.emacs} file: | 2521 | placing the following Lisp form in your @file{.emacs} file: |
| 2571 | 2522 | ||
| 2572 | @lisp | 2523 | @lisp |
| 2573 | (delete-selection-mode t) | 2524 | (delete-selection-mode 1) |
| 2574 | @end lisp | 2525 | @end lisp |
| 2575 | 2526 | ||
| 2576 | According to the documentation string for @code{delete-selection-mode} | 2527 | According to the documentation string for @code{delete-selection-mode} |
| @@ -2686,41 +2637,10 @@ type @kbd{C-h C-e} to read it. | |||
| 2686 | @cindex Files, maximum size | 2637 | @cindex Files, maximum size |
| 2687 | 2638 | ||
| 2688 | Old versions (i.e., anything before 19.29) of Emacs had problems editing | 2639 | Old versions (i.e., anything before 19.29) of Emacs had problems editing |
| 2689 | files larger than 8 megabytes. As of version 19.29, the maximum buffer | 2640 | files larger than 8 megabytes. In versions 19.29 and later, the maximum |
| 2690 | size is at least 2^27-1, or 134,217,727 bytes, or 132 MBytes. Emacs 20 | 2641 | buffer size is at least 2^27-1, or 134,217,727 bytes, or 132 MBytes. |
| 2691 | can be compiled on some 64-bit systems in a way that enlarges the buffer | 2642 | And in Emacs 22, the maximum buffer size has been increased to |
| 2692 | size up to 576,460,752,303,423,487 bytes, or 549,755,813 GBytes. | 2643 | 268,435,455 bytes (or 256 MBytes) on 32-bit machines. |
| 2693 | |||
| 2694 | If you are using a version of Emacs older than 19.29 and cannot upgrade, | ||
| 2695 | you will have to recompile. @email{lnz@@lucid.com, Leonard N. Zubkoff} | ||
| 2696 | suggests putting the following two lines in @file{src/config.h} before | ||
| 2697 | compiling Emacs to allow for 26-bit integers and pointers (and thus file | ||
| 2698 | sizes of up to 33,554,431 bytes): | ||
| 2699 | |||
| 2700 | @example | ||
| 2701 | #define VALBITS 26 | ||
| 2702 | #define GCTYPEBITS 5 | ||
| 2703 | @end example | ||
| 2704 | |||
| 2705 | @noindent | ||
| 2706 | This method may result in ``ILLEGAL DATATYPE'' and other random errors on | ||
| 2707 | some machines. | ||
| 2708 | |||
| 2709 | @email{daveg@@csvax.cs.caltech.edu, David Gillespie} explains how this | ||
| 2710 | problems crops up; while his numbers are true only for pre-19.29 | ||
| 2711 | versions of Emacs, the theory remains the same with current versions. | ||
| 2712 | |||
| 2713 | @quotation | ||
| 2714 | Emacs is largely written in a dialect of Lisp; Lisp is a freely-typed | ||
| 2715 | language in the sense that you can put any value of any type into any | ||
| 2716 | variable, or return it from a function, and so on. So each value | ||
| 2717 | must carry a @dfn{tag} along with it identifying what kind of thing it | ||
| 2718 | is, e.g., integer, pointer to a list, pointer to an editing buffer, and | ||
| 2719 | so on. Emacs uses standard 32-bit integers for data objects, taking the | ||
| 2720 | top 8 bits for the tag and the bottom 24 bits for the value. So | ||
| 2721 | integers (and pointers) are somewhat restricted compared to true C | ||
| 2722 | integers and pointers. | ||
| 2723 | @end quotation | ||
| 2724 | 2644 | ||
| 2725 | @node ^M in the shell buffer, Shell process exits abnormally, Problems with very large files, Bugs and problems | 2645 | @node ^M in the shell buffer, Shell process exits abnormally, Problems with very large files, Bugs and problems |
| 2726 | @section How do I get rid of @samp{^M} or echoed commands in my shell buffer? | 2646 | @section How do I get rid of @samp{^M} or echoed commands in my shell buffer? |
| @@ -2785,9 +2705,10 @@ file: | |||
| 2785 | (add-hook 'comint-output-filter-functions 'shell-strip-ctrl-m) | 2705 | (add-hook 'comint-output-filter-functions 'shell-strip-ctrl-m) |
| 2786 | @end smalllisp | 2706 | @end smalllisp |
| 2787 | 2707 | ||
| 2788 | On a related note: If your shell is echoing your input line in the shell | 2708 | On a related note: if your shell is echoing your input line in the shell |
| 2789 | buffer, you might want to try the following command in your shell | 2709 | buffer, you might want to customize the @code{comint-process-echoes} |
| 2790 | start-up file: | 2710 | variable in your shell buffers, or try the following command in your |
| 2711 | shell start-up file: | ||
| 2791 | 2712 | ||
| 2792 | @example | 2713 | @example |
| 2793 | stty -icrnl -onlcr -echo susp ^Z | 2714 | stty -icrnl -onlcr -echo susp ^Z |
| @@ -3456,7 +3377,6 @@ To get the Xmenu stuff to work, you need to find a copy of MIT's | |||
| 3456 | * Emacs for Apple computers:: | 3377 | * Emacs for Apple computers:: |
| 3457 | * Emacs for VMS and DECwindows:: | 3378 | * Emacs for VMS and DECwindows:: |
| 3458 | * Modes for various languages:: | 3379 | * Modes for various languages:: |
| 3459 | * Translating names to IP addresses:: | ||
| 3460 | @end menu | 3380 | @end menu |
| 3461 | 3381 | ||
| 3462 | @node Finding Emacs on the Internet, Finding a package with particular functionality, Finding Emacs and related packages, Finding Emacs and related packages | 3382 | @node Finding Emacs on the Internet, Finding a package with particular functionality, Finding Emacs and related packages, Finding Emacs and related packages |
| @@ -3665,7 +3585,7 @@ Note that while many of these programs look similar to Emacs, they often | |||
| 3665 | lack certain features, such as the Emacs Lisp extension language. | 3585 | lack certain features, such as the Emacs Lisp extension language. |
| 3666 | 3586 | ||
| 3667 | @node Emacs for Windows, Emacs for OS/2, Emacs for MS-DOS, Finding Emacs and related packages | 3587 | @node Emacs for Windows, Emacs for OS/2, Emacs for MS-DOS, Finding Emacs and related packages |
| 3668 | @section Where can I get Emacs for Microsoft Windows | 3588 | @section Where can I get Emacs for Microsoft Windows? |
| 3669 | @cindex FAQ for NT Emacs | 3589 | @cindex FAQ for NT Emacs |
| 3670 | @cindex Emacs for MS-Windows | 3590 | @cindex Emacs for MS-Windows |
| 3671 | @cindex Microsoft Windows, Emacs for | 3591 | @cindex Microsoft Windows, Emacs for |
| @@ -3745,8 +3665,7 @@ Beginning with version 21.1, the Macintosh is supported in the official | |||
| 3745 | Emacs distribution; see the files @file{mac/README} and | 3665 | Emacs distribution; see the files @file{mac/README} and |
| 3746 | @file{mac/INSTALL} in the Emacs distribution for build instructions. | 3666 | @file{mac/INSTALL} in the Emacs distribution for build instructions. |
| 3747 | 3667 | ||
| 3748 | Apple's ``OS X'' is based largely on NeXTSTEP and OpenStep. | 3668 | Beginning with version 22.1, Emacs supports Mac OS X natively. |
| 3749 | @xref{Emacs for NeXTSTEP}, for more details about that version. | ||
| 3750 | 3669 | ||
| 3751 | @node Emacs for VMS and DECwindows, Modes for various languages, Emacs for Apple computers, Finding Emacs and related packages | 3670 | @node Emacs for VMS and DECwindows, Modes for various languages, Emacs for Apple computers, Finding Emacs and related packages |
| 3752 | @section Where do I get Emacs that runs on VMS under DECwindows? | 3671 | @section Where do I get Emacs that runs on VMS under DECwindows? |
| @@ -3756,7 +3675,7 @@ Apple's ``OS X'' is based largely on NeXTSTEP and OpenStep. | |||
| 3756 | Up-to-date information about GNU software (including Emacs) for VMS is | 3675 | Up-to-date information about GNU software (including Emacs) for VMS is |
| 3757 | available at @uref{http://vms.gnu.org/}. | 3676 | available at @uref{http://vms.gnu.org/}. |
| 3758 | 3677 | ||
| 3759 | @node Modes for various languages, Translating names to IP addresses, Emacs for VMS and DECwindows, Finding Emacs and related packages | 3678 | @node Modes for various languages, , Emacs for VMS and DECwindows, Finding Emacs and related packages |
| 3760 | @section Where can I get modes for Lex, Yacc/Bison, Bourne shell, csh, C@t{++}, Objective-C, Pascal, Java, and Awk? | 3679 | @section Where can I get modes for Lex, Yacc/Bison, Bourne shell, csh, C@t{++}, Objective-C, Pascal, Java, and Awk? |
| 3761 | @cindex Awk, mode for | 3680 | @cindex Awk, mode for |
| 3762 | @cindex @code{awk-mode} | 3681 | @cindex @code{awk-mode} |
| @@ -3781,37 +3700,6 @@ Barry Warsaw's @code{cc-mode} now works for C, C@t{++}, Objective-C, and | |||
| 3781 | Java code. It is distributed with Emacs, but has | 3700 | Java code. It is distributed with Emacs, but has |
| 3782 | @uref{http://cc-mode.sourceforge.net/, its own homepage}. | 3701 | @uref{http://cc-mode.sourceforge.net/, its own homepage}. |
| 3783 | 3702 | ||
| 3784 | @node Translating names to IP addresses, , Modes for various languages, Finding Emacs and related packages | ||
| 3785 | @section What is the IP address of XXX.YYY.ZZZ? | ||
| 3786 | @cindex Translating names to IP addresses | ||
| 3787 | @cindex IP addresses from names | ||
| 3788 | @cindex Using BIND to translate addresses | ||
| 3789 | @cindex DNS and IP addresses | ||
| 3790 | |||
| 3791 | If you are on a Unix machine, try using the @samp{nslookup} command, | ||
| 3792 | included in the Berkeley BIND package. For example, to find the IP | ||
| 3793 | address of @samp{ftp.gnu.org}, you would type @code{nslookup | ||
| 3794 | ftp.gnu.org}. | ||
| 3795 | |||
| 3796 | Your computer should then provide the IP address of that machine. | ||
| 3797 | |||
| 3798 | If your site's nameserver is deficient, you can use IP addresses to FTP | ||
| 3799 | files. You can get this information by e-mail: | ||
| 3800 | |||
| 3801 | @example | ||
| 3802 | To: dns@@[134.214.84.25] (to grasp.insa-lyon.fr) | ||
| 3803 | Body: ip XXX.YYY.ZZZ (or "help" for more information | ||
| 3804 | and options - no quotes) | ||
| 3805 | @end example | ||
| 3806 | |||
| 3807 | @noindent | ||
| 3808 | or: | ||
| 3809 | |||
| 3810 | @example | ||
| 3811 | To: resolve@@[147.31.254.130] (to laverne.cs.widener.edu) | ||
| 3812 | Body: site XXX.YYY.ZZZ | ||
| 3813 | @end example | ||
| 3814 | |||
| 3815 | @c ------------------------------------------------------------ | 3703 | @c ------------------------------------------------------------ |
| 3816 | @node Major packages and programs, Key bindings, Finding Emacs and related packages, Top | 3704 | @node Major packages and programs, Key bindings, Finding Emacs and related packages, Top |
| 3817 | @chapter Major packages and programs | 3705 | @chapter Major packages and programs |
| @@ -4183,6 +4071,7 @@ jde-subscribe@@sunsite.auc.dk | |||
| 4183 | * Binding combinations of modifiers and function keys:: | 4071 | * Binding combinations of modifiers and function keys:: |
| 4184 | * Meta key does not work in xterm:: | 4072 | * Meta key does not work in xterm:: |
| 4185 | * ExtendChar key does not work as Meta:: | 4073 | * ExtendChar key does not work as Meta:: |
| 4074 | * SPC no longer completes file names:: | ||
| 4186 | @end menu | 4075 | @end menu |
| 4187 | 4076 | ||
| 4188 | @node Binding keys to commands, Invalid prefix characters, Key bindings, Key bindings | 4077 | @node Binding keys to commands, Invalid prefix characters, Key bindings, Key bindings |
| @@ -4200,7 +4089,7 @@ local-set-key @key{RET} @var{key} @var{cmd} @key{RET}}. | |||
| 4200 | 4089 | ||
| 4201 | @inforef{Key Bindings, Key Bindings, emacs}, for further details. | 4090 | @inforef{Key Bindings, Key Bindings, emacs}, for further details. |
| 4202 | 4091 | ||
| 4203 | To make the process of binding keys interactively eaiser, use the | 4092 | To make the process of binding keys interactively easier, use the |
| 4204 | following ``trick'': First bind the key interactively, then immediately | 4093 | following ``trick'': First bind the key interactively, then immediately |
| 4205 | type @kbd{C-x @key{ESC} @key{ESC} C-a C-k C-g}. Now, the command needed | 4094 | type @kbd{C-x @key{ESC} @key{ESC} C-a C-k C-g}. Now, the command needed |
| 4206 | to bind the key is in the kill ring, and can be yanked into your | 4095 | to bind the key is in the kill ring, and can be yanked into your |
| @@ -4829,7 +4718,7 @@ You might have to replace @samp{Meta} with @samp{Alt}. | |||
| 4829 | 4718 | ||
| 4830 | @end itemize | 4719 | @end itemize |
| 4831 | 4720 | ||
| 4832 | @node ExtendChar key does not work as Meta, , Meta key does not work in xterm, Key bindings | 4721 | @node ExtendChar key does not work as Meta, SPC no longer completes file names, Meta key does not work in xterm, Key bindings |
| 4833 | @section Why doesn't my @key{ExtendChar} key work as a @key{Meta} key under HP-UX 8.0 and 9.x? | 4722 | @section Why doesn't my @key{ExtendChar} key work as a @key{Meta} key under HP-UX 8.0 and 9.x? |
| 4834 | @cindex @key{ExtendChar} key as @key{Meta} | 4723 | @cindex @key{ExtendChar} key as @key{Meta} |
| 4835 | @cindex @key{Meta}, using @key{ExtendChar} for | 4724 | @cindex @key{Meta}, using @key{ExtendChar} for |
| @@ -4852,6 +4741,25 @@ xmodmap -e 'remove mod1 = Mode_switch' | |||
| 4852 | This will disable the use of the extra keysyms systemwide, which may be | 4741 | This will disable the use of the extra keysyms systemwide, which may be |
| 4853 | undesirable if you actually intend to use them. | 4742 | undesirable if you actually intend to use them. |
| 4854 | 4743 | ||
| 4744 | @node SPC no longer completes file names, , ExtendChar key does not work as Meta, Key bindings | ||
| 4745 | @section Why doesn't SPC complete file names anymore? | ||
| 4746 | @cindex @kbd{SPC} file name completion | ||
| 4747 | |||
| 4748 | Starting with Emacs 22.1, @kbd{SPC} no longer completes file names in | ||
| 4749 | the minibuffer, so that file names with embedded spaces could be typed | ||
| 4750 | without the need to quote the spaces. | ||
| 4751 | |||
| 4752 | You can get the old behavior by binding @kbd{SPC} to | ||
| 4753 | @code{minibuffer-complete-word} in the minibuffer, as follows: | ||
| 4754 | |||
| 4755 | @lisp | ||
| 4756 | (define-key minibuffer-local-filename-completion-map (kbd "SPC") | ||
| 4757 | 'minibuffer-complete-word) | ||
| 4758 | |||
| 4759 | (define-key minibuffer-local-must-match-filename-map (kbd "SPC") | ||
| 4760 | 'minibuffer-complete-word) | ||
| 4761 | @end lisp | ||
| 4762 | |||
| 4855 | @c ------------------------------------------------------------ | 4763 | @c ------------------------------------------------------------ |
| 4856 | @node Alternate character sets, Mail and news, Key bindings, Top | 4764 | @node Alternate character sets, Mail and news, Key bindings, Top |
| 4857 | @chapter Alternate character sets | 4765 | @chapter Alternate character sets |
| @@ -5154,11 +5062,6 @@ best fix I've been able to come up with: | |||
| 5154 | @cindex Mail packages and MIME | 5062 | @cindex Mail packages and MIME |
| 5155 | @cindex FAQ for MIME and Emacs | 5063 | @cindex FAQ for MIME and Emacs |
| 5156 | 5064 | ||
| 5157 | Read the Emacs MIME FAQ, maintained by @email{trey@@cs.berkeley.edu, | ||
| 5158 | MacDonald Hall Jackson} at | ||
| 5159 | |||
| 5160 | @uref{http://bmrc.berkeley.edu/~trey/emacs/mime.html} | ||
| 5161 | |||
| 5162 | Version 6.x of VM supports MIME. @xref{VM}. Gnus supports MIME in mail | 5065 | Version 6.x of VM supports MIME. @xref{VM}. Gnus supports MIME in mail |
| 5163 | and news messages as of version 5.8.1 (Pterodactyl). Rmail has limited | 5066 | and news messages as of version 5.8.1 (Pterodactyl). Rmail has limited |
| 5164 | support for single-part MIME messages beginning with Emacs 20.3. | 5067 | support for single-part MIME messages beginning with Emacs 20.3. |