X-Git-Url: https://git.lyx.org/gitweb/?a=blobdiff_plain;f=INSTALL;h=13af00e815320cb33e4487777b604e670dc811c8;hb=8a58460189b6facf7d067db546edc607ab22f56d;hp=f2d6eb2cb7c825e4e07abbfeeadd830728a3230c;hpb=d9807f7423616a771817d9de11d585ce8bab0196;p=lyx.git diff --git a/INSTALL b/INSTALL index f2d6eb2cb7..13af00e815 100644 --- a/INSTALL +++ b/INSTALL @@ -122,15 +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-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-two-colors=[yes|no] that forces LyX to use two colors pixmaps - (bitmaps) instead of the full-colored standard ones. Defaults to no. - - + o --with-version-suffix will install LyX as lyx-, e.g. lyx-1.2.0 + The LyX data directory will be something like /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: @@ -251,17 +251,35 @@ the source code directory. After you have installed LyX for one architecture, use `make distclean' before reconfiguring for another architecture. -Stripping LyX -------------- +Preparing a binary distribution for the use of others +------------------------------------------------------ + + o Compile LyX with the right compiler switches for your + architecture. In particular you might want to ensure that + libraries like xforms and xpm are statically linked. To this end, + you can use a command like -A LyX binary for linux is about 1M when compiled without debug-information -and with dynamic libraries. If yours is much bigger you probably compiled -it with debug-informations (-g). If you don't want to debug LyX just enter + make LYX_LIBS='/foo/libforms.a /bar/libXpm.a' - strip src/lyx + Moreover, make sure you use the --without-latex-config switch + of configure, since others might not be interested by your + configuration :-) -before installing. Note that this is done automatically for public -versions. + o Create a file README.bin describing your distribution and + referring to *you* if problems arise. As a model, you can use the + file development/tools/README.bin.example, which can be a good + starting point. + + o Type `make bindist'. This will create a file + lyx-1.xx.yy-bin.tar.gz. Rename it to reflect you architecture + and the peculiarities of your build (e.g. static vs. dynamic). + + o Check that everything is correct by unpacking the distribution + in some private place and running it. In particular, check the + output of `ldd lyx' to know which libraries are really needed. + + o Upload your binary file to ftp.devel.lyx.org:/pub/incoming, and + notify larsbj@lyx.org. Problems @@ -276,42 +294,57 @@ 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). - o If you have GNU gettext installed on your system (e.g. on linux), - you will get tons of warnings like: + - 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. - bullet_forms.C:101: warning: passing `char *' to argument 1 of - `__builtin_constant_p(int)' lacks a cast + o if you get an error message when compiling LyX that looks like this : - 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. + ../../src/minibuffer.h:17: using directive `Object' introduced + ambiguous type `_ObjectRec *' - o It is possible to compile lyx with Digital Unix cxx compiler - version 6.1 (and presumably compaq C++ 6.2 on both Tru64 unix and - linux/alpha, when this will be available), provided one uses - CXX=cxx - CXXFLAGS='-ptr /tmp/lyx_cxx_repository -std strict_ansi -g -O' + then you need to upgrade the version of the xforms library you have + installed. + + o If you are using RedHat 7.0 and the option --with-frontend=kde, you + will need to configure LyX as follows : + + export QTDIR=/usr/lib/qt-1.45 + export CC="egcs -L/usr/lib" + export CXX="egcs++ -L/usr/lib" + ./configure --with-frontend=kde + + 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 -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 Jean-Marc.Lasgouttes@inria.fr for a workaround. - o On Digital Unix with cxx, you may have a compilation error in + 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). 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 in gettext. To solve this, you can either (1) configure with --with-included-gettext or (2) add -D__STDC__ to cxx flags. - o The configure script seems to hang while it is checking the LaTeX setup. - We think that this is not a real problem, but rather a symptom of the - fact that the ec-fonts are being rendered. This process can take quite - some time, so the remedy is simply to have patience. (The fonts need to - be rendered at some point to be usable anyways.) - o According to John Collins , on SunOS 4.1.3 you may find two sets of X libraries, and they are of course incompatible :-) One is the set provided as part of OpenWindows, and one is the standard @@ -336,14 +369,6 @@ notify us. The option --without-liberty disable the detection of -liberty. It is meant for debugging purpose only. - o There are several known bugs in gcc 2.7.xx that cause compiler - errors. This is in particular the case in spellchecker.C under - HP-UX 9.05 (ask Bernhard Iselborn for - more comments) and in lyxrc.C under Linux/Alpha or DEC OSF/1. In - both cases, the solution is to recompile the offending file - without optimization and resume the compilation process with - 'make'. - o According to David Sundqvist , some changes are needed to compile with aCC on HP-UX 10.20. These are the relevant changes in the makefile (with comments tagged on):