==========
Ruurd Reitsma <R.A.Reitsma@wbmt.tudelft.nl>
-Bo Peng <ben.bob#gmail.com>
+Bo Peng <ben.bob#gmail.com>
-Building Lyx under cygwin
-=========================
-
-Two building systems are supported to build lyx under cygwin: the traditional
-autotools (autoconf, automake, make etc), and a scons build system. The latter
-is easier to use and is the preferred method. If you prefer using autotools,
-you can find detailed instructions at lyx/wiki.
+Building LyX on Cygwin
+======================
To build lyx, you will need to install the following cygwin packages
- aspell gzip libiconv qt4-bin
- aspell-dev jpeg libpng qt4-devel
- gcc libintl libpng2
- gettext libintl1 jpeg
- gettext-devel libintl2 python
+ aspell gzip libiconv libQtGui4
+ aspell-dev gettext libpng libQtGui4-devel
+ gcc gettext-devel libQtCore4 pkg-config
+ gcc4 libintl8 libQtCore4-devel python
+
+Two building systems can be used to build lyx on cygwin: the traditional
+autotools (autoconf, automake, make etc), and a scons build system.
+The former is the preferred method and it does not differ from building lyx
+on any typical posix system, so you are referred to the INSTALL file.
+Note that it is not advisable using the cmake build system on cygwin for
+the reasons explained here: http://www.cmake.org/Bug/view.php?id=10122
-Then, build lyx with command
+If you prefer using scons, you will have to install it separately, as it
+is not available as a cygwin package, and then build lyx with the command
> python scons.py -f development/scons/SConstruct mode=release install
> python scons.py -f development/scons/SConstruct mode=release DESTDIR=./test install
For more details about the use of scons, please refer to INSTALL.scons.
+However, be aware that scons is not fully supported on cygwin and you may
+be missing some features (reverse dvi/pdf search, for example) and some
+cygwin-specific ancillary programs that you get when building with autotools.
+
+When lyx is built as outlined above, it will be a X-Window application,
+so you will need a X-server for running it. It is possible to build lyx
+as a cygwin application but using the native Windows GDI backend instead
+of X11. You are referred to the lyx wiki for instructions:
+http://wiki.lyx.org/LyX/LyXOnCygwin
Acknowledgements