home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1997 March / Simtel-MSDOS-Mar1997-CD2.iso / disc2 / djgpp / v2gnu / emacs.rdm < prev    next >
Text File  |  1996-11-02  |  8KB  |  176 lines
  1. 1. Introduction
  2.    ------------
  3.  
  4. GNU Emacs compiled with DJGPP v2.x is hereby available as part of the
  5. DJGPP archives.  Emacs can be compiled with DJGPP out of the box, and
  6. you are encouraged to get the latest version from the GNU ftp sites
  7. and build it by yourself; but if you don't have the time, necessary
  8. tools or disk storage required to unzip the full source distribution
  9. and build Emacs, you can get here the pre-built binaries and only
  10. those parts of the package that you need.
  11.  
  12. The binaries here were produced from the official version 19.34 of GNU
  13. Emacs, with the following changes:
  14.  
  15.     * A bug in `hexl' (found after Emacs 19.34 was already released)
  16.       was corrected whereby binary file were not read in binary mode.
  17.  
  18.     * A support for MS-Windows clipboard was added: you can copy, cut
  19.       and paste to or from other Windows applications in the same way
  20.       as on X Windows platforms.  See the `MS-DOS' chapter of the
  21.       Emacs on-line manual for more details.  The clipboard support
  22.       code was originally written by Dale P. Smith <dpsm@en.com> and
  23.       should be included in the next official Emacs release.
  24.  
  25.     * A bug was corrected whereby running sub-processes on Windows 95
  26.       with LFN enabled didn't work.
  27.  
  28.     * Emacs was compiled and linked with the latest release of DJGPP
  29.       v2.01, so no library bugs should affect it (in particular, the 2
  30.       bugs related to Emacs that are described at the end of the
  31.       `INSTALL' file are no longer an issue).
  32.  
  33.  
  34.  
  35. 2. Files
  36.    -----
  37.  
  38. Emacs is a very large package.  To make downloading it easier, the
  39. archive here is divided into several zip files, each one of which
  40. should fit on a 1.4MB floppy disk.  Some files are required for running
  41. Emacs, others are recommended, still others are only needed if you want
  42. to rebuild Emacs (e.g., if you discover a bug).  Here is the list of
  43. the files:
  44.  
  45.      em1934b.zip   Binaries and minimal runtime support, required
  46.      em1934r1.zip  Runtime support (1 of 3), required
  47.      em1934r2.zip  Runtime support (2 of 3), required
  48.      em1934r3.zip  Runtime support (3 of 3), required
  49.      em1934l1.zip  Elisp sources (1 of 3), recommended
  50.      em1934l2.zip  Elisp sources (2 of 3), recommended
  51.      em1934l3.zip  Elisp sources (3 of 3), recommended
  52.      em1934s1.zip  Emacs sources (1 of 3)
  53.      em1934s2.zip  Emacs sources (2 of 3)
  54.      em1934s3.zip  Emacs sources (3 of 3)
  55.  
  56. The approximate disk storage that you will need for the package is as
  57. follows:
  58.  
  59.      Binaries and minimal runtime support...................5MB
  60.      Binaries and full runtime support.....................20MB
  61.      Additional storage for Elisp sources..................15MB
  62.      Additional storage for MSDOS sources (em1934s1.zip)....6MB
  63.      Additional storage for the full sources...............12MB
  64.  
  65. (The above numbers may vary depending on the cluster size of your
  66. disk.)
  67.  
  68. If you are *exceedingly* short on disk space, you can run Emacs after
  69. installing only em1934b.zip.  However, most of the optional packages
  70. are NOT included in that archive, and neither is the on-line manual, so
  71. many commands won't work.  I tried to squeeze as many frequently-used
  72. packages as I could there, though, so `dired', `compile' and the basic
  73. help commands should work.  The rest of the runtime support
  74. (em1934r?.zip) is not organized in any particular order (actually, it's
  75. in alphabetic order), because different people use different packages
  76. for their chores, and there is no simple way to know what is best for
  77. everyone, especially since many packages require others to run.
  78.  
  79. If you can afford the disk space, downloading and installing the Elisp
  80. sources (em1934l?.zip) is *highly* recommended, because the best docs
  81. for each Elisp package can be always found at the beginning of its .el
  82. file; if you can't figure something by reading the on-line manual,
  83. always read the comments at the beginning of the .el package that
  84. defines the function(s) you are after.
  85.  
  86. The rest of the package is only required if you want to recompile Emacs
  87. or debug it.  Note that if you want to rebuild Emacs on MSDOS, you will
  88. only need em1934s1.zip; the rest of the source distribution isn't used
  89. to compile Emacs on MSDOS and is here only for completeness' sake.
  90. (However, if you need the Texinfo sources of the Emacs manual, you will
  91. need to install em1934s2.zip as well.)  The file `INSTALL' in the main
  92. Emacs directory describes (at its end) how to build Emacs on MSDOS.
  93. The distribution has already been configured for DJGPP 2.x, so you
  94. don't need to run CONFIG.BAT if you use DJGPP 2.
  95.  
  96.  
  97. 3. Getting started
  98.    ---------------
  99.  
  100. To install Emacs, follow these steps:
  101.  
  102.    * Go to your main DJGPP installation directory.
  103.  
  104.    * Unzip all the files that you want to install.  If you use PKUNZIP,
  105.      don't forget the -d switch, like so:
  106.  
  107.           pkunzip -d em1934*.zip
  108.  
  109.    * When you unzip the archives, a directory called `emacs' is created
  110.      in the `gnu' subdirectory of the DJGPP tree, with several
  111.      subdirectories.  Add the `gnu/emacs/bin' directory to your PATH.
  112.  
  113.    * If you are a new user of Emacs, be sure to begin by reading the
  114.      Emacs tutorial.  To this end, invoke Emacs and choose the
  115.      "Emacs Tutorial" item from the "Help" submenu (on the menu bar).
  116.  
  117.    * An example start-up file is included under the name
  118.      `_emacs.xmpl'; you can use it as a starting point for your
  119.      customizations by renaming it to `_emacs'.  (Emacs automatically
  120.      searches for and loads a file named `_emacs' at start-up.)  Note
  121.      that some settings there need optional packages and will print an
  122.      error message if you didn't install em1934r?.zip.  And please
  123.      don't complain if you don't like the settings of `_emacs.xmpl',
  124.      as they are my own preferences.  Just change them as you see fit
  125.      and move on.
  126.  
  127.      New users are advised to avoid using the example start-up file
  128.      until they get hold of the Emacs basics, because that example
  129.      disables the message about most important commands printed at
  130.      startup.
  131.  
  132.    * If you run Emacs under MS-Windows, you might find the files
  133.      `msdos/emacs.pif' and `msdos/emacs.ico' useful.
  134.  
  135. The zip files are LFN-clean, which means they can be unzipped on
  136. Windows 95 (or any other system that supports long filenames); in that
  137. case all the files will get their original long names, including the
  138. letter-case (e.g., `ChangeLog', `FAQ', etc.).  Note that if you want
  139. LFN support within Emacs (i.e., you set LFN=y in the environment), you
  140. *must* unzip the archives with an unzip program that supports long
  141. filenames, or else Emacs won't be able to find some of its files.  If
  142. you want to be able to run Emacs from both Windows 95 and plain DOS,
  143. you need to set the NameNumericTail property in the Registry to 0
  144. before you unzip the package (you may return the setting to 1 after you
  145. finish unzipping).  The DJGPP FAQ list explains the details of how to
  146. change this setting.
  147.  
  148.  
  149. 4. Troubleshooting
  150.    ---------------
  151.  
  152. If you have any trouble at all with using Emacs, it is recommended to
  153. perform the following steps in order:
  154.  
  155.    * Read the on-line docs which describe the command you use.
  156.  
  157.    * Look up your problem in the Emacs FAQ list (choose "Help|Emacs FAQ"
  158.      from the menu bar).
  159.  
  160.    * Consult the file `PROBLEMS' in the main Emacs directory for
  161.      solutions to known problems.
  162.  
  163.    * Read the chapter about reporting bugs in the on-line manual.  The
  164.      file `BUGS' in the main Emacs directory describes how to find
  165.      that chapter, if you have trouble with that.
  166.  
  167. You can post questions and requests for help to the gnu.emacs.help news
  168. group if none of the above seems to help. (Problems that seem to be
  169. DOS-related can be reported to comp.os.msdos.djgpp news group first.)
  170.  
  171.  
  172.  
  173.                    Enjoy.
  174.  
  175.                                     Eli Zaretskii <eliz@is.elta.co.il>
  176.