INSTALL.Win32: Update Windows installation instructions

git-svn-id: svn://svn.lyx.org/lyx/lyx-devel/branches/BRANCH_1_4_X@13448 a592a061-630c-0410-9148-cb99ea01b6c8
This commit is contained in:
Michael Schmitt 2006-03-21 22:23:28 +00:00
parent fedbbe9791
commit 7b522c42a8

View File

@ -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.
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/ 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.
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
<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
Using the cvs executable that is packaged with MSYS,
from the MSYS command prompt:
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
4.2 Compile the qtwin library
Open a Windows command line (run cmd.exe) and enter
cd <path_to_your_qtwin_dir>
set QMAKESPEC=win32-g++
configure.bat -verbose
setenv.bat
configure.bat -release
$ 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
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.
5. Aspell
$ cmd.exe
PROMPT> my_configure.bat
5.1 Download the following package from http://aspell.net/
4. Aspell
aspell-0.60.4.tar.gz
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
5.2 Extract the package in your home directory.
4.2 Extract all files in your MSYS home directory. From the
MinSYS command prompt:
Use development/Win32/packaging/build_aspell.sh to build Aspell now.
$ 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.3 You can download pre-compiled aspell dictionaries from
http://wiki.lyx.org/Windows/Aspell6
There's no need to build Aspell now. The script in
development/Win32/packaging should do it for you.
5. LyX
6. LyX
5.1 Get the latest CVS version
6.1 As mentioned above, read the README in development/Win32/packaging.
Using the cvs executable that is packaged with MinSYS,
from the MinSYS command prompt:
$ 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.
There's no need to build LyX now. The script in
development/Win32/packaging should do it for you.
Now go read the README in development/Win32/packaging.
=============================================================================