2 Ronald Florence <ron@18james.com>
3 Modified by Bennett Helm <bennett.helm@fandm.edu> and by Anders
6 LyX/Mac is built from the LyX source, the GPL-licensed Trolltech
7 Qt/Mac library, and a custom application bundle.
9 You will need the MacOSX development tools. The procedure described
10 here builds LyX linked with a static Qt library.
14 1. Qt/Mac Free Edition, version 4. This library is GPL-licensed
15 and can be downloaded from
16 <http://www.trolltech.com/download/qt/mac.html>. You will need to
17 compile it yourself (as described below).
19 2. automake, version 1.5 or higher (check with automake --version).
20 Probably the easiest way to get this is to use DarwinPorts (from
21 http://darwinports.opendarwin.org/getdp/) and install automake
23 sudo port install automake
25 3. gettext version >= 0.12 (check with gettext --version)
26 If the installed version is insufficient the
27 easiest way to obtain a later version is to get DarwinPorts
28 (from http://darwinports.opendarwin.org/getdp/) and install gettext
30 sudo port install gettext
35 Note that building LyX/Mac requires gcc version 4.0 or higher. (You
36 can check your version by entering "gcc -v" in the Terminal; you
37 can change your gcc version to version 4.0, for example, by entering
38 "sudo gcc_select 4.0".)
40 1. Create a directory where you want to install QT4. In the following,
41 the full path to this directory is called /path/to/QT4
42 Decompress Qt/Mac in a convenient directory, cd to the top of the
43 Qt source hierarcy, and:
45 ./configure -static -no-exceptions -nomake examples -nomake tools -prefix /path/to/QT4
51 If you don't prescribe -nomake examples -nomake tools in the
52 configuration you need to make sure you have some 20+ GB of free hard
53 disk space. Else the installation is about 1GB.
56 2. The LyX/Mac application bundle skeleton (LyX.app) can be found in
57 the LyX source hierarchy at development/MacOSX. Copy this bundle to a
58 directory. In the following, the full path to this directory is called
59 /path/to/LyX.app. (The default settings assume that this path is
60 /Applications/LyX.app.)
62 3. cd to the top of the LyX source hierarchy, and:
64 export LDFLAGS="-framework Carbon -framework OpenGL -framework AGL -framework QuickTime -lz -framework Cocoa"
66 ./configure --prefix=/path/to/LyX.app --disable-concept-checks --with-version-suffix=-1.5 --with-qt4-dir=/path/to/QT4 --enable-optimization=-Os --without-x --with-included-gettext --with-frontend=qt4 --disable-stdlib-debug
70 (Note that the --with-version-suffix=-1.5 option will result in LyX's
71 user's directory being located at ~/Library/Application Support/LyX-1.5.)
73 The information on this page is believed to be accurate, has been used
74 successfully on many systems and sites, and has benefited from the
75 comments and suggestions of many users. Due to the variations in
76 individual systems, this information is conveyed as is with no
79 For more information on LyX/Mac, see <http://wiki.lyx.org/Mac/Mac>.