annotate README.MacOS @ 12312:b10ea6efdc58 release-3-4-x ss-3-3-91

version is now 3.3.91
author John W. Eaton <jwe@octave.org>
date Mon, 31 Jan 2011 08:36:58 -0500
parents edaf29362c50
children 88a8248f5b97
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
12252
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
1 1. Easy to install Binary Releases
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
2 ==================================
11410
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
12252
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
14
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
15 2. Building from Source
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
16 =======================
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
17
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
18 Stable releases, development snapshots as well as the current developers
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
19 sources are available. The sources for stable releases are available from
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
20 the links below.
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
21
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
22 ftp://ftp.gnu.org/pub/gnu/octave/
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
23 http://ftp.gnu.org/pub/gnu/octave/
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
24
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
25 Development snapshots, intended for testing, are available from the link
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
26 below.
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
27
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
28 ftp://alpha.gnu.org/gnu/octave
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
29
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
30 Links to the stable releases, snap shots, and instructions for obtaining
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
31 the current development sources using mercurial can be found on Octave's
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
32 web-site below.
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
33
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
34 http://www.gnu.org/software/octave/download.html
11410
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
35
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
36 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
37 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
38
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
39
12252
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
40 2.1 Developer's Tools
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
41 ---------------------
11410
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
42
12283
0664a7ddd944 README.MacOS: Spelling corrections.
Ben Abbott <bpabbott@mac.com>
parents: 12281
diff changeset
43 Apple's Xcode Developer's Tools must be installed to build Octave on MacOS X.
11410
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
44
12252
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
45 A fortran compilar is also required to build Octave.
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
46
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
47 AT&T Research provides versions of gfortran which have been patched to work
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
48 with gcc tool set bundled with Xcode.
11410
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
49
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
50 http://r.research.att.com/tools/
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
51
12252
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
52 Alternatively, the Fink and MacPorts package managers provide more recent
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
53 versions of gcc which include gfortan. Those may be used to build the sources
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
54 as well. However, care must be taken.
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
55
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
56 * The same compiler must be used to build all the dependencies. This is
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
57 necessary to to avoid conflicts between the compiler libraries such as
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
58 libstdc++. For a successful build the first file in LDFLAGS must refer to
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
59 this library. For example, if building with gcc-4.5 obtained from MacPorts
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
60 LDFLAGS would begin as,
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
61
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
62 export LDFLAGS="/opt/local/lib/gcc45/libstdc++.6.dylib [...]"
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
63
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
64 * As of MacOS 10.6.6, the 64bit BLAS routines that are part of Apple's vecLib
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
65 (framework accelerate) are not functioning correctly. As a work around, an
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
66 alternative BLAS/LAPACK library, such as ATLAS, must be used.
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
67
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
68
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
69 2.2 Manual Package Management
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
70 -----------------------------
11410
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
71
12283
0664a7ddd944 README.MacOS: Spelling corrections.
Ben Abbott <bpabbott@mac.com>
parents: 12281
diff changeset
72 Instructions for building Octave are available on the web at the link below.
12280
6027fdbcb3d8 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12266
diff changeset
73
6027fdbcb3d8 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12266
diff changeset
74 http://wiki.octave.org/wiki.pl?BuildFromSource
6027fdbcb3d8 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12266
diff changeset
75
6027fdbcb3d8 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12266
diff changeset
76 In additionn, those wishing to build on MacOS X (10.6.x) should read section
6027fdbcb3d8 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12266
diff changeset
77 2.1 above.
6027fdbcb3d8 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12266
diff changeset
78
6027fdbcb3d8 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12266
diff changeset
79 2.2.1 Critical Dependencies
6027fdbcb3d8 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12266
diff changeset
80 ---------------------------
6027fdbcb3d8 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12266
diff changeset
81
6027fdbcb3d8 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12266
diff changeset
82 The minimal dependencies needed to build Octave's snap-shots are listed below.
6027fdbcb3d8 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12266
diff changeset
83
6027fdbcb3d8 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12266
diff changeset
84 * Xcode
6027fdbcb3d8 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12266
diff changeset
85
6027fdbcb3d8 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12266
diff changeset
86 * gfortran: Available from http://r.reseach.att.com/tools
6027fdbcb3d8 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12266
diff changeset
87
6027fdbcb3d8 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12266
diff changeset
88 * gnu sed: Availabel from http://www.gnu.org/software/sed/
6027fdbcb3d8 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12266
diff changeset
89
6027fdbcb3d8 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12266
diff changeset
90 ./configure --prefix=/usr
6027fdbcb3d8 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12266
diff changeset
91 make
6027fdbcb3d8 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12266
diff changeset
92 make install
6027fdbcb3d8 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12266
diff changeset
93
6027fdbcb3d8 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12266
diff changeset
94 * fftw3: Available from http://www.fftw.org/download.html
6027fdbcb3d8 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12266
diff changeset
95
12281
3f162dd0c112 README.MacOS: Additional modifications for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12280
diff changeset
96 export F77="/usr/bin/gfortran"
12280
6027fdbcb3d8 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12266
diff changeset
97 export CFLAGS="-arch i686 -arch x86_64"
6027fdbcb3d8 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12266
diff changeset
98 export FFLAGS="$CFLAGS"
6027fdbcb3d8 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12266
diff changeset
99 export LDLAGS="$CFLAGS"
6027fdbcb3d8 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12266
diff changeset
100 ./configure --disable-dependency-tracking
6027fdbcb3d8 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12266
diff changeset
101 make
12281
3f162dd0c112 README.MacOS: Additional modifications for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12280
diff changeset
102 sudo make install
3f162dd0c112 README.MacOS: Additional modifications for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12280
diff changeset
103 make clean
3f162dd0c112 README.MacOS: Additional modifications for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12280
diff changeset
104 ./configure --enable-float --disable-dependency-tracking
3f162dd0c112 README.MacOS: Additional modifications for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12280
diff changeset
105 make
3f162dd0c112 README.MacOS: Additional modifications for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12280
diff changeset
106 sudo make install
12280
6027fdbcb3d8 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12266
diff changeset
107
6027fdbcb3d8 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12266
diff changeset
108 A fully functional Octave requires additional dependencies. See the link below
6027fdbcb3d8 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12266
diff changeset
109 for the details.
6027fdbcb3d8 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12266
diff changeset
110
6027fdbcb3d8 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12266
diff changeset
111 http://wiki.octave.org/wiki.pl?BuildFromSource
6027fdbcb3d8 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12266
diff changeset
112
6027fdbcb3d8 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12266
diff changeset
113 2.2.2 Building Octave as a 32bit Application
6027fdbcb3d8 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12266
diff changeset
114 --------------------------------------------
6027fdbcb3d8 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12266
diff changeset
115
6027fdbcb3d8 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12266
diff changeset
116 The commands below are sufficient to build a 32bit Octave.
6027fdbcb3d8 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12266
diff changeset
117
6027fdbcb3d8 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12266
diff changeset
118 export CFLAGS="-m32"
6027fdbcb3d8 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12266
diff changeset
119 export FFLAGS="-m32 -ff2c"
6027fdbcb3d8 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12266
diff changeset
120 export CPPFLAGS="-m32 -D_REENTRANT"
6027fdbcb3d8 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12266
diff changeset
121 export LDFLAGS="-m32"
6027fdbcb3d8 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12266
diff changeset
122 ./configure --disable-readline --disable-docs
6027fdbcb3d8 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12266
diff changeset
123 make
6027fdbcb3d8 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12266
diff changeset
124
6027fdbcb3d8 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12266
diff changeset
125 Octave provides an interegrated tests suite.
6027fdbcb3d8 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12266
diff changeset
126
6027fdbcb3d8 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12266
diff changeset
127 make check
6027fdbcb3d8 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12266
diff changeset
128
6027fdbcb3d8 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12266
diff changeset
129 Octave may be run withou installing the application using the utility below.
6027fdbcb3d8 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12266
diff changeset
130
6027fdbcb3d8 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12266
diff changeset
131 ./run-octave
12252
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
132
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
133
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
134 2.3 Building With Dependencies Satisfied by Fink
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
135 ------------------------------------------------
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
136
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
137 To install and setup the Fink package manager see the on line documentation.
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
138
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
139 http://www.finkproject.org/
11410
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
140
12252
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
141 Currently, Fink does not have a package available for Octave versions above
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
142 3.0.x. These instructions will allow the developers sources to be build and
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
143 run, but will not permit Octave to be installed in the usual Fink way.
11410
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
144
12252
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
145 TODO - when a Fink package is developed for Octave 3.4.x, modify these
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
146 instructions to model the MacPorts secion.
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
147
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
148
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
149 2.3.1 Dependencies
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
150 ------------------
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
151
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
152 To build Octave's sources the list of Fink packages below need to be installed.
11410
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
153
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
154 aquaterm
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
155 autoconf (>= 2.6.0)
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
156 automake (>= 1.11)
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
157 fftw3 (>= 3.1.1)
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
158 fftw3-shlibs (>= 3.1.1)
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
159 flex >= 2.5.30
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
160 fltk-aqua-shlibs
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
161 glpk-dev
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
162 glpk-shlibs
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
163 gnuplot (>= 4.2.6)
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
164 graphicsmagick (<= 1.3.7)
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
165 graphicsmagick-shlibs (<= 1.3.7)
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
166 hdf5 (>= 1.6.5)
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
167 hdf5-shlibs (>= 1.6.5)
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
168 libcurl4
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
169 libcurl4-shlibs
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
170 libncurses5
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
171 libncurses5-shlibs
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
172 libtool >= 2.2.2
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
173 ncurses
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
174 pcre
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
175 pcre-shlibs
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
176 qhull
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
177 qrupdate (**)
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
178 readline5
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
179 readline5-shlibs
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
180 sed
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
181 suitesparse (= 3.1.0-1 )
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
182
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
183 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
184 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
185
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
186 tetex
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
187 texinfo
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
188
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
189 (**) 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
190 available in the tracker at the link below.
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
191
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
192 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
193
12252
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
194
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
195 2.3.2 Building With Dependencies Satisfied by Fink
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
196 --------------------------------------------------
11410
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
197
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
198 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
199 setting the proper environment variables and then following the standard build
12252
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
200 sequence. The following is an example set of variables to for a 32-bit build
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
201 using gcc-4.2. When building from the sources obtained from the mercurial
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
202 archive, ./autogen.sh must be run prior to ./configure.
11410
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
203
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
204 export FINK_PREFIX="/sw"
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
205 export PREFIX="/usr/local/bin"
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
206
11443
cbe3963daefd Update README.MacOS CFLAGS recommendation to -O2.
Rik <octave@nomad.inbox5.com>
parents: 11410
diff changeset
207 export OPTFLAGS="-O2 -g"
11410
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
208 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
209 export CFLAGS="-I$FINK_PREFIX/include $OPTFLAGS -m32"
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
210 export CXXFLAGS=$CFLAGS
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
211 export CPPFLAGS=$CXXFLAGS
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
212 export ACLOCAL_FLAGS="-I$FINK_PREFIX/share/aclocal"
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
213 export PKG_CONFIG_PATH="$FINK_PREFIX/lib/pkgconfig"
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
214 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
215 export MACOSX_DEPLOYMENT_TARGET=10.5
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
216 export PATH="$FINK_PREFIX/lib/flex/bin:$PATH"
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
217 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
218 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
219 export CC="gcc-4.2"
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
220 export CPP="cpp-4.2"
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
221 export CXX="g++-4.2"
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
222 export F77="/usr/bin/gfortran-4.2"
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
223 export FLIBS="-lgfortran -lgfortranbegin"
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
224 export FFLAGS="-ff2c $OPTFLAGS -m32"
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
225 export CPPFLAGS="$CPPFLAGS -I$FINK_PREFIX/include/freetype2 \
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
226 -I$FINK_PREFIX/include/qhull \
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
227 -I/usr/include"
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
228 export CXXFLAGS="$CXXFLAGS -D_THREAD_SAFE -D_REENTRANT"
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
229
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
230 ./configure --prefix=$PREFIX \
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
231 --libexecdir='${prefix}/lib' \
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
232 --with-blas="-Wl,-framework -Wl,vecLib"
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
233 make
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
234
12252
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
235 Note: This approach to building Octave does not support "make install".
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
236
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
237 TODO - develop a Fink package for Octave 3.4.x.
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
238
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
239
11410
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
240 2.4 Building With Dependencies Satisfied by MacPorts
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
241 ----------------------------------------------------
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
242
12252
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
243 To install and setup the MacPorts package manager see the online documentation
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
244
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
245 http://guide.macports.org/
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
246
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
247 Using MacPorts, two approaches are described. The first describes how to build
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
248 and locally install Octave from a formal snapshot of the developer's sources or
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
249 from the developer's sources themselves. This is intended to the causual Octave
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
250 developer, or for users who want to live on the bleeding edge.
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
251
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
252 The second describes an approach for building Octave which is intended for
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
253 active developers. In this case, MacPorts is used to satisfy Octave's
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
254 dependencies, but MacPorts does not build Octave. Futher a direct install of
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
255 Octave is not possible (i.e. cannot "make install").
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
256
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
257
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
258 2.4.1 Building and Installing Octave
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
259 ------------------------------------
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
260
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
261 With MacPorts building the developer's sources is convenient. MacPorts includes
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
262 a port file for octave-devel. To build and run the most recent development
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
263 snapshots, enter the commands below.
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
264
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
265 sudo port selfupdate
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
266 sudo port install octave-devel
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
267
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
268 To build the developers sources in one's own way, or if MacPorts' version is
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
269 outdated, a custom port file can be added. This requires setting up a local
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
270 port file repository (link below).
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
271
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
272 http://guide.macports.org/#development.local-repositories
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
273
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
274 The octave-devel port file may be used as an initial starting point. The port
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
275 file is accessible from the web at the link below.
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
276
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
277 http://trac.macports.org/browser/trunk/dports/math/octave-devel/Portfile
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
278
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
279 It is also available locally at the location below. The parametere ${prefix} is
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
280 corresponds to where MacPorts is install, which by default is "/opt/local".
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
281
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
282 ${prefix}/var/macports/sources/rsync.macports.org/release/ports/math/octave-devel/Portfile
11410
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
283
12252
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
284 The local source tarball must be placed in the location below, where ${name}
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
285 and ${distname} are each specified in the port file.
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
286
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
287 ${prefix}/var/macports/distfiles/${name}/${disname}.tar.gz
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
288
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
289
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
290 2.4.2 Building for Active Development of Octave
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
291 -----------------------------------------------
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
292
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
293 To satisfy Octave's dependencies, first install the octave-devel port.
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
294
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
295 sudo port selfupdate
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
296 sudo port install octave-devel
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
297
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
298 Next run octave to determine the configure options needed to build Octave using
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
299 MacPorts. At Octave's prompt type the command below and make note of the result,
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
300 ${config_opts}.
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
301
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
302 octave:1> octave_config_info.config_opts
11410
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
303
12252
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
304 Now uninstall the Octave port.
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
305
12266
a319d7ed61c6 README.MacOS: Modify instructions for MacPorts to deactivate rather than uninstall octave.
Ben Abbott <bpabbott@mac.com>
parents: 12252
diff changeset
306 sudo port deactivate octave-devel
12252
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
307
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
308 This will remove Octave and leave its dependencies in place. Now Octave may be
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
309 built from the local mercurial archive by typing the commands below, where the
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
310 configure options mentioned above are substituted for the parameter
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
311 ${config_opts}. If the sources being built are from the mercurial archive, then
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
312 ./autogen.sh must be run prior to ./configure.
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
313
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
314 ./configure ${config_opts}
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
315 make
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
316
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
317 Octave's intergrated tests may be run.
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
318
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
319 make check
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
320
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
321 However, "make install" should not be run as it may damage or corrupt the
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
322 MacPorts installation. To run Octave, type the command below from the root of
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
323 the mercurial archive.
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
324
6a82092ffaea README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
325 ./run-octave
11386
fba7b5538b18 README.MacOS: New file with build instructions for Mac OS systems.
Rik <octave@nomad.inbox5.com>
parents:
diff changeset
326
fba7b5538b18 README.MacOS: New file with build instructions for Mac OS systems.
Rik <octave@nomad.inbox5.com>
parents:
diff changeset
327
11410
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
328 John W. Eaton
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
329 jwe@octave.org
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
330
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
331 Ben Abbott
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
332 bpabbott@mac.com
2df163be223e Update build instructions in README.MacOS
Ben Abbott <bpabbott@mac.com>
parents: 11386
diff changeset
333
11582
21dec063e89f More updates to top-level README documentation files ahead of 3.4 release.
Rik <octave@nomad.inbox5.com>
parents: 11443
diff changeset
334 Last updated: Sat, 28 Oct 2010 16:06:00 EDT