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:
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>
|
2005-07-13 Lars Gullik Bjonnes <larsbj@gullik.net>
|
||||||
|
|
||||||
* Makefiles: make sure to dist pch.h and mark PCH_FILE as a build
|
* 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
|
SUBDIRS = config development intl po src sourcedoc lib
|
||||||
endif
|
endif
|
||||||
|
|
||||||
EXTRA_DIST = ANNOUNCE INSTALL.OS2 INSTALL.autoconf README.OS2 \
|
EXTRA_DIST = ANNOUNCE INSTALL.OS2 INSTALL.autoconf INSTALL.Win32 README.OS2 \
|
||||||
UPGRADING lyx.man autogen.sh
|
README.Win32 UPGRADING lyx.man autogen.sh
|
||||||
|
|
||||||
man_MANS = lyx.1
|
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.
|
LyX has been ported to Win32 using the Cygwin environement.
|
||||||
See README.Cygwin for details.
|
See README.Cygwin for details.
|
||||||
|
|
||||||
In addition, Ruurd Reitsma has created a native port of LyX on Win32
|
Ever since Ruurd Reitsma made his port of LyX 1.3.3 to Windows
|
||||||
using the binary Qt/Win32 2.3.0 library. It is not clear whether we
|
available to the general public in 2003, users of LyX/Win have had to
|
||||||
are legally allowed to distribute this library. Certainly, using it
|
fight to overcome bugs that simply weren't present on other
|
||||||
goes against the spirit of Open Source software and we have chosen,
|
platforms. Ruurd did a superb job in writing the original port, but
|
||||||
therefore, not to provide formal support for Ruurd's port.
|
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
|
The official LyX line on these LyX/Win ports has always been that
|
||||||
useful tips, on Ruurd's site: http://www.home.zonnet.nl/rareitsma/lyx/
|
it's nice to know they exist but we won't support them
|
||||||
The Win32 pages on the LyX wiki will also be useful:
|
officially. There were two reasons for this: we didn't have the
|
||||||
http://wiki.lyx.org/pmwiki.php/LyX/LyX
|
necessary knowledge or resources and, until recently, only
|
||||||
Finally, you'll find lots of friendly help on the lyx users'
|
closed-source versions of the Qt GUI library existed. The increasing
|
||||||
mailing list: lyx-users@lists.lyx.org
|
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
|
As a result, LyX 1.3.6 cannot really be classified as a minor bug fix
|
||||||
Qt/Win under the GPL. However, it is likely that a native port of LyX
|
release, especially for Windows users. Large chunks of the code base
|
||||||
to Windows will be supported formally in the future, for two reasons:
|
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
|
Detailed installation instructions can be found in INSTALL.Win32 for
|
||||||
development. The Gtk libraries for Win32 are indeed released under
|
those who wish to compile LyX for themselves. For the rest of us,
|
||||||
the GPL.
|
LyX/Win comes with its own installer, so installation should be pretty
|
||||||
|
straightforward. As always, more detailed help can be found on the
|
||||||
* Some success has been reported compiling LyX on Win32 using the
|
wiki at http://wiki.lyx.org/Windows.
|
||||||
GPL-ed port of qt/x11 to Win32 by the kde-cygwin project. See
|
|
||||||
http://kde-cygwin.sourceforge.net/qt3-win32/index.php
|
|
||||||
|
Loading…
Reference in New Issue
Block a user