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 PREREQUISITES
  14
  15 1. Qt/Mac Free Edition, version 3.3. This library is GPL-licensed
  16 and can be downloaded from
  17 <http://www.trolltech.com/download/qt/mac.html>. You will need to
  18 compile it yourself (as described below).
  19
  20 2. automake, version 1.9 or higher. The easiest way to get this is
  21 to use FinkCommander, which can be downloaded from
  22 <http://finkcommander.sourceforge.net/>.
  23
  24 BUILD INSTRUCTIONS
  25
  26 Note that building LyX/Mac requires gcc version 3.3 or higher. (You
  27 can check your version  by entering "gcc -v" in the Terminal; you
  28 can change your gcc version to version 3.3, for example, by entering
  29 "sudo gcc_select 3.3".)
  30
  31 1. Decompress Qt/Mac in a convenient directory, cd to the top of the
  32 Qt source hierarcy, and:
  33
  34      export QTDIR=`pwd`
  35      ./configure -static -no-exceptions -lresolv   [for OS X 10.2, use "./configure -static -no-exceptions"]
  36      make
  37      rm lib/libqt.la
  38
  39 2. The LyX/Mac application bundle skeleton (LyX.app) can be found in
  40 the LyX source hierarchy at development/MacOSX. The default settings
  41 assume that this bundle has been moved to /Applications and is named
  42 LyX.app. You can rename it or move it somewhere else, but make sure
  43 you read the note in step 3.
  44
  45 3. Using the same terminal session you used to build the Qt library,
  46 cd to the top of the LyX source hierarchy, and:
  47
  48      export LDFLAGS="-framework Carbon -framework OpenGL -framework AGL -framework QuickTime -lz"
  49      ./autogen.sh
  50      ./configure --with-frontend=qt --without-x --with-included-gettext --enable-optimization=-Os --disable-concept-checks
  51
  52 [Note: If you have moved or renamed the LyX/Mac application bundle
  53 skeleton, you will need to add "--prefix=/path/to/LyX.app"
  54 (substituting the appropriate path, of course) to this ./configure
  55 line. (If you do not specify anything for --prefix, the default is
  56 --prefix=/Applications/LyX.app.)]
  57
  58      make
  59      make install
  60
  61
  62 The information on this page is believed to be accurate, has been used
  63 successfully on many systems and sites, and has benefited from the
  64 comments and suggestions of many users. Due to the variations in
  65 individual systems, this information is conveyed as is with no
  66 warranty of any kind.
  67
  68 For more information on LyX/Mac, see <http://wiki.lyx.org/Mac/Mac>.