INSTALL.Win32

   1 Compiling LyX 1.6 for Win32
   2 ===========================
   3
   4 LyX 1.6 can be compiled with Microsoft Visual C++ 2008 (recommended) or MinGW.
   5 Note that you should not have spaces in the path of the source code.
   6
   7 Compiling with MSVC 2008
   8 ========================
   9
  10 1       Install MSVC 2008
  11
  12         If you don't have MSVC 2008 installed, download and install the free
  13         Express edition from http://www.microsoft.com/express/vc/
  14
  15 2       Install Python
  16
  17         Get the latest Python 2.6 version at
  18         http://www.python.org/download/
  19
  20         Install in C:\Python26 and add this directory to the PATH environment
  21         variable (Start > Settings > Control Panel > System > Advanced >
  22         Environment Variables).
  23
  24 3       Install SCons
  25
  26         Download the latest SCons version from http://www.scons.org/download.php
  27
  28 4       Install the dependencies
  29
  30         Download ftp://ftp.lyx.org/pub/lyx/contrib/lyx-windows-deps-msvc2008.zip
  31         and extract in the root directory of your LyX files (so you will get
  32         a directory called lyx-windows-deps-msvc2008 next to the other directories
  33         like src, development etc.).
  34
  35 5       Compile
  36
  37         Start a Visual Studio command prompt (Start > Programs >
  38         Microsoft Visual C++ 9.0 Express Edition > Visual Studio Tools >
  39         Visual Studio 2008 Command Prompt) and run:
  40
  41         cd <lyx root directory>\development\Win32\packaging
  42         build_msvc.bat
  43
  44 6       First start of LyX
  45
  46         To start the just compiled lyx.exe, it is necessary to copy the following
  47         files to the folder where the just compiled "lyx.exe" is:
  48
  49         Aiksaurus.dll
  50         aspell.dll
  51         iconv.dll
  52         intl.dll
  53         Microsoft.VC90.CRT.manifest
  54         msvcp90.dll
  55         msvcr90.dll
  56         QtCore4.dll
  57         QtGui4.dll
  58
  59         msvcp90.dll and msvcr90.dll are the C Runtime and C++ libraries
  60         supplied with MSVC 2008. They are freely redistributable.
  61         See http://msdn2.microsoft.com/en-us/library/8kche8ah.aspx
  62         for details.
  63
  64         All of the other .dlls above and the lyx executable are compiled
  65         from code released under the GPL which states (section 3) that
  66         GPL software may be linked against system files such as msvcp90.dll
  67         and msvcr90.dll.
  68
  69 Compiling with MinGW
  70 ====================
  71
  72         These instructions allow you to create a basic LyX build with MinGW.
  73         To be able to use all LyX features, compiling with MSVC 2008 is recommended.
  74         Creating an installer for MinGW builds is no longer supported.
  75
  76 1       Install MinGW, and all the gcc-related stuff, and win32api.
  77
  78 2       download qt-win-opensource-4.x.x-mingw.exe and install to c:\qt.
  79
  80 3       install python and scons as instructed above. Set $path for python
  81            to make your life a bit easier.
  82
  83 4       Check out lyx svn to c:\lyx-devel\lyx-1.6.x
  84
  85 5       Download zlib binaries and developer files (zlib-1.2.3-bin.zip and
  86            zlib-1.2.3-lib.zip) from http://gnuwin32.sourceforge.net/packages/zlib.htm
  87            libiconv from http://gnuwin32.sourceforge.net/packages/libiconv.htm
  88            gettext  from http://gnuwin32.sourceforge.net/packages/gettext.htm
  89            unpack all of them to the same directory c:\lyx-devel\mingw_deps.
  90
  91 6       start a command window, run commands:
  92            $ cd c:\lyx-devel\lyx-1.6.x
  93            $ scons -f development\scons\SConstruct \
  94                extra_lib_path=..\mingw_deps\lib  \
  95                    extra_inc_path=..\mingw_deps\include \
  96                    extra_bin_path=..\mingw_deps\bin \
  97                    qt_dir=c:\qt \
  98                    DESTDIR=..\lyx-1.6-install \
  99                    install
 100
 101
 102 Creating the Installer
 103 ======================
 104
 105         To create an installer with LyX and all related components, download
 106         and install the latest NSIS from http://nsis.sourceforge.net
 107
 108         Open development\Win32\packaging\installer\setttings.user.nsh and modify
 109         the settings depending on your build environment.
 110
 111         Finally, go to development\Win32\packaging\installer
 112         (in a normal Windows Explorer), right-click on lyx.nsi and click
 113         "Compile NSIS Script".
 114
 115         You can also use the installer target of scons. Namely, use a command like
 116            $ scons -f development\scons\SConscript installer
 117         This will create $BUILDDIR\lyx-version-timestamp-Installer.exe for a devel version,
 118         and $BUILDDIR\lyx-version-Install.exe for a released version of lyx.
 119
 120         If you also want to generate bundled installer, download
 121         lyx-windows-bundle-deps.zip from http://www.lyx.org/~bpeng, unpack
 122         to lyx-windows-bundle-deps under the top source directory, and run
 123           $ scons -f development\scons\SConstruct installer bundle=1
 124         If you prefer to use another directory, you can use option bundle_dir like
 125           $ scons -f development\scons\SConstruct installer bundle=1 bundle_dir=c:\bundle