This directory contains i686 PC Cygwin32 executables for XEmacs 21.1.3.
These were compiled with XPM, GIF, JPEG, PNG, TIFF,
native sound, GNU DB, ncurses, and full optimization.

The binaries have system libraries dynamically linked and all others
statically linked.  The egcs-1.0.3 compiler was used.

Built by Andy Piper <andy@xemacs.org>

A detailed report of how this binary-kit was built can be obtained
after installation by performing an `M-x describe-installation' inside
XEmacs.

This tar file contains the architecture-dependent executables as well
as the core lisp, "man", "etc", and "info" directories.  

In order to reduce the size and increase the maintainability of
XEmacs, the majority of the Elisp packages that came with previous
releases have been unbundled. They have been replaced by the package
system.  Each Elisp add-on (or groups of them when they are small) now
comes in its own tarball that contains a small search hierarchy.  For
more information on how to use the package system, see:
<URL:ftp://ftp.xemacs.org/pub/xemacs/current/README.packages>

HOW TO INSTALL
==============

Simply cd to the directory in which you wish to install XEmacs,
and then unpack the architecture-dependent tar file, followed by
the Elisp add-on tarballs you wish to install.

  % cd /usr/local/	# or wherever you install 3rd-party software
  % gzip -dc xemacs-21.1.3-i686-pc-cygwin32-b19.tar.gz | tar -pxf -

  see <URL:ftp://ftp.xemacs.org/pub/xemacs/current/README.packages>
  for instructions on how to install Elisp through the package system.

Replace `/usr/local/' with what you like, but it probably ought not
have `xemacs' or a version number in it - that directory is expected
to be the common prefix for installed software, and XEmacs-specific
subdirectories of it will be created.  The directories are arranged
in such a way that multiple versions of XEmacs can peaceably coexist
under the same `/usr/local/' tree.

After unpacking, you will have a directory structure like:

  ./bin/i686-pc-cygwin32/xemacs     	        executable
  ./lib/xemacs-21.1-p3/lisp/			lisp library
  ./lib/xemacs-21.1-p3/etc/			data directory
  ./lib/xemacs-21.1-p3/info/			documentation
  ./lib/xemacs-21.1-p3/i686-pc-cygwin32/		utility programs
  ./lib/xemacs/lock/				lock directory
  ./man/man1/					manual pages

For the executable to work, the directory layout must look pretty
much like this; the executable looks for "sibling" directories at
run-time to figure out where its lisp library is.  These constraints
on the local directory layout are necessary to avoid having to
hardcode pathnames into the executables, or require that environment
variables be set before running the executable.

It is possible to do a multi-architecture install in such a way that
the executables for the various architectures are on different
partitions; in that case you must install some symbolic links so that
the directory structure appears as above from the clients.

For example, assume that $LOCAL refers to a directory which is
mounted only on machines of the same type; and $SHARED refers to
a directory which is shared among all machines.  You could set up
the directory hierarchy like this:

  $LOCAL/bin/xemacs-21.1.3*
  $LOCAL/lib/xemacs-21.1-p3/i686-pc-cygwin32/
  $LOCAL/lib/xemacs-21.1-p3/lisp@  ->  $SHARED/xemacs-21.1.3/lisp/
  $LOCAL/lib/xemacs-21.1-p3/etc@   ->  $SHARED/xemacs-21.1.3/etc/
  $LOCAL/lib/xemacs-21.1-p3/info@  ->  $SHARED/xemacs-21.1.3/info/
  $LOCAL/lib/xemacs@               ->  $SHARED/xemacs/

  $SHARED/xemacs-21.1.3/lisp/
  $SHARED/xemacs-21.1.3/etc/
  $SHARED/xemacs-21.1.3/info/
  $SHARED/xemacs/lock/
  $SHARED/xemacs/site-lisp/

That is, the various $SHARED directories contain only the
architecture-independent files, but still look like normal
installation trees, since the architecture-independent
directories have been replaced with symbolic links to the 
single $COMMON tree.

This kit is built with mswindows support only.  This kit will not work
with the default cygwinb19.dll that comes with cygwin b19, you will
need a later version which is provided in the bin directory of this
kit.