]> git.lyx.org Git - lyx.git/blobdiff - README.Cygwin
#9130 Text in main work area isn't rendered with high resolution
[lyx.git] / README.Cygwin
index 97962bdfafc403d77ac674f33249a0ed60335a4f..9da00ef6d2ec49115485c9f2980f13df8b547e6b 100644 (file)
@@ -1,39 +1,37 @@
-================================================================
-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.