X-Git-Url: https://git.lyx.org/gitweb/?a=blobdiff_plain;f=README.Cygwin;h=f44bc7b5153ff1a770c7ec5a583d779562507afb;hb=eef5148a49b2ad5435dd6d6a2c50351229c144b1;hp=6deda70622ec11f0678136cd6a878e8ab3f127c7;hpb=ea3930a7fd9f60539fee684f396f22048ec150a7;p=lyx.git diff --git a/README.Cygwin b/README.Cygwin index 6deda70622..f44bc7b515 100644 --- a/README.Cygwin +++ b/README.Cygwin @@ -1,47 +1,51 @@ LyX/Cygwin +========== + Ruurd Reitsma +Bo Peng + + +Building LyX on Cygwin +====================== -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. +To build lyx, you will need to install the following cygwin packages -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. + aspell gzip libiconv libQtGui4 + aspell-dev gettext libpng libQtGui4-devel + gcc gettext-devel libQtCore4 pkg-config + gcc4 libintl8 libQtCore4-devel python -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. +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 -The prerequisites are (obviously?): +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 -* cygwin installation (http://www.cygwin.com/). -* decent X server; eXceed, X-Win32, or maybe even Cygwin/XFree86. -* working TeX installation; fpTex, MikTex. + > python scons.py -f development/scons/SConstruct mode=release install -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...) +Optionally, you can install to a DESTDIR using a command similar to -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. + > python scons.py -f development/scons/SConstruct mode=release DESTDIR=./test install -Compile with: +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. -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.