INSTALL.MacOSX

   1 Building LyX/Mac-1.4.0
   2 Ronald Florence <ron@18james.com>
   3 Modified by Bennett Helm <bennett.helm@fandm.edu>
   4
   5 LyX/Mac is built from the LyX source, the GPL-licensed Trolltech
   6 Qt/Mac library, and a custom application bundle.
   7
   8 You will need the MacOSX development tools. The procedure described
   9 here builds LyX linked with a static Qt library. If you are using the
  10 tcsh shell, change the "export VAR=value" statements to
  11 "setenv VAR value".
  12
  13 At the moment, compiling LyX/Mac requires using gcc version 3.3. You
  14 can tell OS X to use this compiler by entering the following in the
  15 terminal:
  16
  17      sudo gcc_select 3.3
  18
  19 1. Download the GPL-licensed Qt/Mac Free Edition library source code
  20 from <http://www.trolltech.com/download/qt/mac.html>, untar in a
  21 convenient directory, cd to the top of the Qt source hierarcy, and:
  22
  23      export QTDIR=`pwd`
  24      ./configure -static -no-exceptions -lresolv   [for OS X 10.2, use "./configure -static -no-exceptions"]
  25      make
  26      rm lib/libqt.la
  27
  28 2. The LyX/Mac application bundle skeleton (LyX.app) can be found in
  29 the LyX source hierarchy at development/MacOSX. The default settings
  30 assume that this bundle has been moved to /Applications and is named
  31 LyX.app. You can rename it or move it somewhere else, but make sure
  32 you read the note in step 3.
  33
  34 3. Using the same terminal session you used to build the Qt library,
  35 cd to the top of the LyX source hierarchy, and:
  36
  37      export LDFLAGS="-framework Carbon -framework OpenGL -framework AGL -framework QuickTime -lz"
  38      ./configure --with-frontend=qt --without-x --with-included-gettext --enable-optimization=-Os --disable-concept-checks
  39
  40 [Note: If you have moved or renamed the LyX/Mac application bundle
  41 skeleton, you will need to add "--prefix=/path/to/LyX.app"
  42 (substituting the appropriate path, of course) to this ./configure
  43 line. (If you do not specify anything for --prefix, the default is
  44 --prefix=/Applications/LyX.app.)]
  45
  46      make
  47      make install
  48
  49
  50 The information on this page is believed to be accurate, has been used
  51 successfully on many systems and sites, and has benefited from the
  52 comments and suggestions of many users. Due to the variations in
  53 individual systems, this information is conveyed as is with no
  54 warranty of any kind.
  55
  56 For more information on LyX/Mac, see <http://wiki.lyx.org/pmwiki.php/LyX/Mac>.