]> git.lyx.org Git - lyx.git/blobdiff - INSTALL
Conditionally #include headers.
[lyx.git] / INSTALL
diff --git a/INSTALL b/INSTALL
index 61e7e1f7d4769deddffb6643394a510bac49dad4..6a4bd0fbbbfe95fa6e5b05748a10cd9b129c8cdc 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -6,8 +6,14 @@ 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.
+
        1) ./configure
-          configures LyX to your system.
+          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.
 
        2) make
           compiles the program.
@@ -41,7 +47,7 @@ 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.
 
-Note that, contrary to LyX 1.0.x, LyX 1.2.x makes great use of C++
+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.
@@ -57,7 +63,7 @@ This version has been released under the LGPL (Lesser General Public
 License), and the availability of the source means that many bugs that
 have been plaguing LyX have been fixed in xforms. You are advised to
 upgrade to xforms 1.0 to enjoy all these new fixes.
-In fact, LyX 1.3.0 no longer supports versions of xforms older than 0.89.5.
+In fact, LyX 1.3.x no longer supports versions of xforms older than 0.89.5.
 
 You can get the source from
        http://world.std.com/~xforms/
@@ -78,9 +84,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, tobe found 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.
 
@@ -104,7 +112,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:
 
@@ -137,10 +145,14 @@ to create the Makefile by typing
 For more complicated cases, LyX configure takes the following specific
 flags:
 
-  o --with-extra-lib=DIRECTORY that specifies the path where LyX will find
-    extra libraries (Xpm, xforms) it needs.  Defaults to NONE (i.e. search
-    in standard places).  You can specify several directories, separated
-    by colons.
+  o --with-frontend=FRONTEND that allows to specify which frontend you
+    want to use. Default is "xforms", and the other possible value is
+    "qt".
+
+  o --with-extra-lib=DIRECTORY that specifies the path where LyX will
+    find extra libraries (Xpm, xforms, qt) it needs. Defaults to NONE
+    (i.e. search in standard places). You can specify several
+    directories, separated by colons.
 
   o --with-extra-inc=DIRECTORY that gives the place where LyX will find
     xforms headers.  Defaults to NONE (i.e.  search in standard places).
@@ -150,18 +162,20 @@ flags:
        --with-extra-lib=DIRECTORY/lib --with-extra-inc=DIRECTORY/include
     If DIRECTORY is not specified, the current prefix is used.
 
-  o --with-version-suffix will install LyX as lyx-<version>, e.g. lyx-1.2.0
-    The LyX data directory will be something like <whatever>/lyx-1.2.0/.
+  o --with-version-suffix will install LyX as lyx-<version>, e.g. lyx-1.3.1
+    The LyX data directory will be something like <whatever>/lyx-1.3.1/.
     Additionally your user configuration files will be found in e.g.
-    $HOME/.lyx-1.2.0
+    $HOME/.lyx-1.3.1
 
-    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 : ./configure --with-version-suffix=-latestcvs
+    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 :
+       ./configure --with-version-suffix=-latestcvs
 
-    Note that the standard configure options --program-prefix,--program-suffix
-    and the others will not affect the shared LyX directory etc. so it
-    is recommended that you use --with-version-suffix (or --prefix) instead.
+    Note that the standard configure options --program-prefix,
+    --program-suffix and the others will not affect the shared LyX
+    directory etc. so it is recommended that you use --with-version-suffix
+    (or --prefix) instead.
 
   o --enable-optimization=VALUE enables you to set optimization to a
     higher level as the default (-O), for example --enable-optimization=-O3.
@@ -189,7 +203,7 @@ LyX:
     care.
 
   o You can also set the environment variable LINGUAS to a list of
-    language in case ou do not want to install all the translation
+    language in case you do not want to install all the translation
     files. For example, if you are only interested in German and
     Finnish, you can type (with sh or bash)
         export LINGUAS='de fi'
@@ -211,6 +225,11 @@ 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-maintainer-mode enables some code that automatically
+    rebuilds the configure script, makefiles templates and other useful
+    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
 here, you can prepend it with "`pwd`/".
@@ -348,8 +367,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.