OEMACS Release 4.1 (BETA RELEASE) August 22, 1993 This document describes how to install OEmacs. ********************* ***** IMPORTANT ***** ********************* Backup your hard disk before using this version of Emacs. Although there are no known bugs that will cause filesystem corruption, there may be some. Before you can use this version of Emacs, you must have a 386 or better processor with at least 4MB of motherboard RAM (8MB is recommended). If you want to use this version within a Windows DOS box, you should have at least 8MB of motherboard RAM, and having 12-16MB is strongly recommended. Also note that oemacs, like demacs, uses "/" as the directory separator, and not "\". As a matter of fact, "\" will not work, except in filenames on the command line. ***** Installation instructions OEmacs currently comes in three different versions: 1. A DJGPP-compiled version. This version starts up relatively quickly, but requires a numeric coprocessor to work within a Windows DOS box. 2. A WATCOM C/386-compiled version. This version does not need a numeric coprocessor to work within a Windows DOS box, but it takes a while to start up (about 20 seconds on a 33MHz 486DX), and requires much more disk space. 3. A DJGPP-compiled version for use with DESQview/X. This version provides full multi-frame capability and starts up relatively quickly, but will only run under DESQview/X. To install a particular version, see one of the following sections: Installing the DJGPP-compiled version Installing the WATCOM C/386-compiled version Installing the DESQview/X version ***** Installing the DJGPP-compiled version To install this version, you need the files "oe41gbin.zip" and "oe41min.zip". Any other .zip files are optional. You will need about 3MB of disk space to install this version. The exact amount required will depend on your disk's cluster size. To install the DJGPP-compiled version: 1. Extract the files into some convenient directory. Note that all of the .zip files *MUST* be extracted from the *SAME* directory. All of the files should have been extracted into a subdirectory called "emacs-19.19". If this did not happen, you are using pkunkip (as opposed to the "free" "unzip" program) and probably forgot to specify the "-d" option to preserve the directory structure. In this case, delete the files and try re-extracting them. If you extract any optional .zip files, you *MUST* extract all of the .zip files from the *SAME* directory. 2. Make sure that you have at least 200-250 bytes of free environment space. Various batch files set a number of environment variables, and Emacs will not run properly if setting these environment variables fails. 3. If you are using DOS 5.0 or later, edit the file "emacs-19.19/bin/emacs.bat" to reflect where you extracted the OEmacs files (see the comments in this file for more information), and copy this batch file to some convenient directory listed in your %PATH environment variable. Similarly, if you are using DOS 4.0 or earlier, edit the file "emacs-19.19/bin/emacs2.bat" to reflect where you extracted the OEmacs files, and copy this batch file to some convenient directory listed in your %PATH environment variable. Rename the copied file to "emacs.bat". Also, see the comments in the batch file for anything else that may need to be edited. NOTE: if you try to be "smart" and ignore part of the above instructions by adding "emacs-19.19/bin" to your %PATH environment variable, note that you will still have to copy the "emacs.bat" file to a DIFFERENT directory, one that is EARLIER in the list of directories listed in %PATH (either that, or set all of the appropriate environment variables in your AUTOEXEC.BAT file). This restriction is imposed by the fact that "emacs-19.19/bin" contains both an "emacs.bat" and an "emacs.exe". 4. That should be it. You should now be able to start OEmacs by typing "emacs" and pressing [Enter]. To exit Emacs, press Ctrl-X Ctrl-C. ***** Installing the WATCOM C/386-compiled version To install this version, you need the following files: oe41wbin.zip oe41min.zip oe41el1.zip oe41el2.zip oe41el3.zip Any other .zip files are optional. Note that oe41min.zip contains files that are duplicated in other .zip files; all of the duplicated files should be identical, and so you can tell unzip to overwrite files. You will need about 14MB of disk space to install this version. The exact amount required will depend on your disk's cluster size. To install the WATCOM C/386-compiled version: 1. Extract the files into some convenient directory. Note that all of the .zip files *MUST* be extracted from the *SAME* directory. All of the files should have been extracted into a subdirectory called "emacs-19.19". If this did not happen, you are using pkunkip (as opposed to the "free" "unzip" program) and probably forgot to specify the "-d" option to preserve the directory structure. In this case, delete the files and try re-extracting them. If you extract any optional .zip files, you *MUST* extract all of the .zip files from the *SAME* directory. 2. Make sure that you have at least 200-250 bytes of free environment space. Various batch files set a number of environment variables, and Emacs will not run properly if setting these environment variables fails. 3. If you are using DOS 5.0 or later, edit the file "emacs-19.19/bin.wat/emacs.bat" to reflect where you extracted the OEmacs files, and copy this batch file to some convenient directory listed in your %PATH environment variable. Similarly, if you are using DOS 4.0 or earlier, edit the file "emacs-19.19/bin.wat/emacs2.bat" to reflect where you extracted the OEmacs files, and copy this batch file to some convenient directory listed in your %PATH environment variable. Rename the copied file to "emacs.bat". Also, see the comments in the batch file for anything else that may need to be edited. In particular, if you have one of the following machines, see the section below on the "DOS/4GW DOS extender": NEC 98-series Fujitsu FMR-60,-70 Hitachi B32 OKI if800 If you have one of these machines, you must set additional variables in "emacs.bat"; if you don't, then Emacs will not work. 4. Do one of the following: * Add the directory "emacs-19.19/bin.wat" to your %PATH environment variable (but add the absolute path, not the relative one). * Copy or move the following files into an existing directory listed in your %PATH environment variable: emacs-19.19/bin.wat/dos4gw.exe emacs-19.19/bin.wat/go32.exe (Even though Emacs may be compiled with WATCOM C/386, the support programs "make-doc.exe" and "etags.exe" are compiled using DJGPP.) 5. If you do not have a numeric coprocessor, you will have to manually add a driver to your Windows 3.1 SYSTEM.INI file. If you do not have a numeric coprocessor, you must add a line like the following to the [386Enh] section of your SYSTEM.INI file: device=c:\emacs-19.19\bin.wat\wemu387.386 Edit the above line to reflect where the "wemu387.386" file exists. If you have a numeric coprocessor, you do not need this driver. 6. That should be it. At this point, you should be able to run Emacs by typing "emacs" and pressing [Enter]. To exit Emacs, press Ctrl-X Ctrl-C. ***** Installing the DESQview/X version To install this version, you need the files "oe41xbin.zip" and "oe41min.zip". Any other .zip files are optional. You will need about 3MB of disk space to install this version. The exact amount required will depend on your disk's cluster size. Note: see the file "readme.dvx" for more information. To install the DESQview/X version: 1. Extract the files into some convenient directory. Note that all of the .zip files *MUST* be extracted from the *SAME* directory. All of the files should have been extracted into a subdirectory called "emacs-19.19". If this did not happen, you are using pkunkip (as opposed to the "free" "unzip" program) and probably forgot to specify the "-d" option to preserve the directory structure. In this case, delete the files and try re-extracting them. If you extract any optional .zip files, you *MUST* extract all of the .zip files from the *SAME* directory. 2. Make sure that you have at least 200-250 bytes of free environment space. Various batch files set a number of environment variables, and Emacs will not run properly if setting these environment variables fails. 3. If you are using DOS 5.0 or later, edit the file "emacs-19.19/bin.dvx/emacs.bat" to reflect where you extracted the OEmacs files (see the comments in this file for more information), and copy this batch file to some convenient directory listed in your %PATH environment variable. Similarly, if you are using DOS 4.0 or earlier, edit the file "emacs-19.19/bin.dvx/emacs2.bat" to reflect where you extracted the OEmacs files, and copy this batch file to some convenient directory listed in your %PATH environment variable. Rename the copied file to "emacs.bat". Also, see the comments in the batch file for anything else that may need to be edited. NOTE: if you try to be "smart" and ignore part of the above instructions by adding "emacs-19.19/bin.dvx" to your %PATH environment variable, note that you will still have to copy the "emacs.bat" file to a DIFFERENT directory, one that is EARLIER in the list of directories listed in %PATH (either that, or set all of the appropriate environment variables in your AUTOEXEC.BAT file). This restriction is imposed by the fact that "emacs-19.19/bin.dvx" contains both an "emacs.bat" and an "emacs.exe". 4. That should be it. You should now be able to start OEmacs by typing "emacs" and pressing [Enter]. To exit Emacs, press Ctrl-X Ctrl-C. ******************************************************************************* ***** The DOS/4GW DOS extender: ************* * IMPORTANT * ************* +--------------------------------------------------------------------- | If you have any of the following machines, you MUST set the | DOS16M environment variable before you can use this version of | emacs: | | NEC 98-series | Fujitsu FMR-60,-70 | Hitachi B32 | OKI if800 | | See below for more information. +--------------------------------------------------------------------- The DOS/4GW DOS extender, used and required by this version of Emacs, is a royalty-free DOS extender from Rational Systems. It must be placed in a directory in %PATH, and it can be controlled through through the use of the following environment variables: DOS4G -- Suppresses printout of DOS/4GW startup message. DOS16M -- Controls how 32-bit memory is used and accessed. DOS4GVM -- Enables and controls virtual memory (outside of Windows). * DOS4G: The DOS4G variable can be set to "quiet", which suppresses the display of the DOS/4GW startup message, e.g., set DOS4G=QUIET * DOS16M: [ Note: not all options for the DOS16M variable are documented in the following. ] The DOS16M variable takes values of the form: [<switch_mode>][@<start_address>[-<end_address>]][:<size>] The "<switch_mode>" value, which MUST be specified if you have an NEC 98-series, Fujitsu FMR-60,-70, Hitachi B32, or OKI if800 machine, can take one of the following values: Value Meaning -------------------------------------------------------------------- 0 Use DPMI to access 32-bit memory (automatically set if present). 1 Use a method specific to the NEC 98-series machine. You MUST specify a start/stop range of memory to use. 2 Use a method specific to the PS/2 (automatically set if necessary). 3 Use a method specific to a generic 386/486 machine (automatically set if necessary). INBOARD Use a method specific for a 386 with an Intel Inboard (automatically set if necessary). 5 Use a method specific to the Fujitsu FMR-70 machine. You MUST specify a start/stop range of memory to use. 11 Use VCPI to access 32-bit memory (automatically set if present). 14 Use a method specific to the Hitachi B32 machine. You MUST specify a start/stop range of memory to use. 15 Use a method specific to the OKI if800 machine. You MUST specify a start/stop range of memory to use. 16 Use a method specific to PS/55s. This setting may be needed for some PS/55s, and note that this is NOT automatically detected and used. Note that, for most machines, the correct value for "<switch_mode>" is automatically detected and used. The "<start_address>" and "<end_address>" values specify a range of extended memory to use. This is only necessary if neither DPMI nor VCPI is available (these values are ignored if DMPI or VCPI is available). Values can be specified as decimal or hexadecimal (prefixed with "0x"), and are assumed to be values in kilobytes, unless an "M" (for "megabytes") is appended to the end of the number. The "<size>" value specifies the maximum amount of memory that can be allocated. Values can be specified as decimal or hexadecimal (prefixed with "0x"), and are assumed to be values in kilobytes, unless an "M" (for "megabytes") is appended to the end of the number. If both a memory range ("<start_address"/"<end_address>") and a "<size>" are given, the more restrictive of the two are used. Examples: set DOS16M=:2M Use up to 2MB of extended memory. The method used to access 32-bit memory will be automatically determined (for those machines where it can be done). set DOS16M=14@4M-8M This tells DOS/4GW that an Hitachi B32 machine is being used, and that memory from address 0x00400000 (4 megabytes) to address 0x00800000 (8 megabytes) should be used. * DOS4GVM: [ Note: not all options for the DOS4GVM variable are documented in the following. ] The DOS4GVM variable is used to enable and control virtual memory. To enable virtual memory support, you can set DOS4GVM to one of the following values: set DOS4GVM=1 set DOS4GVM=@<control_filename> The first form, "set DOS4GVM=1", enables virtual memory with default values for all parameters. The second form enables virtual memory, and allows you to specify a file that contains values for some or all parameters (the filename must have the extension ".VMC"). The settable parameters are (all numeric values must be specified in kilobytes): VIRTUALSIZE This is the size of the virtual memory space. The default is 16384KB (16MB). MINMEM This is the minimum amount of RAM to manage. The default is 512KB. MAXMEM This is the maximum amount of RAM to manage. The default is 4096KB (4MB). SWAPMIN This is the minimum or initial size of the swap file. If this is not specified, the initial size will be based upon the "VIRTUALSIZE" parameter. SWAPINC This is the size by which the swap size grows, if the swap has to grow. SWAPNAME This is the name of the swapfile. The default name is "DOS4GVM.SWP", and is placed in the root directory of the CURRENT drive (not the boot drive). It's best if you specify a complete pathname (w/drive letter) here. DELETESWAP If given, the swapfile is deleted when the program exits. Normally, the swapfile is NOT deleted when the program exits, which means that the program will startup faster the next time (it doesn't have to recreate the swapfile). Unlike the other options, this parameter does not take any values. IMPORTANT: The file containing the parameters must NOT have any blank lines, as parameter processing STOPS at the first blank line. An example of a .VMC file is: ! Example .VMC file. ! Comments start with "!". ! Set the virtual memory size: virtualsize = 32768 ! The minimum amount of ram used is: minmem = 4096 ! The maximum amount of ram used is: maxmem = 8192 ! Delete the swapfile when the program terminates: deleteswap ! The name of the swapfile is: swapname = c:\myswap.swp