octave-lyh: doc/interpreter/install.txi annotate

annotate doc/interpreter/install.txi @ 14018:5d5685216876

Deprecate shell_cmd function and update system, dos, unix commands * NEWS: Announce deprecation of shell_cmd. * deprecated/shell_cmd.m: New file to hold documentation and warning for shell_cmd. * deprecated/module.mk: Add shell_cmd to build system. * mk_undocumented_list: Remove shell_cmd from undocumented list. * install.txi: Replace reference to shell_cmd with system. * dos.m, unix.m: Update docstrings and add %!test block. * toplev.cc (system): Update docstring and add %!test block.

author	Rik <octave@nomad.inbox5.com>
date	Thu, 08 Dec 2011 17:25:30 -0800
parents	b80b18f537ca
children	b0cdd60db5e5

rev	line source
11523 fd0a3ac60b0e update copyright notices John W. Eaton <jwe@octave.org> parents: 11302 diff changeset	1 @c Copyright (C) 1996-2011 John W. Eaton
7018 fd42779a8428 [project @ 2007-10-13 00:52:12 by jwe] jwe parents: 6778 diff changeset	2 @c
fd42779a8428 [project @ 2007-10-13 00:52:12 by jwe] jwe parents: 6778 diff changeset	3 @c This file is part of Octave.
fd42779a8428 [project @ 2007-10-13 00:52:12 by jwe] jwe parents: 6778 diff changeset	4 @c
fd42779a8428 [project @ 2007-10-13 00:52:12 by jwe] jwe parents: 6778 diff changeset	5 @c Octave is free software; you can redistribute it and/or modify it
fd42779a8428 [project @ 2007-10-13 00:52:12 by jwe] jwe parents: 6778 diff changeset	6 @c under the terms of the GNU General Public License as published by the
fd42779a8428 [project @ 2007-10-13 00:52:12 by jwe] jwe parents: 6778 diff changeset	7 @c Free Software Foundation; either version 3 of the License, or (at
fd42779a8428 [project @ 2007-10-13 00:52:12 by jwe] jwe parents: 6778 diff changeset	8 @c your option) any later version.
fd42779a8428 [project @ 2007-10-13 00:52:12 by jwe] jwe parents: 6778 diff changeset	9 @c
fd42779a8428 [project @ 2007-10-13 00:52:12 by jwe] jwe parents: 6778 diff changeset	10 @c Octave is distributed in the hope that it will be useful, but WITHOUT
fd42779a8428 [project @ 2007-10-13 00:52:12 by jwe] jwe parents: 6778 diff changeset	11 @c ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
fd42779a8428 [project @ 2007-10-13 00:52:12 by jwe] jwe parents: 6778 diff changeset	12 @c FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
fd42779a8428 [project @ 2007-10-13 00:52:12 by jwe] jwe parents: 6778 diff changeset	13 @c for more details.
fd42779a8428 [project @ 2007-10-13 00:52:12 by jwe] jwe parents: 6778 diff changeset	14 @c
fd42779a8428 [project @ 2007-10-13 00:52:12 by jwe] jwe parents: 6778 diff changeset	15 @c You should have received a copy of the GNU General Public License
fd42779a8428 [project @ 2007-10-13 00:52:12 by jwe] jwe parents: 6778 diff changeset	16 @c along with Octave; see the file COPYING. If not, see
fd42779a8428 [project @ 2007-10-13 00:52:12 by jwe] jwe parents: 6778 diff changeset	17 @c <http://www.gnu.org/licenses/>.
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	18
7018 fd42779a8428 [project @ 2007-10-13 00:52:12 by jwe] jwe parents: 6778 diff changeset	19 @c The text of this file appears in the file INSTALL in the Octave
fd42779a8428 [project @ 2007-10-13 00:52:12 by jwe] jwe parents: 6778 diff changeset	20 @c distribution, as well as in the Octave manual.
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	21
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	22 @ifclear INSTALLONLY
4167 aae05d51353c [project @ 2002-11-12 02:52:50 by jwe] jwe parents: 3960 diff changeset	23 @node Installation
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	24 @appendix Installing Octave
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	25 @end ifclear
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	26
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	27 @ifset INSTALLONLY
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	28
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	29 This file documents the installation of Octave.
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	30
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	31 Octave is free software; you can redistribute it and/or modify it
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	32 under the terms of the GNU General Public License as published by the
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	33 Free Software Foundation.
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	34
12973 b80b18f537ca doc: Correct various Texinfo warnings about incorrect use of macros. Rik <octave@nomad.inbox5.com> parents: 12702 diff changeset	35 @strong{Note}: This file is automatically generated from
9031 1052a66078cf Documentation cleanup of top-level Octave directory (READMEs, INSTALL) Rik <rdrider0-list@yahoo.com> parents: 8920 diff changeset	36 @file{doc/interpreter/install.txi} in the Octave sources. To update
1052a66078cf Documentation cleanup of top-level Octave directory (READMEs, INSTALL) Rik <rdrider0-list@yahoo.com> parents: 8920 diff changeset	37 the documentation make changes to the .txi source file rather than this
1052a66078cf Documentation cleanup of top-level Octave directory (READMEs, INSTALL) Rik <rdrider0-list@yahoo.com> parents: 8920 diff changeset	38 derived file.
7144 30c0533e39ae [project @ 2007-11-09 17:37:24 by jwe] jwe parents: 7091 diff changeset	39
4167 aae05d51353c [project @ 2002-11-12 02:52:50 by jwe] jwe parents: 3960 diff changeset	40 @node Installation
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	41 @chapter Installing Octave
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	42 @end ifset
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	43
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	44 @cindex installing Octave
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	45
12152 8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	46 The procedure for installing Octave from source on a Unix-like system is
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	47 described below. Building on other platforms will follow similar steps.
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	48
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	49 @itemize @bullet
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	50 @item
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	51 Run the shell script @file{configure}. This will determine the features
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	52 your system has (or doesn't have) and create a file named
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	53 @file{Makefile} from each of the files named @file{Makefile.in}.
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	54
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	55 Here is a summary of the configure options that are most frequently used
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	56 when building Octave:
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	57
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	58 @table @code
12152 8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	59 @item --help
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	60 Print a summary of the options recognized by the configure script.
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	61
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	62 @item --prefix=@var{prefix}
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	63 Install Octave in subdirectories below @var{prefix}. The default value
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	64 of @var{prefix} is @file{/usr/local}.
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	65
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	66 @item --srcdir=@var{dir}
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	67 Look for Octave sources in the directory @var{dir}.
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	68
12152 8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	69 @item --enable-64
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	70 This is an @strong{experimental} option to enable Octave to use 64-bit
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	71 integers for array dimensions and indexing on 64-bit platforms. You
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	72 probably don't want to use this option unless you know what you are
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	73 doing. @xref{Compiling Octave with 64-bit Indexing}, for more details
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	74 about building Octave with this option.
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	75
7091 5608935ff522 [project @ 2007-10-31 21:26:39 by jwe] jwe parents: 7081 diff changeset	76 @item --enable-bounds-check
5608935ff522 [project @ 2007-10-31 21:26:39 by jwe] jwe parents: 7081 diff changeset	77 Enable bounds checking for indexing operators in the internal array
5608935ff522 [project @ 2007-10-31 21:26:39 by jwe] jwe parents: 7081 diff changeset	78 classes. This option is primarily used for debugging Octave. Building
8325 b93ac0586e4b spelling corrections Brian Gough<bjg@network-theory.co.uk> parents: 7144 diff changeset	79 Octave with this option has a negative impact on performance and is not
7091 5608935ff522 [project @ 2007-10-31 21:26:39 by jwe] jwe parents: 7081 diff changeset	80 recommended for general use.
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	81
12152 8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	82 @item --disable-docs
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	83 Disable building all forms of the documentation (Info, PDF, HTML). The
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	84 default is to build documentation, but your system will need functioning
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	85 Texinfo and Tex installs for this to succeed.
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	86
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	87 @item --enable-float-truncate
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	88 This option allows for truncation of intermediate floating point results
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	89 in calculations. It is only necessary for certain platforms.
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	90
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	91 @item --enable-readline
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	92 Use the readline library to provide for editing of the command line in
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	93 terminal environments. This option is on by default.
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	94
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	95 @item --enable-shared
7091 5608935ff522 [project @ 2007-10-31 21:26:39 by jwe] jwe parents: 7081 diff changeset	96 Create shared libraries (this is the default). If you are planning to
5608935ff522 [project @ 2007-10-31 21:26:39 by jwe] jwe parents: 7081 diff changeset	97 use the dynamic loading features, you will probably want to use this
5608935ff522 [project @ 2007-10-31 21:26:39 by jwe] jwe parents: 7081 diff changeset	98 option. It will make your @file{.oct} files much smaller and on some
5608935ff522 [project @ 2007-10-31 21:26:39 by jwe] jwe parents: 7081 diff changeset	99 systems it may be necessary to build shared libraries in order to use
5608935ff522 [project @ 2007-10-31 21:26:39 by jwe] jwe parents: 7081 diff changeset	100 dynamically linked functions.
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	101
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	102 You may also want to build a shared version of @code{libstdc++}, if your
7081 503001863427 [project @ 2007-10-31 01:08:14 by jwe] jwe parents: 7018 diff changeset	103 system doesn't already have one.
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	104
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	105 @item --enable-dl
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	106 Use @code{dlopen} and friends to make Octave capable of dynamically
7091 5608935ff522 [project @ 2007-10-31 21:26:39 by jwe] jwe parents: 7081 diff changeset	107 linking externally compiled functions (this is the default if
12152 8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	108 @option{--enable-shared} is specified). This option only works on
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	109 systems that actually have these functions. If you plan on using this
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	110 feature, you should probably also use @option{--enable-shared} to reduce
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	111 the size of your @file{.oct} files.
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	112
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	113 @item --with-blas=<lib>
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	114 By default, configure looks for the best @sc{blas} matrix libraries on
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	115 your system, including optimized implementations such as the free ATLAS
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	116 3.0, as well as vendor-tuned libraries. (The use of an optimized
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	117 @sc{blas} will generally result in several-times faster matrix
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	118 operations.) Use this option to specify a particular @sc{blas} library
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	119 that Octave should use.
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	120
12152 8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	121 @item --with-lapack=<lib>
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	122 By default, configure looks for the best @sc{lapack} matrix libraries on
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	123 your system, including optimized implementations such as the free ATLAS
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	124 3.0, as well as vendor-tuned libraries. (The use of an optimized
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	125 @sc{lapack} will generally result in several-times faster matrix
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	126 operations.) Use this option to specify a particular @sc{lapack}
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	127 library that Octave should use.
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	128
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	129 @item --with-magick=<lib>
12575 d0b799dafede Grammarcheck files for 3.4.1 release. Rik <octave@nomad.inbox5.com> parents: 12462 diff changeset	130 Select the library to use for image I/O@. The two possible values are
12152 8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	131 "GraphicsMagick" (default) or "ImageMagick".
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	132
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	133 @item --with-sepchar=<char>
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	134 Use <char> as the path separation character. This option can help when
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	135 running Octave on non-Unix systems.
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	136
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	137 @item --without-amd
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	138 Don't use @sc{amd}, disable some sparse matrix functionality.
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	139
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	140 @item --without-camd
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	141 Don't use @sc{camd}, disable some sparse matrix functionality.
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	142
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	143 @item --without-colamd
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	144 Don't use @sc{colamd}, disable some sparse matrix functionality.
7091 5608935ff522 [project @ 2007-10-31 21:26:39 by jwe] jwe parents: 7081 diff changeset	145
5608935ff522 [project @ 2007-10-31 21:26:39 by jwe] jwe parents: 7081 diff changeset	146 @item --without-ccolamd
10828 322f43e0e170 Grammarcheck .txi documentation files. Rik <octave@nomad.inbox5.com> parents: 10711 diff changeset	147 Don't use @sc{ccolamd}, disable some sparse matrix functionality.
7091 5608935ff522 [project @ 2007-10-31 21:26:39 by jwe] jwe parents: 7081 diff changeset	148
12152 8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	149 @item --without-cholmod
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	150 Don't use @sc{cholmod}, disable some sparse matrix functionality.
7091 5608935ff522 [project @ 2007-10-31 21:26:39 by jwe] jwe parents: 7081 diff changeset	151
5608935ff522 [project @ 2007-10-31 21:26:39 by jwe] jwe parents: 7081 diff changeset	152 @item --without-curl
12152 8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	153 Don't use the cURL library, disable the ftp objects, @code{urlread} and
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	154 @code{urlwrite} functions.
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	155
7091 5608935ff522 [project @ 2007-10-31 21:26:39 by jwe] jwe parents: 7081 diff changeset	156 @item --without-cxsparse
10828 322f43e0e170 Grammarcheck .txi documentation files. Rik <octave@nomad.inbox5.com> parents: 10711 diff changeset	157 Don't use @sc{cxsparse}, disable some sparse matrix functionality.
7091 5608935ff522 [project @ 2007-10-31 21:26:39 by jwe] jwe parents: 7081 diff changeset	158
12152 8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	159 @item --without-fftw3
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	160 Use the included @sc{fftpack} library for computing Fast Fourier
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	161 Transforms instead of the @sc{fftw3} library.
7091 5608935ff522 [project @ 2007-10-31 21:26:39 by jwe] jwe parents: 7081 diff changeset	162
12152 8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	163 @item --without-fftw3f
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	164 Use the included @sc{fftpack} library for computing Fast Fourier
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	165 Transforms instead of the @sc{fftw3} library when operating on single
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	166 precision (float) values.
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	167
7091 5608935ff522 [project @ 2007-10-31 21:26:39 by jwe] jwe parents: 7081 diff changeset	168 @item --without-glpk
10828 322f43e0e170 Grammarcheck .txi documentation files. Rik <octave@nomad.inbox5.com> parents: 10711 diff changeset	169 Don't use the @sc{glpk} library for linear programming.
7091 5608935ff522 [project @ 2007-10-31 21:26:39 by jwe] jwe parents: 7081 diff changeset	170
5608935ff522 [project @ 2007-10-31 21:26:39 by jwe] jwe parents: 7081 diff changeset	171 @item --without-hdf5
12152 8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	172 Don't use the @sc{hdf5} library, disable reading and writing of
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	173 @sc{hdf5} files.
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	174
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	175 @item --without-opengl
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	176 Don't use OpenGL, disable native graphics toolkit for plotting. You
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	177 will need @code{gnuplot} installed in order to make plots.
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	178
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	179 @item --without-qhull
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	180 Don't use Qhull, disable @code{delaunay}, @code{convhull}, and
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	181 related functions.
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	182
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	183 @item --without-qrupdate
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	184 Don't use @sc{qrupdate}, disable QR and Cholesky update functions.
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	185
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	186 @item --without-umfpack
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	187 Don't use @sc{umfpack}, disable some sparse matrix functionality.
7091 5608935ff522 [project @ 2007-10-31 21:26:39 by jwe] jwe parents: 7081 diff changeset	188
5608935ff522 [project @ 2007-10-31 21:26:39 by jwe] jwe parents: 7081 diff changeset	189 @item --without-zlib
5608935ff522 [project @ 2007-10-31 21:26:39 by jwe] jwe parents: 7081 diff changeset	190 Don't use the zlib library, disable data file compression and support
5608935ff522 [project @ 2007-10-31 21:26:39 by jwe] jwe parents: 7081 diff changeset	191 for recent MAT file formats.
5608935ff522 [project @ 2007-10-31 21:26:39 by jwe] jwe parents: 7081 diff changeset	192
8791 d943e26d30e2 Add documentation for configure options "--without-framework-carbon" and "--without-framework-opengl". Thomas Treichl <Thomas.Treichl@gmx.net> parents: 8481 diff changeset	193 @item --without-framework-carbon
12152 8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	194 Don't use framework Carbon headers, libraries, or specific source code
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	195 even if the configure test succeeds (the default is to use Carbon
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	196 framework if available). This is a platform specific configure option
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	197 for Mac systems.
8791 d943e26d30e2 Add documentation for configure options "--without-framework-carbon" and "--without-framework-opengl". Thomas Treichl <Thomas.Treichl@gmx.net> parents: 8481 diff changeset	198
d943e26d30e2 Add documentation for configure options "--without-framework-carbon" and "--without-framework-opengl". Thomas Treichl <Thomas.Treichl@gmx.net> parents: 8481 diff changeset	199 @item --without-framework-opengl
12152 8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	200 Don't use framework OpenGL headers, libraries, or specific source code
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	201 even if the configure test succeeds. If this option is given then
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	202 OpenGL headers and libraries in standard system locations are tested
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	203 (the default value is @option{--with-framework-opengl}). This is a
8791 d943e26d30e2 Add documentation for configure options "--without-framework-carbon" and "--without-framework-opengl". Thomas Treichl <Thomas.Treichl@gmx.net> parents: 8481 diff changeset	204 platform specific configure option for Mac systems.
d943e26d30e2 Add documentation for configure options "--without-framework-carbon" and "--without-framework-opengl". Thomas Treichl <Thomas.Treichl@gmx.net> parents: 8481 diff changeset	205
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	206 @end table
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	207
9031 1052a66078cf Documentation cleanup of top-level Octave directory (READMEs, INSTALL) Rik <rdrider0-list@yahoo.com> parents: 8920 diff changeset	208 See the file @file{INSTALL} for more general information about the
1052a66078cf Documentation cleanup of top-level Octave directory (READMEs, INSTALL) Rik <rdrider0-list@yahoo.com> parents: 8920 diff changeset	209 command line options used by configure. That file also contains
12152 8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	210 instructions for compiling in a directory other than the one where
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	211 the source is located.
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	212
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	213 @item
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	214 Run make.
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	215
12152 8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	216 You will need a recent version of GNU Make as Octave relies on certain
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	217 features not generally available in all versions of make. Modifying
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	218 Octave's makefiles to work with other make programs is probably not
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	219 worth your time; instead, we simply recommend installing GNU Make.
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	220
12152 8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	221 There are currently two options for plotting in Octave: (1) the external
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	222 program gnuplot, or (2) the internal graphics engine using OpenGL and
12575 d0b799dafede Grammarcheck files for 3.4.1 release. Rik <octave@nomad.inbox5.com> parents: 12462 diff changeset	223 FLTK@. Gnuplot is a command-driven interactive function plotting
12152 8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	224 program. Gnuplot is copyrighted, but freely distributable. As of
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	225 Octave release 3.4, gnuplot is the default option for plotting. But,
12702 013cd94d8d7f doc: Spelling fixes for various documentation files John Bradshaw <john@johnbradshaw.org> parents: 12575 diff changeset	226 the internal graphics engine is nearly 100% compatible, certainly for
12152 8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	227 most ordinary plots, and users are encouraged to test it. It is
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	228 anticipated that the internal engine will become the default option at
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	229 the next major release of Octave.
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	230
12152 8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	231 To compile Octave, you will need a recent version of @code{g++} or other
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	232 ANSI C++ compiler. In addition, you will need a Fortran 77 compiler or
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	233 @code{f2c}. If you use @code{f2c}, you will need a script like
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	234 @code{fort77} that works like a normal Fortran compiler by combining
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	235 @code{f2c} with your C compiler in a single script.
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	236
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	237 If you plan to modify the parser you will also need GNU @code{bison} and
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	238 @code{flex}. If you modify the documentation, you will need GNU
11291 5abe6815aa5e install.txi: delete obsolete statement about needing a patch for makeinfo John W. Eaton <jwe@octave.org> parents: 10846 diff changeset	239 Texinfo.
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	240
12152 8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	241 GNU Make, @code{gcc} (and @code{libstdc++}), @code{gnuplot},
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	242 @code{bison}, @code{flex}, and Texinfo are all available from many
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	243 anonymous ftp archives. The primary site is @url{ftp.gnu.org}, but it
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	244 is often very busy. A list of sites that mirror the software on
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	245 @url{ftp.gnu.org} is available by anonymous ftp from
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	246 @url{ftp://ftp.gnu.org/pub/gnu/GNUinfo/FTP}.
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	247
12152 8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	248 Octave requires approximately 1.4 GB of disk storage to unpack and
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	249 compile from source (significantly less, 400 MB, if you don't compile
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	250 with debugging symbols). To compile without debugging symbols try the
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	251 command
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	252
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	253 @example
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	254 make CFLAGS=-O CXXFLAGS=-O LDFLAGS=
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	255 @end example
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	256
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	257 @noindent
11302 e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	258 instead of just @command{make}.
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	259
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	260 @item
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	261 If you encounter errors while compiling Octave, first check the list of
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	262 known problems below to see if there is a workaround or solution for
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	263 your problem. If not,
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	264 @ifclear INSTALLONLY
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	265 see @ref{Trouble},
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	266 @end ifclear
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	267 @ifset INSTALLONLY
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	268 see the file BUGS
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	269 @end ifset
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	270 for information about how to report bugs.
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	271
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	272 @item
11302 e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	273 Once you have successfully compiled Octave, run @code{make install}.
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	274
8481 00df69d7e698 [docs] capitalize Octave consistently Brian Gough <bjg@gnu.org> parents: 8325 diff changeset	275 This will install a copy of Octave, its libraries, and its documentation
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	276 in the destination directory. As distributed, Octave is installed in
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	277 the following directories. In the table below, @var{prefix} defaults to
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	278 @file{/usr/local}, @var{version} stands for the current version number
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	279 of the interpreter, and @var{arch} is the type of computer on which
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	280 Octave is installed (for example, @samp{i586-unknown-gnu}).
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	281
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	282 @table @file
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	283 @item @var{prefix}/bin
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	284 Octave and other binaries that people will want to run directly.
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	285
12152 8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	286 @item @var{prefix}/lib/octave-@var{version}
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	287 Libraries like libcruft.a and liboctave.a.
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	288
12152 8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	289 @item @var{prefix}/octave-@var{version}/include/octave
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	290 Include files distributed with Octave.
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	291
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	292 @item @var{prefix}/share
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	293 Architecture-independent data files.
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	294
12152 8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	295 @item @var{prefix}/share/man/man1
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	296 Unix-style man pages describing Octave.
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	297
12152 8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	298 @item @var{prefix}/share/info
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	299 Info files describing Octave.
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	300
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	301 @item @var{prefix}/share/octave/@var{version}/m
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	302 Function files distributed with Octave. This includes the Octave
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	303 version, so that multiple versions of Octave may be installed at the
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	304 same time.
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	305
12152 8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	306 @item @var{prefix}/libexec/octave/@var{version}/exec/@var{arch}
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	307 Executables to be run by Octave rather than the user.
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	308
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	309 @item @var{prefix}/lib/octave/@var{version}/oct/@var{arch}
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	310 Object files that will be dynamically loaded.
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	311
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	312 @item @var{prefix}/share/octave/@var{version}/imagelib
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	313 Image files that are distributed with Octave.
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	314 @end table
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	315 @end itemize
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	316
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	317 @menu
11302 e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	318 * Compiling Octave with 64-bit Indexing::
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	319 * Installation Problems::
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	320 @end menu
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	321
11302 e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	322 @node Compiling Octave with 64-bit Indexing
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	323 @appendixsec Compiling Octave with 64-bit Indexing
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	324
12152 8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	325 Note: the following only applies to systems that have 64-bit pointers.
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	326 Configuring Octave with @option{--enable-64} cannot magically make a
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	327 32-bit system have a 64-bit address space.
11302 e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	328
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	329 On 64-bit systems, Octave is limited to (approximately) the following
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	330 array sizes when using the default 32-bit indexing mode:
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	331
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	332 @example
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	333 @group
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	334 double: 16GB
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	335 single: 8GB
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	336 uint64, int64: 16GB
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	337 uint32, int32: 8GB
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	338 uint16, int16: 4GB
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	339 uint8, int8: 2GB
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	340 @end group
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	341 @end example
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	342
12152 8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	343 In each case, the limit is really (approximately) @math{2^{31}} elements
11302 e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	344 because of the default type of the value used for indexing arrays
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	345 (signed 32-bit integer, corresponding to the size of a Fortran INTEGER
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	346 value).
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	347
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	348 Trying to create larger arrays will produce the following error:
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	349
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	350 @example
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	351 @group
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	352 octave:1> a = zeros (102410241024*3, 1, 'int8');
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	353 error: memory exhausted or requested size too large
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	354 for range of Octave's index type --
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	355 trying to return to prompt
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	356 @end group
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	357 @end example
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	358
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	359 @noindent
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	360 You will obtain this error even if your system has enough memory to
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	361 create this array (4 GB in the above case).
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	362
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	363 To use arrays larger than 2 GB, Octave has to be configured with the
12152 8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	364 option @option{--enable-64}. This option is experimental and you are
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	365 encouraged to submit bug reports if you find a problem. With this
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	366 option, Octave will use 64-bit integers internally for array dimensions
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	367 and indexing. However, all numerical libraries used by Octave will
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	368 @strong{also} need to use 64-bit integers for array dimensions and
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	369 indexing. In most cases, this means they will need to be compiled from
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	370 source since most (all?) distributions which package these libraries
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	371 compile them with the default Fortran integer size, which is normally
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	372 32-bits wide.
11302 e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	373
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	374 The following instructions were tested with the development version of
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	375 Octave and GCC 4.3.4 on an x86_64 Debian system.
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	376
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	377 The versions listed below are the versions used for testing. If newer
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	378 versions of these packages are available, you should try to use them,
12152 8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	379 although there may be some differences.
11302 e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	380
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	381 All libraries and header files will be installed in subdirectories of
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	382 @code{$prefix64} (you must choose the location of this directory).
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	383
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	384 @itemize @bullet
12152 8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	385 @item @sc{blas} and @sc{lapack} (@url{http://www.netlib.org/lapack})
11302 e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	386
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	387 Reference versions for both libraries are included in the reference
11573 6f8ffe2c6f76 Grammarcheck txi files for 3.4 release. Rik <octave@nomad.inbox5.com> parents: 11523 diff changeset	388 @sc{lapack} 3.2.1 distribution from @url{netlib.org}.
11302 e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	389
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	390 @itemize @minus
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	391 @item
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	392 Copy the file @file{make.inc.example} and name it @file{make.inc}.
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	393 The options @option{-fdefault-integer-8} and @option{-fPIC} (on 64-bit
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	394 CPU) have to be added to the variable @code{OPTS} and @code{NOOPT}.
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	395
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	396 @item
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	397 Once you have compiled this library make sure that you use it for
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	398 compiling Suite Sparse and Octave. In the following we assume that
11573 6f8ffe2c6f76 Grammarcheck txi files for 3.4 release. Rik <octave@nomad.inbox5.com> parents: 11523 diff changeset	399 you installed the @sc{lapack} library as $prefix64/lib/liblapack.a.
11302 e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	400 @end itemize
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	401
12152 8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	402 @item QRUPDATE (@url{http://sourceforge.net/projects/qrupdate})
11302 e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	403
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	404 In the @file{Makeconf} file:
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	405
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	406 @itemize @minus
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	407 @item
11573 6f8ffe2c6f76 Grammarcheck txi files for 3.4 release. Rik <octave@nomad.inbox5.com> parents: 11523 diff changeset	408 Add @option{-fdefault-integer-8} to @env{FFLAGS}.
11302 e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	409
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	410 @item
12152 8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	411 Adjust the @sc{blas} and @sc{lapack} variables as needed if your 64-bit
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	412 aware @sc{blas} and @sc{lapack} libraries are in a non-standard
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	413 location.
11302 e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	414
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	415 @item
11573 6f8ffe2c6f76 Grammarcheck txi files for 3.4 release. Rik <octave@nomad.inbox5.com> parents: 11523 diff changeset	416 Set @env{PREFIX} to the top-level directory of your install tree.
11302 e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	417
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	418 @item
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	419 Run @code{make solib} to make a shared library.
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	420
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	421 @item
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	422 Run @code{make install} to install the library.
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	423 @end itemize
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	424
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	425 @item
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	426 SuiteSparse (@url{http://www.cise.ufl.edu/research/sparse/SuiteSparse})
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	427
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	428 @itemize @minus
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	429 @item
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	430 In @file{UFconfig/UFconfig.mk} use the following options for
11573 6f8ffe2c6f76 Grammarcheck txi files for 3.4 release. Rik <octave@nomad.inbox5.com> parents: 11523 diff changeset	431 @env{CFLAGS} and @env{F77FLAGS}:
11302 e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	432
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	433 @example
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	434 @group
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	435 CC = gcc
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	436 CFLAGS = -fPIC -O -DLP64 -DLONGBLAS='long int' -DLONG='long int'
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	437 F77 = gfortran
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	438 F77FLAGS = -fPIC -O -fdefault-integer-8
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	439 BLAS = -L$BLAS/lib -lblas -lgfortran"
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	440 LAPACK = -L$LAPACK/lib -llapack"
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	441 @end group
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	442 @end example
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	443
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	444 @item
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	445 Disable the GPL-incompatible @code{METIS} library:
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	446
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	447 @example
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	448 @group
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	449 CHOLMOD_CONFIG = -DNPARTITION
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	450 SPQR_CONFIG = -DNPARTITION
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	451 METIS_PATH =
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	452 METIS =
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	453 @end group
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	454 @end example
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	455
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	456 @item
12152 8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	457 Disable the @code{DI} versions of the @code{CHOLMOD} library files by
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	458 setting
11302 e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	459
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	460 @example
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	461 OBJ = $(DL)
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	462 @end example
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	463
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	464 @noindent
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	465 in @file{CHOLMOD/Lib/Makefile}.
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	466
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	467 @item
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	468 Disable the @code{DI} versions of the @code{CHOLMOD} tests by commenting
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	469 out or deleting the following lines in @file{CHOLMOD/Demo/Makefile}:
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	470
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	471 @example
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	472 @group
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	473 ./cholmod_demo < Matrix/bcsstk01.tri
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	474 ./cholmod_demo < Matrix/lp_afiro.tri
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	475 ./cholmod_demo < Matrix/can___24.mtx
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	476 ./cholmod_demo < Matrix/c.tri
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	477 ./cholmod_simple < Matrix/c.tri
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	478 ./cholmod_simple < Matrix/can___24.mtx
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	479 ./cholmod_simple < Matrix/bcsstk01.tri
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	480 @end group
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	481 @end example
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	482
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	483 @item
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	484 Run @command{make} to build the libraries.
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	485
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	486 @item
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	487 The SuiteSparse @file{Makefile} does not have an install target so
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	488 you must install the files by hand:
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	489
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	490 @example
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	491 @group
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	492 mkdir $prefix64/include/suitesparse
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	493 cp UFconfig/UFconfig.h $prefix64/include/suitesparse
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	494 for d in AMD BTF CAMD CCOLAMD \
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	495 CHOLMOD COLAMD CXSparse UMFPACK; do
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	496 cp $d/Lib/lib*a $prefix64/lib
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	497 cp $d/Include/*h $prefix64/include/suitesparse
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	498 done
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	499 @end group
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	500 @end example
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	501
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	502 @item
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	503 You can generate shared versions of these libraries by doing the
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	504 following in the @file{$prefix64/lib} directory:
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	505
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	506 @example
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	507 @group
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	508 top=$(pwd)
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	509 for f in *.a; do
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	510 mkdir tmp
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	511 cd tmp
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	512 ar vx ../$f
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	513 gcc -shared -o ../$@{f%%.a@}.so *.o
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	514 cd $top
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	515 rm -rf tmp
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	516 done
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	517 @end group
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	518 @end example
11573 6f8ffe2c6f76 Grammarcheck txi files for 3.4 release. Rik <octave@nomad.inbox5.com> parents: 11523 diff changeset	519
11302 e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	520 @end itemize
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	521
12152 8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	522 @item ATLAS instead of reference @sc{blas} and @sc{lapack}
11302 e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	523
12152 8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	524 Suggestions on how to compile ATLAS would be most welcome.
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	525
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	526 @item @sc{glpk}
11302 e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	527
12152 8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	528 Suggestions on how to compile @sc{glpk} would be most welcome.
11302 e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	529
12152 8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	530 @item Qhull (@url{http://www.qhull.org})
11302 e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	531
12152 8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	532 Suggestions on how to compile Qhull would be most welcome.
11302 e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	533
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	534 @item Octave
12152 8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	535
11302 e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	536 Octave's 64-bit index support is activated with the configure option
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	537 @option{--enable-64}.
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	538
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	539 @example
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	540 @group
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	541 ./configure \
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	542 LD_LIBRARY_PATH="$prefix64/lib" \
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	543 CPPFLAGS="-I$prefix64/include" LDFLAGS="-L$prefix64/lib" \
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	544 --enable-64
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	545 @end group
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	546 @end example
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	547
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	548 You must ensure that all Fortran sources except those in the
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	549 @file{libcruft/ranlib} directory are compiled such that INTEGERS are
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	550 8-bytes wide. If you are using gfortan, the configure script should
12575 d0b799dafede Grammarcheck files for 3.4.1 release. Rik <octave@nomad.inbox5.com> parents: 12462 diff changeset	551 automatically set the Makefile variable @w{@env{F77_INTEGER_8_FLAG}} to
11302 e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	552 @option{-fdefault-integer-8}. If you are using another compiler, you
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	553 must set this variable yourself. You should NOT set this flag in
11573 6f8ffe2c6f76 Grammarcheck txi files for 3.4 release. Rik <octave@nomad.inbox5.com> parents: 11523 diff changeset	554 @env{FFLAGS}, otherwise the files in @file{libcruft/ranlib} will be
11302 e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	555 miscompiled.
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	556
12152 8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	557 @item Other dependencies
11302 e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	558
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	559 Probably nothing special needs to be done for the following
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	560 dependencies. If you discover that something does need to be done,
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	561 please submit a bug report.
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	562
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	563 @itemize @minus
12462 e4dbfe3019b1 Use PCRE regular expressions throughout Octave. Rik <octave@nomad.inbox5.com> parents: 12218 diff changeset	564 @item pcre
11573 6f8ffe2c6f76 Grammarcheck txi files for 3.4 release. Rik <octave@nomad.inbox5.com> parents: 11523 diff changeset	565
11302 e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	566 @item zlib
11573 6f8ffe2c6f76 Grammarcheck txi files for 3.4 release. Rik <octave@nomad.inbox5.com> parents: 11523 diff changeset	567
11302 e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	568 @item hdf5
11573 6f8ffe2c6f76 Grammarcheck txi files for 3.4 release. Rik <octave@nomad.inbox5.com> parents: 11523 diff changeset	569
11302 e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	570 @item fftw3
11573 6f8ffe2c6f76 Grammarcheck txi files for 3.4 release. Rik <octave@nomad.inbox5.com> parents: 11523 diff changeset	571
11302 e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	572 @item cURL
11573 6f8ffe2c6f76 Grammarcheck txi files for 3.4 release. Rik <octave@nomad.inbox5.com> parents: 11523 diff changeset	573
11302 e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	574 @item GraphicsMagick++
11573 6f8ffe2c6f76 Grammarcheck txi files for 3.4 release. Rik <octave@nomad.inbox5.com> parents: 11523 diff changeset	575
11302 e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	576 @item OpenGL
11573 6f8ffe2c6f76 Grammarcheck txi files for 3.4 release. Rik <octave@nomad.inbox5.com> parents: 11523 diff changeset	577
11302 e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	578 @item freetype
11573 6f8ffe2c6f76 Grammarcheck txi files for 3.4 release. Rik <octave@nomad.inbox5.com> parents: 11523 diff changeset	579
11302 e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	580 @item fontconfig
11573 6f8ffe2c6f76 Grammarcheck txi files for 3.4 release. Rik <octave@nomad.inbox5.com> parents: 11523 diff changeset	581
11302 e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	582 @item fltk
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	583 @end itemize
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	584
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	585 @end itemize
e971caa4c2bb doc/interpreter/install.txi: explain how to compile Octave with 64-bit indexing John W. Eaton <jwe@octave.org> parents: 11291 diff changeset	586
4167 aae05d51353c [project @ 2002-11-12 02:52:50 by jwe] jwe parents: 3960 diff changeset	587 @node Installation Problems
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	588 @appendixsec Installation Problems
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	589
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	590 This section contains a list of problems (and some apparent problems
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	591 that don't really mean anything is wrong) that may show up during
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	592 installation of Octave.
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	593
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	594 @itemize @bullet
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	595 @item
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	596 On some SCO systems, @code{info} fails to compile if
12152 8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	597 @w{@code{HAVE_TERMIOS_H}} is defined in @file{config.h}. Simply
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	598 removing the definition from @file{info/config.h} should allow it to
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	599 compile.
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	600
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	601 @item
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	602 If @code{configure} finds @code{dlopen}, @code{dlsym}, @code{dlclose},
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	603 and @code{dlerror}, but not the header file @file{dlfcn.h}, you need to
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	604 find the source for the header file and install it in the directory
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	605 @file{usr/include}. This is reportedly a problem with Slackware 3.1.
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	606 For Linux/GNU systems, the source for @file{dlfcn.h} is in the
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	607 @code{ldso} package.
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	608
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	609 @item
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	610 Building @file{.oct} files doesn't work.
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	611
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	612 You should probably have a shared version of @code{libstdc++}. A patch
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	613 is needed to build shared versions of version 2.7.2 of @code{libstdc++}
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	614 on the HP-PA architecture. You can find the patch at
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	615 @url{ftp://ftp.cygnus.com/pub/g++/libg++-2.7.2-hppa-gcc-fix}.
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	616
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	617 @item
12152 8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	618 On some DEC alpha systems there may be a problem with the @code{libdxml}
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	619 library, resulting in floating point errors and/or segmentation faults
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	620 in the linear algebra routines called by Octave. If you encounter such
3464 ab5ae0aca0f1 [project @ 2000-01-20 09:48:41 by jwe] jwe parents: 3294 diff changeset	621 problems, then you should modify the configure script so that
9209 923c7cb7f13f Simplify TeXinfo files by eliminating redundant @iftex followed by @tex construction. Rik <rdrider0-list@yahoo.com> parents: 9081 diff changeset	622 @w{@code{SPECIAL_MATH_LIB}} is not set to @code{-ldxml}.
3464 ab5ae0aca0f1 [project @ 2000-01-20 09:48:41 by jwe] jwe parents: 3294 diff changeset	623
ab5ae0aca0f1 [project @ 2000-01-20 09:48:41 by jwe] jwe parents: 3294 diff changeset	624 @item
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	625 On FreeBSD systems Octave may hang while initializing some internal
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	626 constants. The fix appears to be to use
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	627
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	628 @example
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	629 options GPL_MATH_EMULATE
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	630 @end example
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	631
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	632 @noindent
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	633 rather than
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	634
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	635 @example
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	636 options MATH_EMULATE
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	637 @end example
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	638
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	639 @noindent
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	640 in the kernel configuration files (typically found in the directory
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	641 @file{/sys/i386/conf}. After making this change, you'll need to rebuild
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	642 the kernel, install it, and reboot.
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	643
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	644 @item
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	645 If you encounter errors like
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	646
6670 14992092ab06 [project @ 2007-05-29 17:51:37 by jwe] jwe parents: 5196 diff changeset	647 @example
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	648 @group
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	649 passing `void (*)()' as argument 2 of
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	650 `octave_set_signal_handler(int, void (*)(int))'
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	651 @end group
6670 14992092ab06 [project @ 2007-05-29 17:51:37 by jwe] jwe parents: 5196 diff changeset	652 @end example
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	653
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	654 @noindent
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	655 or
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	656
6670 14992092ab06 [project @ 2007-05-29 17:51:37 by jwe] jwe parents: 5196 diff changeset	657 @example
9081 c79cf77061b7 Cleanup documentation files contrib.texi, bugs.texi, install.texi, emacs.texi Rik <rdrider0-list@yahoo.com> parents: 9031 diff changeset	658 @group
7081 503001863427 [project @ 2007-10-31 01:08:14 by jwe] jwe parents: 7018 diff changeset	659 warning: ANSI C++ prohibits conversion from `(int)'
9209 923c7cb7f13f Simplify TeXinfo files by eliminating redundant @iftex followed by @tex construction. Rik <rdrider0-list@yahoo.com> parents: 9081 diff changeset	660 to `(@dots{})'
9081 c79cf77061b7 Cleanup documentation files contrib.texi, bugs.texi, install.texi, emacs.texi Rik <rdrider0-list@yahoo.com> parents: 9031 diff changeset	661 @end group
6670 14992092ab06 [project @ 2007-05-29 17:51:37 by jwe] jwe parents: 5196 diff changeset	662 @end example
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	663
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	664 @noindent
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	665 while compiling @file{sighandlers.cc}, you may need to edit some files
12152 8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	666 in the @code{gcc} include subdirectory to add proper prototypes for
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	667 functions there. For example, Ultrix 4.2 needs proper declarations for
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	668 the @code{signal} function and the @w{@code{SIG_IGN}} macro in the file
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	669 @file{signal.h}.
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	670
12152 8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	671 On some systems the @w{@code{SIG_IGN}} macro is defined to be something
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	672 like this:
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	673
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	674 @example
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	675 #define SIG_IGN (void (*)())1
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	676 @end example
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	677
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	678 @noindent
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	679 when it should really be something like:
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	680
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	681 @example
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	682 #define SIG_IGN (void (*)(int))1
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	683 @end example
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	684
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	685 @noindent
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	686 to match the prototype declaration for the @code{signal} function. This
12152 8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	687 change should also be made for the @w{@code{SIG_DFL}} and
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	688 @w{@code{SIG_ERR}} symbols. It may be necessary to change the
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	689 definitions in @file{sys/signal.h} as well.
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	690
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	691 The @code{gcc} @code{fixincludes} and @code{fixproto} scripts should
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	692 probably fix these problems when @code{gcc} installs its modified set of
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	693 header files, but I don't think that's been done yet.
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	694
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	695 @strong{You should not change the files in @file{/usr/include}}. You
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	696 can find the @code{gcc} include directory tree by running the command
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	697
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	698 @example
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	699 gcc -print-libgcc-file-name
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	700 @end example
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	701
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	702 @noindent
12152 8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	703 The directory of @code{gcc} include files normally begins in the same
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	704 directory that contains the file @file{libgcc.a}.
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	705
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	706 @item
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	707 Some of the Fortran subroutines may fail to compile with older versions
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	708 of the Sun Fortran compiler. If you get errors like
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	709
6670 14992092ab06 [project @ 2007-05-29 17:51:37 by jwe] jwe parents: 5196 diff changeset	710 @example
9081 c79cf77061b7 Cleanup documentation files contrib.texi, bugs.texi, install.texi, emacs.texi Rik <rdrider0-list@yahoo.com> parents: 9031 diff changeset	711 @group
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	712 zgemm.f:
10599 d0e0bb2ebebb Remove tabs in .txi files causing problems with pdf formatting. Rik <octave@nomad.inbox5.com> parents: 9895 diff changeset	713 zgemm:
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	714 warning: unexpected parent of complex expression subtree
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	715 zgemm.f, line 245: warning: unexpected parent of complex
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	716 expression subtree
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	717 warning: unexpected parent of complex expression subtree
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	718 zgemm.f, line 304: warning: unexpected parent of complex
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	719 expression subtree
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	720 warning: unexpected parent of complex expression subtree
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	721 zgemm.f, line 327: warning: unexpected parent of complex
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	722 expression subtree
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	723 pcc_binval: missing IR_CONV in complex op
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	724 make[2]: *** [zgemm.o] Error 1
9081 c79cf77061b7 Cleanup documentation files contrib.texi, bugs.texi, install.texi, emacs.texi Rik <rdrider0-list@yahoo.com> parents: 9031 diff changeset	725 @end group
6670 14992092ab06 [project @ 2007-05-29 17:51:37 by jwe] jwe parents: 5196 diff changeset	726 @end example
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	727
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	728 @noindent
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	729 when compiling the Fortran subroutines in the @file{libcruft}
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	730 subdirectory, you should either upgrade your compiler or try compiling
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	731 with optimization turned off.
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	732
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	733 @item
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	734 On NeXT systems, if you get errors like this:
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	735
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	736 @example
9081 c79cf77061b7 Cleanup documentation files contrib.texi, bugs.texi, install.texi, emacs.texi Rik <rdrider0-list@yahoo.com> parents: 9031 diff changeset	737 @group
7081 503001863427 [project @ 2007-10-31 01:08:14 by jwe] jwe parents: 7018 diff changeset	738 /usr/tmp/cc007458.s:unknown:Undefined local
503001863427 [project @ 2007-10-31 01:08:14 by jwe] jwe parents: 7018 diff changeset	739 symbol LBB7656
503001863427 [project @ 2007-10-31 01:08:14 by jwe] jwe parents: 7018 diff changeset	740 /usr/tmp/cc007458.s:unknown:Undefined local
503001863427 [project @ 2007-10-31 01:08:14 by jwe] jwe parents: 7018 diff changeset	741 symbol LBE7656
9081 c79cf77061b7 Cleanup documentation files contrib.texi, bugs.texi, install.texi, emacs.texi Rik <rdrider0-list@yahoo.com> parents: 9031 diff changeset	742 @end group
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	743 @end example
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	744
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	745 @noindent
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	746 when compiling @file{Array.cc} and @file{Matrix.cc}, try recompiling
10828 322f43e0e170 Grammarcheck .txi documentation files. Rik <octave@nomad.inbox5.com> parents: 10711 diff changeset	747 these files without @option{-g}.
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	748
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	749 @item
14018 5d5685216876 Deprecate shell_cmd function and update system, dos, unix commands Rik <octave@nomad.inbox5.com> parents: 12973 diff changeset	750 Some people have reported that calls to system() and the pager do not
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	751 work on SunOS systems. This is apparently due to having
9209 923c7cb7f13f Simplify TeXinfo files by eliminating redundant @iftex followed by @tex construction. Rik <rdrider0-list@yahoo.com> parents: 9081 diff changeset	752 @w{@code{G_HAVE_SYS_WAIT}} defined to be 0 instead of 1 when compiling
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	753 @code{libg++}.
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	754
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	755 @item
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	756 On NeXT systems, linking to @file{libsys_s.a} may fail to resolve the
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	757 following functions
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	758
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	759 @example
9081 c79cf77061b7 Cleanup documentation files contrib.texi, bugs.texi, install.texi, emacs.texi Rik <rdrider0-list@yahoo.com> parents: 9031 diff changeset	760 @group
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	761 _tcgetattr
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	762 _tcsetattr
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	763 _tcflow
9081 c79cf77061b7 Cleanup documentation files contrib.texi, bugs.texi, install.texi, emacs.texi Rik <rdrider0-list@yahoo.com> parents: 9031 diff changeset	764 @end group
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	765 @end example
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	766
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	767 @noindent
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	768 which are part of @file{libposix.a}. Unfortunately, linking Octave with
10828 322f43e0e170 Grammarcheck .txi documentation files. Rik <octave@nomad.inbox5.com> parents: 10711 diff changeset	769 @option{-posix} results in the following undefined symbols.
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	770
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	771 @example
9081 c79cf77061b7 Cleanup documentation files contrib.texi, bugs.texi, install.texi, emacs.texi Rik <rdrider0-list@yahoo.com> parents: 9031 diff changeset	772 @group
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	773 .destructors_used
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	774 .constructors_used
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	775 _objc_msgSend
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	776 _NXGetDefaultValue
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	777 _NXRegisterDefaults
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	778 .objc_class_name_NXStringTable
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	779 .objc_class_name_NXBundle
9081 c79cf77061b7 Cleanup documentation files contrib.texi, bugs.texi, install.texi, emacs.texi Rik <rdrider0-list@yahoo.com> parents: 9031 diff changeset	780 @end group
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	781 @end example
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	782
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	783 One kluge around this problem is to extract @file{termios.o} from
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	784 @file{libposix.a}, put it in Octave's @file{src} directory, and add it
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	785 to the list of files to link together in the makefile. Suggestions for
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	786 better ways to solve this problem are welcome!
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	787
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	788 @item
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	789 If Octave crashes immediately with a floating point exception, it is
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	790 likely that it is failing to initialize the IEEE floating point values
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	791 for infinity and NaN.
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	792
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	793 If your system actually does support IEEE arithmetic, you should be able
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	794 to fix this problem by modifying the function @code{octave_ieee_init} in
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	795 the file @file{lo-ieee.cc} to correctly initialize Octave's internal
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	796 infinity and NaN variables.
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	797
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	798 If your system does not support IEEE arithmetic but Octave's configure
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	799 script incorrectly determined that it does, you can work around the
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	800 problem by editing the file @file{config.h} to not define
12152 8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	801 @w{@code{HAVE_ISINF}}, @w{@code{HAVE_FINITE}}, and
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	802 @w{@code{HAVE_ISNAN}}.
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	803
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	804 In any case, please report this as a bug since it might be possible to
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	805 modify Octave's configuration script to automatically determine the
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	806 proper thing to do.
bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	807
7144 30c0533e39ae [project @ 2007-11-09 17:37:24 by jwe] jwe parents: 7091 diff changeset	808 @item
30c0533e39ae [project @ 2007-11-09 17:37:24 by jwe] jwe parents: 7091 diff changeset	809 If Octave is unable to find a header file because it is installed in a
30c0533e39ae [project @ 2007-11-09 17:37:24 by jwe] jwe parents: 7091 diff changeset	810 location that is not normally searched by the compiler, you can add the
30c0533e39ae [project @ 2007-11-09 17:37:24 by jwe] jwe parents: 7091 diff changeset	811 directory to the include search path by specifying (for example)
30c0533e39ae [project @ 2007-11-09 17:37:24 by jwe] jwe parents: 7091 diff changeset	812 @code{CPPFLAGS=-I/some/nonstandard/directory} as an argument to
30c0533e39ae [project @ 2007-11-09 17:37:24 by jwe] jwe parents: 7091 diff changeset	813 @code{configure}. Other variables that can be specified this way are
12152 8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	814 @env{CFLAGS}, @env{CXXFLAGS}, @env{FFLAGS}, and @env{LDFLAGS}. Passing
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	815 them as options to the configure script also records them in the
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	816 @file{config.status} file. By default, @env{CPPFLAGS} and @env{LDFLAGS}
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	817 are empty, @env{CFLAGS} and @env{CXXFLAGS} are set to @code{"-g -O"} and
8e1ab522c902 Update build instructions in INSTALL.OCTAVE for release 3.4. Rik <octave@nomad.inbox5.com> parents: 11573 diff changeset	818 @env{FFLAGS} is set to @code{"-O"}.
7144 30c0533e39ae [project @ 2007-11-09 17:37:24 by jwe] jwe parents: 7091 diff changeset	819
3294 bfe1573bd2ae [project @ 1999-10-19 10:06:07 by jwe] jwe parents: diff changeset	820 @end itemize

Mercurial > hg > octave-lyh

annotate doc/interpreter/install.txi @ 14018:5d5685216876