README.Cygwin

   1 LyX/Cygwin
   2 ==========
   3
   4 Ruurd Reitsma  <R.A.Reitsma@wbmt.tudelft.nl>
   5 Bo Peng <ben.bob#gmail.com>
   6
   7
   8 Building LyX on Cygwin
   9 ======================
  10
  11 To build lyx, you will need to install the following cygwin packages
  12
  13     aspell        gzip             libiconv           libQtGui4
  14     aspell-dev    gettext          libpng             libQtGui4-devel
  15     gcc           gettext-devel    libQtCore4         pkg-config
  16     gcc4          libintl8         libQtCore4-devel   python
  17
  18 Two building systems can be used to build lyx on cygwin: the traditional
  19 autotools (autoconf, automake, make etc), and a scons build system.
  20 The former is the preferred method and it does not differ from building lyx
  21 on any typical posix system, so you are referred to the INSTALL file.
  22 Note that it is not advisable using the cmake build system on cygwin for
  23 the reasons explained here: http://www.cmake.org/Bug/view.php?id=10122
  24
  25 If you prefer using scons, you will have to install it separately, as it
  26 is not available as a cygwin package, and then build lyx with the command
  27
  28     > python scons.py -f development/scons/SConstruct mode=release install
  29
  30 Optionally, you can install to a DESTDIR using a command similar to
  31
  32     > python scons.py -f development/scons/SConstruct mode=release DESTDIR=./test install
  33
  34 For more details about the use of scons, please refer to INSTALL.scons.
  35 However, be aware that scons is not fully supported on cygwin and you may
  36 be missing some features (reverse dvi/pdf search, for example) and some
  37 cygwin-specific ancillary programs that you get when building with autotools.
  38
  39 When lyx is built as outlined above, it will be a X-Window application,
  40 so you will need a X-server for running it. It is possible to build lyx
  41 as a cygwin application but using the native Windows GDI backend instead
  42 of X11. You are referred to the lyx wiki for instructions:
  43 http://wiki.lyx.org/LyX/LyXOnCygwin
  44
  45
  46 Acknowledgements
  47 ================
  48
  49 Many thanks to Steven van Dijk, Claus Hentschel and Miyata Shigeru for
  50 starting the porting business, and Enrico Forestieri for many cygwin-related
  51 improvements.