From 0aab8ead34b4128c27e5452294fc08810d658364 Mon Sep 17 00:00:00 2001 From: Angus Leeming Date: Fri, 15 Jul 2005 09:55:48 +0000 Subject: [PATCH] Add the new README and INSTALL files. git-svn-id: svn://svn.lyx.org/lyx/lyx-devel/trunk@10200 a592a061-630c-0410-9148-cb99ea01b6c8 --- ChangeLog | 4 ++ INSTALL.Win32 | 141 ++++++++++++++++++++++++++++++++++++++++++++++++++ Makefile.am | 4 +- README.Win32 | 47 +++++++++-------- 4 files changed, 173 insertions(+), 23 deletions(-) create mode 100644 INSTALL.Win32 diff --git a/ChangeLog b/ChangeLog index ceacbf70a2..5448a3666e 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,7 @@ +2005-07-14 Angus Leeming + + * Makefile.am (EXTRA_DIST): add the new README and INSTALL files + 2005-07-13 Lars Gullik Bjonnes * Makefiles: make sure to dist pch.h and mark PCH_FILE as a build diff --git a/INSTALL.Win32 b/INSTALL.Win32 new file mode 100644 index 0000000000..ed6a2c75d6 --- /dev/null +++ b/INSTALL.Win32 @@ -0,0 +1,141 @@ +================= +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 + (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. +============================================================================= diff --git a/Makefile.am b/Makefile.am index 49054584cb..0964616430 100644 --- a/Makefile.am +++ b/Makefile.am @@ -14,8 +14,8 @@ else SUBDIRS = config development intl po src sourcedoc lib endif -EXTRA_DIST = ANNOUNCE INSTALL.OS2 INSTALL.autoconf README.OS2 \ - UPGRADING lyx.man autogen.sh +EXTRA_DIST = ANNOUNCE INSTALL.OS2 INSTALL.autoconf INSTALL.Win32 README.OS2 \ + README.Win32 UPGRADING lyx.man autogen.sh man_MANS = lyx.1 diff --git a/README.Win32 b/README.Win32 index 76730f7b68..9e61d37640 100644 --- a/README.Win32 +++ b/README.Win32 @@ -5,27 +5,32 @@ README for Win32 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.