annotate README.MacOS @ 12218:e3048d7fb131

remove ARPACK from documentation and some config files
author John W. Eaton <jwe@octave.org>
date Sun, 30 Jan 2011 02:43:10 -0500
parents ebaae4fddf4b
children 88a8248f5b97
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
12172
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
1 1. Easy to install Binary Releases
2ba904181687 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
12172
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
14
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
15 2. Building from Source
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
16 =======================
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
17
2ba904181687 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
2ba904181687 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
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
20 the links below.
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
21
2ba904181687 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/
2ba904181687 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/
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
24
2ba904181687 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
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
26 below.
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
27
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
28 ftp://alpha.gnu.org/gnu/octave
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
29
2ba904181687 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
2ba904181687 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
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
32 web-site below.
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
33
2ba904181687 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
12172
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
40 2.1 Developer's Tools
2ba904181687 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
12203
ebaae4fddf4b README.MacOS: Spelling corrections.
Ben Abbott <bpabbott@mac.com>
parents: 12201
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
12172
2ba904181687 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.
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
46
2ba904181687 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
2ba904181687 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
12172
2ba904181687 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
2ba904181687 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
2ba904181687 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.
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
55
2ba904181687 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
2ba904181687 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
2ba904181687 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
2ba904181687 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
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
60 LDFLAGS would begin as,
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
61
2ba904181687 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 [...]"
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
63
2ba904181687 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
2ba904181687 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
2ba904181687 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.
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
67
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
68
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
69 2.2 Manual Package Management
2ba904181687 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
12203
ebaae4fddf4b README.MacOS: Spelling corrections.
Ben Abbott <bpabbott@mac.com>
parents: 12201
diff changeset
72 Instructions for building Octave are available on the web at the link below.
12200
c2d2f880dca2 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12186
diff changeset
73
c2d2f880dca2 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12186
diff changeset
74 http://wiki.octave.org/wiki.pl?BuildFromSource
c2d2f880dca2 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12186
diff changeset
75
c2d2f880dca2 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12186
diff changeset
76 In additionn, those wishing to build on MacOS X (10.6.x) should read section
c2d2f880dca2 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12186
diff changeset
77 2.1 above.
c2d2f880dca2 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12186
diff changeset
78
c2d2f880dca2 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12186
diff changeset
79 2.2.1 Critical Dependencies
c2d2f880dca2 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12186
diff changeset
80 ---------------------------
c2d2f880dca2 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12186
diff changeset
81
c2d2f880dca2 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12186
diff changeset
82 The minimal dependencies needed to build Octave's snap-shots are listed below.
c2d2f880dca2 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12186
diff changeset
83
c2d2f880dca2 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12186
diff changeset
84 * Xcode
c2d2f880dca2 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12186
diff changeset
85
c2d2f880dca2 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12186
diff changeset
86 * gfortran: Available from http://r.reseach.att.com/tools
c2d2f880dca2 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12186
diff changeset
87
c2d2f880dca2 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12186
diff changeset
88 * gnu sed: Availabel from http://www.gnu.org/software/sed/
c2d2f880dca2 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12186
diff changeset
89
c2d2f880dca2 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12186
diff changeset
90 ./configure --prefix=/usr
c2d2f880dca2 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12186
diff changeset
91 make
c2d2f880dca2 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12186
diff changeset
92 make install
c2d2f880dca2 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12186
diff changeset
93
c2d2f880dca2 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12186
diff changeset
94 * fftw3: Available from http://www.fftw.org/download.html
c2d2f880dca2 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12186
diff changeset
95
12201
765b15fd3b3d README.MacOS: Additional modifications for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12200
diff changeset
96 export F77="/usr/bin/gfortran"
12200
c2d2f880dca2 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12186
diff changeset
97 export CFLAGS="-arch i686 -arch x86_64"
c2d2f880dca2 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12186
diff changeset
98 export FFLAGS="$CFLAGS"
c2d2f880dca2 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12186
diff changeset
99 export LDLAGS="$CFLAGS"
c2d2f880dca2 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12186
diff changeset
100 ./configure --disable-dependency-tracking
c2d2f880dca2 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12186
diff changeset
101 make
12201
765b15fd3b3d README.MacOS: Additional modifications for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12200
diff changeset
102 sudo make install
765b15fd3b3d README.MacOS: Additional modifications for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12200
diff changeset
103 make clean
765b15fd3b3d README.MacOS: Additional modifications for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12200
diff changeset
104 ./configure --enable-float --disable-dependency-tracking
765b15fd3b3d README.MacOS: Additional modifications for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12200
diff changeset
105 make
765b15fd3b3d README.MacOS: Additional modifications for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12200
diff changeset
106 sudo make install
12200
c2d2f880dca2 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12186
diff changeset
107
c2d2f880dca2 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12186
diff changeset
108 A fully functional Octave requires additional dependencies. See the link below
c2d2f880dca2 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12186
diff changeset
109 for the details.
c2d2f880dca2 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12186
diff changeset
110
c2d2f880dca2 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12186
diff changeset
111 http://wiki.octave.org/wiki.pl?BuildFromSource
c2d2f880dca2 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12186
diff changeset
112
c2d2f880dca2 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12186
diff changeset
113 2.2.2 Building Octave as a 32bit Application
c2d2f880dca2 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12186
diff changeset
114 --------------------------------------------
c2d2f880dca2 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12186
diff changeset
115
c2d2f880dca2 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12186
diff changeset
116 The commands below are sufficient to build a 32bit Octave.
c2d2f880dca2 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12186
diff changeset
117
c2d2f880dca2 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12186
diff changeset
118 export CFLAGS="-m32"
c2d2f880dca2 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12186
diff changeset
119 export FFLAGS="-m32 -ff2c"
c2d2f880dca2 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12186
diff changeset
120 export CPPFLAGS="-m32 -D_REENTRANT"
c2d2f880dca2 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12186
diff changeset
121 export LDFLAGS="-m32"
c2d2f880dca2 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12186
diff changeset
122 ./configure --disable-readline --disable-docs
c2d2f880dca2 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12186
diff changeset
123 make
c2d2f880dca2 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12186
diff changeset
124
c2d2f880dca2 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12186
diff changeset
125 Octave provides an interegrated tests suite.
c2d2f880dca2 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12186
diff changeset
126
c2d2f880dca2 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12186
diff changeset
127 make check
c2d2f880dca2 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12186
diff changeset
128
c2d2f880dca2 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12186
diff changeset
129 Octave may be run withou installing the application using the utility below.
c2d2f880dca2 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12186
diff changeset
130
c2d2f880dca2 README.MacOS: Modify instructions for building Octave manually.
Ben Abbott <bpabbott@mac.com>
parents: 12186
diff changeset
131 ./run-octave
12172
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
132
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
133
2ba904181687 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
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
135 ------------------------------------------------
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
136
2ba904181687 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.
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
138
2ba904181687 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
12172
2ba904181687 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
2ba904181687 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
2ba904181687 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
12172
2ba904181687 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
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
146 instructions to model the MacPorts secion.
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
147
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
148
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
149 2.3.1 Dependencies
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
150 ------------------
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
151
2ba904181687 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
12172
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
194
2ba904181687 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
2ba904181687 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
12172
2ba904181687 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
2ba904181687 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
2ba904181687 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
12172
2ba904181687 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".
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
236
2ba904181687 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.
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
238
2ba904181687 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
12172
2ba904181687 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
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
244
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
245 http://guide.macports.org/
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
246
2ba904181687 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
2ba904181687 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
2ba904181687 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
2ba904181687 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.
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
251
2ba904181687 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
2ba904181687 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
2ba904181687 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
2ba904181687 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").
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
256
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
257
2ba904181687 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
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
259 ------------------------------------
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
260
2ba904181687 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
2ba904181687 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
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
263 snapshots, enter the commands below.
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
264
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
265 sudo port selfupdate
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
266 sudo port install octave-devel
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
267
2ba904181687 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
2ba904181687 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
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
270 port file repository (link below).
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
271
2ba904181687 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
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
273
2ba904181687 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
2ba904181687 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.
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
276
2ba904181687 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
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
278
2ba904181687 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
2ba904181687 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".
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
281
2ba904181687 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
12172
2ba904181687 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}
2ba904181687 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.
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
286
2ba904181687 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
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
288
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
289
2ba904181687 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
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
291 -----------------------------------------------
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
292
2ba904181687 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.
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
294
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
295 sudo port selfupdate
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
296 sudo port install octave-devel
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
297
2ba904181687 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
2ba904181687 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,
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
300 ${config_opts}.
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
301
2ba904181687 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
12172
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
304 Now uninstall the Octave port.
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
305
12186
75f12ba604b4 README.MacOS: Modify instructions for MacPorts to deactivate rather than uninstall octave.
Ben Abbott <bpabbott@mac.com>
parents: 12172
diff changeset
306 sudo port deactivate octave-devel
12172
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
307
2ba904181687 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
2ba904181687 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
2ba904181687 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
2ba904181687 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
2ba904181687 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.
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
313
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
314 ./configure ${config_opts}
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
315 make
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
316
2ba904181687 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.
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
318
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
319 make check
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
320
2ba904181687 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
2ba904181687 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
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
323 the mercurial archive.
2ba904181687 README.MacOS: Modify organization, and update for MacPorts.
Ben Abbott <bpabbott@mac.com>
parents: 11582
diff changeset
324
2ba904181687 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