INSTALL.Win32

   1 =================
   2 INSTALL for Win32
   3 =================
   4
   5 Building LyX the first time can appear to be a daunting task, but much of
   6 that is knowing which packages to download in the first place.
   7
   8 The instructions below should guide you through the installation of
   9 the MinGW/MinSYS build environment, together with details on how to
  10 grab and build the Qt toolkit and how to grab Aspell and LyX.
  11
  12 Once you've done all that, you should go read the README in
  13 development/Win32/packaging/ The two scripts in the same directory,
  14 build_lyxwin.sh and package_lyxwin.sh should automate the entire
  15 build process. If not and you really can't figure out what to do next,
  16 then please, please drop a mail to lyx-devel@lists.lyx.org.
  17
  18 Enjoy!
  19 The LyX Team
  20
  21 =============================================================================
  22 1 MinGW & MSYS
  23
  24 1.1 Download the following packages from http://www.mingw.org/download.shtml:
  25
  26       MinGW-3.2.0-rc-3.exe
  27       binutils-2.15.94-20050118-1.tar.gz
  28       MSYS-1.0.11-2004.04.30-1.exe
  29       msysDTK-1.0.1.exe
  30
  31 1.2 Install MinGW-3.2.0-rc-3.exe in C:\MinGW
  32
  33 1.3 Install MSYS-1.0.11-2004.04.30-1.exe in C:\msys
  34
  35 1.4 Install msysDTK-1.0.1 in C:\msys
  36
  37 1.5 Extract binutils-2.15.94-20050118-1.tar.gz in C:\MinGW
  38     (i.e., overwrite the existing binutils)
  39
  40
  41 2. Gettext & Libiconv
  42
  43 2.1 Download the following packages from
  44     http://www.gnu.org/software/gettext/gettext.html:
  45
  46       gettext-tools-0.13.1.bin.woe32.zip
  47       gettext-runtime-0.13.1.bin.woe32.zip
  48       libiconv-1.9.1.bin.woe32.zip
  49
  50 2.2 Extract the three packages in C:\MinGW
  51
  52
  53
  54 3 QT/Win Free Edition
  55   http://qtwin.sourceforge.net/index.php/QT/Free_from_CVS_with_Mingw
  56
  57 3.1 Get the latest CVS version
  58
  59     Using the cvs executable that is packaged with MinSYS,
  60     from the MinSYS command prompt:
  61
  62     $ cd ~
  63     $ cvs -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/kde-cygwin login
  64       <return> (no password)
  65     $ cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/kde-cygwin co \
  66          -r QT_WIN32_3_3_BRANCH -d qt3 qt-3
  67
  68     Alternatively, use the TortoiseCVS graphical interface.
  69
  70 3.2 Compile the QT library
  71
  72     Create two .bat files, in the top-level directory of the Qt tree,
  73     my_configure.bat and my_make.bat. Mine are shown below. Obviously,
  74     you'll have to tweak them ;-)
  75
  76     $ cat my_configure.bat
  77     set QTDIR=J:\MinSys\home\Angus\qt3
  78     set MINGW=J:\MinGW
  79     set PATH=J:\MinSys\home\Angus\qt3\bin;J:\MinGW\bin;C:\WINDOWS\system32;C:\WINDOWS
  80     set QMAKESPEC=win32-g++
  81     configure.bat -verbose
  82
  83     $ cat my_make.bat
  84     set QTDIR=J:\MinSys\home\Angus\qt3
  85     set MINGW=J:\MinGW
  86     set PATH=J:\MinSys\home\Angus\qt3\bin;J:\MinGW\bin;C:\WINDOWS\system32;C:\WINDOWS
  87     set QMAKESPEC=win32-g++
  88     mingw32-make symlinks
  89     mingw32-make src-moc
  90     mingw32-make sub-src
  91
  92     The first time that you build the Qt sources, run my_configure.bat.
  93     Thereafter, you should be able to get away with my_make.bat. If it fails,
  94     you should try my_configure.bat again, but this will overwrite all the
  95     Qt header files, so you'll end up rebuilding large chunks of LyX as well.
  96
  97     $ cmd.exe
  98     PROMPT> my_configure.bat
  99
 100 4. Aspell
 101
 102 4.1 Download aspell-0.50.5.tar.gz from ftp://ftp.gnu.org/gnu/aspell/
 103     (note: version 0.60.2 does not compile)
 104     Download dictionaries from ftp://ftp.gnu.org/gnu/aspell/dict/
 105     Eg: en/aspell-en-0.50-2.tar.bz2
 106         de/aspell-de-0.50-2.tar.bz2
 107
 108 4.2 Extract all files in your MSYS home directory. From the
 109     MinSYS command prompt:
 110
 111     $ gunzip aspell-0.50.5.tar.gz
 112     $ bunzip2 aspell-en-0.50-2.tar.bz2
 113     $ tar xvf aspell-0.50.5.tar
 114     $ tar xvf aspell-en-0.50-2.tar
 115     $ rm -f aspell-0.50.5.tar
 116     $ rm -f aspell-en-0.50-2.tar
 117
 118     There's no need to build Aspell now. The script in
 119     development/Win32/packaging should do it for you.
 120
 121 5. LyX
 122
 123 5.1 Get the latest CVS version
 124
 125     Using the cvs executable that is packaged with MinSYS,
 126     from the MinSYS command prompt:
 127
 128     $ cd ~
 129     $ mkdir lyx && cd lyx
 130     $ cvs -d:pserver:anoncvs@anoncvs.us.lyx.org:/cvs/lyx login
 131       (The password is "lyx" (no inverted commas))
 132     $ cvs -d:pserver:anoncvs@anoncvs.us.lyx.org:/cvs/lyx \
 133           checkout -r BRANCH_1_3_X -d 13x lyx-devel
 134
 135     Alternatively, use the TortoiseCVS graphical interface.
 136
 137     There's no need to build LyX now. The script in
 138     development/Win32/packaging should do it for you.
 139
 140 Now go read the README in development/Win32/packaging.
 141 =============================================================================