Mercurial > octave-nkf

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

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
version is now 3.3.91
author John W. Eaton <jwe@octave.org>
date Mon, 31 Jan 2011 08:36:58 -0500
parents dfe958c044a2
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
12144
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
1 1. General Users
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
2 ================
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
3
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
4 A MInGW bundle is available from sourceforge.
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
5
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
6 http://octave.sourceforge.net/index.html
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
7
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
8 2. Developers
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
9 =============
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
10
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
11 The process for building Octave from source is as follows.
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
12
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
13 * Install development tools and compiler
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
14 * Install or compile dependencies of Octave
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
15 * Download Octave source
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
16 * Configure and compile source
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
17
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
18 We strongly encourage experienced users to build Octave from the
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
19 testing and development snapshots to try the latest features of Octave.
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
20
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
21 A good tutorial on building Octave for version 3.2 is available from
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
22 http://octave.svn.sourceforge.net/viewvc/octave/trunk/octave-forge/admin/Windows/mingw32/HOWTO.txt
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
23
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
24 Additional information beyond the tutorial is summarized below.
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
25
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
26 2.1 Development tools and compiler
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
27 ----------------------
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
28 Msys + MinGW development Tools
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
29
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
30 The Msys + MinGW development Tools are required to build Octave from source.
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
31
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
32 The latest version of the Msys system is 1.0.16. For MinGW, search and use
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
33 the most recent version available. Note: The Howto.txt file describing
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
34 the development tools is rather old.
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
35
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
36 The latest GCC (GNU Complier Collection) for MinGW is gcc-4.5.0. Earlier
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
37 versions are not recommended for building Octave 3.4.xx.
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
38
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
39 The latest Msys, MinGW, and GCC tools can be downloaded from
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
40 http://sourceforge.net/projects/mingw/files/
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
41
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
42 (Compiling for 64-bit binaries requires mingw-64 toolkits. This has not been
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
43 tested.)
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
44
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
45 2.2 Dependencies
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
46 ----------------------
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
47
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
48 External program dependencies
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
49
12147
dfe958c044a2 Small corrections to README.MinGW.
Tatsuro MATSUOKA <tmacchant@yahoo.co.jp>
parents: 12144
diff changeset
50 * gnuplot (you can build this with the shell script mentioned in Howto.txt)
12144
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
51 * MikTeX
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
52 * ghostscript
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
53 * pstoedit (required for printing using FLTK (OpenGL) graphics)
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
54 * fig2dev (Optional; better quality for FLTK printing in some file formats)
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
55 * sed
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
56 * less
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
57
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
58 The tools below are required for building the development sources from
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
59 the Mercurial archive, but not for simply building Octave from a snapshot
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
60 tar.gz file.
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
61
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
62 * Mercurial
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
63 * git
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
64 * automake
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
65 * autoconf
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
66
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
67 Library dependencies
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
68
12147
dfe958c044a2 Small corrections to README.MinGW.
Tatsuro MATSUOKA <tmacchant@yahoo.co.jp>
parents: 12144
diff changeset
69 Please read Howto.txt carefully on how to build them. The Howto.txt is old
12144
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
70 so some revisions will be required when using GCC-4.5.0
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
71
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
72 2.3 Download Octave source
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
73 ----------------------
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
74
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
75 The source for testing snapshots can be downloaded from the official Octave
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
76 web site. http://www.gnu.org/software/octave/download.html
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
77
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
78 The very latest development code is also available via anonymous access to a
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
79 read-only Mercurial archive. The method of download is described on the web
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
80 site. You will also need to install gnulib as another dependency. Please
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
81 visit http://www.gnu.org/software/gnulib/ and download sources using git.
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
82
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
83 2.4 Configure and compile source
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
84 ----------------------
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
85
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
86 Building from source can be carried out using the script described in
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
87 Howto.txt.
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
88
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
89 When using GCC-4.5.0, remove flags for shared libstdc++ because a shared
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
90 build is already the default.
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
91
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
92 When running './configure', you must add '--enable-float-truncate' option.
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
93 Please see the following thread for more information:
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
94 http://thread.gmane.org/gmane.comp.gnu.octave.bugs/12361/focus=12404
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
95
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
96 To build development sources from the Mercurial repository you must run
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
97 'autogen.sh' (bootstrap) before running configure and make. This requires
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
98 that automake and autoconf tools be installed.
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
99
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
100
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
101 Tatsuro MATSUOKA
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
102 tmacchant@yahoo.co.jp
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
103
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
104 Benjamin Lindner
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
105 bjmldn@gmail.com
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
106
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
107
c06797c9bd0c README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
108 Last updated: Sat Jan 22 17:29:12 PST 2011