LyX/Cygwin 1.5.2
----------------

This package provides LyX version 1.5.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        netpbm
coreutils       jbigkit       libintl2        python
diffutils       jpeg          libpng          sed
gettext         libintl       libpng2         tar

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.

After installing the required packages above, you will find instructions
on how to install LyX/Cygwin in the file INSTALL.txt.

This package contains both a wrapper for launching LyX from the Windows GUI
(in order to set up a proper environment for LyX and avoid having a terminal
window open) and a real binary for command line usage.

lyx-win.exe      wrapper, to be used from the Windows GUI
lyx-qtwin.exe    real binary, 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).

After installation, you may wish to edit the file /etc/lyxprofile in
order to specify your home directory (if you don't have the HOME variable
already set in your Windows environment) and the language to be used
in the GUI. These are the only changes that you need to do.
Please, note that you have to use a cygwin editor for editing /etc/lyxprofile
as a native Windows editor may introduce wrong line endings, causing troubles
with the bash shell.

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 previous versions
--------------------------------

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, be aware that some old variables are no longer
supported (see below), but they are not harmful if left in place. If you
experience problems such as disappearing entries from the View menu, this
means that you are upgrading from 1.4 and customized some formats. In this
case open the preferences dialog, go to the "File formats" section and check
the "Document format" checkbox for each format that you would like to see in
the View menu. If you still experience some weird problem, try moving away
the ~.lyx/preferences file by renaming it and see whether this solves it.
If you have custom layout files using non-ascii characters, you should
convert them to utf8. Please read the UPGRADING.txt file for details.

Starting from version 1.4.3, an official cygwin version of LyX is also
available with package name "lyx", so I had to change the package name
to "LyXwin" in order to avoid conflicts. This means that if you are
upgrading from 1.4.3 or earlier of this package (and not have the official
version installed) the old version is not recognized as such and thus it is
not automatically uninstalled. So, you have to uninstall it first, and then
perform a new installation as described in the file INSTALL.txt.

Starting from version 1.5.0, the old xforms frontend is no more available,
so if you want a X11 version, you'll have to wait for the official release
of LyX Qt/X11, which you can install in parallel to this one without
conflicts, though.

The old environment variable LYX_WINPATHS used in the 1.4.x versions is no
longer supported, so if you use Windows applications that do not understand
posix paths you need to call them through a wrapper script in order to
translate the paths to the native Windows style.

You can find a wrapper script skeleton in /usr/local/share/lyx/etc/wrapper.sh.
Simply give it the same name of your Windows application (without any
extension), and then place it in /usr/local/bin. Now edit it using a cygwin
text editor and change command_name in the last line with the full path
to the Windows application with the same name. That's it.
The wrapper should work with the vast majority of applications.


Disclaimer
----------

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

-- 
Enrico Forestieri, October 2007

