1. Introduction ------------ GNU Emacs compiled with DJGPP v2.x is hereby available as part of the DJGPP archives. Emacs can be compiled with DJGPP out of the box, and you are encouraged to get the latest version from the GNU ftp sites and build it by yourself; but if you don't have the time, necessary tools or disk storage required to unzip the full source distribution and build Emacs, you can get here the pre-built binaries and only those parts of the package that you need. The binaries here were produced from the official version 19.34 of GNU Emacs, with the following changes: * A bug in `hexl' (found after Emacs 19.34 was already released) was corrected whereby binary files were not read in binary mode. * Support for MS-Windows clipboard was added: you can copy, cut and paste to or from other Windows applications in the same way as on X Windows platforms. See the `MS-DOS' chapter of the Emacs on-line manual for more details. The clipboard support code was originally written by Dale P. Smith and should be included in the next official Emacs release. * A bug was corrected whereby running sub-processes on Windows 95 with LFN enabled didn't work. * When Emacs doesn't have to support non-US keyboards, both left and right Alt keys behave the same. * A bug with restoring the blink/bright background bit has been corrected. Emacs will now restore that bit to whatever it found on startup. * `M-x grep' and `M-x diff' now correctly interpret the exit code of the sub-programs they run. * `M-x man' now works (but you need to install a clone for the `man' command). * Emacs was compiled and linked with the latest release of DJGPP v2.01, so no library bugs should affect it (in particular, the 2 bugs related to Emacs that are described at the end of the `INSTALL' file are no longer an issue, and it should no longer crash on NT or when a certain number of environment variables is defined). 2. Files ----- Emacs is a very large package. To make downloading it easier, the archive here is divided into several zip files, each one of which should fit on a 1.4MB floppy disk. Some files are required for running Emacs, others are recommended, still others are only needed if you want to rebuild Emacs (e.g., if you discover a bug). Here is the list of the files: em1934b.zip Binaries and minimal runtime support, required em1934r1.zip Full runtime support (1 of 3), required em1934r2.zip Full runtime support (2 of 3), required em1934r3.zip Full runtime support (3 of 3), required em1934l1.zip Elisp sources (1 of 3), recommended em1934l2.zip Elisp sources (2 of 3), recommended em1934l3.zip Elisp sources (3 of 3), recommended em1934s1.zip Emacs sources (1 of 3) em1934s2.zip Emacs sources (2 of 3) em1934s3.zip Emacs sources (3 of 3) The approximate disk storage that you will need for the package is as follows: Binaries and minimal runtime support...................5MB Binaries and full runtime support.....................20MB Additional storage for Elisp sources..................15MB Additional storage for MSDOS sources (em1934s1.zip)....6MB Additional storage for the full sources...............12MB (The above numbers may vary depending on the cluster size of your disk.) If you are *exceedingly* short on disk space, you can run Emacs after installing only em1934b.zip. However, most of the optional packages are NOT included in that archive, and neither is the on-line manual, so many commands won't work. I tried to squeeze as many frequently-used packages as I could there, though, so `dired', `compile' and the basic help commands should work. The rest of the runtime support (em1934r?.zip) is not organized in any particular order (actually, it's in alphabetical order), because different people use different packages for their chores, and there is no simple way to know what is best for everyone, especially since many packages require others to run. If you can afford the disk space, downloading and installing the Elisp sources (em1934l?.zip) is *highly* recommended, because the best docs for each Elisp package can be always found at the beginning of its .el file; if you can't figure out something by reading the on-line manual, always read the comments at the beginning of the .el package that defines the function(s) you are after. (The GNU Emacs Lisp Manual, available from GNU FTP sites, is highly recommended if you seek deep understanding of how the Elisp code works.) The rest of the package is only required if you want to recompile Emacs or debug it. Note that if you want to rebuild Emacs on MSDOS, you will only need em1934s1.zip; the rest of the source distribution isn't used to compile Emacs on MSDOS and is here only for completeness' sake. (However, if you need the Texinfo sources of the Emacs manual, you will need to install em1934s2.zip as well.) The file `INSTALL' in the main Emacs directory describes (at its end) how to build Emacs on MSDOS. The distribution has already been configured for DJGPP 2.x, so you don't need to run CONFIG.BAT if you use DJGPP 2. 3. Getting started --------------- To install Emacs, follow these steps: * Go to your main DJGPP installation directory. * Unzip all the files that you want to install. If you use PKUNZIP, don't forget the -d switch, like so: pkunzip -d em1934*.zip If you unzip the files on Windows 95, make sure you use an unzip program that supports long file names in zip archives. * When you unzip the archives, a directory called `emacs' is created in the `gnu' subdirectory of the DJGPP tree, with several subdirectories. Add the `gnu/emacs/bin' directory to your PATH. * On Windows 95, you should set LFN=y in the environment, or the long file names might not work for you. (Long file names are NOT supported on Windows NT.) * If you are a new user of Emacs, be sure to begin by reading the Emacs tutorial. To this end, invoke Emacs and choose the "Emacs Tutorial" item from the "Help" submenu (on the menu bar). * An example start-up file is included under the name `_emacs.xmpl'; you can use it as a starting point for your customizations by renaming it to `_emacs'. (Emacs automatically searches for and loads a file named `_emacs' at start-up.) Note that some settings there need optional packages and will print an error message if you didn't install em1934r?.zip. And please don't complain if you don't like the settings of `_emacs.xmpl', as they are my own preferences. Just change them as you see fit and move on. New users are advised to avoid using the example start-up file until they get hold of the Emacs basics, because that example disables the message about most important commands printed at startup. * If you run Emacs under MS-Windows, you might find the files `msdos/emacs.pif' and `msdos/emacs.ico' useful. The zip files are LFN-clean, which means they can be unzipped on Windows 95 (or any other system that supports long filenames); in that case all the files will get their original long names, including the letter-case (e.g., `ChangeLog', `FAQ', etc.). Note that if you want LFN support within Emacs (i.e., you set LFN=y in the environment), you *must* unzip the archives with an unzip program that supports long filenames, or else Emacs won't be able to find some of its files. If you want to be able to run Emacs from both Windows 95 and plain DOS, you need to set the NameNumericTail property in the Registry to 0 before you unzip the package (you may return the setting to 1 after you finish unzipping). The DJGPP FAQ list explains the details of how to change this setting. 4. Troubleshooting --------------- If you invoke Emacs on Windows 9X or Windows NT, and it returns to the DOS prompt immediately when invoked, you have a problem related to long file names. On Windows 9X, try setting LFN=y in the environment before running Emacs; if that doesn't help, set LFN=n and try again. If it only works with LFN=n on Windows 9X, you need to unzip the distribution again using a program which supports long file names in zip archives. If Emacs immediately returns to DOS prompt on Windows NT, make sure you unzip the distribution with a program which truncates the long file names to DOS 8+3 limits. If you have any other trouble with using Emacs, it is recommended to perform the following steps in order: * Read the on-line docs which describe the command you use. * Look up your problem in the Emacs FAQ list (choose "Help|Emacs FAQ" from the menu bar). * Consult the file `PROBLEMS' in the main Emacs directory for solutions to known problems. * Read the chapter about reporting bugs in the on-line manual. The file `BUGS' in the main Emacs directory describes how to find that chapter, if you have trouble with that. You can post questions and requests for help to the gnu.emacs.help news group if none of the above seems to help. (Problems that seem to be DOS-related can be reported to the comp.os.msdos.djgpp news group first.) Enjoy. Eli Zaretskii