annotate NEWS @ 5781:faafc2d98b8d

[project @ 2006-05-02 19:40:19 by jwe]
author jwe
date Tue, 02 May 2006 19:40:21 +0000
parents e461b8ed7c4d
children 1138ced03f14
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents: 3482
diff changeset
1 Summary of changes for version 3.0:
2452
a28ed603c65c [project @ 1996-10-31 19:49:29 by jwe]
jwe
parents:
diff changeset
2 ----------------------------------
a28ed603c65c [project @ 1996-10-31 19:49:29 by jwe]
jwe
parents:
diff changeset
3
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents: 3482
diff changeset
4 * Previous versions of Octave had a number of built-in variables to
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents: 3482
diff changeset
5 control warnings (for example, warn_divide_by_zero). These
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents: 3482
diff changeset
6 variables have been replaced by warning identifiers that are used
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents: 3482
diff changeset
7 with the warning function to control the state of warnings. Now,
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents: 3482
diff changeset
8 instead of writing
2511
9b0dd36714eb [project @ 1996-11-14 02:57:33 by jwe]
jwe
parents: 2496
diff changeset
9
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents: 3482
diff changeset
10 warn_divide_by_zero = false;
2452
a28ed603c65c [project @ 1996-10-31 19:49:29 by jwe]
jwe
parents:
diff changeset
11
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents: 3482
diff changeset
12 to disable divide-by-zero warnings, you should write
2452
a28ed603c65c [project @ 1996-10-31 19:49:29 by jwe]
jwe
parents:
diff changeset
13
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents: 3482
diff changeset
14 warning ("off", "Octave:divide-by-zero");
2452
a28ed603c65c [project @ 1996-10-31 19:49:29 by jwe]
jwe
parents:
diff changeset
15
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents: 3482
diff changeset
16 You may use the same technique in your own code to control
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents: 3482
diff changeset
17 warnings. For example, you can use
2452
a28ed603c65c [project @ 1996-10-31 19:49:29 by jwe]
jwe
parents:
diff changeset
18
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents: 3482
diff changeset
19 warning ("My-package:phase-of-the-moon",
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents: 3482
diff changeset
20 "the phase of the moon could cause trouble today");
2452
a28ed603c65c [project @ 1996-10-31 19:49:29 by jwe]
jwe
parents:
diff changeset
21
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents: 3482
diff changeset
22 to allow users to control this warning using the
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents: 3482
diff changeset
23 "My-package:phase-of-the-moon" warning identifier.
2452
a28ed603c65c [project @ 1996-10-31 19:49:29 by jwe]
jwe
parents:
diff changeset
24
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents: 3482
diff changeset
25 You may also enable or disable all warnings, or turn them into
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents: 3482
diff changeset
26 errors:
2452
a28ed603c65c [project @ 1996-10-31 19:49:29 by jwe]
jwe
parents:
diff changeset
27
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents: 3482
diff changeset
28 warning ("on", "all");
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents: 3482
diff changeset
29 warning ("off", "all");
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents: 3482
diff changeset
30 warning ("error", "Octave:divide-by-zero");
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents: 3482
diff changeset
31 warning ("error", "all");
2452
a28ed603c65c [project @ 1996-10-31 19:49:29 by jwe]
jwe
parents:
diff changeset
32
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents: 3482
diff changeset
33 You can query the state of current warnings using
2452
a28ed603c65c [project @ 1996-10-31 19:49:29 by jwe]
jwe
parents:
diff changeset
34
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents: 3482
diff changeset
35 warning ("query", ID)
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents: 3482
diff changeset
36 warning ("query")
2452
a28ed603c65c [project @ 1996-10-31 19:49:29 by jwe]
jwe
parents:
diff changeset
37
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents: 3482
diff changeset
38 (only those warning IDs which have been explicitly set are
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents: 3482
diff changeset
39 returned).
2459
0a2cd53db5f9 [project @ 1996-11-03 03:36:01 by jwe]
jwe
parents: 2458
diff changeset
40
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents: 3482
diff changeset
41 A partial list and description of warning identifiers is available
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents: 3482
diff changeset
42 using
2452
a28ed603c65c [project @ 1996-10-31 19:49:29 by jwe]
jwe
parents:
diff changeset
43
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents: 3482
diff changeset
44 help warning_ids
2452
a28ed603c65c [project @ 1996-10-31 19:49:29 by jwe]
jwe
parents:
diff changeset
45
a28ed603c65c [project @ 1996-10-31 19:49:29 by jwe]
jwe
parents:
diff changeset
46
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents: 3482
diff changeset
47 See NEWS.2 for old news.