Give an error message when path to file contains spaces.

[lyx.git] / INSTALL

diff --git a/INSTALL b/INSTALL
index ad7aeb2d7a4509f877a9f4c79ac99b93cab70963..13af00e815320cb33e4487777b604e670dc811c8 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -122,12 +122,15 @@ flags:
        --with-extra-lib=DIRECTORY/lib --with-extra-inc=DIRECTORY/include
     If DIRECTORY is not specified, the current prefix is used.
 
        --with-extra-lib=DIRECTORY/lib --with-extra-inc=DIRECTORY/include
     If DIRECTORY is not specified, the current prefix is used.
 

-  o --with-lyxname=STRING sets the name of the installed LyX binary and 
-    of the LyX library directory to STRING. This may be used to
-    compile lyx as lyx-1.1 and avoid clashes with earlier/later
-    versions. Default is "lyx". 
-
-
+  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:
 
 There are also flags to control the internationalization support in
 LyX:
 


@@ -291,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.  
 
     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
 
   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
 
     Note that this will not work when compiling directly from the cvs
     repository, due to the tricks used by automake for dependencies. Ask


@@ -317,7 +337,8 @@ notify us.
 
   o On Tru64 Unix, you may have to compile with
     --with-included-string to work around a Tru64 linker limitation
 
   o On Tru64 Unix, you may have to compile with
     --with-included-string to work around a Tru64 linker limitation

-    (the STL string template creates names which may be too long).
+    (the STL string template creates names which may be too long). We
+    also had reports that it helps with gcc 2.95.2 on solaris 2.6. 

 
   o On Tru64 Unix with cxx, you may have a compilation error in
     lyx_main.C if you have GNU gettext installed. This is due to a bug
 
   o On Tru64 Unix with cxx, you may have a compilation error in
     lyx_main.C if you have GNU gettext installed. This is due to a bug