LyX/Cygwin 1.4.2
----------------

This package provides LyX version 1.4.2 built as a Cygwin application.
Thus, a preliminary requirement is the installation of the Cygwin runtime.
Before installing LyX, you should install at least the following Cygwin
packages (and all other packages pulled in by dependencies):

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

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.

After installing the required packages above, 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 (it sets up a proper
environment for LyX and avoids having a CMD window open) and a real binary
for command line usage.

lyx-win.exe      Qt/Win, to be used from the Windows GUI
lyx-qtwin.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-qtx11.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-qtwin.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".


Caveat
------

Under Tools->Preferences->Outputs->Paths you will find a checkbox labeled
"Use Windows-style paths in LaTeX files". Its status (checked or unchecked)
is determined at configure time. If you use MikTeX you'll find that it is
checked, whereas if you use the cygwin tetex you'll find that it is unchecked.
Please, don't play with this checkbox if you don't know what you are doing.


Upgrading from LyX/Cygwin 1.4.1
-------------------------------

This should be straightforward and you need to do nothing. During the
upgrade, the file /etc/lyxprofile will not be replaced, as you may have
customized it. However, I modified it adding a new environment variable
letting you decide the kind of path style used by LyX.
So I suggest that, after upgrading, you have a look at the new version,
located at /usr/local/share/lyx/etc/lyxprofile, in order to import the
new environment variable (LYX_WINPATHS) to your old version.

Be warned that I have renamed lyx-winbin.exe and lyx-x11bin.exe as
lyx-qtwin.exe and lyx-qtx11.exe, respectively, so if you have scripts
using the old names, you will have to update them. Sorry for that.


What's new
----------

These news are specific to the Cygwin version of LyX.

- New environment variable (LYX_WINPATHS). When setting this variable to
  "yes" or "true", LyX uses Windows- rather than posix-style paths. This
  is useful when you use Windows applications that do not understand posix
  and relieves you from the need of writing a wrapper script.

- The lyxpipe now works with the latest cygwin dll (1.5.20).

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

- None that I am aware of.

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, July 2006

