X-Git-Url: https://git.lyx.org/gitweb/?a=blobdiff_plain;f=README.Cygwin;h=f44bc7b5153ff1a770c7ec5a583d779562507afb;hb=1db7ad00fe02ca4ebba56a5e02c2b9856dc538db;hp=97962bdfafc403d77ac674f33249a0ed60335a4f;hpb=55069dd3abd7ce5b13483a205e6edbd757816493;p=lyx.git diff --git a/README.Cygwin b/README.Cygwin index 97962bdfaf..f44bc7b515 100644 --- a/README.Cygwin +++ b/README.Cygwin @@ -1,39 +1,51 @@ -================================================================ -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 +Bo Peng -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 libiconv libQtGui4 + aspell-dev gettext libpng libQtGui4-devel + gcc gettext-devel libQtCore4 pkg-config + gcc4 libintl8 libQtCore4-devel python -Compile with: +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 -gcc lyxwin32.C -O2 -o lyxwin32 -static -Wall -Wno-format \ --Wstrict-prototypes -Wmissing-prototypes -mwindows -e _mainCRTStartup +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 -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: + > python scons.py -f development/scons/SConstruct mode=release install -ln -s //c/Program\ Files/adobe/Acrobat\ 4.0/Reader/AcroRd32.exe \ -/usr/bin/acroread +Optionally, you can install to a DESTDIR using a command similar to -Many thanks to Steven van Dijk, Claus Hentschel and Miyata Shigeru for -starting the porting business. + > 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 +================ + +Many thanks to Steven van Dijk, Claus Hentschel and Miyata Shigeru for +starting the porting business, and Enrico Forestieri for many cygwin-related +improvements.