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 3.1.2 library source code from
  12    ftp://ftp.lyx.org/pub/lyx/contrib/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
  23    To avoid this compiler-changing procedure in the future, you might
  24    want to write Apple to urge that they fix bug ID #3162425 so the
  25    default gcc-3.1 compiler can be used to compile LyX-1.3.x on MacOSX.
  26
  27    Using the same terminal session you used to build the Qt libraries
  28    (or if you start a new terminal, set the QTDIR environment variable
  29    as above), cd to the top of the LyX source hierarchy. Then:
  30
  31    % setenv CXX g++2
  32    % setenv LDFLAGS "-framework Carbon -framework OpenGL -framework AGL -framew
  33 ork QuickTime -lz"
  34    % ./configure --with-frontend=qt --without-x --datadir=/Applications/LyX.app
  35 /Contents/Resources --bindir=/Applications/LyX.app/Contents/MacOS --mandir=/App
  36 lications/LyX.app/Contents/Resources/man
  37    % make
  38
  39    Download the LyX Framework at
  40    http://www.18james.com/code/LyX.tar.gz and run the installer. Then
  41    in the terminal where you built LyX:
  42
  43    % make install
  44    % rm /Applications/LyX.app/Contents/Resources/LyX/images/lyx.xpm
  45
  46    For information on configuring LyX/Mac, please see the howto at
  47    http://www.18james.com/lyx_on_aqua.html . The binary installation
  48    of LyX on Aqua sets the PATH in ~/.MacOS/environment.plist,
  49    installs the LyX math fonts, configures LyX to use the reLyX and
  50    noweb2lyx commands in the application package and to use system
  51    defaults for viewers, sets up the lyxpipe for Start-LyX, and
  52    optionally installs latex-preview; you will need to do this
  53    configuration manually if you build LyX/Mac 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.