home *** CD-ROM | disk | FTP | other *** search
/ Nebula 1994 June / NEBULA_SE.ISO / Documents / FAQ / GNU-Emacs-faq / part1 < prev    next >
Encoding:
Internet Message Format  |  1993-05-05  |  35.8 KB

  1. Path: senator-bedfellow.mit.edu!enterpoop.mit.edu!eru.mt.luth.se!kth.se!sunic!mcsun!uknet!doc.ic.ac.uk!agate!usenet.ins.cwru.edu!gatech!swrinde!cs.utexas.edu!newsfeed.rice.edu!rice!sbyrnes
  2. From: sbyrnes@rice.edu (Steven Byrnes)
  3. Newsgroups: gnu.emacs.help,comp.emacs,news.answers,comp.answers
  4. Subject: GNU Emacs FAQ (1/5, 1-27): Notation/General/Help/Status
  5. Summary: READ BEFORE POSTING.  A regularly posted list of answers to frequently
  6.          asked questions (FAQs) about GNU Emacs and many Emacs Lisp programs.
  7.          Contains pointers to other resources.  Follow "References:" link for
  8.          more metainfo.
  9. Keywords: gnu emacs faq answers frequently asked questions periodic
  10. Message-ID: <GNU-Emacs-FAQ-1.1993.05.04.025218@rice.edu>
  11. Date: 4 May 93 02:52:18 GMT
  12. Expires: Sat, 3 Jul 1993 02:52:18 GMT
  13. References: <GNU-Emacs-FAQ-0.1993.05.04.025218@rice.edu>
  14. Sender: news@rice.edu (News)
  15. Reply-To: gnu-emacs-faq-maintainers@bigbird.bu.edu
  16. Followup-To: poster
  17. Organization: GNU's Not UNIX
  18. Lines: 794
  19. Approved: news-answers-request@mit.edu
  20. Supersedes: <GNU-Emacs-FAQ-1.1993.01.05.171933@rice.edu>
  21. Originator: sbyrnes@is.rice.edu
  22. Xref: senator-bedfellow.mit.edu gnu.emacs.help:10206 comp.emacs:17188 news.answers:8179 comp.answers:621
  23.  
  24. Archive-Name: GNU-Emacs-FAQ/part1
  25. Last-Modified: Sat, 6 Mar 1993 21:13:32 GMT
  26. Last-Posted: Tue, 4 May 1993 02:52:18 GMT
  27.  
  28.                GNU Emacs FAQ: Notation/General/Help/Status
  29.  
  30. If you are viewing this text in a GNU Emacs Buffer, you can type "M-2 C-x $" to
  31. get an overview of just the questions.  Then, when you want to look at the text
  32. of the answers, just type "C-x $".
  33.  
  34. To search for a question numbered XXX, type "M-C-s ^XXX:", followed by a C-r if
  35. that doesn't work, then type ESC to end the search.
  36.  
  37. A `+' in the 78th column means something was inserted on the line.  A `-' means
  38. something was deleted and a `!' means some combination of insertions and
  39. deletions occurred.
  40.  
  41. Full instructions for getting the latest FAQ are in question 22.  Also see the
  42. `Introduction to news.answers' posting in the `news.answers' newsgroup, or send
  43. e-mail to `mail-server@rtfm.mit.edu' with `help' on a body line, or use FTP,
  44. WAIS, or Prospero to rtfm.mit.edu.
  45.  
  46.  
  47.  
  48. Notation Used in FAQ
  49.  
  50.   Skip this section and then come back if you don't understand some of the
  51.   later answers.
  52.   
  53. 1:   What do these mean: C-h, M-C-a, RET, "ESC a", etc.?
  54.   
  55.   C-x means press the `x' key while holding down the Control key.  M-x means
  56.   press the `x' key while holding down the Meta key.  M-C-x means press the
  57.   `x' key while holding down both the Control key and the Meta key.  C-M-a
  58.   is a synonym for M-C-a.  RET, LFD, DEL, ESC, and TAB respectively refer to
  59.   pressing the Return, Linefeed (aka Newline), Delete, Escape, and Tab keys
  60.   and are equivalent to C-m, C-j, C-?, C-[, and C-i.  SPC means press the
  61.   Space bar.
  62.   
  63.   I put any key sequence that is longer than one key (and some single-key
  64.   sequences) inside double quotes or on a line by itself.  Any real spaces
  65.   in such a key sequence should be ignored; only SPC really means press the
  66.   space key.
  67.   
  68.   The ASCII code sent by C-x (except for C-?) is the value that would be
  69.   sent by pressing just `x' minus 96 (or 64 for uppercase `X') and will be
  70.   from 0 to 31.  The ASCII code sent by M-x is the sum of 128 and the ASCII
  71.   code that would be sent by pressing just the `x' key.  Essentially, the
  72.   Control key turns off bits 5 and 6 and the Meta key turns on bit 7.
  73.   
  74.   For further information, see `Characters' and `Keys' in the online manual.
  75.   
  76.   NOTE: C-? (aka DEL) is ASCII code 127.  It is a misnomer to call C-? a
  77.   "control" key, since 127 has both bits 5 and 6 turned ON.  Also, on very
  78.   few keyboards does Control-? generate ASCII code 127.
  79.   
  80. 2:   What does "M-x command" mean?
  81.   
  82.   "M-x command" means type M-x, then type the name of the command, then
  83.   type RET.
  84.   
  85.   M-x (by default) invokes the command `execute-extended-command'.  This
  86.   command allows you to run any Emacs command if you can remember the
  87.   command's name.  If you can't remember the command's name, you can type
  88.   TAB and SPC for completion, and "?" for a list of possibilities.  An Emacs
  89.   "command" is any "interactive" Emacs function.
  90.   
  91.   NOTE: Your system administrator may have bound other key sequences to
  92.   invoke execute-extended-command.  A function key labeled `Do' is a good
  93.   candidate for this.
  94.   
  95.   To run non-interactive Emacs functions, see question 53.
  96.   
  97. 3:   How do I read topic XXX in the on-line manual?
  98.   
  99.   When I refer you to topic XXX in the on-line manual, you can read this
  100.   manual node inside Emacs (assuming nothing is broken) by typing this:
  101.   
  102.     C-h i m emacs RET m XXX RET
  103.   
  104.   This invokes the Info facility.  If you don't already know how to use
  105.   Info, type "?" from within Info.
  106.   
  107.   If I refer you to topic XXX:YYY, you need to type this:
  108.   
  109.     C-h i m emacs RET m XXX RET m YYY RET
  110.   
  111.   WARNING: Your system administrator may not have installed the Info files,
  112.   or may have installed them properly.  In this case you should complain.
  113.   
  114. 4:   What do these mean: etc/SERVICE, src/config.h, lisp/default.el?
  115.   
  116.   These are files that come with GNU Emacs.  The GNU Emacs distribution is
  117.   divided into subdirectories; the important ones are `etc', `lisp', and
  118.   `src'.
  119.   
  120.   If you use GNU Emacs, but don't know where it is kept on your system,
  121.   start Emacs, then type "C-h v exec-directory RET".  The directory name
  122.   displayed by this will be the full pathname of the installed `etc'
  123.   directory.
  124.   
  125.   Some of these files are available individually via FTP or e-mail, see
  126.   question 20.  All are available in the source distribution.
  127.   
  128. 5:   What are FSF, LPF, OSF, GNU, RMS, FTP, and GPL?
  129.   
  130.   FSF == Free Software Foundation
  131.   LPF == League for Programming Freedom
  132.   OSF == Open Software Foundation
  133.   GNU == GNU's Not Unix
  134.   RMS == Richard Matthew Stallman
  135.   FTP == File Transfer Protocol
  136.   GPL == GNU General Public Licence
  137.   
  138.   NOTE: Avoid confusing the FSF, the LPF, and the OSF.  The LPF opposes
  139.   look-and-feel copyrights and software patents.  The FSF aims to make high
  140.   quality free software available for everyone.  The OSF is a commercial
  141.   organization which wants to provide an alternative, standardized version
  142.   of Unix not controlled by AT&T.
  143.   
  144.   NOTE: The word "free" in the title of the Free Software Foundation refers
  145.   to "freedom", not "zero dollars".  Anyone can charge any price for
  146.   GPL-covered software that they want to.  However, in practice, the freedom
  147.   enforced by the GPL leads to low prices, because you can always get the
  148.   software for less money from someone else, because everyone has the right
  149.   to resell or give away GPL-covered software.
  150.   
  151.  
  152.  
  153. General Questions
  154.  
  155. 6:   What is the LPF and why should I join it?
  156.   
  157.   The LPF opposes the expanding danger of software patents and look-and-feel
  158.   copyrights.  To get more information, feel free to contact the LPF via
  159.   e-mail or otherwise.  {You may also contact me, jbw@cs.bu.edu; I will be
  160.   happy to talk with you about the LPF.}  Here is the contact information:
  161.   
  162.     E-mail address: league@prep.ai.mit.edu
  163.     Phone number: (617) 243-4091
  164.     Postal address:
  165.       League for Programming Freedom
  166.       1 Kendall Square, Number 143
  167.       Post Office Box 9171
  168.       Cambridge, MA 02139, USA
  169.   
  170.   Papers describing the LPF's views are available on the internet and also
  171.   from the LPF:
  172.   
  173.     Anonymous FTP:
  174.       /prep.ai.mit.edu:/pub/lpf/
  175.       /archive.cis.ohio-state.edu:pub/lpf/
  176.     Anonymous UUCP:
  177.       osu-cis!~/lpf/*
  178.   
  179. 7:   What is the real legal meaning of the GNU copyleft?
  180.   
  181.   The real legal meaning of the GNU General Public Licence (copyleft) is
  182.   however it is interpreted by a judge.  There has never been a copyright
  183.   infringment case involving the GPL to set any precedents.  Please take any
  184.   discussion regarding this issue to the newsgroup gnu.misc.discuss, which
  185.   was created to hold the extensive flame wars on the subject.
  186.   
  187.   RMS writes:
  188.   
  189.     The legal meaning of the GNU copyleft is less important than the spirit,
  190.     which is that Emacs is a free software project and that work pertaining
  191.     to Emacs should also be free software.  "Free" means that all users have
  192.     the freedom to study, share, change and improve Emacs.  To make sure
  193.     everyone has this freedom, pass along source code when you distribute
  194.     any version of Emacs or a related program, and give the recipients the
  195.     same freedom that you enjoyed.
  196.   
  197. 8:   What are appropriate messages for gnu.emacs.help, gnu.emacs.bug,
  198.  comp.emacs, etc.?
  199.   
  200.   The file etc/MAILINGLISTS discusses the purpose of each GNU mailing-list.
  201.   (See question 20 on how to get a copy.)  For those which are gatewayed
  202.   with newsgroups, it lists both the newsgroup name and the mailing list
  203.   address.
  204.   
  205.   comp.emacs is for discussion of Emacs programs in general.  This
  206.   includes GNU Emacs along with various other implementations like JOVE,
  207.   MicroEmacs, Freemacs, MG, Unipress, CCA, Epsilon, etc.
  208.   
  209.   Many people post GNU Emacs questions to comp.emacs because they don't
  210.   receive any of the gnu.* newsgroups.  Arguments have been made both for
  211.   and against posting GNU-Emacs-specific material to comp.emacs.  You have
  212.   to decide for yourself.
  213.   
  214.   Messages advocating "non-free" software are considered unacceptable on any
  215.   of the gnu.* newsgroups except for gnu.misc.discuss, which was created to
  216.   hold the extensive flame-wars on the subject.  "non-free" software
  217.   includes any software for which the end user can't freely modify the
  218.   source code and exchange enhancements.  Be careful to remove the gnu.*
  219.   groups from the `Newsgroups:' line when posting a followup that recommends
  220.   such software.
  221.   
  222.   gnu.emacs.bug is a place where bug reports appear, but avoid posting bug
  223.   reports to this newsgroup, instead see question 10.
  224.   
  225. 9:   Where can I get old postings to gnu.emacs.help and other GNU groups?
  226.   
  227.   The FSF has maintained archives of all of the GNU mailing lists for many
  228.   years, although there may be some unintentional gaps in coverage.  The
  229.   archive is not particularly well organized or easy to retrieve individual
  230.   postings from, but pretty much everything is there.
  231.   
  232.     Anonymous FTP:
  233.       /prep.ai.mit.edu:/pub/gnu/MailingListArchives/
  234.   
  235.   There is a WAIS database named `comp.emacs' on wais.oit.unc.edu that
  236.   makes available the last few days of articles in comp.emacs.
  237.   
  238. 10:  Where should I report bugs and other problems with GNU Emacs?
  239.   
  240.   The correct way to report GNU Emacs bugs is by e-mail to
  241.   bug-gnu-emacs@prep.ai.mit.edu.  Anything sent here also appears in the
  242.   newsgroup gnu.emacs.bug, but please use e-mail instead of news to submit
  243.   the bug report.  This way a reliable return address is available so you
  244.   can be contacted for further details.
  245.   
  246.   RMS explains:
  247.   
  248.     Sending bug reports to help-gnu-emacs (which has the effect of posting
  249.     on gnu.emacs.help) is undesirable because it takes the time of an
  250.     unnecessarily large group of people, most of whom are just users and
  251.     have no idea how to fix these problem.  bug-gnu-emacs reaches a much
  252.     smaller group of people who are more likely to know what to do and have
  253.     expressed a wish to receive more messages about Emacs than the others.
  254.   
  255.   However, RMS says there are circumstances when it is okay to post to
  256.   gnu.emacs.help:
  257.   
  258.     If you have reported a bug and you don't hear about a possible fix, then
  259.     after a suitable delay (such as a week) it is okay to post on
  260.     gnu.emacs.help asking if anyone can help you.
  261.   
  262.   If you are unsure whether you have a bug, RMS describes how to tell:
  263.   
  264.     ... if Emacs crashes, that is a bug.  If Emacs gets compilation errors
  265.     while building, that is a bug.  If Emacs crashes while building, that is
  266.     a bug.  If Lisp code does not do what the documentation says it does,
  267.     that is a bug.
  268.   
  269. 11:  How do I unsubscribe to this mailing list?
  270.   
  271.   If you are receiving a GNU mailing list named `XXX', you might be able
  272.   to unsubscribe to it by sending a request to the address
  273.   `XXX-request@prep.ai.mit.edu'.  However, this will not work if you are
  274.   not listed on the main mailing list, but instead recieve the mail from a
  275.   distribution point.  In that case, you will have to track down at which
  276.   distribution point you are listed.  Inspecting the `Received:' headers
  277.   on the mail messages may help, along with liberal use of the `EXPN' or
  278.   `VRFY' sendmail commands through `telnet <site-address> smtp'.  Ask your
  279.   postmaster for help.
  280.   
  281. 12:  What is the current address of the FSF?
  282.   
  283.   E-mail address: gnu@prep.ai.mit.edu
  284.   Phone number: (617) 876-3296
  285.   Postal address:
  286.     Free Software Foundation, Inc.
  287.     675 Massachusetts Avenue
  288.     Cambridge, MA 02139, USA
  289.   
  290.  
  291.  
  292. On-line Help, Printed Manuals, Other Sources of Help
  293.  
  294. 13:  I'm just starting GNU Emacs; how do I do basic editing?
  295.   
  296.   Type "C-h t" to invoke the self-paced tutorial.  Typing just C-h is
  297.   how to enter the help system.
  298.   
  299.   WARNING: Your system administrator may have changed C-h to act like DEL to
  300.   deal local keyboards.  You can use M-x help-for-help instead to invoke
  301.   help.  To discover what key (if any) invokes help on your system, type
  302.   "M-x where-is RET help-for-help RET".  This will print a comma-separated
  303.   list of key sequences in the echo area.  Ignore the last character in each
  304.   key sequence listed.  Each of the resulting key sequences invokes help.
  305.   
  306.   NOTE: Emacs's help facility works best if help is invoked by a single key
  307.   whose value should be stored in the variable help-char.  Andrew
  308.   Arensburger <arensb@kong.gsfc.nasa.gov> wrote a patch that allows the help
  309.   facility to work properly when invoked by multiple character sequences.
  310.   
  311. 14:  How do I find out how to do something in GNU Emacs?
  312.   
  313.   There are several methods for finding out how to do things in Emacs.
  314.   
  315.   * The complete text of the Emacs manual is available online via the Info
  316.     hypertext reader.  Type "C-h i" to invoke Info.
  317.   
  318.   * You can order a hardcopy of the manual from the FSF.  See question 15.
  319.   
  320.   * You can get a printed reference card listing commands and keys to invoke
  321.     them.  You can order one from the FSF for $1 (or 10 for $5), or you can
  322.     print your own from the etc/refcard.tex file in the Emacs distribution.
  323.     {Are PostScript versions of this available for FTP?}
  324.   
  325.   * You can list all of the commands whose names contain a certain word
  326.     (actually which match a regular expression) using "C-h a"
  327.     (M-x command-apropos).
  328.   
  329.   * You can list all of the functions and variables whose names contain a
  330.     certain word using M-x apropos.
  331.   
  332.   * There are many other commands in Emacs for getting help and information.
  333.     To get a list of these commands, type "C-h C-h C-h".
  334.   
  335.   NOTE: You may find that command-apropos and apropos are extremely slow
  336.   on your system.  This will be fixed in Emacs 19.  If you can't wait that
  337.   long, there is a fast-apropos.el file available in the Emacs Lisp
  338.   Archive (see question 89) that contains the fix.
  339.   
  340. 15:  How do I get a printed copy of the GNU Emacs manual?
  341.   
  342.   You can order a printed copy of the GNU Emacs manual from the FSF for
  343.   $20.  For 6 or more manuals the price is $13 each.  The price may be
  344.   tax-deductible as a business expense.
  345.   
  346.   The full TeX source for the manual also comes in the `man' directory of
  347.   the Emacs distribution, if you're daring enough to try to print out this
  348.   300 page manual yourself (see question 18).
  349.   
  350.   If you absolutely have to print your own copy, and you don't have TeX, you
  351.   can get a PostScript version via anonymous FTP:
  352.   
  353.     /cs.ubc.ca:pub/archive/gnu/manuals_ps/emacs-18.57.ps.Z                   !
  354.   
  355.   which site requests that you please CONFINE ANY MAJOR FTPING TO LATE
  356.   EVENINGS OR EARLY MORNINGS OUR TIME (pacific time zone, GMT-8)).  A DVI
  357.   version is also available via FTP:
  358.   
  359.     /prep.ai.mit.edu:pub/gnu/emacs-manual-6.0.dvi.Z
  360.   
  361.   If you don't have TeX you can convert the Texinfo sources into
  362.   {t,n,ps}roff format with the `texi2roff' program, which is available via
  363.   anonymous FTP:
  364.   
  365.     /archive.cis.ohio-state.edu:pub/gnu/texi2roff/texi2roff.shar.Z
  366.   
  367.   See also question 14 for how to view the manual online.
  368.   
  369. 16:  Where can I get documentation on GNU Emacs Lisp?
  370.   
  371.   Within Emacs, you can type "C-h f" to get the documentation for a
  372.   function, "C-h v" for a variable.
  373.   
  374.   For more information, obtain the GNU Emacs Lisp Reference Manual for Emacs
  375.   18 under Unix.  It is available from the FSF for $50 (or 5 for $200).  The
  376.   latest revision available for FTP is edition 1.03 dated 28 January 1991.
  377.   
  378.   For online use, a set of pregenerated Info files is available with the
  379.   Texinfo source for the Emacs Lisp manual via anonymous FTP:
  380.   
  381.     /archive.cis.ohio-state.edu:pub/gnu/emacs/
  382.     /prep.ai.mit.edu:pub/gnu/elisp-manual-1.03.tar.Z
  383.   
  384.   (You can also create the Info files from the Texinfo source.)  See
  385.   question 17 for details on how to install these files online.
  386.   
  387.   If you are daring enough to try to print this 550 page manual out
  388.   yourself, for instructions see question 18.
  389.   
  390.   Also, as a popular USENET saying goes, "Use the Force, Read the Source".
  391.   
  392. 17:  How do I install a piece of Texinfo documentation?
  393.   
  394.   First create Info files from the Texinfo files with the `makeinfo'
  395.   program.  makeinfo is available as part of the latest Texinfo package:
  396.   
  397.     /prep.ai.mit.edu:pub/gnu/texinfo-2.14.tar.Z
  398.   
  399.   For information about the Texinfo format, read the Texinfo manual which
  400.   comes with Emacs.  This manual also comes installed in Info format, so you
  401.   can read it online.
  402.   
  403.   Neither texinfo-format-buffer nor the makeinfo program install the
  404.   resulting Info files in Emacs's Info tree.  To install Info files:
  405.   
  406.   1. Move the files to the `info' directory in the installed Emacs
  407.      distribution.  See question 4 if you don't know where that
  408.      is.
  409.   
  410.   2. Edit the file info/dir in the installed Emacs distribution, and add a
  411.      line for the top level node in the Info package that you are
  412.      installing.  Follow the examples are already in this file.  The format
  413.      is:
  414.   
  415.        * Topic: (relative-pathname).  Short description of topic.
  416.   
  417.   If you want to install Info files and you don't have the necessary
  418.   privileges, you have several options:
  419.   
  420.   * Info files don't actually need to be installed before being used.  You
  421.     can feed a file name to the Info-goto-node command (invoked by pressing
  422.     "g" in Info mode) by typing the name of the file in parentheses.  This
  423.     goes to the node named `Top' in that file.  For example, to view a Info
  424.     file named `XXX' in your home directory, you can type this:
  425.   
  426.       C-h i g (~/XXX) RET
  427.   
  428.   * You can create your own Info directory.  You can tell Emacs where the
  429.     Info directory is by setting the value of the variable Info-directory
  430.     to its pathname.  For example, to use a private Info directory which
  431.     is a subdirectory of your home directory named `Info', you could do
  432.     this:
  433.   
  434.       (setq Info-directory (expand-file-name "~/Info"))
  435.   
  436.     You will need a top-level Info file named `dir' in this directory.
  437.     You can include the system-wide Info directory in your private Info
  438.     directory with symbolic links or by copying it.
  439.   
  440.   * You can use an enhanced version of lisp/info.el that handles multiple
  441.     Info directories.  Then you can more easily use a mix of private and
  442.     shared Info files.  Dave Gillespie <daveg@synaptics.com,
  443.     daveg@csvax.cs.caltech.edu> has written one such enhancement and I
  444.     believe there are others.  Dave's info.el also handles compressed Info
  445.     files.
  446.   
  447.     Anonymous FTP:
  448.       /archive.cis.ohio-state.edu:modes/info.el.Z
  449.       /ftp.uu.net:languages/emacs-lisp/modes/info.el.Z                       !
  450.   
  451.     According to Jay Bourland <jayb@math.stanford.edu>, a version of Dave's
  452.     info.el comes with `xinfo' (see question 19).
  453.   
  454. 18:  How do I print a Texinfo file?
  455.   
  456.   NOTE: You can't get nice printed output from Info files; you must still
  457.   have the original Texinfo source file for the manual you want to print.
  458.   
  459.   1. Make sure the first line of the Texinfo file looks like this:
  460.   
  461.        \input texinfo
  462.   
  463.      You may need to alter `texinfo' to the full pathname of the
  464.      texinfo.tex file, which comes with Emacs as man/texinfo.tex (or copy
  465.      or link it into the current directory).
  466.   
  467.   2. tex XXX.texinfo
  468.   
  469.   3. texindex XXX.??
  470.   
  471.      The `texindex' program comes with Emacs as man/texindex.c.
  472.   
  473.   4. tex XXX.texinfo
  474.   
  475.   5. Print the DVI file XXX.dvi in the normal way for printing DVI files
  476.      at your site.
  477.   
  478.   To get more general instructions, retrieve the latest Texinfo package
  479.   mentioned in question 17.
  480.   
  481. 19:  Can I view Info files without using GNU Emacs?
  482.   
  483.   Yes, the `info', `xinfo', and `ivinfo' programs do this.  info uses
  484.   curses, xinfo uses standard X11 libraries, and ivinfo uses InterViews.
  485.   You can get info as part of the latest Texinfo package (see question
  486.   17).  xinfo is available separately:
  487.   
  488.     /prep.ai.mit.edu:pub/gnu/xinfo-1.01.01.tar.Z
  489.     /export.lcs.mit.edu:
  490.   
  491.   ivinfo is available in a comp.sources.misc archive or from Tom Horsley
  492.   <tom@ssd.csd.harris.com>.  For ivinfo, you need Stanford's InterViews C++
  493.   X library, available via anonymous FTP (interviews.stanford.edu).
  494.   
  495. 20:  What informational files are available for GNU Emacs?
  496.   
  497.   This isn't a frequently asked question, but it should be!  A variety of
  498.   informational files about GNU Emacs and relevant aspects of the GNU
  499.   project are available for you to read.
  500.   
  501.   The following files are available in the `etc' directory of the GNU
  502.   Emacs distribution, and also the latest versions are available
  503.   individually via anonymous FTP (prep.ai.mit.edu:/pub/gnu/GNUinfo/):
  504.   
  505.     APPLE -- Why the FSF doen't support GNU Emacs on Apple computers
  506.     DISTRIB -- GNU Emacs Availability Information,
  507.       including the popular "Free Software Foundation Order Form"
  508.     FTP -- How to get GNU Software by Internet FTP or by UUCP
  509.     GNU -- The GNU Manifesto
  510.     INTERVIEW -- Richard Stallman discusses his public-domain
  511.                UNIX-compatible software system
  512.                   with BYTE editors
  513.     MACHINES -- Status of GNU Emacs on Various Machines and Systems
  514.     MAILINGLISTS -- GNU Project Electronic Mailing Lists
  515.     SERVICE -- GNU Service Directory
  516.     SUN-SUPPORT -- including "Using Emacstool with GNU Emacs"
  517.   
  518.   These files are available in the `etc' directory of the GNU Emacs
  519.   distribution:
  520.   
  521.     DIFF -- Differences between GNU Emacs and Twenex Emacs
  522.     CCADIFF -- Differences between GNU Emacs and CCA Emacs
  523.     GOSDIFF -- Differences between GNU Emacs and Gosling (Unipress??) Emacs
  524.     COPYING -- GNU Emacs General Public License
  525.     NEWS -- GNU Emacs News, a history of user-visible changes
  526.     LPF -- Why you should join the League for Programming Freedom
  527.     FAQ -- GNU Emacs Frequently Asked Questions (You're reading it)
  528.     OPTIONS -- a complete explanation of startup option handling
  529.   
  530.   These files are available via anonymous FTP (prep.ai.mit.edu:/pub/gnu/):
  531.   
  532.     tasks -- GNU Task List
  533.     standards.text -- GNU Coding Standards
  534.   
  535.   In addition, all of the above files are available directly from the FSF
  536.   via e-mail.  Of course, please try to get them from a local source
  537.   first.
  538.   
  539.   These additional files are available from the FSF via e-mail:
  540.   
  541.   * GNU's Bulletin, June, 1991 -- this file includes:
  542.       GNU'S Who
  543.       What Is the Free Software Foundation?
  544.       What Is Copyleft?
  545.       A Small Way to Help Free Software
  546.       GNUs Flashes (important recent developments for project GNU)
  547.       Free Software Support (and how to get it!)
  548.       Copyrighted Programming Languages
  549.       AT&T Threatens Users of X Windows (and other software patent threats)
  550.       Project Gutenberg
  551.       GNU Project Status Report
  552.       GNU in Japan
  553.       GNU Wish List
  554.       Help Keep Government Software Free
  555.       GNU Software Available Now
  556.         Contents of the Emacs Tape
  557.         Contents of the Compiler Tape
  558.         Contents of the X11 Tapes
  559.         VMS Emacs and Compiler Tapes
  560.       GNU Documentation
  561.       How to Get GNU Software
  562.       Free Software for Microcomputers
  563.         GNU Software on Apple computers
  564.         GNU Software on the Amiga
  565.         GNU Software on the Atari
  566.         GNUish MS-DOS project
  567.         Freemacs, an Extensible Editor for MS-DOS
  568.       GNU in Japan
  569.       FSF Order Form
  570.       Thank GNUs
  571.   * Legal issues about contributing code to GNU
  572.   * GNU Project Status Report
  573.   
  574.   A collection of past GNU's Bulletins is available via anonymous FTP:
  575.   
  576.     /ftp.funet.fi:pub/gnu/Bulletins/
  577.   
  578. 21:  Where can I get help in installing GNU Emacs?
  579.   
  580.   Look in etc/SERVICE for names of companies and individuals who will sell
  581.   you this type of service.  An up-to-date version of the SERVICE file is
  582.   available on prep.ai.mit.edu (also see question 20).
  583.   
  584. 22:  Where can I get the latest version of this document (the FAQ list)?
  585.   
  586.   The GNU Emacs FAQ is available in several ways:
  587.   
  588.   * Via USENET.  If you can read news, the FAQ should be available in your
  589.     news spool, in both the gnu.emacs.help and comp.emacs newsgroups.  Every
  590.     news reader of which I know will allow you to read any news article that
  591.     is still in the news spool, even if you have read the article before.
  592.     You may need to read the instructions for your news reader to discover
  593.     how to do this.  In `rn', this command will do this for you at the
  594.     article selection level:
  595.   
  596.       ?GNU Emacs FAQ?rc:m
  597.   
  598.     In GNUS, you should type "C-u G" from the *Subject* buffer or "C-u SPC"
  599.     from the *Newsgroup* buffer to view all articles in a newsgroup.
  600.   
  601.     The FAQ articles' message IDs are:
  602.   
  603.       <GNU-Emacs-FAQ-0.1993.05.04.025218@rice.edu>                           !
  604.       <GNU-Emacs-FAQ-1.1993.05.04.025218@rice.edu>                           !
  605.       <GNU-Emacs-FAQ-2.1993.05.04.025218@rice.edu>                           !
  606.       <GNU-Emacs-FAQ-3.1993.05.04.025218@rice.edu>                           !
  607.       <GNU-Emacs-FAQ-4.1993.05.04.025218@rice.edu>                           !
  608.       <GNU-Emacs-FAQ-5.1993.05.04.025218@rice.edu>                           !
  609.   
  610.     If you are viewing this in the GNUS *Article* buffer, you can move point
  611.     within one of the above message IDs and type "r" to fetch the referenced
  612.     article.  Type "o" in the *Article* buffer to restore the previous
  613.     contents.  If this text is not in the GNUS *Article* buffer, use M-r
  614.     from the *Subject* buffer instead.
  615.   
  616.     If the FAQ articles have expired and been deleted from your news spool,
  617.     it might (or might not) do some good to complain to your news
  618.     administrator, because the most recent FAQ should not expire before
  619.     July 3, 1993.                                                            !
  620.   
  621.   * Via anonymous FTP.  You can fetch the FAQ articles via anonymous FTP
  622.   
  623.       /rtfm.mit.edu:pub/usenet/news.answers/GNU-Emacs-FAQ/ part*
  624.   
  625.   * Via e-mail.  You can send the following magical incantation in the body
  626.     of a message to mail-server@rtfm.mit.edu:
  627.   
  628.       send usenet/news.answers/GNU-Emacs-FAQ/part0
  629.       send usenet/news.answers/GNU-Emacs-FAQ/part1
  630.       send usenet/news.answers/GNU-Emacs-FAQ/part2
  631.       send usenet/news.answers/GNU-Emacs-FAQ/part3
  632.       send usenet/news.answers/GNU-Emacs-FAQ/part4
  633.       send usenet/news.answers/GNU-Emacs-FAQ/part5
  634.   
  635.   * Via WAIS.  The GNU Emacs FAQ is available via WAIS indexed on a
  636.     per-question basis from the `faq' database on bigbird.bu.edu on the
  637.     non-standard IP port number of 2210.  This is probably the best way to
  638.     find out if there is something in the FAQ related to your question.  I
  639.     use this myself to answer questions I see posted on gnu.emacs.help.
  640.   
  641.     The articles of the GNU Emacs FAQ are also available from the `usenet'
  642.     database on rtfm.mit.edu (on the standard IP port: 210), along with a
  643.     lot of other FAQ articles.  However, these are all indexed at the whole
  644.     article level instead of at the question level.  This is a better place
  645.     to look if you want to fetch the entire FAQ.
  646.   
  647.   * In the GNU Emacs distribution.  Since GNU Emacs 18.56, the latest
  648.     available version of the FAQ at the time of release has been part of the
  649.     GNU Emacs distribution as file etc/FAQ.  18.59 is the latest version,
  650.     and it was released in October 1992.
  651.   
  652.   * There is an old version of the FAQ list available for FTP in the GNU
  653.     archives at MIT:
  654.   
  655.       /prep.ai.mit.edu:pub/gnu/GNUinfo/FAQ.emacs
  656.   
  657.   * As the very last resort, you can e-mail a request to
  658.     gnu-emacs-faq-maintainers@bigbird.bu.edu.  Don't do this unless you have
  659.     made a serious effort to obtain the FAQ list via one of the methods
  660.     listed above.
  661.   
  662.  
  663.  
  664. Status of Emacs
  665.  
  666. 23:  Where does the name "Emacs" come from?
  667.   
  668.   Emacs originally was an acronym for Editor MACroS.  RMS says he "picked
  669.   the name `Emacs' because `E' was not in use as an abbreviation on ITS at
  670.   the time.".  The first Emacs was a set of macros written in 1976 at MIT by
  671.   RMS for the editor TECO (Text Editor and COrrector (originally Tape Editor
  672.   and COrrector)) under ITS on a PDP-10.  RMS had already extended TECO with
  673.   a "real-time" full screen mode with active keys.  Emacs was started by Guy
  674.   Steele <gls@think.com> as a project to unify the many divergent TECO
  675.   command sets and keybindings at MIT.
  676.   
  677.   Many people have told me that TECO code looks a lot like line noise.  See
  678.   alt.lang.teco if you are interested.  I think someone has written a TECO
  679.    implementation in Emacs Lisp.  It would be an interesting project to run
  680.   the original TECO Emacs inside of GNU Emacs.
  681.   
  682. 24:  What is the latest version of GNU Emacs?
  683.   
  684.   GNU Emacs 18.59 is the current version.  Fixes from 18.57 include better
  685.   mail address parsing, an X visual bell speedup, a call-process
  686.   enhancement, a regexp matching change, the ability to apply a numeric
  687.   argument to a self-inserting digit, getting X resource values from the
  688.   RESOURCE_MANAGER property, more reliable shell mode job control, and a
  689.   change to copy-keymap.  Also, support has been added for many new system
  690.   types.  Fixes from 18.55 include the removal of arbitrary limits on the
  691.   undo facility.
  692.   
  693.   According to the January 1992 GNU's Bulletin, "Emacs 18 maintenance
  694.   continues for simple bug fixes.".
  695.   
  696.   To visit a file with information about what has changed in recent
  697.   versions, type "C-h n".
  698.   
  699. 25:  When will GNU Emacs 19 be available?
  700.   
  701.   Richard Stallman recently (February 19, 1993) posted in gnu.emacs.help     !
  702.   the following:                                                             !
  703.                                                                              !
  704.     People should keep in mind that the successor of Emacs 18 does not       !
  705.     come from Lucid.  Its is GNU Emacs 19.  I still can't say exactly when   !
  706.     public release is going to be, but we are about to start testing at a    !
  707.     number of sites.                                                         !
  708.                                                                              !
  709.     GNU Emacs 19 will support a broad spectrum of machines, like Emacs       !
  710.     18.  Ensuring this is the purpose of the testing we are about to do.     !
  711.                                                                              !
  712.     (Please don't volunteer; we have enough pretesters, and if more people   !
  713.     offer, dealing with those messages will slow things down.)               !
  714.                                                                              !
  715.     Once we make sure it is indeed working reliably on various different     !
  716.     systems, we will have a public beta test release.                        !
  717.                                                                              !
  718.     Emacs 19 does support adding properties to ranges of text, and using     !
  719.     these to switch fonts.  In the future, the Epoch people will help        !
  720.     merge support for variable-width fonts.                                  !
  721.                                                                              !
  722.     Meanwhile, I have almost finished updating the Emacs Lisp manual.  Its   !
  723.     next edition will describe Emacs 19.  There will be an announcement      !
  724.     when we know when this edition will be available.                        !
  725.  
  726.   Lucid has released Lucid GNU Emacs 19.6, which is based on an early        !
  727.   unreleased version of GNU Emacs 19.  This will be similar to Emacs 19 when
  728.   it finally arrives, but they are not the same.  See question 121.
  729.   
  730.   Work has begun on features for Emacs 20.
  731.   
  732. 26:  What is different about GNU Emacs 19?
  733.   
  734.   From the January 1992 GNU's Bulletin:
  735.   
  736.     Version 19 will enter beta test late this year.  Among its new features
  737.     are: before and after change hooks, source-level debugging of Emacs Lisp
  738.     programs, X selection processing (including clipboard selections),
  739.     scrollbars, support for European character sets, floating point numbers,
  740.     per-buffer mouse commands, X resource manager interfacing,
  741.     mouse-tracking, Lisp-level binding of function keys, multiple X windows
  742.     (`screens' to Emacs), a new input system, and buffer allocation, which
  743.     uses a new mechanism capable of returning storage to the system when a
  744.     buffer is killed.
  745.   
  746.     The input stream is now a sequence of Lisp objects, instead of a
  747.     sequence of characters.  This allows a reasonable representation for
  748.     mouse clicks, function keys, menu selections, etc.
  749.   
  750.     Thanks go to Alan Carroll and the people who worked on Epoch for
  751.     generating initial feedback to a multi-windowed Emacs, and to Eric
  752.     Raymond for help in polishing the Emacs 19 Lisp libraries.
  753.   
  754.   The June 1991 GNU's bulletin had this to say about future plans for Emacs:
  755.   
  756.     Features being considered for later releases of Emacs include:
  757.     associating property lists with regions of text in a buffer; multiple
  758.     fonts, color, and pixmaps defined by those properties; different
  759.     visibility conditions for the regions, and for various windows showing
  760.     one buffer; hooks to be run if point or mouse moves outside a certain
  761.     range; incrementally saving undo history in a file; static menu bars;
  762.     and better pop-up menus.
  763.   
  764.   Mention of this feature disappeared in the January 1992 GNU's bulletin:
  765.   
  766.     Emacs 19 supports two styles of multiple windows, one with a separate
  767.     screen for the minibuffer, and another with a minibuffer attached to
  768.     each screen.
  769.   
  770.   Mention of these two proposed features disappeared in the January 1991
  771.   GNU's bulletin:
  772.   
  773.   * Incremental syntax analysis for various programming languages (Leif).
  774.   * A more sophisticated emacsclient/server model, which would provide
  775.     network transparent Emacs widget functionality.
  776.   
  777. 27:  What variants of GNU Emacs exist?
  778.   
  779.   * Nemacs (Nihongo Emacs), which can handle Japanese text, is derived from
  780.     GNU Emacs 18.55.  See question 149.
  781.   
  782.   * Demacs, which can run under MS-DOS on 386 machines, is derived from
  783.     Nemacs.  See question 122.
  784.   
  785.   * Epoch, which has better X support, is derived from GNU Emacs 18.58.
  786.     See question 120 and 92.
  787.   
  788.   * Nepoch (Nihongo Epoch), which can handle Japanese text, is derived from
  789.     Epoch.
  790.   
  791.   * Mule (the MULtilingual Enhancement of GNU Emacs) can handle many
  792.     character sets simultaneously.  It is derived from Emacs 18.58.  It is
  793.     available for FTP:
  794.   
  795.       /sh.wide.ad.jp:/JAPAN/mule/
  796.       /etlport.etl.go.jp:/pub/mule/
  797.   
  798.   * Lucid GNU Emacs is derived from an early unreleased version of GNU Emacs
  799.     19.  See question 121 and 92.
  800.   
  801.  
  802.  
  803. ----------------------------------------------------------------------
  804. Copyright (C) 1990, 1991, 1992 Joseph Brian Wells
  805. Copyright (C) 1992, 1993 Steven Byrnes
  806.  
  807. This list of frequently asked questions about GNU Emacs with answers
  808. ("FAQ") may be translated into other languages, transformed into other
  809. formats (e.g. Texinfo, Info, WWW, WAIS, etc.), and updated with new
  810. information.  The same conditions apply to any derivative of the FAQ as
  811. apply to the FAQ itself.  Every copy of the FAQ must include this notice
  812. or an approved translation, information on who is currently maintaining
  813. the FAQ and how to contact them (including their e-mail address), and
  814. information on where the latest version of the FAQ is archived (including
  815. FTP information).  The FAQ may be copied and redistributed under these
  816. conditions, except that the FAQ may not be embedded in a larger literary
  817. work unless that work itself allows free copying and redistribution.
  818.