INSTALL for Win32
=================
-Building LyX the first time can appear to be a daunting task, but much of
-that is knowing which packages to download in the first place.
-
-The instructions below should guide you through the installation of
-the MinGW/MinSYS build environment, together with details on how to
-grab and build the Qt toolkit and how to grab Aspell and LyX.
-
-Once you've done all that, you should go read the README in
-development/Win32/packaging/ The two scripts in the same directory,
-build_lyxwin.sh and package_lyxwin.sh should automate the entire
-build process. If not and you really can't figure out what to do next,
-then please, please drop a mail to lyx-devel@lists.lyx.org.
+LyX can be built with either MinGW/MSYS or Microsoft Visual Studio. The
+instructions below describe the detailed steps needed to set up a MinGW/MSYS
+environment ready to compile LyX. Several of these steps (installation of the
+third-party libraries) need to be performed for a MSVS build also but, of
+course, the details of how to do so are different. Nonetheless, we hope that
+the description below provides the MSVS developer with enough info to get
+started.
+
+Building LyX the first time can appear to be a daunting task but much of that
+is knowing which packages to download in the first place. Once you've set up
+the build environment, actually building LyX should be straightforward.
+
+The instructions below should guide you through the installation of the
+MinGW/MSYS build environment, together with details on how to grab and build
+gettext, libiconv, qtwin, and aspell.
+
+Once you've done all that, you should go read the README in
+development/Win32/packaging/ (MSVS users just open up development/Win32/lyx.sln
+and click Build) The two scripts in the same directory, build_lyxwin.sh and
+package_lyxwin.sh should automate the entire build process. If not and you
+really can't figure out what to do next, then please, please drop a mail to
+lyx-devel@lists.lyx.org.
Enjoy!
The LyX Team
=============================================================================
+
1 MinGW & MSYS
1.1 Download the following packages from http://www.mingw.org/download.shtml:
- MinGW-3.2.0-rc-3.exe
- binutils-2.15.94-20050118-1.tar.gz
- MSYS-1.0.11-2004.04.30-1.exe
+ binutils-2.16.91-...tar.gz
+ gcc-core-3.4.5-...tar.gz
+ gcc-g++-3.4.5-...tar.gz
+ mingw32-make-3.80.0-3.tar.gz
+ mingw-runtime-3.9.tar.gz
+ mingw-utils-0.3.tar.gz
+ MSYS-1.0.11-...exe
+ msys-autoconf-2.59.tar.bz2
+ msys-automake-1.8.2.tar.bz2
msysDTK-1.0.1.exe
+ msys-libtool-1.5.tar.bz2
+ w32api-3.6.tar.gz
+
+1.2 Install in C:\MinGW
-1.2 Install MinGW-3.2.0-rc-3.exe in C:\MinGW
+ binutils, gcc-core, gcc-g++, mingw32-make, mingw-runtime,
+ mingw-utils, w32api
-1.3 Install MSYS-1.0.11-2004.04.30-1.exe in C:\msys
+1.3 Install in C:\msys
-1.4 Install msysDTK-1.0.1 in C:\msys
+ MSYS, msys-autoconf, msys-automake, msysDTK, msys-libtool
-1.5 Extract binutils-2.15.94-20050118-1.tar.gz in C:\MinGW
- (i.e., overwrite the existing binutils)
+2 Gettext
-2. Gettext & Libiconv
+2.1 Download the following package from http://www.gnu.org/software/gettext:
-2.1 Download the following packages from
- http://www.gnu.org/software/gettext/gettext.html:
+ gettext-0.14.5.tar.gz
- gettext-tools-0.13.1.bin.woe32.zip
- gettext-runtime-0.13.1.bin.woe32.zip
- libiconv-1.9.1.bin.woe32.zip
+2.2 Extract the package in your home directory and run
-2.2 Extract the three packages in C:\MinGW
+ ./configure --disable-shared --prefix=/mingw
+ make
+ make install
+3 Libiconv
-3 QT/Win Free Edition
- http://qtwin.sourceforge.net/index.php/QT/Free_from_CVS_with_Mingw
+3.1 Download the following package from http://www.gnu.org/software/libiconv:
-3.1 Get the latest CVS version
+ libiconv-1.10.tar.gz
- Using the cvs executable that is packaged with MinSYS,
- from the MinSYS command prompt:
+3.2 Extract the package in your home directory and run
- $ cd ~
- $ cvs -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/kde-cygwin login
- <return> (no password)
- $ cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/kde-cygwin co \
- -r QT_WIN32_3_3_BRANCH -d qt3 qt-3
+ ./configure --prefix=/mingw
+ make
+ make install
- Alternatively, use the TortoiseCVS graphical interface.
-3.2 Compile the QT library
+4 QTWIN (see http://sourceforge.net/projects/qtwin)
- Create two .bat files, in the top-level directory of the Qt tree,
- my_configure.bat and my_make.bat. Mine are shown below. Obviously,
- you'll have to tweak them ;-)
+4.1 Get the latest CVS version
- $ cat my_configure.bat
- set QTDIR=J:\MinSys\home\Angus\qt3
- set MINGW=J:\MinGW
- set PATH=J:\MinSys\home\Angus\qt3\bin;J:\MinGW\bin;C:\WINDOWS\system32;C:\WINDOWS
- set QMAKESPEC=win32-g++
- configure.bat -verbose
+ Using the cvs executable that is packaged with MSYS,
+ from the MSYS command prompt:
- $ cat my_make.bat
- set QTDIR=J:\MinSys\home\Angus\qt3
- set MINGW=J:\MinGW
- set PATH=J:\MinSys\home\Angus\qt3\bin;J:\MinGW\bin;C:\WINDOWS\system32;C:\WINDOWS
- set QMAKESPEC=win32-g++
- mingw32-make symlinks
- mingw32-make src-moc
- mingw32-make sub-src
+ cvs -d :pserver:anonymous@cvs.sourceforge.net:/cvsroot/qtwin login
+ <return> (i.e., no password)
+ cvs -z3 -d :pserver:anonymous@cvs.sourceforge.net:/cvsroot/qtwin co \
+ -r QT_WIN32_3_3_BRANCH qt-3
- The first time that you build the Qt sources, run my_configure.bat.
- Thereafter, you should be able to get away with my_make.bat. If it fails,
- you should try my_configure.bat again, but this will overwrite all the
- Qt header files, so you'll end up rebuilding large chunks of LyX as well.
+4.2 Compile the qtwin library
- $ cmd.exe
- PROMPT> my_configure.bat
+ Open a Windows command line (run cmd.exe) and enter
-4. Aspell
+ cd <path_to_your_qtwin_dir>
+ set QMAKESPEC=win32-g++
+ setenv.bat
+ configure.bat -release
-4.1 Download aspell-0.50.5.tar.gz from ftp://ftp.gnu.org/gnu/aspell/
- (note: version 0.60.2 does not compile)
- Download dictionaries from ftp://ftp.gnu.org/gnu/aspell/dict/
- Eg: en/aspell-en-0.50-2.tar.bz2
- de/aspell-de-0.50-2.tar.bz2
-4.2 Extract all files in your MSYS home directory. From the
- MinSYS command prompt:
+5. Aspell
- $ gunzip aspell-0.50.5.tar.gz
- $ bunzip2 aspell-en-0.50-2.tar.bz2
- $ tar xvf aspell-0.50.5.tar
- $ tar xvf aspell-en-0.50-2.tar
- $ rm -f aspell-0.50.5.tar
- $ rm -f aspell-en-0.50-2.tar
+5.1 Download the following package from http://aspell.net/
- There's no need to build Aspell now. The script in
- development/Win32/packaging should do it for you.
+ aspell-0.60.4.tar.gz
-5. LyX
+5.2 Extract the package in your home directory.
-5.1 Get the latest CVS version
+ Use development/Win32/packaging/build_aspell.sh to build Aspell now.
- Using the cvs executable that is packaged with MinSYS,
- from the MinSYS command prompt:
+5.3 You can download pre-compiled aspell dictionaries from
+ http://wiki.lyx.org/Windows/Aspell6
- $ cd ~
- $ mkdir lyx && cd lyx
- $ cvs -d:pserver:anoncvs@anoncvs.us.lyx.org:/cvs/lyx login
- (The password is "lyx" (no inverted commas))
- $ cvs -d:pserver:anoncvs@anoncvs.us.lyx.org:/cvs/lyx \
- checkout -r BRANCH_1_3_X -d 13x lyx-devel
- Alternatively, use the TortoiseCVS graphical interface.
+6. LyX
- There's no need to build LyX now. The script in
- development/Win32/packaging should do it for you.
+6.1 As mentioned above, read the README in development/Win32/packaging.
-Now go read the README in development/Win32/packaging.
=============================================================================