INSTALL.Win32

   1 =================
   2 INSTALL for Win32
   3 =================
   4
   5 LyX can be built with either MinGW/MSYS or Microsoft Visual Studio. The
   6 instructions below describe the detailed steps needed to set up a MinGW/MSYS
   7 environment ready to compile LyX. Several of these steps (installation of the
   8 third-party libraries) need to be performed for a MSVS build also but, of
   9 course, the details of how to do so are different. Nonetheless, we hope that
  10 the description below provides the MSVS developer with enough info to get
  11 started.
  12
  13 Building LyX the first time can appear to be a daunting task but much of that
  14 is knowing which packages to download in the first place. Once you've set up
  15 the build environment, actually building LyX should be straightforward.
  16
  17 The instructions below should guide you through the installation of the
  18 MinGW/MSYS build environment, together with details on how to grab and build
  19 gettext, libiconv, qtwin, and aspell.
  20
  21 Once you've done all that, you should go read the README in
  22 development/Win32/packaging/ (MSVS users just open up development/Win32/lyx.sln
  23 and click Build) The two scripts in the same directory, build_lyxwin.sh and
  24 package_lyxwin.sh should automate the entire build process. If not and you
  25 really can't figure out what to do next, then please, please drop a mail to
  26 lyx-devel@lists.lyx.org.
  27
  28 Enjoy!
  29 The LyX Team
  30
  31 =============================================================================
  32
  33 1 MinGW & MSYS
  34
  35 1.1 Download the following packages from http://www.mingw.org/download.shtml:
  36
  37       binutils-2.16.91-...tar.gz
  38       gcc-core-3.4.5-...tar.gz
  39       gcc-g++-3.4.5-...tar.gz
  40       mingw32-make-3.80.0-3.tar.gz
  41       mingw-runtime-3.9.tar.gz
  42       mingw-utils-0.3.tar.gz
  43       MSYS-1.0.11-...exe
  44       msys-autoconf-2.59.tar.bz2
  45       msys-automake-1.8.2.tar.bz2
  46       msysDTK-1.0.1.exe
  47       msys-libtool-1.5.tar.bz2
  48       w32api-3.6.tar.gz
  49
  50 1.2 Install in C:\MinGW
  51
  52       binutils, gcc-core, gcc-g++, mingw32-make, mingw-runtime,
  53       mingw-utils, w32api
  54
  55 1.3 Install in C:\msys
  56
  57       MSYS, msys-autoconf, msys-automake, msysDTK, msys-libtool
  58
  59
  60 2 Gettext
  61
  62 2.1 Download the following package from http://www.gnu.org/software/gettext:
  63
  64       gettext-0.14.5.tar.gz
  65
  66 2.2 Extract the package in your home directory and run
  67
  68       ./configure --disable-shared --prefix=/mingw
  69       make
  70       make install
  71
  72
  73 3 Libiconv
  74
  75 3.1 Download the following package from http://www.gnu.org/software/libiconv:
  76
  77       libiconv-1.10.tar.gz
  78
  79 3.2 Extract the package in your home directory and run
  80
  81       ./configure --prefix=/mingw
  82       make
  83       make install
  84
  85
  86 4 QTWIN (see http://sourceforge.net/projects/qtwin)
  87
  88 4.1 Get the latest CVS version
  89
  90     Using the cvs executable that is packaged with MSYS,
  91     from the MSYS command prompt:
  92
  93       cvs -d :pserver:anonymous@cvs.sourceforge.net:/cvsroot/qtwin login
  94       <return> (i.e., no password)
  95       cvs -z3 -d :pserver:anonymous@cvs.sourceforge.net:/cvsroot/qtwin co \
  96          -r QT_WIN32_3_3_BRANCH qt-3
  97
  98 4.2 Compile the qtwin library
  99
 100     Open a Windows command line (run cmd.exe) and enter
 101
 102       cd <path_to_your_qtwin_dir>
 103       set QMAKESPEC=win32-g++
 104       setenv.bat
 105       configure.bat -release
 106
 107
 108 5. Aspell
 109
 110 5.1 Download the following package from http://aspell.net/
 111
 112       aspell-0.60.4.tar.gz
 113
 114 5.2 Extract the package in your home directory.
 115
 116     Use development/Win32/packaging/build_aspell.sh to build Aspell now.
 117
 118 5.3 You can download pre-compiled aspell dictionaries from
 119     http://wiki.lyx.org/Windows/Aspell6
 120
 121
 122 6. LyX
 123
 124 6.1 As mentioned above, read the README in development/Win32/packaging.
 125
 126 =============================================================================