]> git.lyx.org Git - lyx.git/blobdiff - INSTALL
two more kludges bite the dust
[lyx.git] / INSTALL
diff --git a/INSTALL b/INSTALL
index 2814f29657d890e5ce9322c314426c1c5ae1f300..a3d4db782ee5bda2b41a1e27a41feb7f221d3f6b 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -7,12 +7,12 @@ Quick compilation guide
 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 
+           version. You may have to set
            --with-qt-dir=<path-to-your-qt-installation> to succeed.
 
        2) make
@@ -29,9 +29,11 @@ These four steps will compile, test and install LyX:
 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).
@@ -41,16 +43,17 @@ Requirements
 
 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
 
@@ -84,9 +87,11 @@ point to make is that you must ensure that both LyX and the Qt libraries
 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.
 
@@ -110,7 +115,7 @@ much on it.
 
 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:
 
@@ -167,7 +172,7 @@ flags:
 
     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,
@@ -223,9 +228,10 @@ Moreover, the following generic configure flags may be useful:
   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
@@ -364,8 +370,11 @@ notify us.
     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.