mirror of
https://git.lyx.org/repos/lyx.git
synced 2024-11-22 01:59:02 +00:00
Add the new README and INSTALL files.
git-svn-id: svn://svn.lyx.org/lyx/lyx-devel/trunk@10200 a592a061-630c-0410-9148-cb99ea01b6c8
This commit is contained in:
Angus Leeming
parent
97a158fd8e
commit
0aab8ead34
@ -1,3 +1,7 @@
|
||||
2005-07-14 Angus Leeming <leeming@lyx.org>
|
||||
|
||||
* Makefile.am (EXTRA_DIST): add the new README and INSTALL files
|
||||
|
||||
2005-07-13 Lars Gullik Bjonnes <larsbj@gullik.net>
|
||||
|
||||
* Makefiles: make sure to dist pch.h and mark PCH_FILE as a build
|
||||
|
||||
141
INSTALL.Win32
Normal file
141
INSTALL.Win32
Normal file
@ -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
|
||||
<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.
|
||||
=============================================================================
|
||||
@ -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
|
||||
|
||||
|
||||
47
README.Win32
47
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.
|
||||
|
||||
Loading…
Reference in New Issue
Block a user