LyX/Cygwin 2.0.3
----------------

This package provides LyX version 2.0.3 built as a Cygwin application.
Thus, a preliminary requirement is the installation of the Cygwin runtime.
Note that you need Cygwin 1.7.0 or later, as previous versions will not work.
Before installing LyX, you should install at least the following Cygwin
packages (and all other packages pulled in by dependencies):

aspell         ghostscript
python         tetex-extra
gettext        ImageMagick
libpng
libstdc++6

Important note: Be sure to install the latest version of libstdc++6.

However, you must be aware that the ImageMagick package has a dependency
on X11, so installing it would also pull in the Cygwin/X server. This
version of LyX does not need a X server, and if you want to avoid it, you
can simply install the native Windows version of ImageMagick from
http://www.imagemagick.org/script/binary-releases.php#windows

You also have the option of installing native versions of ghostscript
and latex, such that you could skip the installation of the Cygwin
packages listed in the second column above. Another excellent alternative
to both teTeX and MiKTeX is texlive, as Cygwin is now directly supported.

After installing the required packages, 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.

lyxwin.exe      wrapper, to be used from the Windows GUI
lyx.exe         real binary, to be used from the command line

When using the lyxwin wrapper, its environment is set through the system
file /usr/local/share/lyx/lyxprofile. You may wish to create a file named
.lyxprofile in your home directory if you want to override the settings in the
system lyxprofile. For example, in order to specify the language to be used
in the GUI, add the line "export LANG=it_IT.UTF-8" (without the quotes) to the
file ~/.lyxprofile if you want menus in italian, or "export LANG=fr_FR.UTF-8"
(again, without quotes) for french menus.
Your home directory should be correctly guessed by the system lyxprofile, but
it is better setting the HOME variable in your Windows environment.
These are the only changes that you need to do. Please, note that you have to
use a cygwin editor for editing the system lyxprofile or ~/.lyxprofile, as a
native Windows editor may introduce wrong line endings, causing troubles with
the bash shell. Also note that until version 1.6.6 the system lyxprofile was
located in the /etc directory, but this is no more the case.

In /usr/local/share/lyx/etc/lyx.reg you will find registry entries for
associating a .lyx file to lyxwin.exe. Simply navigate to that dir using
the Windows explorer, select the file and choose "Join" or whatever the name
of 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".


Upgrading from previous versions
--------------------------------

Please read the UPGRADING.txt file for how to upgrade to version 2.0.3.
The upgrade should be straightforward and you should need to do nothing.
If you have a file called chkconfig.ltx in the ~/.lyx dir (maybe a relic of
the past), please simply remove it as it interferes with the normal operation.
If you experience problems with unrecognized latex classes, then most surely
you have to delete that file and reconfigure LyX.

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.

Dictionaries and Thesauri
-------------------------
The LyXdict package contains only a couple of dictionaries and thesauri files
(english and italian). However, you can download the files for your language
from http://www.lyx.org/trac/browser/dictionaries/trunk/dicts
and  http://www.lyx.org/trac/browser/dictionaries/trunk/thes
(you need four files per language, those with extensions .aff and .dic for
the dictionaries and .dat and .idx for the thesauri) and put them into the
/usr/local/share/dict/ and /usr/local/share/thes/ directories, respectively.
However, these locations can be configured in the preferences.


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, February 2012

