X-Git-Url: https://git.lyx.org/gitweb/?a=blobdiff_plain;f=INSTALL.scons;h=482cf90e798e1b0aa78c1254f0cf38dc61a7ef7a;hb=6e7c76fe4f2b5525abdf36fd89520e32984cfdf7;hp=8554a833d719e8a3a8498c763346bb37456fc2fa;hpb=a54d3e83bdf9f3be3b1466c63ac6036bce0d0275;p=lyx.git diff --git a/INSTALL.scons b/INSTALL.scons index 8554a833d7..482cf90e79 100644 --- a/INSTALL.scons +++ b/INSTALL.scons @@ -2,7 +2,7 @@ Building LyX with SCons ========================= -June, 2006 +July, 2006 The GNU Build System (autoconf, automake and make) has been used to build @@ -11,17 +11,16 @@ widely supported on the *nix systems, but not so under windows. They are not necessarily easy to use and maintain (at least to non-m4 experts) either. Because of these, a scons (http://www.scons.org) build system has been set up as an alternative way to build lyx. As of writing, this system -only supports qt3 and qt4 frontends. +only supports the qt4 frontend. This file is organized as follows: 1. General usage of scons 2. *nix systems (Linux, Solaris and Mac OSX) 3. Windows/mingw 4. Windows/cygwin -5. windows/msvc -6. Other versions of lyx (1.4.x) -7. Tips and hints -8. Troubleshooting +5. Windows/msvc +6. Tips and hints +7. Troubleshooting 1. General usage of scons @@ -44,7 +43,7 @@ Prerequisites: in the near future. * Other libraries: - These include zlib (required), qt3 or qt4 (required), gettext + These include zlib (required), qt4 (required), gettext (optional), boost (optional), aspell (optional) and Aiksaurus (optional). Please refer to the system-specific sections regarding the availability and installation of them. @@ -78,9 +77,7 @@ command 'scons -h'. Components to use/build: - * frontend=qt3/qt4: qt3 is the default for all *nix systems including - windows cygwin. qt4 is the default for windows/mingw and windows/ - msvc. xform and gtk are not currently supported. + * frontend=qt4: qt4 is the only option right now. * mode=debug/release: lyx will be built under the debug or release directory, with different default build options. * boost=included/system/auto: whether or not use included boost, system @@ -116,7 +113,7 @@ Convenience options: * rebuild=target1,target2... By default, scons will exam all components when you build lyx. You can free scons from some hard work and save yourself some time by telling scons to rebuild only specified - component(s). + component(s). rebuild=no, none, yes or all can be used as well. * log_file: a log file of executed commands, default to scons_lyx.log @@ -126,6 +123,8 @@ Installation options: * exec_dir: directory where lyx binaries will be installed. Default to $prefix/bin * dest_dir: if specified, install to this directory instead of $prefix. + * version_suffix=yes/no/something : if specified, this suffix will be + appended to the user data directory. Compiler choice and flags: @@ -143,7 +142,7 @@ You can specify one or more of the following targets: Static libraries (names correspond to their directories): boost, intl, support, mathed, insets, frontends, graphics, - controllers, client, qt3, qt4, lyxbase + controllers, client, qt4, lyxbase Programs: tex2lyx, client, lyx, all = tex2lyx + client + lyx Installation: @@ -157,7 +156,7 @@ directory structure is: $build_dir - common: most of the intermediate files, mostly object files - libs: all static libraries - - qt3 etc: lyx executable built with the frontend + - qt4 etc: lyx executable built with the frontend - executables: lyxclient, tex2lyx, lyx MSVS projects will be put to development/scons (and you should invoke @@ -245,30 +244,33 @@ extra_inc_path etc is needed. 4. Windows/cygwin ================= -LyX should be easy to compile, but the qt3 library in the cygwin -distribution does not work with the current cygwin dll (version 1.5.19-4 -as of June 2006) due to broken threading support. You should either wait -for the forthcoming 1.5.20 version or install a recent snapshot from -http://cygwin.com/snapshots. +LyX should be easy to compile, but you must use the most recent cygwin +dll (version 1.5.20-1 as of July 2006) because qt library in older +cygwin distribution does not work with previous versions due to broken +threading support. To build lyx for cygwin, you should * install (using the cygwin setup program) at least the following packages and all other packages pulled in by dependencies: - aspell grep libintl1 qt3-bin tar - coreutils jbigkit libintl2 qt3-devel libiconv - diffutils jpeg libpng python - gettext libintl libpng2 sed + aspell gzip libiconv qt4-bin + aspell-dev jpeg libpng qt4-devel + gcc libintl libpng2 + gettext libintl1 jpeg + gettext-devel libintl2 python + + * install aiksaurus (http://aiksaurus.sourceforge.net/, optional): + There is no cygwin package for aiksaurus, so you should build it from + source. However, aiksaurus builds smoothly on cygwin. * run scons as you would do under linux. Note: cygwin/qt does not follow the usual $qt_dir/include, $qt_dir/bin, -$qt_dir/lib directory structure. For example, cygwin/qt3 uses directories -/usr/include/qt3, /usr/lib/qt3/bin and /usr/lib/qt3/lib. If these +$qt_dir/lib directory structure. For example, cygwin/qt4 uses directories +/usr/include/qt4, /usr/lib/qt4/bin and /usr/lib/qt4/lib. If these directories can not be detected automatically, use options, for example, - qt_dir=/usr/lib/qt3 qt_inc_path=/usr/include/qt3 - + qt_dir=/usr/lib/qt4 qt_inc_path=/usr/include/qt4 5. Windows/msvc @@ -288,7 +290,7 @@ To build lyx with msvc, you should directories in VCProjectEngine.dll.express.config, as suggested in http://msdn.microsoft.com/vstudio/express/visualc/usingpsdk/. - * build qt4 + * build qt4 - download qt4 source from trolltech (not the binary version, which only works with mingw) - get q../free patch for qt4 @@ -314,22 +316,7 @@ To build lyx with msvc, you should - To use the msvc debugger, you have to use mode=debug (default). -6. Other versions of lyx (1.4.x) -================================ - -The scons build system is not yet distributed with lyx1.4.x. Support for -the qt2 frontend of lyx1.4.x is, however, added to the trunk (1.5.x). If -you have checked out both 1.4.x and the trunk, you can build lyx 1.4.x -using commands similar to - - > cd lyx-1.4.x - > scons -f ../lyx-1.5.x/development/scons/SConstruct - -Note that lyx 1.4.x does not use the latest version of the boost library -so option boost=included is recommended. - - -7. Tips and hints +6. Tips and hints ================= * Using external boost libraries (install boost libraries and use @@ -338,7 +325,7 @@ so option boost=included is recommended. not be included in the dependency tree. -8. Troubleshooting +7. Troubleshooting ================== When you get an error: