X-Git-Url: https://git.lyx.org/gitweb/?a=blobdiff_plain;f=INSTALL;h=57a46650d0da9190625b5b4c7237671aeeec6c7f;hb=2ffd130d2bc4b594ab64327479ace742f119b5ae;hp=51b55148d3a8bb41b5933ba34424fc4dbc9c1272;hpb=8d66bb07c496b6a882bfa4dc6b66a7dbe2394916;p=lyx.git diff --git a/INSTALL b/INSTALL index 51b55148d3..57a46650d0 100644 --- a/INSTALL +++ b/INSTALL @@ -9,14 +9,16 @@ These four steps will compile, test and install LyX: 0) Linux users beware: You need qt4 and qt4-devel packages of the same version to compile LyX. - 1) ./configure - configures LyX according to your system. - You may have to set - --with-qt4-dir= - if the environment variable QTDIR is not set (for example, - '--with-qt4-dir=/usr/share/qt4/'). Alternatively, you could - install pkgconfig (the name might vary depending on your - distribution). + In general, it is also recommended to have pkg-config + installed (the name might vary depending on your + distribution). + + 1) ./configure configures LyX according to your system. You + may have to set --with-qt4-dir= + (for example, "--with-qt4-dir=/usr/share/qt4/") if the + environment variable QTDIR is not set and pkg-config is not + available. + See Note below if ./configure script is not present. 2) make @@ -30,15 +32,15 @@ These four steps will compile, test and install LyX: if you want a smaller binary. -Note for Subversion (SVN) checkouts +Note for Git checkouts ----------------------------- -If you have checked this out from Subversion, you need to have: +If you have checked this out from Git, you need to have: * automake >= 1.8 * autoconf >= 2.59c -* gettext >= 0.12 +* gettext >= 0.16.1 Then type "./autogen.sh" to build the needed configuration -files and proceed as stated below. +files and proceed as stated above/below. You will also probably need GNU m4 (perhaps installed as gm4). @@ -53,21 +55,15 @@ LyX 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. -LyX has been tested with all Qt versions since Qt 4.4.0. For compilation -you need to compile against at least Qt 4.4.0. The only special point to -make is that you must ensure that both LyX and the Qt libraries are -compiled with the same C++ compiler. +For full LyX usability we suggest to use at least Qt 4.8 which has been +widely tested. For compilation you need to compile against at least +Qt 4.5.0. The only special 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-xft-fonts package (at ftp://ftp.lyx.org/pub/lyx/contrib/) to get -maths symbols displayed properly. To find out, type: +To build LyX with spell checking capabilities included you have to +install at least one of the development packages of the spell checker +libraries. See the RELEASE-NOTES for details. - ldd `which lyx` | grep fontconfig - -at the console. Most recent distributions are known to use fontconfig. - -If, however, your version of Qt does not use fontconfig, then TeX -fonts should be added to the font path. 'man xset' is your friend. * Other things to note @@ -83,9 +79,11 @@ The two following programs should be available at configuration time: as. Otherwise, LyX will not be able to run a number of tests. Note that users can run these tests manually with Tools>Reconfigure. - o Python 2.3 or newer installed to be able to import older LyX files + o Python 2.4 or newer must be installed. Python is used for many + simple tasks that are executed by external scripts, such as the + automatic configuration step and the import of older LyX documents with the lyx2lyx script (this script is called automatically when - opening a file). + opening a file). Python 3.0 or later is not supported. Creating the Makefile @@ -98,25 +96,26 @@ to create the Makefile by typing ./configure -For more complicated cases, LyX configure takes the following specific +For more complicated cases, LyX configure honors the following specific flags: - o --enable-build-type=[rel(ease), dev(elopment), pre(release)] + o --enable-build-type=[rel(ease), pre(release), dev(elopment), prof(iling), gprof] allows to tweak the compiled code. The following table describes the settings in terms of various options that are described later - release prerelease development - optimization -O2 -O2 -O + release prerelease development profiling gprof + optimization -O2 -O2 -O -O2 -O2 assertions X X stdlib-debug X concept-checks X X warnings X X - debug X X + debug X X X X + gprof X The default are as follows in terms of version number release: stable release (1.x.y) prerelease: version number contains alpha, beta, rc or pre. - development: version number contains svn. + development: version number contains dev. o --with-extra-lib=DIRECTORY that specifies the path where LyX will find extra libraries (qt4) it needs. Defaults to NONE @@ -140,7 +139,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 : - ./configure --with-version-suffix=-latestsvn + ./configure --with-version-suffix=-latestdev Note that the standard configure options --program-prefix, --program-suffix and the others will not affect the shared LyX @@ -206,7 +205,7 @@ this file. The following options allow to tweak more precisely the generated code: - o --enable-profiling instruments the code for use with the gprof + o --enable-gprof instruments the code for use with the gprof profiler. The result are only meaningful in conjunction with --enable-build-type=release.