README file for the binary distribution of LyX 1.0.4
======================================================

Please read the file README for general information on LyX.

To use this binary distribution of LyX, please follow these steps:

1) Unpack the distribution in the directory /usr/local (if you unpack
   it in a different place, please read the note below)

2) Configure LyX for you system by executing
     cd share/lyx ; ./configure

3) Make sure that the directory bin/ is in your path. For example, if
   you unpacked the distribution in /usr/local, your PATH environment
   variable should contain "/usr/local/bin".

4) If you want to use reLyX, the LaTeX-to-LyX translator, you will
   have to edit the first line of the script, which should read
     #!/usr/local/bin/perl
   if you have perl installed as /usr/local/bin/perl. 
   Note that reLyX requires at least perl version 5.002.

That's it. Happy LyXing !


If you did not unpack the distribution in /usr/local
----------------------------------------------------

LyX can perfectly work in this situation, except for one thing: as
distributed, LyX expects to find its internationalization files in the
directory /usr/local/share/locale. If you unpacked the distribution in
directory /foo, you should set the environment variable LYX_LOCALEDIR
to point to /foo/share/locale as follows:
  LYX_LOCALEDIR=/foo/share/locale            (if you use sh or bash as shell)
or
  setenv LYX_LOCALEDIR /foo/share/locale     (for csh or tcsh)

Note that, if if you do not have any interest in having LyX display
its messages in other languages than english, you can safely skip this
step.

NB - Versions of IRIX less than 6.5 will only work with this binary 
distribution if you set the environment variable _RLD_ARGS to 
-ignore_unresolved, in an identical way to that described above for 
LYX_LOCALEDIR.

This is a dynamically linked version, which will only work if you have n32
versions of the XForms & Xpm libraries installed on your system. These can
be obtained from:

Xpm: ftp://koala.inria.fr/pub/xpm
     ftp://ftp.x.org/contrib & mirrors
XForms: ftp://bragg.phys.uwm.edu/pub/xforms/sgi/

The ideal way to install the libraries is in one of the common directories,
such as /usr/lib, /usr/lib32/ or /usr/local/lib. If you do not have root 
access to your system, and cannot install in these directories, the following
method should work.

1. Unpack the xforms & xpm distributions. Copy the libforms.so.0.88 & libXpm.so
files to a library directory (eg $HOME/lib). Create a symbollic link from 
libXpm.so to libXpm.so.1 in this directory. 

2. Unpack the lyx distribution as described above.

3. Create a wrapper file to set a couple of variables. This example assumes
lyx has been installed to your home directory, and the libraries to ~/libs:

#!/bin/csh
setenv LD_LIBRARY_PATH $HOME/lib 
setenv _RLD_ARGS -ignore_unresolved
$HOME/bin/lyx

Call this lyx2, set as executable, put in your path, and away you go.

This has been linked with xforms 0.88, so may not work with other versions.
If you have the more recent xforms 0.89, you may need to create a symbolic
link from libforms.so.0.89 to libforms.so.0.88

A binary which has static linking against XForms should be available 
from ftp://ftp.lyx.org
 
This distribution created by Steve Holden <sjh1008@cam.ac.uk>. Please
contact me if you have any problems.