X-Git-Url: https://git.lyx.org/gitweb/?a=blobdiff_plain;ds=sidebyside;f=INSTALL.scons;h=482cf90e798e1b0aa78c1254f0cf38dc61a7ef7a;hb=3ef684e752bb5afdbfdea51d4c3df4afe1461916;hp=f3f4a22f51b47ba4ed095a466b4d786c7f3fa972;hpb=c8c3f0ed11d4a0faaec7fdb3f87c80d92152541a;p=lyx.git diff --git a/INSTALL.scons b/INSTALL.scons index f3f4a22f51..482cf90e79 100644 --- a/INSTALL.scons +++ b/INSTALL.scons @@ -11,7 +11,7 @@ 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 @@ -19,9 +19,8 @@ This file is organized as follows: 3. Windows/mingw 4. Windows/cygwin 5. Windows/msvc -6. Other versions of lyx (1.4.x) -7. Tips and hints -8. Troubleshooting +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 @@ -246,7 +245,7 @@ extra_inc_path etc is needed. ================= 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 the qt3 library in the +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. @@ -255,8 +254,8 @@ 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 gzip libiconv qt3-bin - aspell-dev jpeg libpng qt3-devel + aspell gzip libiconv qt4-bin + aspell-dev jpeg libpng qt4-devel gcc libintl libpng2 gettext libintl1 jpeg gettext-devel libintl2 python @@ -268,10 +267,10 @@ To build lyx for cygwin, you should * 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 @@ -291,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 @@ -317,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 @@ -341,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: