README.Cygwin

   1 LyX/Cygwin
   2 Ruurd Reitsma  <R.A.Reitsma@wbmt.tudelft.nl>
   3
   4 There are two ways to run LyX on Windows:
   5 * as a native Windows application, using the Qt/Win Free clone of
   6   Trolltech's cross-platform Qt toolkit.
   7 * as a POSIX application running under the Cygwin environment.
   8
   9 This README describes what is needed for the latter of these two
  10 options. Please refer to README.Win32 if you'd like to run LyX
  11 as a native Windows application.
  12
  13 The Cygwin port consists of a few small tweaks to the original
  14 Unix sources to deal with DOS-style pathnames, so that LyX can use
  15 Win32 TeX distros like fptex and MiKTeX. There's also a cygwin TeTeX port,
  16 but the native Win32 ports have a definite speed advantage. Besides that,
  17 nothing fancy.
  18
  19 The prerequisites are (obviously?):
  20
  21 * cygwin installation (http://www.cygwin.com/).
  22 * decent X server; eXceed, X-Win32 or Cygwin/XFree86.
  23 * working TeX installation; fpTex, MikTex.
  24
  25 It should compile out of the box, but there might be some libraries
  26 missing in the final link step. You'll have to add them to the Makefile
  27 by hand. Be sure to include -lregex, because cygwin's builtin regex is
  28 sortof weird (filedialogs will turn up empty...)
  29
  30 If you want to run LyX with no console windows open, there's a small
  31 program in development/Win32 that will set the proper environment vars
  32 and start LyX.
  33
  34 Compile with:
  35
  36 gcc lyxwin32.C -O2 -o lyxwin32 -static -Wall -Wno-format \
  37 -Wstrict-prototypes -Wmissing-prototypes -mwindows -e _mainCRTStartup
  38
  39 Also make sure the latex binaries are in your Windows path. Windvi and
  40 Yap are auto detected, and you might want to make a symlink to Adobe
  41 Acrobat so it's detected too:
  42
  43 ln -s //c/Program\ Files/adobe/Acrobat\ 4.0/Reader/AcroRd32.exe \
  44 /usr/bin/acroread
  45
  46 Many thanks to Steven van Dijk, Claus Hentschel and Miyata Shigeru for
  47 starting the porting business.