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
are compiled with the same C++ compiler.
Note that if Qt is using Xft2/fontconfig, you may need to install the
-latex-ttf-fonts package (available on ftp://ftp.lyx.org/) to get maths
-symbols displayed properly. To find out, type:
+latex-xft-fonts package (at ftp://ftp.lyx.org/pub/lyx/contrib/) to get
+maths symbols displayed properly. To find out, type:
+
ldd `which lyx` | grep fontconfig
+
at the console. Both RH8 and Debian unstable distributions are known
to use fontconfig.
To use the thesaurus, you will need to install libAikSaurus, available
from:
- http://aiken.clan11.com/aiksaurus/
+ http://aiksaurus.sourceforge.net/
The two following programs should be available at configuration time:
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.
+
+ The Solaris ar seg-faults trying to build the insets library. You
+ will need to use the ar from the GNU binutils for this subdirectory.
o LyX can be compiled on Tru64 Unix with either GNU's gcc or the default
Compaq cxx compiler.