				EMX1929

INTRODUCTION
============

The three files here (emx1929?.zip) are a "modified" version of GNU
emacs.  The files are

	emx1929b.zip		binaries (needed)
	emx1929l.zip		lisp libraries (needed)
	emx1929s.zip		source (needed only for re-building)

Actually, what is modified is that there is only the source available
for compiling this version.  For this to be a bona-fide version of GNU
emacs, the entire source would have to be made available.

Also, this version has less of the lisp library than comes with the
full GNU emacs.  Things like ange-ftp, telnet, vms-specific files, vi
emulation, etc. have been removed for space reasons.  And all the
compiled lisp is gone.  If you want to restore it, you can
byte-compile everything you use regularly, or all of the files in the
lisp directory (try C-h f dired-do-byte-compile for an easy way to do
this).

The info pages are included, so you have on-line help.

INSTALLATION
============

To install this version of emacs, get the zip files you want (at least the
b and l files), and do

	pkunzip -d emx1929b
	pkunzip -d emx1929l

You need the -d to keep the directory structure intact.  (I know, this
readme file is in one of the archives.  If you unzipped everything without
keeping the directory structure, start over.  Nothing will work
correctly.)

You don't need to add anything to your PATH variable.  But you do need to
move one of the included files to a directory in your PATH.  GO32.EXE is
the dos extender used with emacs, and needs to be available.  Once you do
that, you should be able to type "bin\emacs" to start emacs.  See the
section on environment variables below, though, for some problems that may
arise.

This version of emacs pulls the directory information off of
the name of the executable used, and references all of it's support
files from there.  So, if you install this in C:\APPS\EMACS, you can
execute C:\APPS\EMACS\BIN\EMACS, and it will know where to find
everything.  It will also consider C:\APPS\EMACS as your "HOME"
directory.  The way I have set up my system to easily execute emacs is
to load "DOSKEY" (see the MS-DOS documentation), and then execute,
from my AUTOEXEC.BAT

	doskey emacs=\apps\emacs\bin\emacs $*

This allows me to type "emacs filename" and be editing the file, without
having to type in the full path to emacs every time.  The $* at the end
puts any arguments you add to the command line at that point.

The initialization file used in the rest of the computer world is
"~.emacs", which is an invalid name under the MS-DOG FAT file system.  The
name used with this version of emacs is "~/_emacs", where ~ is the
directory that holds the subdirectories of the distribution.  (In the
example above, ~ = \apps\emacs).

There are files in the msdos directory (emacs.pif, emacs.ico) which can
be used to set up emacs for use in windows.

Please read etc/msdos for more information.

ENVIRONMENT VARIABLES
=====================

First, this version of emacs uses an "internal terminal" type if there is
no TERM environment variable set.  This is the way it should be.  If you
have a TERM variable set, you will need to find some lisp files from the
standard emacs distribution (lisp/term/*.el), and even then, things might
not work correctly.  To get the full benefit, you should unset any TERM
variable before you start emacs.

There are no other environment variables used by emacs, so you shouldn't
have to worry about anything.

However, there is an environment variable used by the DOS extender
GO32.EXE, called GO32 (appropriately enough!).  The documentation from the
DJGPP compiler that refers to that variable is included here.
(Note that this piece is copyrighted by DJ Delorie (dj@ctron.com))

START OF INCLUDED TEXT -------------------------------------------------------
The GO32 environment variable:


This variable controls the options available in go32.  The syntax of
this variable is:

  SET GO32=[parm [value]] [parm [value]] . . .

Parameters:

  ansi           Use ANSI commands to control the color in edebug32
  mono           Use the Monochrome monitor for debugging - useful when
                   debugging graphics applications
  topline        Display status information on the top line of the screen
                 (or the top of the mono monitor)
  1rm            Redirect stdout (file #1) to the monochrome monitor
  2rm            Redirect stderr (file #2) to the monochrome monitor
  1r2            Redirect stdout (file #1) to stderr (file #2)
  2r1            Redirect stderr (file #2) to stdout (file #1)
  nodpmi         don't use dpmi even if you find it.
  core [file]    append exception traceback to the named file.

  glob           enable globbing (default)
  noglob         disable globbing

  emu [path]     Use the specified file as the 80387 emulator

  driver [path]  Use the specified file as the graphics driver
  gw [width]     Default graphics width
  gh [height]    Default graphics height
  tw [width]     Default text width
  th [height]    Default text height
  nc [colors]    Number of colors (for new-style drivers only - see cbgrx*.zip)


These parameters may occur in any order.

Note that "1rm" and "2rm" are done before "1r2" and "2r1", so "1rm 2r1" sends
stdout to the mono monitor and stderr to any redirection used.

Examples:

  C:\> set GO32=mono driver c:\djgpp\drivers\tseng4k.grd gw 1024 gh 768 tw 132 th 43 nc 256
  C:\> set GO32=ansi
  C:\> set GO32=driver c:\djgpp\drivers\tseng4k.grd ansi
  C:\> set GO32=mono 1rm 2rm nodpmi topline

END OF INCLUDED TEXT -------------------------------------------------------

The most important part of that is the EMU stuff.  If your PC doesn't have
a math co-processor, you can emulate one with the included file "bin/emu387".
Just set the GO32 environment variable:

	set GO32=emu \path\to\emu387

and you should be ready to roll.  (This version of emacs will fault if you
don't have a math co-processor, so if you see a message that looks like
"Attempting to use a non-existent 80387", you should set this variable.)

CONCLUSION
==========

I hope you can use this version of emacs.  I had fun building it, and
I hope it becomes widely distributed.  As the GNU GPL says, if you
distribute this, you also have to distribute the source, and so the 3
files here (emx1929b.zip, emx1929l.zip and emx1929s.zip) all need to
go with you.  I have tried to keep them under 1.4M so they will fit on
a single disk.

REPORTING BUGS
==============

If you find bugs, you should really report them to the GNU emacs
maintainers (bug-emacs@prep.ai.mit.edu).  But if you notice that there
are files missing that you need for some reason, please let me know.

Randy Zack
randy@acucobol.com
