    				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