lyx_mirror/INSTALL.MacOSX

Building LyX/Mac-1.5
Ronald Florence <ron@18james.com>
Modified by Bennett Helm <bennett.helm@fandm.edu> and by Anders
Ekberg <anek@mac.com>.

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. 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".)


PREREQUISITES

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.

1. Qt/Mac Opensource Edition, version 4. This library is GPL-
licensed and can be downloaded from
<http://www.trolltech.com/download/qt/mac.html>. 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:

     ./configure -static -no-exceptions -nomake examples -nomake tools -nomake demos -prefix /path/to/QT4
     make
     make install
     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 DarwinPorts (from
http://darwinports.opendarwin.org/getdp/) 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
DarwinPorts (from http://darwinports.opendarwin.org/getdp/) and
install gettext using:

     sudo port install gettext


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

cd to the top of the LyX source hierarchy, and enter:

     export LDFLAGS="-framework Carbon -framework OpenGL -framework AGL -framework QuickTime -lz -framework Cocoa"
     ./configure --prefix=/path/to/LyX.app --with-version-suffix=-1.5 --without-x --with-frontend=qt4 --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:

cd to the top of the LyX source hierarchy, and enter:

     export LDFLAGS="-framework Carbon -framework OpenGL -framework AGL -framework QuickTime -lz -framework Cocoa"
     ./autogen.sh
     ./configure --prefix=/path/to/LyX.app --with-version-suffix=-1.5 --without-x --with-frontend=qt4 --with-qt4-dir=/path/to/QT4 --with-included-gettext --enable-optimization=-Os --disable-stdlib-debug --disable-concept-checks
     make
     make install-strip


The information on this page is believed to be accurate, has been used
successfully on many systems and sites, and has benefited from the
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 <http://wiki.lyx.org/Mac/Mac>.