This directory contains Alpha DIGITAL UNIX V4.0D (formerly DEC OSF/1,
and in the process of being renamed to Compaq Tru64 UNIX) executables
for XEmacs 21.1.3.  These were compiled with XAUTH, XPM, X-Face, PNG,
GIF, JPEG, TIFF, X-Face, DBM, Tooltalk, full optimization (-O4), and
support for Mule (MUlti-Lingual Emacs) with XIM which is needed to
support non-Latin-1 (including Asian) languages.

The binaries have system libraries dynamically linked and all others
statically linked.  The binaries were build on an Alpha EV56 system, but
they should work on other Alpha architectures (running DIGITAL UNIX
V4.0D or later) with negligible performance impact.  The DEC C V5.6-071
compiler was used.  To workaround a compiler bug, two files were
manually compiled with reduced optimization as follows:

  ( cd lib-src ; rm -f regex.o ; make regex.o CFLAGS='-g3 -O2' ) 
  ( cd src     ; rm -f regex.o ; make regex.o CFLAGS='-g3 -O2' )

Built by Steve Carney <Steve.Carney@altavista.com>

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.  

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-alpha-dec-osf4.0d-mule.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/alpha-dec-osf4.0d-mule/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/alpha-dec-osf4.0d/       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/alpha-dec-osf4.0d/
  $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.
