--- /dev/null
+=================
+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.
+
+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
+ msysDTK-1.0.1.exe
+
+1.2 Install MinGW-3.2.0-rc-3.exe in C:\MinGW
+
+1.3 Install MSYS-1.0.11-2004.04.30-1.exe in C:\msys
+
+1.4 Install msysDTK-1.0.1 in C:\msys
+
+1.5 Extract binutils-2.15.94-20050118-1.tar.gz in C:\MinGW
+ (i.e., overwrite the existing binutils)
+
+
+2. Gettext & Libiconv
+
+2.1 Download the following packages from
+ http://www.gnu.org/software/gettext/gettext.html:
+
+ 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 three packages in C:\MinGW
+
+
+
+3 QT/Win Free Edition
+ http://qtwin.sourceforge.net/index.php/QT/Free_from_CVS_with_Mingw
+
+3.1 Get the latest CVS version
+
+ Using the cvs executable that is packaged with MinSYS,
+ from the MinSYS command prompt:
+
+ $ 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
+
+ Alternatively, use the TortoiseCVS graphical interface.
+
+3.2 Compile the QT library
+
+ 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 ;-)
+
+ $ 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
+
+ $ 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.
+
+ $ cmd.exe
+ PROMPT> my_configure.bat
+
+4. Aspell
+
+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:
+
+ $ 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
+
+ There's no need to build Aspell now. The script in
+ development/Win32/packaging should do it for you.
+
+5. LyX
+
+5.1 Get the latest CVS version
+
+ 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.
+=============================================================================
LyX has been ported to Win32 using the Cygwin environement.
See README.Cygwin for details.
-In addition, Ruurd Reitsma has created a native port of LyX on Win32
-using the binary Qt/Win32 2.3.0 library. It is not clear whether we
-are legally allowed to distribute this library. Certainly, using it
-goes against the spirit of Open Source software and we have chosen,
-therefore, not to provide formal support for Ruurd's port.
+Ever since Ruurd Reitsma made his port of LyX 1.3.3 to Windows
+available to the general public in 2003, users of LyX/Win have had to
+fight to overcome bugs that simply weren't present on other
+platforms. Ruurd did a superb job in writing the original port, but
+didn't have the resources to squash all the irritating little bugs
+discovered by many people using LyX "for real".
-Having said that, you'll find the executable, together with lots of
-useful tips, on Ruurd's site: http://www.home.zonnet.nl/rareitsma/lyx/
-The Win32 pages on the LyX wiki will also be useful:
-http://wiki.lyx.org/pmwiki.php/LyX/LyX
-Finally, you'll find lots of friendly help on the lyx users'
-mailing list: lyx-users@lists.lyx.org
+The official LyX line on these LyX/Win ports has always been that
+it's nice to know they exist but we won't support them
+officially. There were two reasons for this: we didn't have the
+necessary knowledge or resources and, until recently, only
+closed-source versions of the Qt GUI library existed. The increasing
+maturity of the Qt/Win Free project means that this latter point is
+no longer true, so we felt that we should make the effort and make
+LyX/Win an official part of LyX.
-Trolltech has stated that they do not intend to release
-Qt/Win under the GPL. However, it is likely that a native port of LyX
-to Windows will be supported formally in the future, for two reasons:
+As a result, LyX 1.3.6 cannot really be classified as a minor bug fix
+release, especially for Windows users. Large chunks of the code base
+have been touched in an attempt to resolve those problems that
+Windows users have found with Ruurd's original ports. We feel
+confident that LyX 1.3.6 will be the best ever version of LyX on
+Windows. We are not confident, however, that we haven't introduced
+any new bugs.
-* A frontend for LyX using the Gtk libraries is under active
-development. The Gtk libraries for Win32 are indeed released under
-the GPL.
-
-* Some success has been reported compiling LyX on Win32 using the
-GPL-ed port of qt/x11 to Win32 by the kde-cygwin project. See
-http://kde-cygwin.sourceforge.net/qt3-win32/index.php
+Detailed installation instructions can be found in INSTALL.Win32 for
+those who wish to compile LyX for themselves. For the rest of us,
+LyX/Win comes with its own installer, so installation should be pretty
+straightforward. As always, more detailed help can be found on the
+wiki at http://wiki.lyx.org/Windows.