README.MacOSX

   1
   2                          Building LyX on Aqua
   3
   4                   Ronald Florence <ron@18james.com>
   5
   6
   7    Make sure you have installed the MacOSX development tools.  The
   8    procedure described here builds LyX-1.3.3 linked with a static Qt
   9    library and installs the LyX and Start-LyX applications.
  10
  11    Download the GPL-licensed MacOSX Qt library source code from
  12    ftp://ftp.trolltech.com/qt/source/qt-mac-free-3.1.2.sit. Untar the
  13    .tar.gz file in a convenient directory in /usr/local/src or
  14    /usr/local. Then open a terminal, cd to the Qt source directory,
  15    apply the patch development/MacOSX/qt.patch, and:
  16
  17    % setenv QTDIR `pwd`
  18    % sudo gcc_select 2
  19    % ./configure -static
  20    % make
  21    % sudo gcc_select 3
  22    % mkdir lib/unused
  23    % mv lib/*.dylib lib/unused
  24
  25    To avoid this compiler-changing procedure in the future, you might
  26    want to write Apple to urge that they fix bug ID #3162425 so the
  27    default gcc-3.1 compiler can be used to compile LyX-1.3.x on MacOSX.
  28
  29    Using the same terminal session you used to build the Qt libraries
  30    (or if you start a new terminal, set the QTDIR environment variable
  31    as above), cd to the top of the LyX source hierarchy. Then:
  32
  33    % setenv CXX g++2
  34    % setenv LDFLAGS "-framework Carbon -framework OpenGL -framework AGL -framew
  35 ork QuickTime -lz"
  36    % ./configure --with-frontend=qt --without-x --datadir=/Applications/LyX.app
  37 /Contents/Resources --bindir=/Applications/LyX.app/Contents/MacOS --mandir=/App
  38 lications/LyX.app/Contents/Resources/man
  39    % make
  40
  41    Download the LyX Framework at
  42    http://www.18james.com/code/LyX.tar.gz and run the installer. Then
  43    in the terminal where you built LyX:
  44
  45    % make install
  46    % cp development/MacOSX/lyx.xpm /Applications/LyX.app/Contents/Resources/LyX/images/lyx.xpm
  47
  48    Please see the LyX on Aqua howto at
  49    http://www.18james.com/lyx_on_aqua.html for information on
  50    configuring LyX on Aqua. The binary installation of LyX on Aqua
  51    installs ~/.MacOS/environment.plist and the TeX math fonts; you
  52    will need to do this configuration manually if you build LyX
  53    yourself.
  54
  55    The information on this page is believed to be accurate, has been
  56    used successfully on many systems and sites, and has benefited from
  57    the comments and suggestions of many users. Due to the variations
  58    in individual systems, this information is conveyed as is with no
  59    warranty of any kind.