Mercurial > octave-nkf

annotate etc/README.MinGW @ 20614:10ec79b47808

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
use new string_value method to handle value extraction errors * __voronoi__.cc, chol.cc, colamd.cc, fftw.cc: Use new string_value method.
author John W. Eaton <jwe@octave.org>
date Thu, 08 Oct 2015 18:15:56 -0400
parents 446c46af4b42
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
12138
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
1 1. General Users
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
2 ================
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
3
2f728f9d32d4 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.
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
5
2f728f9d32d4 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
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
7
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
8 2. Developers
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
9 =============
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
10
2f728f9d32d4 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.
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
12
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
13 * Install development tools and compiler
2f728f9d32d4 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
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
15 * Download Octave source
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
16 * Configure and compile source
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
17
2f728f9d32d4 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
2f728f9d32d4 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.
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
20
19627
446c46af4b42 strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 15512
diff changeset
21 A good tutorial on building Octave for version 3.2 is available from
446c46af4b42 strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 15512
diff changeset
22 http://octave.svn.sourceforge.net/viewvc/octave/trunk/octave-forge/admin/Windows/mingw32/HOWTO.txt
12138
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
23
2f728f9d32d4 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.
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
25
2f728f9d32d4 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
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
27 ----------------------
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
28 Msys + MinGW development Tools
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
29
2f728f9d32d4 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.
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
31
2f728f9d32d4 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
2f728f9d32d4 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
2f728f9d32d4 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.
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
35
2f728f9d32d4 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
2f728f9d32d4 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.
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
38
19627
446c46af4b42 strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 15512
diff changeset
39 The latest Msys, MinGW, and GCC tools can be downloaded from
446c46af4b42 strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 15512
diff changeset
40 http://sourceforge.net/projects/mingw/files/
12138
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
41
2f728f9d32d4 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
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
43 tested.)
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
44
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
45 2.2 Dependencies
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
46 ----------------------
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
47
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
48 External program dependencies
19627
446c46af4b42 strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 15512
diff changeset
49
12141
f0e61a6a0fb4 Small corrections to README.MinGW.
Tatsuro MATSUOKA <tmacchant@yahoo.co.jp>
parents: 12138
diff changeset
50 * gnuplot (you can build this with the shell script mentioned in Howto.txt)
12138
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
51 * MikTeX
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
52 * ghostscript
2f728f9d32d4 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)
2f728f9d32d4 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)
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
55 * sed
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
56 * less
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
57
2f728f9d32d4 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
2f728f9d32d4 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
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
60 tar.gz file.
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
61
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
62 * Mercurial
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
63 * git
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
64 * automake
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
65 * autoconf
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
66
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
67 Library dependencies
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
68
12141
f0e61a6a0fb4 Small corrections to README.MinGW.
Tatsuro MATSUOKA <tmacchant@yahoo.co.jp>
parents: 12138
diff changeset
69 Please read Howto.txt carefully on how to build them. The Howto.txt is old
12138
2f728f9d32d4 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
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
71
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
72 2.3 Download Octave source
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
73 ----------------------
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
74
2f728f9d32d4 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
19627
446c46af4b42 strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 15512
diff changeset
76 web site. http://www.octave.org/download.html
12138
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
77
2f728f9d32d4 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
2f728f9d32d4 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
2f728f9d32d4 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
2f728f9d32d4 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.
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
82
2f728f9d32d4 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
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
84 ----------------------
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
85
2f728f9d32d4 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
19627
446c46af4b42 strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 15512
diff changeset
87 Howto.txt.
446c46af4b42 strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 15512
diff changeset
88
12138
2f728f9d32d4 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
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
90 build is already the default.
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
91
19627
446c46af4b42 strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 15512
diff changeset
92 When running './configure', you must add '--enable-float-truncate' option.
446c46af4b42 strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 15512
diff changeset
93 Please see the following thread for more information:
12138
2f728f9d32d4 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
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
95
2f728f9d32d4 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
15414
494f9bac8862 build: Rename autogen.sh script to bootstrap to conform to GNU guidelines.
Rik <rik@octave.org>
parents: 12733
diff changeset
97 bootstrap before running configure and make. This requires
12138
2f728f9d32d4 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.
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
99
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
100
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
101 Tatsuro MATSUOKA
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
102 tmacchant@yahoo.co.jp
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
103
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
104 Benjamin Lindner
19627
446c46af4b42 strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 15512
diff changeset
105 bjmldn@gmail.com
12138
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
106
2f728f9d32d4 README.MinGW: Replace placeholder with actual instructions for platform.
Rik <octave@nomad.inbox5.com>
parents: 11582
diff changeset
107
2f728f9d32d4 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