LyX/Cygwin
-Ruurd Reitsma <R.A.Reitsma@wbmt.tudelft.nl>
-
-There are two ways to run LyX on Windows:
-* as a native Windows application, using the Qt/Win Free clone of
- Trolltech's cross-platform Qt toolkit.
-* as a POSIX application running under the Cygwin environment.
+==========
-This README describes what is needed for the latter of these two
-options. Please refer to README.Win32 if you'd like to run LyX
-as a native Windows application.
-
-The Cygwin port consists of a few small tweaks to the original
-Unix sources to deal with DOS-style pathnames, so that 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.
projects / lyx.git / blobdiff