annotate README.MacOS @ 11542:695141f1c05c ss-3-3-55

snapshot 3.3.55
author John W. Eaton <jwe@octave.org>
date Sat, 15 Jan 2011 04:53:04 -0500
parents cbe3963daefd
children 21dec063e89f
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
11410
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
1 1. General Users
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
2 ================
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
3
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
4 A MacOS bundle is available from sourceforge.
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
5
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
6 http://octave.sourceforge.net/index.html
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
7
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
8 There are also Octave packages available from both Fink and MacPorts. Each
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
9 of these package managers handle the details of compiling Octave from source.
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
10
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
11 http://www.finkproject.com
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
12 http://www.macports.org/
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
13
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
14 2. Developers
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
15 =============
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
16
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
17 Building on MacOS can vary significantly between versions. These
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
18 instructions document the procedure for MacOS 10.6.X.
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
19
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
20 2.1 Development Tools
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
21 ----------------------
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
22
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
23 Apple's Xcode Developer's Tool must be installed to build from source code.
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
24
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
25 http://developer.apple.com/technologies/xcode.html
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
26
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
27 A Fortran compiler is also required. AT&T Research provides versions of
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
28 gfortran which have been patched to work with recent versions of Xcode.
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
29
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
30 http://r.research.att.com/tools/
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
31
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
32 2.2 Dependencies
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
33 ----------------
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
34
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
35 There are additional build dependencies and run-time dependencies which
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
36 must be met. Using a package management system such as Fink or MacPorts
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
37 is the easiest way to meet these requirements.
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
38
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
39 http://www.finkproject.com
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
40 http://www.macports.org/
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
41
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
42 The list of dependencies is below. Dependencies in the list are referred to
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
43 using the name of the Fink package.
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
44
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
45 aquaterm
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
46 arpack
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
47 autoconf (>= 2.6.0)
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
48 automake (>= 1.11)
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
49 fftw3 (>= 3.1.1)
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
50 fftw3-shlibs (>= 3.1.1)
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
51 flex >= 2.5.30
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
52 fltk-aqua-shlibs
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
53 glpk-dev
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
54 glpk-shlibs
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
55 gnuplot (>= 4.2.6)
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
56 graphicsmagick (<= 1.3.7)
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
57 graphicsmagick-shlibs (<= 1.3.7)
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
58 hdf5 (>= 1.6.5)
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
59 hdf5-shlibs (>= 1.6.5)
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
60 libcurl4
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
61 libcurl4-shlibs
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
62 libncurses5
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
63 libncurses5-shlibs
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
64 libtool >= 2.2.2
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
65 ncurses
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
66 pcre
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
67 pcre-shlibs
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
68 qhull
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
69 qrupdate (**)
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
70 readline5
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
71 readline5-shlibs
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
72 sed
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
73 suitesparse (= 3.1.0-1 )
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
74
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
75 Some of Octave's dependencies are among the default packages for Fink. These
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
76 include the list below, and possibly others as well.
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
77
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
78 tetex
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
79 texinfo
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
80
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
81 (**) Fink does not yet have a package for qrupdate. However, one is
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
82 available in the tracker at the link below.
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
83
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
84 http://sourceforge.net/tracker/index.php?func=detail&aid=2861045&group_id=17203&atid=414256
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
85
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
86 2.3 Building With Dependencies Satisfied by Fink
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
87 ------------------------------------------------
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
88
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
89 After installing each of the dependencies, the sources are compiled by
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
90 setting the proper environment variables and then following the standard build
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
91 sequence. The following is an example set of variables for a 32-bit processor
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
92 compling with gcc-4.2.
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
93
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
94 export FINK_PREFIX="/sw"
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
95 export PREFIX="/usr/local/bin"
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
96
11443
cbe3963daefd Update README.MacOS CFLAGS recommendation to -O2.
Rik <octave@nomad.inbox5.com>
parents: 11410
diff changeset
97 export OPTFLAGS="-O2 -g"
11410
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
98 export LDFLAGS="-L$FINK_PREFIX/lib -L/usr/lib -m32"
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
99 export CFLAGS="-I$FINK_PREFIX/include $OPTFLAGS -m32"
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
100 export CXXFLAGS=$CFLAGS
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
101 export CPPFLAGS=$CXXFLAGS
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
102 export ACLOCAL_FLAGS="-I$FINK_PREFIX/share/aclocal"
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
103 export PKG_CONFIG_PATH="$FINK_PREFIX/lib/pkgconfig"
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
104 export PATH="$FINK_PREFIX/var/lib/fink/path-prefix-10.6/:$PATH"
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
105 export MACOSX_DEPLOYMENT_TARGET=10.5
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
106 export PATH="$FINK_PREFIX/lib/flex/bin:$PATH"
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
107 export CPPFLAGS="-I$FINK_PREFIX/lib/flex/include $CPPFLAGS"
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
108 export LDFLAGS="-L$FINK_PREFIX/lib/flex/lib $LDFLAGS"
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
109 export CC="gcc-4.2"
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
110 export CPP="cpp-4.2"
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
111 export CXX="g++-4.2"
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
112 export F77="/usr/bin/gfortran-4.2"
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
113 export FLIBS="-lgfortran -lgfortranbegin"
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
114 export FFLAGS="-ff2c $OPTFLAGS -m32"
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
115 export CPPFLAGS="$CPPFLAGS -I$FINK_PREFIX/include/freetype2 \
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
116 -I$FINK_PREFIX/include/qhull \
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
117 -I/usr/include"
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
118 export CXXFLAGS="$CXXFLAGS -D_THREAD_SAFE -D_REENTRANT"
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
119
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
120 ./autogen.sh
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
121 ./configure --prefix=$PREFIX \
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
122 --libexecdir='${prefix}/lib' \
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
123 --with-blas="-Wl,-framework -Wl,vecLib"
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
124 make
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
125
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
126 2.4 Building With Dependencies Satisfied by MacPorts
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
127 ----------------------------------------------------
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
128
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
129 TODO - add instructions.
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
130
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
131 2.5 Building without a package manager
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
132 --------------------------------------
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
133
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
134 TODO - add instructions.
11386
fba7b5538b18 README.MacOS: New file with build instructions for Mac OS systems.
Rik <octave@nomad.inbox5.com>
parents:
diff changeset
135
fba7b5538b18 README.MacOS: New file with build instructions for Mac OS systems.
Rik <octave@nomad.inbox5.com>
parents:
diff changeset
136
11410
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
137 John W. Eaton
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
138 jwe@octave.org
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
139
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
140 Ben Abbott
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
141 bpabbott@mac.com
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
142
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
143 Sat, 28 Oct 2010 16:06:00 EDT