From: CRDGW2::CRDGW2::MRGATE::"SMTP::AI.MIT.EDU::GNULISTS" 26-FEB-1991 06:07:54.81 To: ARISIA::EVERHART CC: Subj: GNU Emacs Frequently Asked Questions with Answers (part 1 of 2) From: gnulists@ai.mit.edu@SMTP@CRDGW2 To: Everhart@Arisia@MRGATE Received: by crdgw1.ge.com (5.57/GE 1.83) id AA03833; Tue, 26 Feb 91 05:58:15 EST Received: by life.ai.mit.edu (4.1/AI-4.10) id AA05919; Sun, 24 Feb 91 14:06:27 EST Return-Path: Received: from wheat-chex (wheat-chex.ai.mit.edu) by life.ai.mit.edu (4.1/AI-4.10) id AA05870; Sun, 24 Feb 91 14:03:40 EST Received: by wheat-chex (4.1/AI-4.10) id AA20537; Sun, 24 Feb 91 14:03:43 EST Resent-Date: 17 Feb 91 22:45:31 GMT Resent-From: gnulists@ai.mit.edu Resent-Message-Id: <9102241903.AA20537@wheat-chex> Received: from tut.cis.ohio-state.edu by life.ai.mit.edu (4.1/AI-4.10) id AA25468; Sun, 17 Feb 91 18:01:47 EST Received: by tut.cis.ohio-state.edu (5.61-kk/5.910130) id AA15500; Sun, 17 Feb 91 17:56:56 -0500 Received: from USENET by tut.cis.ohio-state.edu with netnews for help-gnu-emacs@prep.ai.mit.edu (help-gnu-emacs@prep.ai.mit.edu) (contact usenet@tut.cis.ohio-state.edu if you have questions) Date: 17 Feb 91 22:45:31 GMT From: nntp-read!jbw@bu.edu (Joe Wells) Sender: gnulists@ai.mit.edu Organization: Boston University Computer Science Department Subject: GNU Emacs Frequently Asked Questions with Answers (part 1 of 2) Message-Id: To: help-gnu-emacs@prep.ai.mit.edu This is a list of frequently asked questions (FAQ) about GNU Emacs with answers. This list is designed to cut down on the noise in the gnu.emacs.help newsgroup (which is also the help-gnu-emacs mailing list) that results from people repeatedly asking many of the same questions. This is the first time I am cross-posting this to comp.emacs. If the reaction is mostly positive, I'll continue to do so. Here is a short list of new questions, questions that were deleted because the problem they describe has been fixed, and questions whose answer changed: New questions: How do I unsubscribe to this mailing list? Why doesn't display-time show the load factor in the mode line anymore? How do I control Emacs's case sensitivitiy when searching/replacing? Questions that were obsoleted (I think) by GNU Emacs 18.56 and 18.57: Why does Emacs crash under SunOS 4.1? Why does Emacs occasionally cause segmentation faults and machine Why won't src/alloc.c compile on a SPARCstation? Why do shells started from Emacs suspend themselves under SunOS 4.1? Why does Emacs crash from a bus error in XLookupString under OpenLook? Why doesn't "C-c C-c" interrupt subprocesses under HP/UX? Why don't the command line switches documented in the man page work? Why does gnus-Subject-mail-reply chop off the last character of the article headers? Why can't I paste a selection I made in Emacs into my xterm window? What does Emacs do every time it starts up? Questions whose answers were improved or updated (including minor changes): Where can I get GNU Emacs on the net (or by snail mail)? Where can I get help in installing GNU Emacs? How do I get a printed copy of the GNU Emacs manual? Where can I get GNU Emacs Lisp packages that don't come with Emacs? Where can I get documentation on GNU Emacs Lisp? What informational files are available for GNU Emacs? Where can I get the latest VM, Supercite, GNUS, Calc, Calendar, or Patch? How do I install a piece of Texinfo documentation? Where does the name "Emacs" come from? What is the latest version of GNU Emacs? How do I get Emacs for my PC? How do I "swap" two keys? Why does the cursor always go to the wrong column when I move up or down one line? Why doesn't GNUS work anymore via NNTP? What are the valid X resource settings (ie., stuff in .Xdefaults file)? How do I show which parenthesis matches the one I'm looking at? Feel free to contribute text for the answers that I haven't written yet, to suggest new questions, to suggest changes in the wording, to suggest deletions, etc. Please include either "FAQ" or "frequently asked questions" in the subject of messages you send to me to help keep me from accidentally filing your message in the wrong mail folder. However, please don't send questions to me just because you don't want to disturb a lot of people. The main reason I have assembled the FAQ is because I don't have time to answer questions individually. Please send only questions that are about the FAQ or something else I have written. -- Enjoy, Joe Wells ------------------------------------------------- GNU Emacs Frequently Asked Questions with Answers (part 1 of 2) Sun Feb 17 17:45:14 1991 If you are viewing this file in a GNU Emacs Buffer, you can type "M-2 C-x $" to get an overview of just the questions. Then, when you want to look at the text of the answers, just type "C-x $". To search for a question numbered XXX, type "M-C-s ^XXX:", followed by a C-r if that doesn't work, then type ESC to end the search. Notation Used in the Answers (READ THIS SECTION FIRST!) You may skip this section if you are reasonably familiar with GNU Emacs. Some of these are not actually frequently asked questions, but knowing them is important for understanding the answers to the rest of the questions. 1: What do things like this mean: C-h, M-C-a, RET, etc.? C-a means while holding down the "Control" key press the "a" key. The ASCII code this sends will generally be the value that would be sent by pressing just "a" minus 96 or 64. Either way it will be a number from 0 to 31. M-a means while holding down the "Meta" key press the "a" key. The ASCII code this sends is the sum of the ASCII code that would be sent by pressing just "a" and 128. M-C-a means while holding down both the "Control" key and the "Meta" key press the "a" key. C-M-a is a synonym for M-C-a. RET means press the "Return" key. RET is the same as C-m. This sends ASCII code 13. LFD means press the "Linefeed" key. LFD is also the same as C-j. This sends ASCII code 10. Under Unix, ASCII code 10 is more often called "Newline". DEL means press the "Delete" key. DEL is the same as C-?. This sends ASCII code 127. ESC means press the "Escape" key. ESC is the same as C-[. This sends ASCII code 27. SPC means press the "Space" key. This send ASCII code 32. TAB means press the "Tab" key. TAB is the same as C-i. This send ASCII code 9. To read more about this online, type "C-h i m emacs RET m characters RET", and also "C-h i m emacs RET m keys RET". 2: What do you mean when you write things like this: type "ESC a"? I will enclose key sequences that are longer than one key inside double quotes. These notations refer to single keys (some with modifiers): C-x, M-x, M-C-x RET, LFD, DEL, ESC, SPC, TAB I separate these from other keys within double quotes by spaces. Any real spaces that I write inside double quotes can be ignored, only SPC means press the space key. All other characters within double quotes represent single keys (some shifted). 3: What if I don't have a Meta key? Instead of typing M-a, you can type "ESC a" instead. In fact, Emacs converts M-a internally into "ESC a" anyway. 4: What if I don't have an Escape key? Type C-[ instead. This should send ASCII code 27 just like an Escape key would. 5: What does "M-x command" mean? "M-x command" means type M-x, then type the name of the command, then type RET. M-x is simply the default key sequence that invokes the command "execute-extended-command". This command allows you to run any Emacs command if you can remember the command's name. If you can't remember the command's name, you can type TAB and SPC for completion, and ? for a list of possibilities. An Emacs "command" is any "interactive" Emacs function. NOTE: Your system administrator may have bound other key sequences to invoke execute-extended-command. A function key labeled "Do" is a good candidate for this. To run non-interactive Emacs functions, use M-ESC instead and type a Lisp form. 6: What do things like this mean: etc/SERVICE, src/config.h, lisp/default.el? These are the names of files that are part of the GNU Emacs distribution. The GNU Emacs distribution is so big that it is divided into several subdirectories; the important subdirectories are named "etc", "lisp", and "src". If you use GNU Emacs, but don't know where it is kept on your system, start Emacs, then type "C-h v exec-directory RET". The directory name that is displayed by this will be the full pathname of the "etc" directory of your installed GNU Emacs distribution. Some of these files are available individually via FTP or e-mail, see question 16. 7: What are FSF, LPF, OSF, GNU, RMS, FTP, BTW, and GPL? FSF == Free Software Foundation LPF == League for Programming Freedom OSF == Open Software Foundation GNU == GNU's Not Unix RMS == Richard M. Stallman FTP == File Transfer Protocol BTW == By the way GPL == GNU General Public Licence NOTE: Avoid confusing the FSF, the LPF, and the OSF. The LPF only opposes look-and-feel copyrights and software patents. The FSF aims to make high quality free software available for everyone. The OSF is a commercial organization which wants to provide an alternative, standardized version of Unix not controlled by AT&T. Sources of Information and Help 8: I'm just starting GNU Emacs; how do I do basic editing? Type "C-h t" to invoke the self-paced tutorial. Typing just C-h is how to enter the help system. WARNING: your system administrator may have changed C-h to act like DEL. You can use M-x help-for-help instead to invoke help. To discover what key (if any) invokes help on your system, type "M-x where-is RET help-for-help RET". This will print a comma-separated list of key sequences in the echo area. Ignore the last character in each key sequence listed. Each of the resulting key sequences invokes help. NOTE: Emacs's help facility works best if help is invoked by a single key. The variable help-char should hold the value of this character. 9: How do I find out how to do something in GNU Emacs? There are several methods for finding out how to do things in Emacs. You should become familiar with the online documentation for Emacs. The complete text of the Emacs manual is available online in a hypertext format via the "Info" manual reader. Type "C-h i" to invoke Info. You can order a hardcopy of the manual from the FSF. See question 12. You can list all of the commands whose names contain a certain word (actually which match a regular expression) using the "command-apropos" command. Type "C-h a" to invoke this command. You can list all of the functions and variables whose names contain a certain word using the "apropos" command. M-x apropos invokes this command. You may find that command-apropos and apropos are extremely slow on your system. This will be fixed in Emacs 19. If you can't wait that long, I can send you the "fast-apropos.el" file that contains the fix. This file also contains a "super-apropos" command that will list all the functions and variables whose documentation strings contain a certain word. There are many other commands in Emacs for getting help and information. To get a list of these commands, type "C-h C-h C-h". 10: Where can I get GNU Emacs on the net (or by snail mail)? Look in the files etc/DISTRIB and etc/FTP for information on nearby archive sites. If you don't already have GNU Emacs, see question 16 for how to get these two files. The latest version is always available via anonymous FTP at MIT (prep.ai.mit.edu:/pub/gnu/emacs-18.57.tar.Z). 11: Where can I get help in installing GNU Emacs? Look in the file etc/SERVICE for names of companies and individuals who will sell you this type of service. An up-to-date version of the SERVICE file is available on prep.ai.mit.edu. See question 16 for how to retrieve this file. 12: How do I get a printed copy of the GNU Emacs manual? You can order a printed copy of the GNU Emacs manual from the FSF for $20. For 6 or more manuals the price is $13 each. The full TeX source for the manual also comes with Emacs, if you're daring enough to try to print out this 300 page manual yourself. If you order it from the FSF, the price may be tax-deductible as a business expense.) If you absolutely have to print your own copy, and you don't have TeX, you can get a PostScript version via anonymous FTP (ab20.larc.nasa.gov:/pub/docs/emacs-18.57.PS.Z, size: 466K). If you don't have TeX you can convert the TeXinfo sources into {t,n,ps}roff format with the "texi2roff" program, which is available via anonymous FTP (tut.cis.ohio-state.edu:/pub/gnu/texi2roff/texi2roff.shar.Z) Carl Witty writes: The Emacs manual is also available online in the Info system, which is available by typing "C-h i". In this form, it has hypertext links and is very easy to browse or search; many people prefer it to the printed manual. 13: Has someone written an GNU Emacs Lisp package that does XXX? Probably. A listing of Emacs Lisp packages, called the Lisp Code Directory, is being maintained by Dave Brennan . You can search through this list to find if someone has written something that fits your needs. This list is file "LCD-datafile.Z" in the Emacs Lisp Archive. (See question 14.) The files "lispdir.el.Z" and "lispdir.doc.Z" in the archive contain information to help you use the list. 14: Where can I get GNU Emacs Lisp packages that don't come with Emacs? First, check the Lisp Code Directory to find the name of the package you are looking for. (See question 13). Then check local archives and the Emacs Lisp Archive to find a copy of the relevant files. Then, if you still haven't found it, you can send e-mail to the author asking for a copy. You can access the Emacs Lisp Archive via anonymous FTP (tut.cis.ohio-state.edu:/pub/gnu/emacs/elisp-archive/). Fetch the file "README.Z" first. NOTE: Any files with names ending in ".Z" are compressed, and you should use "binary" mode in FTP to retrieve them. You should also use binary mode whenever you retrieve any files with names ending in ".elc". Submissions for the archive should be sent to Dave Sill . If you have ftp access, the submission can be deposited in the directory /pub/gnu/emacs/elisp-archive/incoming on tut.cis.ohio-state.edu. Whenever possible submissions should contain an LCD-datafile entry since this helps reduce administrative overhead for the maintainers. Before submitting anything, first read the file "guidelines.Z", which is available in the archive. 15: Where can I get documentation on GNU Emacs Lisp? Obtain the GNU Emacs Lisp Reference Manual for Emacs 18 under Unix. It is available from the FSF for $50. The latest revision available for FTP is edition 1.03 dated 28 January 1991. Within Emacs, you can type "C-h f" to get the documentation for a function, "C-h v" for a variable. Also, as a popular USENET saying goes, "Use the Force, Read the Source". You can also get the Texinfo source for the manual, if you are daring enough to try to print this 550 page manual out yourself. This is available in the Emacs Lisp Archive and also via anonymous FTP (prep.ai.mit.edu:/pub/gnu/elisp.tar.Z). A set of pregenerated Info files comes with the Texinfo source for the Emacs Lisp manual, so you don't have to format it yourself for online use. (You can create the Info files from the Texinfo source.) See question 21 for details on how to install these files online. 16: What informational files are available for GNU Emacs? This isn't a frequently asked question, but it should be! A variety of informational files about GNU Emacs and relevant aspects of the GNU project are available for you to read. The following files are available in the "etc" directory of the GNU Emacs distribution, and also the latest versions are available individually via anonymous FTP (prep.ai.mit.edu:/pub/gnu/etc/): APPLE -- Why the FSF doen't support GNU Emacs on Apple computers DISTRIB -- GNU Emacs Availability Information, including the popular "Free Software Foundation Order Form" FTP -- How to get GNU Software by Internet FTP or by UUCP GNU -- The GNU Manifesto INTERVIEW -- Richard Stallman discusses his public-domain UNIX-compatible software system with BYTE editors MACHINES -- Status of GNU Emacs on Various Machines and Systems MAILINGLISTS -- GNU Project Electronic Mailing Lists SERVICE -- GNU Service Directory SUN-SUPPORT -- includes the popular "Using Emacstool with GNU Emacs" These files are available in the "etc" directory of the GNU Emacs distribution: DIFF -- Differences between GNU Emacs and Twenex Emacs CCADIFF -- Differences between GNU Emacs and CCA Emacs GOSDIFF -- Differences between GNU Emacs and Gosling (Unipress??) Emacs COPYING -- GNU Emacs General Public License NEWS -- GNU Emacs News, a history of user-visible changes LPF -- Why you should join the League for Programming Freedom FAQ -- GNU Emacs Frequently Asked Questions (You're reading it) OPTIONS -- a complete explanation of startup option handling These files are available via anonymous FTP (prep.ai.mit.edu:/pub/gnu/): tasks -- GNU Task List standards.text -- GNU Coding Standards In addition, all of the above files are available directly from the FSF via e-mail. Of course, please try to get them from a local source first. These additional files are available from the FSF via e-mail: * GNU's Bulletin, June, 1990 -- this file includes: GNU'S Who What Is the Free Software Foundation? What Is Copyleft? GNUs Flashes Possible New Terms for GNU Libraries by Richard Stallman "League for Programming Freedom" by Michael Bloom and Richard Stallman Free Software Support GNU Project Status Report GNU Wish List GNU Documentation GNU Software Available Now Contents of the Emacs Release Tape Contents of the Pre-Release Tape Contents of the X11 Tapes VMS Emacs and Compiler Tapes How to Get GNU Software Freemacs, an Extensible Editor for MS-DOS Thank GNUs FSF Order Form * Legal issues about contributing code to GNU * GNU Project Status Report 17: What is the current address of the FSF? Snail mail address: Free Software Foundation 675 Massachusetts Avenue Cambridge, MA 02139, USA Phone number: (617) 876-3296 E-mail addresses: gnu@prep.ai.mit.edu {probably read by Len Tower} gnulists@prep 18: What is the current address of the LPF? Snail mail address: League for Programming Freedom 1 Kendall Square, Number 143 Post Office Box 9171 Cambridge, MA 02139, USA Phone number: (617) 243-4061 { or 243-4091, I'm not sure ... } E-mail address: league@prep.ai.mit.edu 19: Where can I get the up-to-date GNU stuff? The most up-to-date official GNU stuff is normally kept on prep.ai.mit.edu and is available for anonymous FTP. See the files etc/DISTRIB and etc/FTP for more information. (To get copies of these files, see question 16.) 20: Where can I get the latest VM, Supercite, GNUS, Calc, Calendar, or Patch? 1. VM: Author: Kyle Jones Mailing lists: info-vm-request@uunet.uu.net info-vm@uunet.uu.net bug-vm-request@uunet.uu.net bug-vm@uunet.uu.net Anonymous FTP: Last released version: 4.41 tut.cis.ohio-state.edu:/pub/gnu/emacs/elisp-archive/packages/vm-4.41.tar.Z ab20.larc.nasa.gov:/pub/vm/vm-4.41.tar.Z Beta test version: 5.22 ab20.larc.nasa.gov:/pub/vm/{vm-5.22,timer}.tar.Z 2. Supercite: Author: Barry Warsaw Latest version: 2.1 Mailing lists: supercite@warsaw.nlm.nih.gov supercite-request@warsaw.nlm.nih.gov Anonymous FTP: site: durer.cme.nist.gov files:/pub/gnu/elisp/supercite-2.1.shar.0# (where # is replaced by 1 or 2) NOTE: Superyank is an old version of Supercite. 3. GNUS: Author: Masanobu Umeda Latest version: 3.13 Anonymous FTP: tut.cis.ohio-state.edu:/pub/gnu/emacs/elisp-archive/packages/gnus-3.13.tar.Z 4. Calc: Author: Dave Gillespie Latest version: 1.06 Anonymous FTP: site: csvax.cs.caltech.edu [131.215.131.131] or any comp.sources.misc archive 5. Calendar/Diary Author: Ed Reingold Latest version: 4 E-mail: Subject: send-emacs-cal body: your best internet e-mail address 6. Patch Author: Larry Wall Latest version: 2.0 patchlevel 12 Anonymous FTP: site: any comp.sources.unix archive or, for Europeans: site: archive.cs.ruu.nl [131.211.80.5] file: /pub/UNIX/patch-2.0.tar.Z 21: How do I install a piece of Texinfo documentation? First create Info files from the Texinfo files with M-x texinfo-format-buffer. There is also a program called "makeinfo" that provides better error checking and runs faster. Currently, it comes with the Emacs Lisp manual (which comes on the GNU Emacs tape). For information about the Texinfo format, read the Texinfo manual which comes with Emacs. This manual also comes installed in Info format, so you can read it online. Neither texinfo-format-buffer nor the makeinfo program install the resulting Info files in Emacs's Info tree. To install Info files: 1. Move the files to the "info" directory in the installed Emacs distribution. See question 6 if you don't know where that is. 2. Edit the file info/dir in the installed Emacs distribution, and add a line for the top level node in the Info package that you are installing. If you want to install Info files and you don't have the necessary priveleges, you have two options: 1. Info files don't actually need to be installed. You can feed a file name to the Info-goto-node command (invoked by pressing "g" in Info mode) by typing the name of the file in parentheses. This goes to the node named "Top" in that file. For example, to view a Info file named "XXX" in your home directory, you can type this: C-h i g (~/XXX) RET 2. You can create your own Info directory. You can tell Emacs where the Info directory is by setting the value of the variable Info-directory to its pathname. For example, to use a private Info directory which is a subdirectory of your home directory named "Info", you could do this: (setq Info-directory (expand-file-name "~/Info")) You will need a top-level Info file named "dir" in this directory. You can include the system-wide Info directory in your private Info directory with symbolic links or by copying it. 22: What is the real legal meaning of the GNU copyleft? RMS writes: The legal meaning of the GNU copyleft is less important than the spirit, which is that Emacs is a free software project and that work pertaining to Emacs should also be free software. "Free" means that all users have the freedom to study, share, change and improve Emacs. To make sure everyone has this freedom, pass along source code when you distribute any version of Emacs or a related program, and give the recipients the same freedom that you enjoyed. If you still want to find out about the legal meaning of the copyleft, please ask yourself if this means you are not paying attention to the spirit. 23: What are appropriate messages for gnu.emacs.help/gnu.emacs.bug/comp.emacs etc.? The file etc/MAILINGLISTS discusses the purpose of each GNU mailing-list. (See question 16 on how to get a copy.) For those which are gatewayed with newsgroups, it lists both the newsgroup name and the mailing list address. comp.emacs is for discussion of Emacs programs in general. This includes GNU Emacs along with various other implementations like JOVE, MicroEmacs, Freemacs, MG, Unipress, CCA, etc. Many people post GNU Emacs questions to comp.emacs because they don't receive any of the gnu.* newsgroups. Arguments have been made both for and against posting GNU-Emacs-specific material to comp.emacs. You have to decide for yourself. 24: How do I unsubscribe to this mailing list? If you are receiving a GNU mailing list named "XXX", you might be able to unsubscribe to it by sending a request to the address "XXX-request@prep.ai.mit.edu". However, this will not work if you are not listed on the main mailing list, but instead recieve the mail from a distribution point. In that case, you will have to track down at which distribution point you are listed. Inspecting the "Received:" headers on the mail messages may help, along with liberal use of the "EXPN" and "VRFY" sendmail commands through "telnet smtp". Ask your postmaster for help. {Sending mail to gnulists@prep.ai.mit.edu might also work in addition to the "-request" address, I'm not quite sure about that though.} GNU Emacs, all its Variants, and other Editors 25: Where does the name "Emacs" come from? EMACS originally was an acronym for Editor MACroS. The first Emacs was a set of macros written by Richard Stallman and Guy Steele for the editor TECO (Text Editor and COrrector (originally Tape Editor and COrrector)) on a PDP-10. (Amusing fact: many people have told me that TECO code looks a lot like line noise. See alt.lang.teco if you are interested.) 26: What is the latest version of GNU Emacs? GNU Emacs 18.57. 27: When will GNU Emacs 19 be available? Good question, I don't know. For that matter, neither do the developers. It will undoubtedly be available sometime in the 1990s. 28: What will be different about GNU Emacs 19? From the latest "GNU's Bulletin": Version 19 approaches release with a host of new features: before and after change hooks; X selection processing (including CLIPBOARD selections); scrollbars; support for European character sets; floating point numbers; per-buffer mouse commands; interfacing with the X resource manager; mouse-tracking; Lisp-level binding of function keys; and multiple X windows (`screens' to Emacs). Thanks go to Alan Carroll and the people who worked on Epoch for generating initial feedback to a multi-windowed Emacs. Emacs 19 supports two styles of multiple windows, one with a separate screen for the minibuffer, and another with a minibuffer attached to each screen. More features of Version 19 are buffer allocation, which uses a new mechanism capable of returning storage to the system when a buffer is killed, and a new input system---all input now arrives in the form of Lisp objects. Other features being considered for Version 19 include: * Associating property lists with regions of text in a buffer. * Multiple font, color, and pixmaps defined by those properties. * Different visibility conditions for the regions, and for the various windows showing one buffer. * Incremental syntax analysis for various programming languages. * Hooks to be run if point or mouse moves outside a certain range. * Source-level debugging for Emacs Lisp. * Incrementally saving undo history in a file, so that recover-file also reinstalls buffer's undo history. * Static menu bars, and better pop-up menus. * A more sophisticated emacsclient/server model, which would provide network transparent Emacs widget functionality. Also, Emacs 19 will have a Emacs Lisp source code debugger. 29: Is there an Emacs that has better mouse and X window support? Emacs 18 has some limited X Window System support, but there are problems. Emacs 19 will have amazing mouse and window support. Right now, there is a modified version of Emacs 18.55 called "Epoch" which has greatly improved mouse and window support. The latest version of Epoch is available via anonymous FTP (cs.uiuc.edu:/pub/epoch-files/epoch/epoch-3.2b, b stands for beta). NOTE: Epoch only works with the X Window System; it does not work on ordinary terminals. 30: How do I get Emacs for my PC? GNU Emacs won't run on a PC directly under MS-DOS. There have been reports of people running GNU Emacs under a special program under MS-DOS on 286 or 386 machines, but I don't know the details. You can try a variety of similar programs such as MG, MicroEmacs, Freemacs, etc. Russ Nelson , the author, describes Freemacs: * Freemacs is free, and it was designed from the start to be programmable. * Freemacs is the only IBM-PC editor that tries to be like GNU Emacs. * Freemacs can only edit files less than 64K in length. * Freemacs doesn't have undo. Carl Witty writes about Freemacs: Better is Freemacs, which follows the tradition of ITS and GNU Emacs by having an full, turing-complete extension language which is incompatible with everything else. In fact, it's even closer to ITS Emacs than GNU Emacs is, because Mint (Freemacs' extension language) is absolutely illegible without weeks of study, much like TECO. You can get Freemacs several ways: 1. Anonymous FTP: site: simtel20.army.mil, directory: PD: site: grape.ecs.clarkson.edu [128.153.13.196], directory: /e/freemacs 2. E-mail: address: archive-server@sun.soe.clarkson.edu, or archive-server%sun.soe@omnigate (BITNET), or {smart-host}!sun.soe.clarkson.edu!archive-server (UUCP) body: help 3. Snail mail: address: Russell Nelson, 11 Grant St., Potsdam, NY 13676 Send $15 copying fee, and specify preferred floppy disk format: 5.25", 1.2 Meg, or 5.25", 360K, or 3.50", 720K I don't know much about MicroEmacs. All I know is that the latest version is 3.10 and it is available via anonymous FTP (durer.cme.nist.gov). Another Emacs for small machines is JOVE (Jonathan's Own Version of Emacs). The latest version is 4.14. It is available via anonymous FTP (cs.rochester.edu:/pub/jove.tar.4.14.Z). Yet another Emacs is "mg", which used to stand for MicroGNUEmacs, but now just stands for "mg". It is also available via anonymous FTP (snow.white.toronto.edu). 31: Where can I get Emacs for my Atari ST? The latest version for the ST is available via anonymous FTP (cs.uni-sb.de:/pub/atari/emacs/). 32: Where can I get Emacs with NeWS support? Chris Maio's NeWS support package for GNU Emacs is available via anonymous FTP (columbia.edu/pub/ps-emacs.tar.Z, tut.cis.ohio-state.edu:/pub/gnu/emacs/ps-emacs.tar.Z). Binding Keys to Commands 33: Why does my key binding fail? Most likely, it failed because "ESC [" was already defined. Evaluate this form first: (define-key esc-map "[" nil) 34: Why doesn't this [terminal or window-system setup] code work in my .emacs file, but it works just fine after Emacs starts up? This is because you're trying to do something in your .emacs file that needs to be postponed until after the terminal/window-system setup code is loaded. This is a result of the order in which things are done during the startup of Emacs. In order to postpone the execution of Emacs Lisp code until after the terminal/window-system setup, set the value of the variable term-setup-hook or window-setup-hook to be a function which does what you want. See etc/OPTIONS for a complete explanation of what Emacs does every time it is started. Here is a simple example of how to set term-setup-hook: (setq term-setup-hook (function (lambda () (if (string-match "^vt220" (or (getenv "TERM") "")) ;; Make vt220's "Do" key behave like M-x: (define-key CSI-map "29~" 'execute-extended-command))))) 35: How do I use function keys under X Windows? If compiled on a Sun, Emacs recognizes the function keys that are normally on a Sun keyboard, and you can bind them the same way you normally bind Sun keys. Each function key will generate a key sequence that looks like "ESC [ ### z", where ### is replaced by a number. If not compiled on a Sun, the function keys will appear to Emacs in a way remarkably similar to the keys of a VT220 terminal. Each function key will generate a key sequence that looks like "ESC [ ### ~". For the complete list of the numbers which are generated by the function keys, look in the file src/x11term.c. However, this may be inadequate for you if you have function keys Emacs doesn't know about. Johan Vromans explains: There are a number of tricks that can be helpful. The most elegant solution, however, is to use the function "x-rebind-key". This function is commented out in the source for good reasons --- it's buggy. It is rather easy to replace this function with the function epoch:rebind-key from the Epoch distribution. After implementing this, all keyboard keys can be configured to send user definable sequences, e.g. (x-rebind-key "KP_F1" 0 "\033OP") This will have the keypad key PF1 send the sequence \eOP, just like an ordinary VTxxx terminal. Another method is to handle the keys in the C source. Although this may be slightly more efficient, it is much less flexible. 36: How do I tell what characters my function keys emit? Use this function by Randal L. Schwartz : (defun see-chars () "Displays characters typed, terminated by a 3-second timeout." (interactive) (let ((chars "") (inhibit-quit t)) (message "Enter characters, terminated by 3-second timeout.") (while (not (sit-for 3)) (setq chars (concat chars (list (read-char))) quit-flag nil)) ; quit-flag maybe set by C-g (message "Characters entered: %s" (key-description chars)))) ---Continued---