-================================================================
-README for Cygwin by Ruurd Reitsma (R.A.Reitsma@wbmt.tudelft.nl)
-================================================================
+LyX/Cygwin
+==========
-LyX has been ported to Win32 using the Cygwin environement. The port
-consists of a few small tweaks to deal with DOS-style pathnames, so
-LyX can use Win32 TeX distros like fptex and MiKTeX. There's also a
-cygwin TeTeX port, but the native Win32 ports have a definite speed
-advantage. Besides that, nothing fancy.
+Ruurd Reitsma <R.A.Reitsma@wbmt.tudelft.nl>
+Bo Peng <ben.bob#gmail.com>
-The prerequisites are (obviously?):
-* cygwin installation (http://www.cygwin.com/).
-* decent X server; eXceed, X-Win32, or maybe even Cygwin/XFree86.
-* working TeX installation; fpTex, MikTex.
+Building LyX on Cygwin
+======================
-It should compile out of the box, but there might be some libraries
-missing in the final link step. You'll have to add them to the Makefile
-by hand. Be sure to include -lregex, because cygwin's builtin regex is
-sortof weird (filedialogs will turn up empty...)
+To build lyx, you will need to install the following cygwin packages
-If you want to run lyx with no console windows open, there's a small
-program in development/Win32 that will set the proper environment vars
-and start lyx.
+ aspell gzip libpng libQtGui4-devel
+ aspell-dev gettext libQtCore4 pkg-config
+ gcc gettext-devel libQtCore4-devel python
+ gcc4 libiconv libQtGui4
-Compile with:
+Currently only the traditional autotools (autoconf, automake, make etc)
+build system is recommended to build LyX on cygwin. 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
-gcc lyxwin32.C -O2 -o lyxwin32 -static -Wall -Wno-format \
--Wstrict-prototypes -Wmissing-prototypes -mwindows -e _mainCRTStartup
+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
-Also make sure the latex binaries are in your Windows path. Windvi and
-Yap are auto detected, and you might want to make a symlink to Adobe
-Acrobat so it's detected too:
-ln -s //c/Program\ Files/adobe/Acrobat\ 4.0/Reader/AcroRd32.exe \
-/usr/bin/acroread
+Acknowledgements
+================
-Many thanks to Steven van Dijk, Claus Hentschel and Miyata Shigeru for
-starting the porting business.
+Many thanks to Steven van Dijk, Claus Hentschel and Miyata Shigeru for
+starting the porting business, and Enrico Forestieri for many cygwin-related
+improvements.