README for Win-Emacs 1.00.02 beta

Copyright (c) 1993 Pearl Software, Oakland, CA


    Win-Emacs is a version of GNU Emacs that runs under Windows 3.1 or
later on 80386-based machines with at least 8 megabytes of memory.  12
megabytes of free hard-disk space is required for a complete distribution.
Win-Emacs is based on Lucid Emacs version 19.4 and provides complete
windowing support including full programmability in E-Lisp, the variation
of the Lisp programming language that Emacs supports.


I. Installation

    Installation is accomplished through the SETUP.EXE program located on
the disk "Win-Emacs 1" in the distribution.  Insert this disk in drive A
and type "A:SETUP" from a DOS prompt; or from within Windows, select the Run
command from the File menu in Program Manager and type "A:SETUP.EXE".
Setup will start Windows automatically if it is not currently running, and
will allow you to select the sections of Emacs you wish to install.  You
must install the "Core Program Files" in order for Emacs to work, if you have
not already install them.  "Emacs Info" refers to the online documentation
files; you may choose not to install these files if you wish.


II. Initialization files

    Arbitrary E-Lisp code can be run at start-up time by placing it in
a file "_emacs".  Starting colors, fonts, and so on are specified in a file
"xdefault.ini", which is formatted as a standard X-Windows resource file.
The location of these files is the directory contained in $HOME, or the root
directory of the current hard disk.  See the file "etc/news" for more
information about X Resources.


III. Functions/features not implemented or incompletely implemented

    All of these features may be available in future versions of Win-Emacs,
    except where otherwise noted.

    a. Spawning a sub-process -- you cannot currently use Win-Emacs to run
       another program such that the program's input comes from Emacs or
       the program's output is placed into an Emacs buffer.
    b. Scrollbars -- these do not exist in either Win-Emacs or Lucid-Emacs
       19.4.
    c. Variable-width fonts, bold/italic fonts, multiple fonts, changing
       fonts during program execution -- support is incomplete and buggy.
       This will most likely require an extensive rewrite of the redisplay
       code.


IV. Differences between Win-Emacs and Emacs version 18

    Please look in the file "etc/news" for more information.  This file
documents the differences between Emacs 18 and Lucid Emacs 19.4.


V. MS-DOS-specific additions to Emacs

    These are documented in the file "readme.dos".


VI. Questions, problems, bug reports

    Please send e-mail to

	pearl@netcom.com

    or contact Pearl Software at

	320 Lenox Ave.
	Oakland, CA 94610

	voice: 510-273-9795
	fax: 510-839-9820
