LyX/Cygwin 1.4.0
----------------

This package provides LyX version 1.4.0 built using Cygwin tools, such that
it is a Cygwin application that needs the Cygwin runtime environment.
Thus, a preliminary requirement is the installation of Cygwin. Before
installing LyX, you should install at least the following Cygwin packages
(and all other packages pulled in by dependencies):

coreutils       jbigkit       libintl2        sed
diffutils       jpeg          libpng          tar
gettext         libintl       libpng2
grep            libintl1      python

Other than the above, other packages are also needed, but you have the
option of installing native versions of them. The remaining packages
are: latex, imagemagick and ghostscript. For example, you could install
either the cygwin tetex packages or the native MikTeX one.
If you want to use the X11 version of LyX (see below), you will also
need the xorg-x11-* cygwin packages or some third party X-server.

You also need installing the fonts you find here:
ftp://ftp.lyx.org/pub/lyx/contrib/BaKoMa4LyX-1.1.zip

After you have done that, you will find instructions on how to install
LyX/Cygwin in the file INSTALL.txt.

This package contains two different flavors of LyX, one using the native
Qt/Win GUI and the other the Qt/X11 GUI. For each flavor there are two binaries:
a wrapper for launching LyX from the Windows GUI and a real binary for command
line usage:

lyx-win.exe       Qt/Win, to be used from the Windows GUI
lyx-winbin.exe    Qt/Win, to be used from command line
lyx-x11.exe       Qt/X11, needs an X-server, to be used from the Windows GUI
lyx-x11bin.exe    Qt/X11, needs an X-server, to be used from the command line

When using the command line, you can also launch LyX by simply typing lyx, as
this is a symlink to lyx-winbin.exe (make sure that /usr/local/bin is in
your PATH). The wrapper program lyx-x11.exe takes care of launching the
X-server if it is not running.

For the X11 version you can use whatever X-server you prefer. However, the
configuration files are taylored for using the cygwin server XWin.
The only two files that you need tweaking to adapt them to another X-server
are /etc/lyxprofile and /usr/local/bin/startxserver.
In /etc/lyxprofile you should enter the name of the X-server as shown (when
it is running) by the command "ps -efW", whereas you should replace
/usr/local/bin/startxserver with an appropriate Bourne shell script. As it
is now, it tries to start the cygwin server XWin.

In /usr/local/share/lyx/etc/lyx.reg you will find registry entries for
associating a .lyx file to lyx-win.exe. Simply navigate to that dir using
the Windows explorer, select the file and choose "Join" or whatever is named
that entry in your locale. An easy way for opening an explorer window in the
right location when working in a cygwin shell, is using the command
"cygstart /usr/local/share/lyx/etc".

Known problems
--------------

- The lyxpipe doesn't work, yet. I am currently investigating the problem.
  Issuing the command
      echo "LYXCMD:test:file-open" > /path/to/lyxpipe.in
  does nothing when using the native Qt/Win version, whereas using the Qt/X11
  version the file dialog opens, but then LyX hangs.

- LyX/Cygwin crashes when trying to preview a beamer document. However, the
  output .pdf file is produced in the temporary directory, so the crash 
  occurs just at the end of the process (this one is quite puzzling).

Disclaimer
----------

This package works for me but I cannot guarantee that it does for you, or
even that using it your computer will not blew in smoke ;-)

-- 
Enrico Forestieri, March 2006

