diff --git a/INSTALL.Win32 b/INSTALL.Win32 index ed6a2c75d6..f69387b2a7 100644 --- a/INSTALL.Win32 +++ b/INSTALL.Win32 @@ -2,140 +2,125 @@ 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. +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. -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. +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. -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. +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 MinGW-3.2.0-rc-3.exe in C:\MinGW +1.2 Install in C:\MinGW -1.3 Install MSYS-1.0.11-2004.04.30-1.exe in C:\msys + binutils, gcc-core, gcc-g++, mingw32-make, mingw-runtime, + mingw-utils, w32api -1.4 Install msysDTK-1.0.1 in C:\msys +1.3 Install in C:\msys -1.5 Extract binutils-2.15.94-20050118-1.tar.gz in C:\MinGW - (i.e., overwrite the existing binutils) + MSYS, msys-autoconf, msys-automake, msysDTK, msys-libtool -2. Gettext & Libiconv +2 Gettext -2.1 Download the following packages from - http://www.gnu.org/software/gettext/gettext.html: +2.1 Download the following package from http://www.gnu.org/software/gettext: - gettext-tools-0.13.1.bin.woe32.zip - gettext-runtime-0.13.1.bin.woe32.zip - libiconv-1.9.1.bin.woe32.zip + gettext-0.14.5.tar.gz -2.2 Extract the three packages in C:\MinGW +2.2 Extract the package in your home directory and run + + ./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 - (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 + (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 + 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. =============================================================================