Give an error message when path to file contains spaces.

[lyx.git] / INSTALL

diff --git a/INSTALL b/INSTALL
index 2f84382e0d0327bcbf380b0dfb5f49838074722a..13af00e815320cb33e4487777b604e670dc811c8 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -122,14 +122,15 @@ flags:
        --with-extra-lib=DIRECTORY/lib --with-extra-inc=DIRECTORY/include
     If DIRECTORY is not specified, the current prefix is used.
 
-  o --with-lyx-suffix=STRING adds the given suffix to the names of the 
-    LyX binary and scripts, and the library directory. For example,
-    "--with-lyx-suffix=1.1.6" would install a binary "lyx-1.1.6", and
-    create a directory "/usr/share/lyx-1.1.6", install "reLyX-1.1.6" etc.
-    Additionally, LyX will look for the user configuration file in e.g.
-    "$HOME/.lyx-1.1.6". This feature is useful for installing more than
-    one version of LyX on the same machine.
-
+  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/.
+    Additionally your user configuration files will be found in e.g.
+    $HOME/.lyx-1.2.0
+
+    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
+ 
 There are also flags to control the internationalization support in
 LyX:
 
@@ -293,25 +294,42 @@ notify us.
     the xforms or Xpm library, use the --with-extra-lib and --with-extra-inc 
     options of configure to specify where these libraries reside.  
 
-  o Configure will seemingly fail to find xpm.h and forms.h on linux if
-    you did a 'make mrproper' in the kernel directory, because this
-    removes some symbolic links that are needed for compilation. A 'make
-    symlinks' in linux kernel sources fixes that.
+  o Configure will seemingly fail to find xpm.h and forms.h on linux
+    if the kernel headers are not available. Two cases are possible: 
+
+      - you have not installed the kernel sources. Then you should
+        install them or at least the kernel-headers package (or
+        whatever it is called in your distribution).
+
+      - you have the sources, but you did a 'make mrproper' in the
+       kernel directory (this  this removes some symbolic links that
+       are needed for compilation). A 'make symlinks' in linux kernel
+       sources fixes that. 
+
+  o if you get an error message when compiling LyX that looks like this :
+
+    ../../src/minibuffer.h:17: using directive `Object' introduced
+    ambiguous type `_ObjectRec *'
+
+    then you need to upgrade the version of the xforms library you have
+    installed.
 
-  o If you have GNU gettext installed on your system (e.g. on linux),
-    you will get tons of warnings like:
+  o If you are using RedHat 7.0 and the option --with-frontend=kde, you
+    will need to configure LyX as follows :
 
-    bullet_forms.C:101: warning: passing `char *' to argument 1 of
-    `__builtin_constant_p(int)' lacks a cast
+       export QTDIR=/usr/lib/qt-1.45
+       export CC="egcs -L/usr/lib"
+       export CXX="egcs++ -L/usr/lib"
+       ./configure --with-frontend=kde 
 
-    These are in harmless warnings caused by a bug in libintl.h, but
-    will be solved if you use --with-included-gettext when configuring
-    LyX.
+    If you your version of gcc-c++ is > 2.96-69, you may not need to do
+    this.
 
   o It is possible to compile lyx with Tru64 Unix cxx compiler
     version 6.2, provided one uses
-       CXX=cxx
-       CXXFLAGS='-ptr /tmp/lyx_cxx_repository -std strict_ansi -g -O'
+       CXX='cxx -std strict_ansi'
+       CXXFLAGS='-ptr /tmp/lyx_cxx_repository -g'
+       CC=cc
 
     Note that this will not work when compiling directly from the cvs
     repository, due to the tricks used by automake for dependencies. Ask