X-Git-Url: http://git.hcoop.net/bpt/emacs.git/blobdiff_plain/7ac1c664547ca88fd6c0ff65ef5e780b1c5efcb0..494ec1e71d7f725534be9a5518f0a2bdfe35d2c3:/doc/misc/edt.texi diff --git a/doc/misc/edt.texi b/doc/misc/edt.texi index d394137d76..ef27d339e9 100644 --- a/doc/misc/edt.texi +++ b/doc/misc/edt.texi @@ -1,12 +1,12 @@ \input texinfo @setfilename ../../info/edt @settitle EDT Emulation for Emacs +@documentencoding UTF-8 @copying This file documents the EDT emulation package for Emacs. -Copyright @copyright{} 1986, 1992, 1994, 1995, 1999, 2000, 2001, 2002, -2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010 +Copyright @copyright{} 1986, 1992, 1994--1995, 1999--2014 Free Software Foundation, Inc. @quotation @@ -18,12 +18,11 @@ and with the Back-Cover Texts as in (a) below. A copy of the license is included in the section entitled ``GNU Free Documentation License''. (a) The FSF's Back-Cover Text is: ``You have the freedom to copy and -modify this GNU manual. Buying copies from the FSF supports it in -developing GNU and promoting software freedom.'' +modify this GNU manual.'' @end quotation @end copying -@dircategory Emacs +@dircategory Emacs misc features @direntry * EDT: (edt). An Emacs emulation of the EDT editor. @end direntry @@ -63,10 +62,10 @@ of DEC's EDT editor. @node Overview @chapter Overview of the EDT Package -This manual describes version 4.0 of the EDT Emulation for Emacs 19 and -above. It comes with special functions which replicate nearly all of +This manual describes version 4.0 of the EDT Emulation for Emacs. +It comes with special functions which replicate nearly all of EDT's keypad mode behavior. It sets up default keypad and function key -bindings which closely match those found in EDT. Support is provided so +bindings which closely match those found in EDT@. Support is provided so that users may reconfigure most keypad and function key bindings to their own liking. @@ -88,11 +87,11 @@ informing you that the emulation has been enabled: ``Default EDT keymap active''. You can have the EDT Emulation start up automatically, each time you -initiate a GNU Emacs session, by adding the following line to your +initiate an Emacs session, by adding the following line to your @file{.emacs} file: @example -(add-hook term-setup-hook 'edt-emulation-on) +(add-hook 'emacs-startup-hook 'edt-emulation-on) @end example @noindent @strong{Important:} Be sure to read the rest of this manual. @@ -104,25 +103,25 @@ how to customize it to your liking. @itemize @item -@file{edt.texi} - This manual. +@file{edt.texi}---This manual. @item -@file{edt-user.el} - An example customization file. +@file{edt-user.el}---An example customization file. @item -@file{edt.el} - EDT emulation functions and default configuration. +@file{edt.el}---EDT emulation functions and default configuration. @item -@file{edt-lk201.el} - Built-in support for DEC LK-201 keyboards. +@file{edt-lk201.el}---Built-in support for DEC LK-201 keyboards. @item -@file{edt-vt100.el} - Built-in support for DEC VT-100 (and above) terminals. +@file{edt-vt100.el}---Built-in support for DEC VT-100 (and above) terminals. @item -@file{edt-pc.el} - Built-in support for PC 101 Keyboards under MS-DOS. +@file{edt-pc.el}---Built-in support for PC 101 Keyboards under MS-DOS. @item -@file{edt-mapper.el} - Create an EDT LK-201 map file for keyboards +@file{edt-mapper.el}---Create an EDT LK-201 map file for keyboards without built-in support. @end itemize @@ -152,9 +151,8 @@ You can also invoke @code{edt-set-scroll-margins} interactively while EDT Emulation is active to change the settings for that session. @strong{Please note:} Another way to set the scroll margins is to use -the Emacs customization feature (not available in Emacs 19) to set the -following two variables directly: @code{edt-top-scroll-margin} and -@code{edt-bottom-scroll-margin}. +the Emacs customization feature to set the following two variables +directly: @code{edt-top-scroll-margin} and @code{edt-bottom-scroll-margin}. Enter the Emacs @code{customize} command. First select the @samp{Editing} group and then select the @samp{Emulations} group. @@ -220,7 +218,7 @@ user quits without saving those buffers. @item Emulate EDT Keypad Mode commands closely so that current EDT users will -find that it easy and comfortable to use GNU Emacs with a small learning +find that it easy and comfortable to use Emacs with a small learning curve. @item @@ -239,8 +237,7 @@ Provide an easy way to restore @strong{all} original Emacs key bindings, just as they existed before the EDT emulation was first invoked. @item -Support GNU Emacs 19 and higher. (GNU Emacs 18 and below is no longer -supported.) XEmacs 19, and above, is also supported. +Support Emacs and XEmacs 19 and higher. @item Supports highlighting of marked text within the EDT emulation on all @@ -288,17 +285,17 @@ apply to you. @node Starting emulation @chapter How to Get Started -Start up GNU Emacs and enter @kbd{M-x edt-emulation-on} to begin the +Start up Emacs and enter @kbd{M-x edt-emulation-on} to begin the emulation. After initialization is complete, the following message will appear below the status line informing you that the emulation has been enabled: ``Default EDT keymap active''. You can have the EDT Emulation start up automatically, each time you -initiate a GNU Emacs session, by adding the following line to your +initiate an Emacs session, by adding the following line to your @file{.emacs} file: @example -(add-hook term-setup-hook 'edt-emulation-on) +(add-hook 'emacs-startup-hook 'edt-emulation-on) @end example A reference sheet is included (later on) listing the default EDT @@ -309,7 +306,7 @@ in the EDT Default Mode). It is easy to customize key bindings in the EDT Emulation (@pxref{Customizing}). Customizations are placed in a file called @file{edt-user.el}. The Emacs @file{etc/} directory contains an -example. If @file{edt-user.el} is found in your GNU Emacs load path +example. If @file{edt-user.el} is found in your Emacs load path during EDT Emulation initialization, then the following message will appear below the status line indicating that the emulation has been enabled, enhanced by your own customizations: ``User EDT custom keymap @@ -324,8 +321,8 @@ restores the original key bindings in effect just prior to invoking the emulation. Emacs binds keys to @acronym{ASCII} control characters and so does the -real EDT. Where EDT key bindings and GNU Emacs key bindings conflict, -the default GNU Emacs key bindings are retained by the EDT emulation by +real EDT@. Where EDT key bindings and Emacs key bindings conflict, +the default Emacs key bindings are retained by the EDT emulation by default. If you are a diehard EDT user you may not like this. The @ref{Control keys} section explains how to change this so that the EDT bindings to @acronym{ASCII} control characters override the default @@ -367,7 +364,7 @@ older SunOS release configured with a Sun Type 5 keyboard: @example ! File: .xmodmaprc ! -! Set up Sun Type 5 keypad for use with the GNU Emacs EDT Emulation +! Set up Sun Type 5 keypad for use with the Emacs EDT Emulation ! keycode 53 = KP_Divide keycode 54 = KP_Multiply @@ -439,7 +436,7 @@ things up nicely. @example ! File: .xmodmaprc ! -! Set up PC keypad under GNU/Linux for the GNU Emacs EDT Emulation +! Set up PC keypad under GNU/Linux for the Emacs EDT Emulation ! clear mod2 keycode 77 = F12 @@ -521,7 +518,7 @@ assign Num_Lock back to mod2. @example ! File: .xmodmaprc ! -! Set up PC keypad under GNU/Linux for the GNU Emacs EDT Emulation +! Set up PC keypad under GNU/Linux for the Emacs EDT Emulation ! clear mod2 keycode 77 = F12 @@ -530,7 +527,7 @@ add mod2 = Num_Lock @end example So, after executing @samp{xmodmap .xmodmaprc}, a press of the physical -@key{F12} key looks like a Num_Lock keypress to X. Also, a press of the +@key{F12} key looks like a Num_Lock keypress to X@. Also, a press of the physical @key{NumLock} key looks like a press of the @key{F12} key to X. Now, @file{edt-mapper.el} will see @samp{f12} when the physical @@ -544,7 +541,7 @@ In general, you will find that this emulation of EDT replicates most, but not all, of EDT's most used Keypad Mode editing functions and behavior. It is not perfect, but most EDT users who have tried the emulation agree that it is quite good enough to make it easy for -die-hard EDT users to move over to using GNU Emacs. +die-hard EDT users to move over to using Emacs. Here's a list of the most important differences between EDT and this GNU Emacs EDT Emulation. The list is short but you must be aware of these @@ -677,7 +674,7 @@ two-thirds of the current window. (There is also an @item Cursor movement and deletion involving word entities is identical to -EDT. This, above all else, gives the die-hard EDT user a sense of being +EDT@. This, above all else, gives the die-hard EDT user a sense of being at home. Also, an emulation of EDT's @samp{SET ENTITY WORD} command is provided, for those users who like to customize movement by a word at a time to their own liking. @@ -786,20 +783,20 @@ terminals on the same system, you need not look at @file{edt-user.el2}. @end ignore First, you need to have your own private lisp directory, say -@file{~/lisp}, and you should add it to the GNU Emacs load path. +@file{~/lisp}, and you should add it to the Emacs load path. @strong{Please note:} A few sites have different load-path requirements, so the above directions may need some modification if your site has such special needs. @menu -* edt-user.el:: Creating your own @file{edt-user.el} file. +* Init file:: Creating your own @file{edt-user.el} file. * Words:: Specifying word entities. * Control keys:: Enabling EDT control key sequence bindings. * Scroll margins:: Setting scroll margins. @end menu -@node edt-user.el +@node Init file @section Creating your own @file{edt-user.el} File A sample @file{edt-user.el} file is provided in the Emacs @file{etc/} @@ -901,8 +898,8 @@ Here are some examples: @node Control keys @section Enabling EDT Control Key Sequence Bindings -Where EDT key bindings and GNU Emacs key bindings conflict, the default -GNU Emacs key bindings are retained by default. Some diehard EDT users +Where EDT key bindings and Emacs key bindings conflict, the default +Emacs key bindings are retained by default. Some diehard EDT users may not like this. So, if the variable @code{edt-use-EDT-control-key-bindings} is set to true in a user's @file{.emacs} file, then the default EDT Emulation mode will enable most @@ -933,9 +930,8 @@ You can also invoke @code{edt-set-scroll-margins} interactively while EDT Emulation is active to change the settings for that session. @strong{Please note:} Another way to set the scroll margins is to use -the Emacs customization feature (not available in Emacs 19) to set the -following two variables directly: @code{edt-top-scroll-margin} and -@code{edt-bottom-scroll-margin}. +the Emacs customization feature to set the following two variables +directly: @code{edt-top-scroll-margin} and @code{edt-bottom-scroll-margin}. Enter the Emacs @code{customize} command. First select the @samp{Editing} group and then select the @samp{Emulations} group. @@ -946,7 +942,3 @@ Finally, select the @samp{Edt} group and follow the directions. @include doclicense.texi @bye - -@ignore - arch-tag: 1b7ebe01-754b-4834-a12b-f152ef7db9e0 -@end ignore