These four steps will compile, test and install LyX:
0) Linux users beware: if compiling the Qt frontend, you need
- qt and qt-devel packages of the same version to compile LyX.
+ qt and qt-devel packages of the same version to compile LyX.
1) ./configure
configures LyX to your system. By default, LyX configures
the xforms frontend, use --with-frontend=qt to build a Qt
- version. You may have to set
- --with-qt-dir=<path-to-your-qt-installation> to succeed.
+ version. You may have to set
+ --with-qt-dir=<path-to-your-qt-installation>
+ if the environment variable QTDIR is not set.
2) make
compiles the program.
Note for CVS checkouts
----------------------
-If you have checked this out from CVS, you need to have
-automake, autoconf, and gettext installed. Then,
-type "./autogen.sh" to build the needed configuration
+If you have checked this out from CVS, you need to have:
+* automake >= 1.5
+* autoconf >= 2.52
+* gettext >= 0.12
+Then type "./autogen.sh" to build the needed configuration
files and proceed as stated below.
You will also probably need GNU m4 (perhaps installed as gm4).
First of all, you will also need a recent C++ compiler, where recent
means that the compilers are close to C++ standard conforming.
-Compilers that are known to compile LyX are egcs 1.1.x, gcc 2.95.x and
-later, and Digital C++ version 6.1 and later. Please tell us your
-experience with other compilers. It is _not_ possible to compile LyX
-with gcc 2.7.x and 2.8.x, and this is not likely to change in the
-future.
+Compilers that are known to compile LyX are gcc 2.95.x and later
+and Digital C++ version 6.1 and later. Please tell us your experience
+with other compilers.
-Note that, contrary to LyX 1.0.x, LyX 1.3.x makes great use of C++
-Standard Template Library (STL); this means that gcc users will have
-to install the relevant libstdc++ library to be able to compile this
-version.
+It is _not_ possible to compile LyX with gcc 2.7.x and 2.8.x.
+
+LyX 1.4.x makes great use of C++ Standard Template Library (STL).
+This means that gcc users will have to install the relevant libstdc++
+library to be able to compile this version of LyX. Users of gcc 2.95.x
+will have to install the STLPort version of these libraries as the
+ones that come with gcc 2.95.x are too broken for us to use.
* xforms frontend
at the console. Both RH8 and Debian unstable distributions are known
to use fontconfig.
-If, however, your version of Qt does not use fontconfig, then the
-/usr/local/share/lyx/xfonts directory (or equivalent) should be added to
-the font path. This is done automatically by LyX if LyX is run on
-the local machine, and the X server supports Postscript fonts. If, however,
-you're running LyX remotely, then you'll have to do this step yourself.
-'man xset' is your friend.
+If, however, your version of Qt does not use fontconfig, then TeX
+fonts should be added to the font path. 'man xset' is your friend.
* Other things to note
The two following programs should be available at configuration time:
- o Perl (at least 5.002) is needed for the reLyX script. reLyX will
- not be installed if perl is not found. If the environment
- variable PERL is set to point to some program, this value will be
- used, even if the program does no exist (this can be useful if
- the machine on which LyX is built is not the one where it will
- run).
-
o LaTeX2e should be correctly setup for the user you are logged in
as. Otherwise, LyX will not be able to run a number of tests. Note
that users can run these tests manually with Edit>Reconfigure.
-Finally, you will need to have python 1.5.2 or newer installed to be
-able to import older LyX files with the lyx2lyx script (this script is
-called automatically when opening a file).
+ o Python 1.5.2 or newer installed to be able to import older LyX files
+ with the lyx2lyx script (this script is called automatically when
+ opening a file).
Creating the Makefile
You can use this feature to install more than one version of LyX
on the same system. You can optionally specify a "version" of your
- own, by doing something like :
+ own, by doing something like :
./configure --with-version-suffix=-latestcvs
Note that the standard configure options --program-prefix,
o --mandir=DIRECTORY gives the directory where the man pages will go.
[defaults to ${prefix}/man]
- o --enable-mainainer-mode enables some code that automatically
+ o --enable-maintainer-mode enables some code that automatically
rebuilds the configure script, makefiles templates and other useful
- files when needed. This is off by default, to avoid surprises.
+ files when needed. This is off by default on releases, to avoid
+ surprises.
Note that the --with-extra-* commands are not really robust when it
comes to use of relative paths. If you really want to use a relative path
then you need to upgrade the version of the xforms library you have
installed.
- o On solaris 2.6, you may have to compile with --with-included-string
- if compiling with gcc 2.95.2.
-
o On SUN Sparc Solaris 8, you need gnumake. The LyX makefiles do not
work with Solaris make.
projects / lyx.git / blobdiff