Mercurial > octave-nkf
annotate README @ 20569:b70cc4bd8109
begin removal of global error_state variable
* gripes.h, gripes.cc (gripe_library_execution_error): Delete.
* error.cc (warning_state): Delete unused variable.
(reset_error_handler): Don't set warning_state or error_state.
(debug_or_throw_exception): New static function.
(verror): Don't check error_state.
(vmessage): Call debug_or_throw_exception instead of setting
error_state.
(error_1, error_2): Combine into single function, error_1 that prints
error message and ultimately calls debug_or_throw_exception.
(verror, verror_with_cfn, verror_with_id_cfn): Call error_1. Don't
check or set warning_state.
(error): Don't check error_state.
(Flasterror, Flasterr): Adapt to not using error_state.
(interpreter_try): Don't unwind_protect error_state.
* NEWS: Update.
* doc/interpreter/external.txi: Explain octave_execution_exception
instead of error_state for matrix addition example.
* jit-typeinfo.cc (octave_jit_gripe_nan_to_logical_conversion,
octave_jit_ginvalid_index, octave_jit_gindex_range,
octave_jit_paren_scalar, octave_jit_paren_scalar_subsasgn):
Don't catch octave_execution_exception.
* cellfun.cc (Fcellfun): Use exceptions instead of error_state.
* ls-mat-ascii.cc (save_mat_ascii_data): Likewise.
* mex.cc (mexCallMATLAB, mexEvalString): Likewise.
* variables.cc (safe_symbol_lookup): Likewise.
* svd.cc (Fsvd): Eliminate use of error_state.
* __magick_read__.cc (read_file, write_file): Likewise.
* variables.cc (generate_struct_completions): Eliminate use of
obsolete warning_state variable.
* ov-builtin.cc (octave_builtin::do_multi_index_op): Don't catch
octave_execution_exception and call gripe_library_execution_error.
* ov-class.cc (octave_class::reconstruct_exemplar): Eliminate use of
error_state. Catch possible octave_execution_exception in
do_multi_index_op.
* ov-mex-fcn.cc (octave_mex_function::do_multi_index_op): Eliminate
use of error_state. Catch possible octave_execution_exception in
call_mex.
* ov-fcn-handle.cc (octave_fcn_binder::maybe_binder): Eliminate use of
error_state.
* ov-oncleanup.cc (octave_oncleanup::~octave_oncleanup): Eliminate use
of error_state. Propagate possible octave_execution_exception from
do_multi_index_op.
* ov.cc (octave_value::assign, do_binary_op, do_unary_op,
octave_value::do_non_const_unary_op): Don't catch
octave_execution_exception here.
* oct-parse.in.yy (octave_base_parser::finish_colon_expression,
octave_base_parser::finish_array_list): Eliminate use of warning_state
and error_state.
(Feval, Fevalin): Use exceptions instead of error_state.
* pt-eval.cc, pt-eval.h (tree_evaluator::unwind_protect_exception):
New static variable.
* (tree_evaluator::visit_statement): Don't catch
octave_execution_exception here.
(tree_evaluator::visit_try_catch_command,
tree_evaluator::do_unwind_protect_cleanup): Eliminate use of error_state.
(tree_evaluator::visit_unwind_protect_command): Use
unwind_protect_exception to track whether an exception has occurred in
the try block.
author | John W. Eaton <jwe@octave.org> |
---|---|
date | Thu, 01 Oct 2015 16:18:19 -0400 |
parents | 4197fc428c7d |
children |
rev | line source |
---|---|
2993 | 1 GNU Octave -- a high-level language for numerical computations. |
2330 | 2 |
19731
4197fc428c7d
maint: Update copyright notices for 2015.
John W. Eaton <jwe@octave.org>
parents:
19192
diff
changeset
|
3 Copyright (C) 1996-2015 John W. Eaton |
2330 | 4 |
5 Overview | |
6 -------- | |
7 | |
2993 | 8 GNU Octave is a high-level language, primarily intended for numerical |
2330 | 9 computations. It provides a convenient command line interface for |
10 solving linear and nonlinear problems numerically. | |
11 | |
2993 | 12 GNU Octave is free software; you can redistribute it and/or modify it |
2330 | 13 under the terms of the GNU General Public License as published by the |
7016 | 14 Free Software Foundation; either version 3 of the License, or (at your |
15 option) any later version. | |
2330 | 16 |
2993 | 17 GNU Octave is distributed in the hope that it will be useful, but |
18 WITHOUT ANY WARRANTY; without even the implied warranty of | |
19 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the file | |
20 COPYING for more details. | |
2330 | 21 |
22 Availability | |
23 ------------ | |
24 | |
25 The latest released version of Octave is always available via | |
8922 | 26 anonymous ftp from ftp.gnu.org and its many mirror sites around the |
27 world. You may also find links to binary distributions at | |
28 http://www.octave.org/download.html. The current development sources | |
11453
780a8b80c3e8
README: Update WWW links and disk space requirements.
Rik <octave@nomad.inbox5.com>
parents:
9031
diff
changeset
|
29 may be found on Savannah (http://savannah.gnu.org/projects/octave) |
780a8b80c3e8
README: Update WWW links and disk space requirements.
Rik <octave@nomad.inbox5.com>
parents:
9031
diff
changeset
|
30 under the Source Code tab. |
2330 | 31 |
11453
780a8b80c3e8
README: Update WWW links and disk space requirements.
Rik <octave@nomad.inbox5.com>
parents:
9031
diff
changeset
|
32 Installation |
780a8b80c3e8
README: Update WWW links and disk space requirements.
Rik <octave@nomad.inbox5.com>
parents:
9031
diff
changeset
|
33 ------------ |
2330 | 34 |
11453
780a8b80c3e8
README: Update WWW links and disk space requirements.
Rik <octave@nomad.inbox5.com>
parents:
9031
diff
changeset
|
35 Octave requires approximately 1.4 GB of disk storage to unpack and |
780a8b80c3e8
README: Update WWW links and disk space requirements.
Rik <octave@nomad.inbox5.com>
parents:
9031
diff
changeset
|
36 compile from source (significantly less, 400 MB, if you don't compile |
780a8b80c3e8
README: Update WWW links and disk space requirements.
Rik <octave@nomad.inbox5.com>
parents:
9031
diff
changeset
|
37 with debugging symbols). Once installed, Octave requires |
780a8b80c3e8
README: Update WWW links and disk space requirements.
Rik <octave@nomad.inbox5.com>
parents:
9031
diff
changeset
|
38 approximately 350MB of disk space (again, considerably less, 70 MB, |
780a8b80c3e8
README: Update WWW links and disk space requirements.
Rik <octave@nomad.inbox5.com>
parents:
9031
diff
changeset
|
39 if you don't build shared libraries or the binaries and libraries do |
780a8b80c3e8
README: Update WWW links and disk space requirements.
Rik <octave@nomad.inbox5.com>
parents:
9031
diff
changeset
|
40 not include debugging symbols). |
2484 | 41 |
3148 | 42 To compile Octave, you will need a recent version of GNU Make. You |
9031
1052a66078cf
Documentation cleanup of top-level Octave directory (READMEs, INSTALL)
Rik <rdrider0-list@yahoo.com>
parents:
8922
diff
changeset
|
43 will also need a recent version of g++ or another ANSI C++ compiler. |
7088 | 44 You will also need a Fortran 77 compiler or f2c. If you use f2c, you |
45 will need a script like fort77 that works like a normal Fortran | |
46 compiler by combining f2c with your C compiler in a single script. | |
2330 | 47 |
48 YOU MUST HAVE GNU MAKE TO COMPILE OCTAVE. Octave's Makefiles use | |
2484 | 49 features of GNU Make that are not present in other versions of make. |
2330 | 50 GNU Make is very portable and easy to install. |
51 | |
19192
9c28728a3041
* README: Mention INSTALL.OCTAVE instead of INSTALL.
John W. Eaton <jwe@octave.org>
parents:
17744
diff
changeset
|
52 See the notes in the files INSTALL.OCTAVE and the system-specific README |
9c28728a3041
* README: Mention INSTALL.OCTAVE instead of INSTALL.
John W. Eaton <jwe@octave.org>
parents:
17744
diff
changeset
|
53 files in the etc directory of the Octave source distribution for more |
9c28728a3041
* README: Mention INSTALL.OCTAVE instead of INSTALL.
John W. Eaton <jwe@octave.org>
parents:
17744
diff
changeset
|
54 specific installation instructions. |
2330 | 55 |
11453
780a8b80c3e8
README: Update WWW links and disk space requirements.
Rik <octave@nomad.inbox5.com>
parents:
9031
diff
changeset
|
56 Bugs and Patches |
780a8b80c3e8
README: Update WWW links and disk space requirements.
Rik <octave@nomad.inbox5.com>
parents:
9031
diff
changeset
|
57 ---------------- |
780a8b80c3e8
README: Update WWW links and disk space requirements.
Rik <octave@nomad.inbox5.com>
parents:
9031
diff
changeset
|
58 |
780a8b80c3e8
README: Update WWW links and disk space requirements.
Rik <octave@nomad.inbox5.com>
parents:
9031
diff
changeset
|
59 The file BUGS explains the recommended procedure for reporting bugs |
780a8b80c3e8
README: Update WWW links and disk space requirements.
Rik <octave@nomad.inbox5.com>
parents:
9031
diff
changeset
|
60 or contributing patches. |
2330 | 61 |
2580 | 62 Documentation |
63 ------------- | |
2330 | 64 |
11453
780a8b80c3e8
README: Update WWW links and disk space requirements.
Rik <octave@nomad.inbox5.com>
parents:
9031
diff
changeset
|
65 Octave's manual has been revised for version 3.4, but it is lagging a |
2580 | 66 bit behind the development of the software. In particular, there is |
7088 | 67 currently no complete documentation of the C++ class libraries. If |
11453
780a8b80c3e8
README: Update WWW links and disk space requirements.
Rik <octave@nomad.inbox5.com>
parents:
9031
diff
changeset
|
68 you notice omissions or inconsistencies, please report them on the |
15497
c49d891eb263
Update broken or inconsistent project and wiki urls
Mike Miller <mtmiller@ieee.org>
parents:
14138
diff
changeset
|
69 bug tracker at http://bugs.octave.org. Specific suggestions for ways |
c49d891eb263
Update broken or inconsistent project and wiki urls
Mike Miller <mtmiller@ieee.org>
parents:
14138
diff
changeset
|
70 to improve Octave and its documentation are always welcome. Reports |
c49d891eb263
Update broken or inconsistent project and wiki urls
Mike Miller <mtmiller@ieee.org>
parents:
14138
diff
changeset
|
71 with patches are even more welcome. |
2330 | 72 |
2582 | 73 Additional Information |
74 ---------------------- | |
75 | |
76 Up to date information about Octave is available on the WWW at the | |
7088 | 77 URL http://www.octave.org, including archives of the help, bug, and |
78 maintainers mailing lists. | |
2582 | 79 |
7088 | 80 |
12733
b67c2d580a25
maint: clean up top-level directory
John W. Eaton <jwe@octave.org>
parents:
11523
diff
changeset
|
81 Last updated: Fri, 10 Jun 2011 14:02:32 EDT |