Scons: update INSTALL.scons according to Abdel's recommended links.

git-svn-id: svn://svn.lyx.org/lyx/lyx-devel/trunk@14113 a592a061-630c-0410-9148-cb99ea01b6c8
This commit is contained in:
Bo Peng 2006-06-14 20:10:36 +00:00
parent 20802b7c9b
commit b8f8bdfb69

View File

@ -13,7 +13,7 @@ either. Because of these, a scons (http://www.scons.org) build system has
been set up as an alternative way to build lyx. As of writing, this system
only supports qt3 and qt4 frontends.
This README file is organized as follows:
This file is organized as follows:
1. General usage of scons
2. *nix systems (Linux, Solaris and Mac OSX)
3. Windows/mingw
@ -104,9 +104,10 @@ Convenience options:
* fast_start=yes/no: if true, bypass initial configuration step and use
existing src/config.h
* load_option=yes/no: if true, load previously saved command line
options so you can run 'scons install' directly after a long
'scons all' building command.
* load_option=yes/no/opt1,opt2/-opt1,opt2: if true, load previously saved
command line options so you can run 'scons install' directly after a
long 'scons all' building command. You can load selected options using
load_option=opt1,opt2,... or exclude options using the - version of it.
* rebuild=target1,target2... By default, scons will exam all components
when you build lyx. You can free scons from some hard work and save
yourself some time by telling scons to rebuild only specified
@ -121,10 +122,13 @@ Installation options:
Default to $prefix/bin
* dest_dir: if specified, install to this directory instead of $prefix.
Compiler choice and flags:
* use_vc: use msvc instead of mingw g++ under windows
* CC, LINK, CPP, CXX, CCFLAGS, LDFLAGS etc: compiler commands and
flags. They can be set as environment variables as well.
* optimization: optimization flag to use (e.g. -O2)
* CC, LINK, CPP, CXX, CCFLAGS, LINKFLAGS etc: compiler commands and
flags. Setting CCFLAGS etc will replace default flags. These variables
can be set as environment variables as well.
Targets:
@ -148,11 +152,11 @@ directory structure is:
$build_dir
- common: most of the intermediate files, mostly object files
- libs: all static libraries
- qt3/qt4: lyx built with the frontend
- qt3 etc: lyx executable built with the frontend
- executables: lyxclient, tex2lyx, lyx
MSVS projects will be put to development/scons (and you should invoke
scons from there for this target).
MSVS projects will be put to development/scons (and you should invoke
scons from there for this target).
A typical working sequence:
@ -160,7 +164,7 @@ A typical working sequence:
> cd development/scons
> scons frontend=qt4 qt_dir=/path/to/qt4
(build lyx, and all necessary libraries...)
(build lyx, and all needed libraries...)
> scons all -j3
(build lyx, client and tex2lyx, options like qt_dir will be carried
over here)
@ -174,7 +178,6 @@ A typical working sequence:
(lyx is built for /usr/site, but install to /install/dir)
2. *nix systems (Linux, Solaris and Mac OSX)
============================================
@ -186,7 +189,6 @@ problems.
================
* install mingw with the following packages:
FIXME: we only need gcc/g++ and win32 api.
binutils-2.16.91-...tar.gz
gcc-core-3.4.5-...tar.gz
gcc-g++-3.4.5-...tar.gz
@ -194,33 +196,40 @@ problems.
mingw-utils-0.3.tar.gz
MSYS-1.0.11-...exe
msysDTK-1.0.1.exe
msys-libtool-1.5.tar.bz2
w32api-3.6.tar.g
* install the latest Qt official "open source" binary package for
Windows/Mingw
Windows/Mingw (required)
* install iconv (libiconv):
Download the windows binary (libiconv-x.x.x.bin.woe32.zip) of iconv
from one of the GNU mirrors listed in http://www.gnu.org/prep/ftp.html.
You may also try gnuwin32/libiconv from
http://gnuwin32.sourceforge.net/packages/libiconv.htm
* install gettext (libintl):
Download the windows binary (gettext-runtime-x.x.x.bin.woe32.zip and
gettext-tools-x.x.x.bin.woe32.zip) from one of the GNU mirrors
(e.g. http://mirrors.usc.edu/pub/gnu/gettext/) and decompress.
You may also try gnuwin32/libintl from
http://gnuwin32.sourceforge.net/packages/libintl.htm
* install mingw/zlib:
* install mingw/zlib (required):
Download zlib binaries and developer files (zlib-1.2.3-bin.zip and
zlib-1.2.3-lib.zip) from http://gnuwin32.sourceforge.net/packages/zlib.htm .
* aspell: this is difficult. Everybody has his own compiled library.
Mine is in D:\program\Aspell-0.60.4.
* install iconv (optional):
Download libiconv from http://gnuwin32.sourceforge.net/packages/libiconv.htm
The complete package (without source) is recommended.
You may also try the windows binary (libiconv-x.x.x.bin.woe32.zip) of
iconv from one of the GNU mirrors listed in http://www.gnu.org/prep/ftp.html.
* install gettext (optional):
Download gettext from http://gnuwin32.sourceforge.net/packages/gettext.htm
The complete package (without source) is recommended.
You may also try the windows binary (gettext-runtime-x.x.x.bin.woe32.zip
and gettext-tools-x.x.x.bin.woe32.zip) from one of the GNU mirrors
(e.g. http://mirrors.usc.edu/pub/gnu/gettext/).
* install aspell (optional):
LyX uses aspell 0.60.4 and there is no, as of now, official windows
version. If you do not want to compile aspell from source by yourself,
your best bet is using Abdel's lyx 1.5.0svn experimental package located
at http://wiki.lyx.org/Windows/LyX150Experimental. The link to his
pre-built aspell package is http://younes.a.free.fr/Lyx-15-experimental
* install aiksaurus (optional):
Try to build aiksaurus from source (both mingw or msvc should work),
or look for pre-built package from the lyx 1.5.0svn experimental page.
* Open a mingw xterm, and start scons as usual.
@ -275,23 +284,8 @@ To build lyx with msvc, you should
* download and install the official zlib library from www.zlib.org.
* install iconv (libiconv):
Download the windows binary (libiconv-x.x.x.bin.woe32.zip) of iconv
from one of the GNU mirrors listed in http://www.gnu.org/prep/ftp.html.
You may also try gnuwin32/libiconv from
http://gnuwin32.sourceforge.net/packages/libiconv.htm
* install gettext (libintl):
Download the windows binary (gettext-runtime-x.x.x.bin.woe32.zip and
gettext-tools-x.x.x.bin.woe32.zip) from one of the GNU mirrors
(e.g. http://mirrors.usc.edu/pub/gnu/gettext/) and decompress.
You may also try gnuwin32/libintl from
http://gnuwin32.sourceforge.net/packages/libintl.htm
* set up other optional libraries like aspell (following mingw
instructions)
* optionally install iconv, gettext, aspell, aiksaurus following
the mingw instructions.
* start from msvc command prompt, use the use_vc option to build lyx.
You may need to use extra_inc_path etc to point to zlib paths.