INSTALL.MacOSX

   1 Building LyX/Mac-1.5
   2 Ronald Florence <ron@18james.com>
   3 Modified by Bennett Helm <bennett.helm@fandm.edu> and by Anders
   4 Ekberg <anek@mac.com>.
   5
   6 LyX/Mac is built from the LyX source, the GPL-licensed Trolltech
   7 Qt/Mac library, and a custom application bundle.
   8
   9 You will need the MacOSX development tools. The procedure described
  10 here builds LyX linked with a static Qt library.
  11
  12 PREREQUISITES
  13
  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).
  18
  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
  22 using
  23     sudo port install automake
  24
  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
  29 using
  30      sudo port install gettext
  31
  32
  33 BUILD INSTRUCTIONS
  34
  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".)
  39
  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:
  44
  45      ./configure -static -no-exceptions -nomake examples -nomake tools -prefix /path/to/QT4
  46      make
  47      make install
  48      cd /path/to/QT4/lib
  49      rm *.la
  50
  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.
  54
  55
  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.)
  61
  62 3. cd to the top of the LyX source hierarchy, and:
  63
  64      export LDFLAGS="-framework Carbon -framework OpenGL -framework AGL -framework QuickTime -lz -framework Cocoa"
  65      ./autogen.sh
  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
  67      make
  68      make install-strip
  69
  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.)
  72
  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
  77 warranty of any kind.
  78
  79 For more information on LyX/Mac, see <http://wiki.lyx.org/Mac/Mac>.