unicodesymbols: (last round of adding symbols)

[lyx.git] / INSTALL.MacOSX

diff --git a/INSTALL.MacOSX b/INSTALL.MacOSX
index 0aa370cf67b6c35ff54c106d3146ed152b3599be..75e150198186689f66ab187b3eee66f65ff36131 100644 (file)
--- a/INSTALL.MacOSX
+++ b/INSTALL.MacOSX
@@ -1,42 +1,90 @@
-Building LyX/Mac-1.4.0
+Building LyX/Mac-1.5

 Ronald Florence <ron@18james.com>
 Ronald Florence <ron@18james.com>

-Modified by Bennett Helm <bennett.helm@fandm.edu>
+Modified by Bennett Helm <bennett.helm@fandm.edu> and by Anders
+Ekberg <anek@mac.com>.

 
 LyX/Mac is built from the LyX source, the GPL-licensed Trolltech
 Qt/Mac library, and a custom application bundle.
 
 You will need the MacOSX development tools. The procedure described
 
 LyX/Mac is built from the LyX source, the GPL-licensed Trolltech
 Qt/Mac library, and a custom application bundle.
 
 You will need the MacOSX development tools. The procedure described

-here builds LyX linked with a static Qt library. If you are using the
-tcsh shell, change the "export VAR=value" statements to
-"setenv VAR value".
+here builds LyX linked with a static Qt library. Also note that
+building LyX/Mac requires gcc version 4.0 or higher. (You can check
+your version  by entering "gcc -v" in the Terminal; you can change
+your gcc version to version 4.0, for example, by entering
+"sudo gcc_select 4.0".)

 
 

-1. Download the GPL-licensed Qt/Mac Free Edition library source code
-from <http://www.trolltech.com/download/qt/mac.html>, untar in a
-convenient directory, cd to the top of the Qt source hierarcy, and:

 
 

-     export QTDIR=`pwd`
-     sudo gcc_select 3.3
-     ./configure -static -no-exceptions   [for Panther, use "./configure -static -no-exceptions -lresolv"]
-     make
-     rm lib/libqt.la
+PREREQUISITES

 
 

-2. The LyX/Mac application bundle skeleton (LyX.app) can be found in 
-development/MacOSX. This bundle should be moved to some convenient
-place. (These instructions assume it is placed in /Applications and
-named LyX.app.)
+Note: Only Qt/Mac is needed for building official LyX releases, and
+so steps 2 and 3 can be skipped in these cases. Those wanting to
+build developmental versions must have automake and gettext as
+well.

 
 

-3. Using the same terminal session you used to build the Qt library,
-cd to the top of the LyX source hierarchy, and:
+1. Qt/Mac Opensource Edition, version 4. This library is GPL-
+licensed and can be downloaded from
+<http://www.trolltech.com/download/qt/mac.html>. To compile it,
+create a directory where you want to install QT4. In the following, 
+the full path to this directory is called /path/to/QT4
+Decompress Qt/Mac in a convenient directory, cd to the top of the
+Qt source hierarcy, and enter:

 
 

-     export LDFLAGS="-framework Carbon -framework OpenGL -framework AGL -framework QuickTime -lz"
-     ./configure --with-frontend=qt --without-x --prefix=/Applications/LyX.app --enable-maintainer-mode --with-included-gettext --enable-optimization=-Os --disable-concept-checks
+     ./configure -static -no-exceptions -nomake examples -nomake tools -nomake demos -prefix /path/to/QT4

      make
      make install
      make
      make install

-     rm /Applications/LyX.app/Contents/Resources/LyX/images/lyx.xpm
+     cd /path/to/QT4/lib
+     rm *.la
+
+2. [Needed only for developmental builds:] automake, version 1.5
+or higher (check with automake --version). Probably the easiest
+way to get this is to use DarwinPorts (from
+http://darwinports.opendarwin.org/getdp/) and install automake
+using
+
+     sudo port install automake
+
+3. [Needed only for developmental builds:] gettext version >= 0.12
+(check with gettext --version). If the installed version is
+insufficient the easiest way to obtain a later version is to use
+DarwinPorts (from http://darwinports.opendarwin.org/getdp/) and
+install gettext using:
+
+     sudo port install gettext
+
+
+BUILD INSTRUCTIONS
+
+In what follows, /path/to/LyX.app is the location where you want LyX
+to create the LyX binary. You should substitute something appropriate,
+like: ~/Desktop/LyX.app. Also, substitute the appropriate path to
+where you installed Qt for /path/to/QT4 (as above).
+
+(a) Official Releases
+
+cd to the top of the LyX source hierarchy, and enter:
+
+     export LDFLAGS="-framework Carbon -framework OpenGL -framework AGL -framework QuickTime -lz -framework Cocoa"
+     ./configure --prefix=/path/to/LyX.app --with-version-suffix=-1.5 --without-x --with-frontend=qt4 --with-qt4-dir=/path/to/QT4 --with-included-gettext --enable-optimization=-Os
+     make
+     make install-strip
+
+(Note that the --with-version-suffix=-1.5 option will result in LyX's
+user's directory being located at ~/Library/Application Support/LyX-1.5.)
+
+
+(b) Developmental Versions (svn checkouts)
+
+Building LyX from developmental sources requires a few more steps.
+Instead of the instructions above, do the following:
+
+cd to the top of the LyX source hierarchy, and enter:
+
+     export LDFLAGS="-framework Carbon -framework OpenGL -framework AGL -framework QuickTime -lz -framework Cocoa"
+     ./autogen.sh
+     ./configure --prefix=/path/to/LyX.app --with-version-suffix=-1.5 --without-x --with-frontend=qt4 --with-qt4-dir=/path/to/QT4 --with-included-gettext --enable-optimization=-Os --disable-stdlib-debug --disable-concept-checks
+     make
+     make install-strip

 
 

-[Note that removing lyx.xpm -- the point of the last line above -- is
-necessary for the Mac OS X native icon files included in the LyX/Mac 
-skeleton to be used.]

 
 The information on this page is believed to be accurate, has been used
 successfully on many systems and sites, and has benefited from the
 
 The information on this page is believed to be accurate, has been used
 successfully on many systems and sites, and has benefited from the


@@ -44,4 +92,4 @@ comments and suggestions of many users. Due to the variations in
 individual systems, this information is conveyed as is with no
 warranty of any kind.
 
 individual systems, this information is conveyed as is with no
 warranty of any kind.
 

-For more information on LyX/Mac, see <http://wiki.lyx.org/pmwiki.php/LyX/Mac>.
+For more information on LyX/Mac, see <http://wiki.lyx.org/Mac/Mac>.