X-Git-Url: https://git.lyx.org/gitweb/?a=blobdiff_plain;f=INSTALL.MacOSX;h=e84af755059c401e4799eeb0ccc55f29fd7c8614;hb=581b67b26e0cac98f2c83c035b483768875c5adc;hp=0aa370cf67b6c35ff54c106d3146ed152b3599be;hpb=9e4dae0bad2a48ad00cf48092af78ebce59a1707;p=lyx.git diff --git a/INSTALL.MacOSX b/INSTALL.MacOSX index 0aa370cf67..e84af75505 100644 --- a/INSTALL.MacOSX +++ b/INSTALL.MacOSX @@ -1,42 +1,103 @@ -Building LyX/Mac-1.4.0 +Building LyX/Mac-1.5 Ronald Florence -Modified by Bennett Helm +Modified by Bennett Helm , Anders +Ekberg and Jean-Marc Lasgouttes . LyX/Mac is built from the LyX source, the GPL-licensed Trolltech Qt/Mac library, and a custom application bundle. You will need the MacOSX development tools. The procedure described -here builds LyX linked with a static Qt library. If you are using the -tcsh shell, change the "export VAR=value" statements to -"setenv VAR value". +here builds LyX linked with a static Qt library. Also note that +building LyX/Mac requires gcc version 4.0 or higher. (You can check +your version by entering "gcc -v" in the Terminal; you can change +your gcc version to version 4.0, for example, by entering +"sudo gcc_select 4.0".) -1. Download the GPL-licensed Qt/Mac Free Edition library source code -from , untar in a -convenient directory, cd to the top of the Qt source hierarcy, and: - export QTDIR=`pwd` - sudo gcc_select 3.3 - ./configure -static -no-exceptions [for Panther, use "./configure -static -no-exceptions -lresolv"] - make - rm lib/libqt.la +PREREQUISITES -2. The LyX/Mac application bundle skeleton (LyX.app) can be found in -development/MacOSX. This bundle should be moved to some convenient -place. (These instructions assume it is placed in /Applications and -named LyX.app.) +Note: Only Qt/Mac is needed for building official LyX releases, and +so steps 2 and 3 can be skipped in these cases. Those wanting to +build developmental versions must have automake and gettext as +well. -3. Using the same terminal session you used to build the Qt library, -cd to the top of the LyX source hierarchy, and: +1. Qt/Mac Opensource Edition, version 4. This library is GPL- +licensed and can be downloaded from +. To compile it, +create a directory where you want to install QT4. In the following, +the full path to this directory is called /path/to/QT4 +Decompress Qt/Mac in a convenient directory, cd to the top of the +Qt source hierarcy, and enter: - export LDFLAGS="-framework Carbon -framework OpenGL -framework AGL -framework QuickTime -lz" - ./configure --with-frontend=qt --without-x --prefix=/Applications/LyX.app --enable-maintainer-mode --with-included-gettext --enable-optimization=-Os --disable-concept-checks + ./configure -static -no-exceptions -nomake examples -nomake tools -nomake demos -prefix /path/to/QT4 make make install - rm /Applications/LyX.app/Contents/Resources/LyX/images/lyx.xpm + cd /path/to/QT4/lib + rm *.la + +2. [Needed only for developmental builds:] automake, version 1.5 +or higher (check with automake --version). Probably the easiest +way to get this is to use MacPorts (from http://www.macports.org/) +and install automake using + + sudo port install automake + +3. [Needed only for developmental builds:] gettext version >= 0.12 +(check with gettext --version). If the installed version is +insufficient the easiest way to obtain a later version is to use +MacPorts (from http://www.macports.org/) and install gettext +using: + + sudo port install gettext + +4. [Useful to simplify detection of Qt:] pkg-config >= 0.9.0. Again, +the simplest way is through MacPorts: + + sudo port install pkgconfig + + +BUILD INSTRUCTIONS + +In what follows, /path/to/LyX.app is the location where you want LyX +to create the LyX binary. You should substitute something appropriate, +like: ~/Desktop/LyX.app. Also, substitute the appropriate path to +where you installed Qt for /path/to/QT4 (as above). + +(a) Official Releases + +If you did not install pkg-config, first set the LDFLAGS variable: + + export LDFLAGS="-framework Carbon -framework OpenGL -framework AGL -framework QuickTime -framework Cocoa" + +Then, cd to the top of the LyX source hierarchy, and enter: + + ./configure --prefix=/path/to/LyX.app --with-version-suffix=-1.5 --without-x --with-qt4-dir=/path/to/QT4 --with-included-gettext --enable-optimization=-Os + make + make install-strip + +(Note that the --with-version-suffix=-1.5 option will result in LyX's +user's directory being located at ~/Library/Application Support/LyX-1.5.) + + +(b) Developmental Versions (svn checkouts) + +Building LyX from developmental sources requires a few more steps. +Instead of the instructions above, do the following: + +If you did not install pkg-config, first set the LDFLAGS variable: + + export LDFLAGS="-framework Carbon -framework OpenGL -framework AGL -framework QuickTime -framework Cocoa" + +Then, cd to the top of the LyX source hierarchy, and enter: + + ./autogen.sh + ./configure --prefix=/path/to/LyX.app --with-version-suffix=-1.5 --without-x --with-qt4-dir=/path/to/QT4 --with-included-gettext --enable-optimization=-Os + make + make install-strip -[Note that removing lyx.xpm -- the point of the last line above -- is -necessary for the Mac OS X native icon files included in the LyX/Mac -skeleton to be used.] +Note that by default svn versions use some extra debugging code that +somewhat slows LyX down. If it is a real problem, you can pass the +option --disable-stdlib-debug to configure. The information on this page is believed to be accurate, has been used successfully on many systems and sites, and has benefited from the @@ -44,4 +105,4 @@ comments and suggestions of many users. Due to the variations in individual systems, this information is conveyed as is with no warranty of any kind. -For more information on LyX/Mac, see . +For more information on LyX/Mac, see .