annotate scripts/miscellaneous/warning_ids.m @ 19610:e97c63531e76

doc: Periodic grammarcheck of documentation. * func.txi: Use @noindent for examples in the middle of sentences. * warning_ids.m: Aline @item in table.
author Rik <rik@octave.org>
date Tue, 13 Jan 2015 22:06:39 -0800
parents a0c7001cf1a8
children 4197fc428c7d
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
17744
d63878346099 maint: Update copyright notices for release.
John W. Eaton <jwe@octave.org>
parents: 17170
diff changeset
1 ## Copyright (C) 2006-2013 John W. Eaton
7016
93c65f2a5668 [project @ 2007-10-12 06:40:56 by jwe]
jwe
parents: 6555
diff changeset
2 ##
93c65f2a5668 [project @ 2007-10-12 06:40:56 by jwe]
jwe
parents: 6555
diff changeset
3 ## This file is part of Octave.
93c65f2a5668 [project @ 2007-10-12 06:40:56 by jwe]
jwe
parents: 6555
diff changeset
4 ##
93c65f2a5668 [project @ 2007-10-12 06:40:56 by jwe]
jwe
parents: 6555
diff changeset
5 ## Octave is free software; you can redistribute it and/or modify it
93c65f2a5668 [project @ 2007-10-12 06:40:56 by jwe]
jwe
parents: 6555
diff changeset
6 ## under the terms of the GNU General Public License as published by
93c65f2a5668 [project @ 2007-10-12 06:40:56 by jwe]
jwe
parents: 6555
diff changeset
7 ## the Free Software Foundation; either version 3 of the License, or (at
93c65f2a5668 [project @ 2007-10-12 06:40:56 by jwe]
jwe
parents: 6555
diff changeset
8 ## your option) any later version.
93c65f2a5668 [project @ 2007-10-12 06:40:56 by jwe]
jwe
parents: 6555
diff changeset
9 ##
93c65f2a5668 [project @ 2007-10-12 06:40:56 by jwe]
jwe
parents: 6555
diff changeset
10 ## Octave is distributed in the hope that it will be useful, but
93c65f2a5668 [project @ 2007-10-12 06:40:56 by jwe]
jwe
parents: 6555
diff changeset
11 ## WITHOUT ANY WARRANTY; without even the implied warranty of
93c65f2a5668 [project @ 2007-10-12 06:40:56 by jwe]
jwe
parents: 6555
diff changeset
12 ## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
93c65f2a5668 [project @ 2007-10-12 06:40:56 by jwe]
jwe
parents: 6555
diff changeset
13 ## General Public License for more details.
93c65f2a5668 [project @ 2007-10-12 06:40:56 by jwe]
jwe
parents: 6555
diff changeset
14 ##
93c65f2a5668 [project @ 2007-10-12 06:40:56 by jwe]
jwe
parents: 6555
diff changeset
15 ## You should have received a copy of the GNU General Public License
93c65f2a5668 [project @ 2007-10-12 06:40:56 by jwe]
jwe
parents: 6555
diff changeset
16 ## along with Octave; see the file COPYING. If not, see
93c65f2a5668 [project @ 2007-10-12 06:40:56 by jwe]
jwe
parents: 6555
diff changeset
17 ## <http://www.gnu.org/licenses/>.
93c65f2a5668 [project @ 2007-10-12 06:40:56 by jwe]
jwe
parents: 6555
diff changeset
18
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
19 ## -*- texinfo -*-
14119
94e2a76f1e5a doc: Final grammarcheck and spellcheck before 3.6.0 release.
Rik <octave@nomad.inbox5.com>
parents: 14116
diff changeset
20 ## @cindex warning ids
14366
b76f0740940e doc: Periodic grammar check of documentation.
Rik <octave@nomad.inbox5.com>
parents: 14363
diff changeset
21 ##
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
22 ## @table @code
13842
4aadd3e2c5bc warning_ids.m: Add missing warnings to list. They are not documented.
Rik <octave@nomad.inbox5.com>
parents: 13841
diff changeset
23 ## @item Octave:abbreviated-property-match
4aadd3e2c5bc warning_ids.m: Add missing warnings to list. They are not documented.
Rik <octave@nomad.inbox5.com>
parents: 13841
diff changeset
24 ## By default, the @code{Octave:abbreviated-property-match} warning is enabled.
4aadd3e2c5bc warning_ids.m: Add missing warnings to list. They are not documented.
Rik <octave@nomad.inbox5.com>
parents: 13841
diff changeset
25 ##
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
26 ## @item Octave:array-to-scalar
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
27 ## If the @code{Octave:array-to-scalar} warning is enabled, Octave will
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
28 ## warn when an implicit conversion from an array to a scalar value is
13841
0a158dbdb04a Remove 3 unused warning ids
Rik <octave@nomad.inbox5.com>
parents: 12845
diff changeset
29 ## attempted.
0a158dbdb04a Remove 3 unused warning ids
Rik <octave@nomad.inbox5.com>
parents: 12845
diff changeset
30 ## By default, the @code{Octave:array-to-scalar} warning is disabled.
11587
c792872f8942 all script files: untabify and strip trailing whitespace
John W. Eaton <jwe@octave.org>
parents: 11523
diff changeset
31 ##
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
32 ## @item Octave:array-to-vector
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
33 ## If the @code{Octave:array-to-vector} warning is enabled, Octave will
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
34 ## warn when an implicit conversion from an array to a vector value is
13841
0a158dbdb04a Remove 3 unused warning ids
Rik <octave@nomad.inbox5.com>
parents: 12845
diff changeset
35 ## attempted.
0a158dbdb04a Remove 3 unused warning ids
Rik <octave@nomad.inbox5.com>
parents: 12845
diff changeset
36 ## By default, the @code{Octave:array-to-vector} warning is disabled.
11587
c792872f8942 all script files: untabify and strip trailing whitespace
John W. Eaton <jwe@octave.org>
parents: 11523
diff changeset
37 ##
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
38 ## @item Octave:assign-as-truth-value
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
39 ## If the @code{Octave:assign-as-truth-value} warning is
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
40 ## enabled, a warning is issued for statements like
11587
c792872f8942 all script files: untabify and strip trailing whitespace
John W. Eaton <jwe@octave.org>
parents: 11523
diff changeset
41 ##
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
42 ## @example
9051
1bf0ce0930be Grammar check TexInfo in all .m files
Rik <rdrider0-list@yahoo.com>
parents: 9039
diff changeset
43 ## @group
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
44 ## if (s = t)
9039
51dc9691f23f Cleanup documentation files errors.texi, debug.texi, io.texi
Rik <rdrider0-list@yahoo.com>
parents: 8920
diff changeset
45 ## @dots{}
9051
1bf0ce0930be Grammar check TexInfo in all .m files
Rik <rdrider0-list@yahoo.com>
parents: 9039
diff changeset
46 ## @end group
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
47 ## @end example
11587
c792872f8942 all script files: untabify and strip trailing whitespace
John W. Eaton <jwe@octave.org>
parents: 11523
diff changeset
48 ##
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
49 ## @noindent
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
50 ## since such statements are not common, and it is likely that the intent
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
51 ## was to write
11587
c792872f8942 all script files: untabify and strip trailing whitespace
John W. Eaton <jwe@octave.org>
parents: 11523
diff changeset
52 ##
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
53 ## @example
9051
1bf0ce0930be Grammar check TexInfo in all .m files
Rik <rdrider0-list@yahoo.com>
parents: 9039
diff changeset
54 ## @group
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
55 ## if (s == t)
9039
51dc9691f23f Cleanup documentation files errors.texi, debug.texi, io.texi
Rik <rdrider0-list@yahoo.com>
parents: 8920
diff changeset
56 ## @dots{}
9051
1bf0ce0930be Grammar check TexInfo in all .m files
Rik <rdrider0-list@yahoo.com>
parents: 9039
diff changeset
57 ## @end group
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
58 ## @end example
11587
c792872f8942 all script files: untabify and strip trailing whitespace
John W. Eaton <jwe@octave.org>
parents: 11523
diff changeset
59 ##
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
60 ## @noindent
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
61 ## instead.
11587
c792872f8942 all script files: untabify and strip trailing whitespace
John W. Eaton <jwe@octave.org>
parents: 11523
diff changeset
62 ##
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
63 ## There are times when it is useful to write code that contains
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
64 ## assignments within the condition of a @code{while} or @code{if}
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
65 ## statement. For example, statements like
11587
c792872f8942 all script files: untabify and strip trailing whitespace
John W. Eaton <jwe@octave.org>
parents: 11523
diff changeset
66 ##
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
67 ## @example
9051
1bf0ce0930be Grammar check TexInfo in all .m files
Rik <rdrider0-list@yahoo.com>
parents: 9039
diff changeset
68 ## @group
14327
4d917a6a858b doc: Use Octave coding conventions in @example blocks of docstrings.
Rik <octave@nomad.inbox5.com>
parents: 14138
diff changeset
69 ## while (c = getc ())
9039
51dc9691f23f Cleanup documentation files errors.texi, debug.texi, io.texi
Rik <rdrider0-list@yahoo.com>
parents: 8920
diff changeset
70 ## @dots{}
9051
1bf0ce0930be Grammar check TexInfo in all .m files
Rik <rdrider0-list@yahoo.com>
parents: 9039
diff changeset
71 ## @end group
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
72 ## @end example
11587
c792872f8942 all script files: untabify and strip trailing whitespace
John W. Eaton <jwe@octave.org>
parents: 11523
diff changeset
73 ##
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
74 ## @noindent
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
75 ## are common in C programming.
11587
c792872f8942 all script files: untabify and strip trailing whitespace
John W. Eaton <jwe@octave.org>
parents: 11523
diff changeset
76 ##
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
77 ## It is possible to avoid all warnings about such statements by
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
78 ## disabling the @code{Octave:assign-as-truth-value} warning,
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
79 ## but that may also let real errors like
11587
c792872f8942 all script files: untabify and strip trailing whitespace
John W. Eaton <jwe@octave.org>
parents: 11523
diff changeset
80 ##
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
81 ## @example
9051
1bf0ce0930be Grammar check TexInfo in all .m files
Rik <rdrider0-list@yahoo.com>
parents: 9039
diff changeset
82 ## @group
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
83 ## if (x = 1) # intended to test (x == 1)!
9039
51dc9691f23f Cleanup documentation files errors.texi, debug.texi, io.texi
Rik <rdrider0-list@yahoo.com>
parents: 8920
diff changeset
84 ## @dots{}
9051
1bf0ce0930be Grammar check TexInfo in all .m files
Rik <rdrider0-list@yahoo.com>
parents: 9039
diff changeset
85 ## @end group
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
86 ## @end example
11587
c792872f8942 all script files: untabify and strip trailing whitespace
John W. Eaton <jwe@octave.org>
parents: 11523
diff changeset
87 ##
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
88 ## @noindent
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
89 ## slip by.
11587
c792872f8942 all script files: untabify and strip trailing whitespace
John W. Eaton <jwe@octave.org>
parents: 11523
diff changeset
90 ##
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
91 ## In such cases, it is possible suppress errors for specific statements by
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
92 ## writing them with an extra set of parentheses. For example, writing the
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
93 ## previous example as
11587
c792872f8942 all script files: untabify and strip trailing whitespace
John W. Eaton <jwe@octave.org>
parents: 11523
diff changeset
94 ##
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
95 ## @example
9051
1bf0ce0930be Grammar check TexInfo in all .m files
Rik <rdrider0-list@yahoo.com>
parents: 9039
diff changeset
96 ## @group
14327
4d917a6a858b doc: Use Octave coding conventions in @example blocks of docstrings.
Rik <octave@nomad.inbox5.com>
parents: 14138
diff changeset
97 ## while ((c = getc ()))
9039
51dc9691f23f Cleanup documentation files errors.texi, debug.texi, io.texi
Rik <rdrider0-list@yahoo.com>
parents: 8920
diff changeset
98 ## @dots{}
9051
1bf0ce0930be Grammar check TexInfo in all .m files
Rik <rdrider0-list@yahoo.com>
parents: 9039
diff changeset
99 ## @end group
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
100 ## @end example
11587
c792872f8942 all script files: untabify and strip trailing whitespace
John W. Eaton <jwe@octave.org>
parents: 11523
diff changeset
101 ##
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
102 ## @noindent
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
103 ## will prevent the warning from being printed for this statement, while
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
104 ## allowing Octave to warn about other assignments used in conditional
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
105 ## contexts.
11587
c792872f8942 all script files: untabify and strip trailing whitespace
John W. Eaton <jwe@octave.org>
parents: 11523
diff changeset
106 ##
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
107 ## By default, the @code{Octave:assign-as-truth-value} warning is enabled.
11587
c792872f8942 all script files: untabify and strip trailing whitespace
John W. Eaton <jwe@octave.org>
parents: 11523
diff changeset
108 ##
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
109 ## @item Octave:associativity-change
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
110 ## If the @code{Octave:associativity-change} warning is
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
111 ## enabled, Octave will warn about possible changes in the meaning of
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
112 ## some code due to changes in associativity for some operators.
9051
1bf0ce0930be Grammar check TexInfo in all .m files
Rik <rdrider0-list@yahoo.com>
parents: 9039
diff changeset
113 ## Associativity changes have typically been made for @sc{matlab}
13841
0a158dbdb04a Remove 3 unused warning ids
Rik <octave@nomad.inbox5.com>
parents: 12845
diff changeset
114 ## compatibility.
0a158dbdb04a Remove 3 unused warning ids
Rik <octave@nomad.inbox5.com>
parents: 12845
diff changeset
115 ## By default, the @code{Octave:associativity-change} warning is enabled.
11587
c792872f8942 all script files: untabify and strip trailing whitespace
John W. Eaton <jwe@octave.org>
parents: 11523
diff changeset
116 ##
12486
32279948bf3b Document the Octave:autoload-relative-file-name warning.
Thomas Weber <tweber@debian.org>
parents: 12477
diff changeset
117 ## @item Octave:autoload-relative-file-name
32279948bf3b Document the Octave:autoload-relative-file-name warning.
Thomas Weber <tweber@debian.org>
parents: 12477
diff changeset
118 ## If the @code{Octave:autoload-relative-file-name} is enabled,
32279948bf3b Document the Octave:autoload-relative-file-name warning.
Thomas Weber <tweber@debian.org>
parents: 12477
diff changeset
119 ## Octave will warn when parsing autoload() function calls with relative
12575
d0b799dafede Grammarcheck files for 3.4.1 release.
Rik <octave@nomad.inbox5.com>
parents: 12486
diff changeset
120 ## paths to function files. This usually happens when using autoload()
12486
32279948bf3b Document the Octave:autoload-relative-file-name warning.
Thomas Weber <tweber@debian.org>
parents: 12477
diff changeset
121 ## calls in PKG_ADD files, when the PKG_ADD file is not in the same
32279948bf3b Document the Octave:autoload-relative-file-name warning.
Thomas Weber <tweber@debian.org>
parents: 12477
diff changeset
122 ## directory as the .oct file referred to by the autoload() command.
13841
0a158dbdb04a Remove 3 unused warning ids
Rik <octave@nomad.inbox5.com>
parents: 12845
diff changeset
123 ## By default, the @code{Octave:autoload-relative-file-name} warning is enabled.
12486
32279948bf3b Document the Octave:autoload-relative-file-name warning.
Thomas Weber <tweber@debian.org>
parents: 12477
diff changeset
124 ##
14116
951eacaf9381 Initial documentation for broadcasting and general vectorization guidelines
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 13842
diff changeset
125 ## @item Octave:broadcast
14119
94e2a76f1e5a doc: Final grammarcheck and spellcheck before 3.6.0 release.
Rik <octave@nomad.inbox5.com>
parents: 14116
diff changeset
126 ## Warn when performing broadcasting operations. By default, this is
14120
0a051c406242 doc: Fix incorrect xref usage in warning_ids.m
Rik <octave@nomad.inbox5.com>
parents: 14119
diff changeset
127 ## enabled. See @ref{Broadcasting} in the chapter Vectorization and Faster
0a051c406242 doc: Fix incorrect xref usage in warning_ids.m
Rik <octave@nomad.inbox5.com>
parents: 14119
diff changeset
128 ## Code Execution of the manual.
14116
951eacaf9381 Initial documentation for broadcasting and general vectorization guidelines
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 13842
diff changeset
129 ##
13842
4aadd3e2c5bc warning_ids.m: Add missing warnings to list. They are not documented.
Rik <octave@nomad.inbox5.com>
parents: 13841
diff changeset
130 ## @item Octave:built-in-variable-assignment
4aadd3e2c5bc warning_ids.m: Add missing warnings to list. They are not documented.
Rik <octave@nomad.inbox5.com>
parents: 13841
diff changeset
131 ## By default, the @code{Octave:built-in-variable-assignment} warning is
4aadd3e2c5bc warning_ids.m: Add missing warnings to list. They are not documented.
Rik <octave@nomad.inbox5.com>
parents: 13841
diff changeset
132 ## enabled.
4aadd3e2c5bc warning_ids.m: Add missing warnings to list. They are not documented.
Rik <octave@nomad.inbox5.com>
parents: 13841
diff changeset
133 ##
15605
80a4ded6b89c warning_ids.m: Add 2 missing warning IDs to documentation.
Rik <rik@octave.org>
parents: 14366
diff changeset
134 ## @item Octave:deprecated-keyword
80a4ded6b89c warning_ids.m: Add 2 missing warning IDs to documentation.
Rik <rik@octave.org>
parents: 14366
diff changeset
135 ## If the @code{Octave:deprecated-keyword} warning is enabled, a
80a4ded6b89c warning_ids.m: Add 2 missing warning IDs to documentation.
Rik <rik@octave.org>
parents: 14366
diff changeset
136 ## warning is issued when Octave encounters a keyword that is obsolete and
80a4ded6b89c warning_ids.m: Add 2 missing warning IDs to documentation.
Rik <rik@octave.org>
parents: 14366
diff changeset
137 ## scheduled for removal from Octave.
80a4ded6b89c warning_ids.m: Add 2 missing warning IDs to documentation.
Rik <rik@octave.org>
parents: 14366
diff changeset
138 ## By default, the @code{Octave:deprecated-keyword} warning is enabled.
80a4ded6b89c warning_ids.m: Add 2 missing warning IDs to documentation.
Rik <rik@octave.org>
parents: 14366
diff changeset
139 ##
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
140 ## @item Octave:divide-by-zero
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
141 ## If the @code{Octave:divide-by-zero} warning is enabled, a
13841
0a158dbdb04a Remove 3 unused warning ids
Rik <octave@nomad.inbox5.com>
parents: 12845
diff changeset
142 ## warning is issued when Octave encounters a division by zero.
0a158dbdb04a Remove 3 unused warning ids
Rik <octave@nomad.inbox5.com>
parents: 12845
diff changeset
143 ## By default, the @code{Octave:divide-by-zero} warning is enabled.
11587
c792872f8942 all script files: untabify and strip trailing whitespace
John W. Eaton <jwe@octave.org>
parents: 11523
diff changeset
144 ##
13842
4aadd3e2c5bc warning_ids.m: Add missing warnings to list. They are not documented.
Rik <octave@nomad.inbox5.com>
parents: 13841
diff changeset
145 ## @item Octave:fopen-file-in-path
4aadd3e2c5bc warning_ids.m: Add missing warnings to list. They are not documented.
Rik <octave@nomad.inbox5.com>
parents: 13841
diff changeset
146 ## By default, the @code{Octave:fopen-file-in-path} warning is enabled.
4aadd3e2c5bc warning_ids.m: Add missing warnings to list. They are not documented.
Rik <octave@nomad.inbox5.com>
parents: 13841
diff changeset
147 ##
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
148 ## @item Octave:function-name-clash
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
149 ## If the @code{Octave:function-name-clash} warning is enabled, a
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
150 ## warning is issued when Octave finds that the name of a function
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
151 ## defined in a function file differs from the name of the file. (If
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
152 ## the names disagree, the name declared inside the file is ignored.)
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
153 ## By default, the @code{Octave:function-name-clash} warning is enabled.
11587
c792872f8942 all script files: untabify and strip trailing whitespace
John W. Eaton <jwe@octave.org>
parents: 11523
diff changeset
154 ##
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
155 ## @item Octave:future-time-stamp
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
156 ## If the @code{Octave:future-time-stamp} warning is enabled, Octave
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
157 ## will print a warning if it finds a function file with a time stamp
13841
0a158dbdb04a Remove 3 unused warning ids
Rik <octave@nomad.inbox5.com>
parents: 12845
diff changeset
158 ## that is in the future.
0a158dbdb04a Remove 3 unused warning ids
Rik <octave@nomad.inbox5.com>
parents: 12845
diff changeset
159 ## By default, the @code{Octave:future-time-stamp} warning is enabled.
11587
c792872f8942 all script files: untabify and strip trailing whitespace
John W. Eaton <jwe@octave.org>
parents: 11523
diff changeset
160 ##
13842
4aadd3e2c5bc warning_ids.m: Add missing warnings to list. They are not documented.
Rik <octave@nomad.inbox5.com>
parents: 13841
diff changeset
161 ## @item Octave:glyph-render
4aadd3e2c5bc warning_ids.m: Add missing warnings to list. They are not documented.
Rik <octave@nomad.inbox5.com>
parents: 13841
diff changeset
162 ## By default, the @code{Octave:glyph-render} warning is enabled.
4aadd3e2c5bc warning_ids.m: Add missing warnings to list. They are not documented.
Rik <octave@nomad.inbox5.com>
parents: 13841
diff changeset
163 ##
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
164 ## @item Octave:imag-to-real
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
165 ## If the @code{Octave:imag-to-real} warning is enabled, a warning is
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
166 ## printed for implicit conversions of complex numbers to real numbers.
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
167 ## By default, the @code{Octave:imag-to-real} warning is disabled.
11587
c792872f8942 all script files: untabify and strip trailing whitespace
John W. Eaton <jwe@octave.org>
parents: 11523
diff changeset
168 ##
13842
4aadd3e2c5bc warning_ids.m: Add missing warnings to list. They are not documented.
Rik <octave@nomad.inbox5.com>
parents: 13841
diff changeset
169 ## @item Octave:load-file-in-path
4aadd3e2c5bc warning_ids.m: Add missing warnings to list. They are not documented.
Rik <octave@nomad.inbox5.com>
parents: 13841
diff changeset
170 ## By default, the @code{Octave:load-file-in-path} warning is enabled.
4aadd3e2c5bc warning_ids.m: Add missing warnings to list. They are not documented.
Rik <octave@nomad.inbox5.com>
parents: 13841
diff changeset
171 ##
4aadd3e2c5bc warning_ids.m: Add missing warnings to list. They are not documented.
Rik <octave@nomad.inbox5.com>
parents: 13841
diff changeset
172 ## @item Octave:logical-conversion
4aadd3e2c5bc warning_ids.m: Add missing warnings to list. They are not documented.
Rik <octave@nomad.inbox5.com>
parents: 13841
diff changeset
173 ## By default, the @code{Octave:logical-conversion} warning is enabled.
4aadd3e2c5bc warning_ids.m: Add missing warnings to list. They are not documented.
Rik <octave@nomad.inbox5.com>
parents: 13841
diff changeset
174 ##
5794
1138ced03f14 [project @ 2006-05-08 20:23:04 by jwe]
jwe
parents: 5781
diff changeset
175 ## @item Octave:matlab-incompatible
1138ced03f14 [project @ 2006-05-08 20:23:04 by jwe]
jwe
parents: 5781
diff changeset
176 ## Print warnings for Octave language features that may cause
9051
1bf0ce0930be Grammar check TexInfo in all .m files
Rik <rdrider0-list@yahoo.com>
parents: 9039
diff changeset
177 ## compatibility problems with @sc{matlab}.
13841
0a158dbdb04a Remove 3 unused warning ids
Rik <octave@nomad.inbox5.com>
parents: 12845
diff changeset
178 ## By default, the @code{Octave:matlab-incompatible} warning is disabled.
15620
9bbc96a6ef94 doc: Small fixes to traditional/Octave:matlab-incompatible
Jordi Gutiérrez Hermoso <jordigh@octave.org>
parents: 15618
diff changeset
179 ## The --traditional or --braindead startup options for Octave may also
17097
e7a059a9a644 doc: Use XREF as anchor prefix in documentation for clearer results in Info viewer.
Rik <rik@octave.org>
parents: 15620
diff changeset
180 ## be of use, @pxref{Command Line Options}.
11587
c792872f8942 all script files: untabify and strip trailing whitespace
John W. Eaton <jwe@octave.org>
parents: 11523
diff changeset
181 ##
13842
4aadd3e2c5bc warning_ids.m: Add missing warnings to list. They are not documented.
Rik <octave@nomad.inbox5.com>
parents: 13841
diff changeset
182 ## @item Octave:md5sum-file-in-path
4aadd3e2c5bc warning_ids.m: Add missing warnings to list. They are not documented.
Rik <octave@nomad.inbox5.com>
parents: 13841
diff changeset
183 ## By default, the @code{Octave:md5sum-file-in-path} warning is enabled.
4aadd3e2c5bc warning_ids.m: Add missing warnings to list. They are not documented.
Rik <octave@nomad.inbox5.com>
parents: 13841
diff changeset
184 ##
4aadd3e2c5bc warning_ids.m: Add missing warnings to list. They are not documented.
Rik <octave@nomad.inbox5.com>
parents: 13841
diff changeset
185 ## @item Octave:missing-glyph
4aadd3e2c5bc warning_ids.m: Add missing warnings to list. They are not documented.
Rik <octave@nomad.inbox5.com>
parents: 13841
diff changeset
186 ## By default, the @code{Octave:missing-glyph} warning is enabled.
4aadd3e2c5bc warning_ids.m: Add missing warnings to list. They are not documented.
Rik <octave@nomad.inbox5.com>
parents: 13841
diff changeset
187 ##
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
188 ## @item Octave:missing-semicolon
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
189 ## If the @code{Octave:missing-semicolon} warning is enabled, Octave
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
190 ## will warn when statements in function definitions don't end in
13841
0a158dbdb04a Remove 3 unused warning ids
Rik <octave@nomad.inbox5.com>
parents: 12845
diff changeset
191 ## semicolons.
0a158dbdb04a Remove 3 unused warning ids
Rik <octave@nomad.inbox5.com>
parents: 12845
diff changeset
192 ## By default the @code{Octave:missing-semicolon} warning is disabled.
0a158dbdb04a Remove 3 unused warning ids
Rik <octave@nomad.inbox5.com>
parents: 12845
diff changeset
193 ##
0a158dbdb04a Remove 3 unused warning ids
Rik <octave@nomad.inbox5.com>
parents: 12845
diff changeset
194 ## @item Octave:mixed-string-concat
0a158dbdb04a Remove 3 unused warning ids
Rik <octave@nomad.inbox5.com>
parents: 12845
diff changeset
195 ## If the @code{Octave:mixed-string-concat} warning is enabled, print a
0a158dbdb04a Remove 3 unused warning ids
Rik <octave@nomad.inbox5.com>
parents: 12845
diff changeset
196 ## warning when concatenating a mixture of double and single quoted strings.
0a158dbdb04a Remove 3 unused warning ids
Rik <octave@nomad.inbox5.com>
parents: 12845
diff changeset
197 ## By default, the @code{Octave:mixed-string-concat} warning is disabled.
11587
c792872f8942 all script files: untabify and strip trailing whitespace
John W. Eaton <jwe@octave.org>
parents: 11523
diff changeset
198 ##
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
199 ## @item Octave:neg-dim-as-zero
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
200 ## If the @code{Octave:neg-dim-as-zero} warning is enabled, print a warning
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
201 ## for expressions like
11587
c792872f8942 all script files: untabify and strip trailing whitespace
John W. Eaton <jwe@octave.org>
parents: 11523
diff changeset
202 ##
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
203 ## @example
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
204 ## eye (-1)
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
205 ## @end example
11587
c792872f8942 all script files: untabify and strip trailing whitespace
John W. Eaton <jwe@octave.org>
parents: 11523
diff changeset
206 ##
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
207 ## @noindent
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
208 ## By default, the @code{Octave:neg-dim-as-zero} warning is disabled.
11587
c792872f8942 all script files: untabify and strip trailing whitespace
John W. Eaton <jwe@octave.org>
parents: 11523
diff changeset
209 ##
13842
4aadd3e2c5bc warning_ids.m: Add missing warnings to list. They are not documented.
Rik <octave@nomad.inbox5.com>
parents: 13841
diff changeset
210 ## @item Octave:nested-functions-coerced
4aadd3e2c5bc warning_ids.m: Add missing warnings to list. They are not documented.
Rik <octave@nomad.inbox5.com>
parents: 13841
diff changeset
211 ## By default, the @code{Octave:nested-functions-coerced} warning is enabled.
4aadd3e2c5bc warning_ids.m: Add missing warnings to list. They are not documented.
Rik <octave@nomad.inbox5.com>
parents: 13841
diff changeset
212 ##
4aadd3e2c5bc warning_ids.m: Add missing warnings to list. They are not documented.
Rik <octave@nomad.inbox5.com>
parents: 13841
diff changeset
213 ## @item Octave:noninteger-range-as-index
4aadd3e2c5bc warning_ids.m: Add missing warnings to list. They are not documented.
Rik <octave@nomad.inbox5.com>
parents: 13841
diff changeset
214 ## By default, the @code{Octave:noninteger-range-as-index} warning is enabled.
4aadd3e2c5bc warning_ids.m: Add missing warnings to list. They are not documented.
Rik <octave@nomad.inbox5.com>
parents: 13841
diff changeset
215 ##
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
216 ## @item Octave:num-to-str
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
217 ## If the @code{Octave:num-to-str} warning is enable, a warning is
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
218 ## printed for implicit conversions of numbers to their ASCII character
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
219 ## equivalents when strings are constructed using a mixture of strings and
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
220 ## numbers in matrix notation. For example,
11587
c792872f8942 all script files: untabify and strip trailing whitespace
John W. Eaton <jwe@octave.org>
parents: 11523
diff changeset
221 ##
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
222 ## @example
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
223 ## @group
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
224 ## [ "f", 111, 111 ]
14327
4d917a6a858b doc: Use Octave coding conventions in @example blocks of docstrings.
Rik <octave@nomad.inbox5.com>
parents: 14138
diff changeset
225 ## @result{} "foo"
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
226 ## @end group
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
227 ## @end example
10821
693e22af08ae Grammarcheck documentation of m-files
Rik <octave@nomad.inbox5.com>
parents: 9051
diff changeset
228 ##
10846
a4f482e66b65 Grammarcheck more of the documentation.
Rik <octave@nomad.inbox5.com>
parents: 10821
diff changeset
229 ## @noindent
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
230 ## elicits a warning if the @code{Octave:num-to-str} warning is
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
231 ## enabled. By default, the @code{Octave:num-to-str} warning is enabled.
11587
c792872f8942 all script files: untabify and strip trailing whitespace
John W. Eaton <jwe@octave.org>
parents: 11523
diff changeset
232 ##
12477
d1466d956d17 Add a warning description for Matlab-style short-circuiting
Jordi Gutiérrez Hermoso <jordigh@gmail.com>
parents: 11587
diff changeset
233 ## @item Octave:possible-matlab-short-circuit-operator
d1466d956d17 Add a warning description for Matlab-style short-circuiting
Jordi Gutiérrez Hermoso <jordigh@gmail.com>
parents: 11587
diff changeset
234 ## If the @code{Octave:possible-matlab-short-circuit-operator} warning
d1466d956d17 Add a warning description for Matlab-style short-circuiting
Jordi Gutiérrez Hermoso <jordigh@gmail.com>
parents: 11587
diff changeset
235 ## is enabled, Octave will warn about using the not short circuiting
d1466d956d17 Add a warning description for Matlab-style short-circuiting
Jordi Gutiérrez Hermoso <jordigh@gmail.com>
parents: 11587
diff changeset
236 ## operators @code{&} and @code{|} inside @code{if} or @code{while}
12575
d0b799dafede Grammarcheck files for 3.4.1 release.
Rik <octave@nomad.inbox5.com>
parents: 12486
diff changeset
237 ## conditions. They normally never short circuit, but @sc{matlab} always
d0b799dafede Grammarcheck files for 3.4.1 release.
Rik <octave@nomad.inbox5.com>
parents: 12486
diff changeset
238 ## short circuits if any logical operators are used in a condition. You
12477
d1466d956d17 Add a warning description for Matlab-style short-circuiting
Jordi Gutiérrez Hermoso <jordigh@gmail.com>
parents: 11587
diff changeset
239 ## can turn on the option
d1466d956d17 Add a warning description for Matlab-style short-circuiting
Jordi Gutiérrez Hermoso <jordigh@gmail.com>
parents: 11587
diff changeset
240 ##
d1466d956d17 Add a warning description for Matlab-style short-circuiting
Jordi Gutiérrez Hermoso <jordigh@gmail.com>
parents: 11587
diff changeset
241 ## @example
d1466d956d17 Add a warning description for Matlab-style short-circuiting
Jordi Gutiérrez Hermoso <jordigh@gmail.com>
parents: 11587
diff changeset
242 ## @group
14327
4d917a6a858b doc: Use Octave coding conventions in @example blocks of docstrings.
Rik <octave@nomad.inbox5.com>
parents: 14138
diff changeset
243 ## do_braindead_shortcircuit_evaluation (1)
12477
d1466d956d17 Add a warning description for Matlab-style short-circuiting
Jordi Gutiérrez Hermoso <jordigh@gmail.com>
parents: 11587
diff changeset
244 ## @end group
d1466d956d17 Add a warning description for Matlab-style short-circuiting
Jordi Gutiérrez Hermoso <jordigh@gmail.com>
parents: 11587
diff changeset
245 ## @end example
d1466d956d17 Add a warning description for Matlab-style short-circuiting
Jordi Gutiérrez Hermoso <jordigh@gmail.com>
parents: 11587
diff changeset
246 ##
d1466d956d17 Add a warning description for Matlab-style short-circuiting
Jordi Gutiérrez Hermoso <jordigh@gmail.com>
parents: 11587
diff changeset
247 ## @noindent
d1466d956d17 Add a warning description for Matlab-style short-circuiting
Jordi Gutiérrez Hermoso <jordigh@gmail.com>
parents: 11587
diff changeset
248 ## if you would like to enable this short-circuit evaluation in
12575
d0b799dafede Grammarcheck files for 3.4.1 release.
Rik <octave@nomad.inbox5.com>
parents: 12486
diff changeset
249 ## Octave. Note that the @code{&&} and @code{||} operators always short
d0b799dafede Grammarcheck files for 3.4.1 release.
Rik <octave@nomad.inbox5.com>
parents: 12486
diff changeset
250 ## circuit in both Octave and @sc{matlab}, so it's only necessary to
15605
80a4ded6b89c warning_ids.m: Add 2 missing warning IDs to documentation.
Rik <rik@octave.org>
parents: 14366
diff changeset
251 ## enable @sc{matlab}-style short-circuiting if it's too arduous to modify
12576
a1e386b9ef4b Spellcheck documentation for 3.4.1 release.
Rik <octave@nomad.inbox5.com>
parents: 12575
diff changeset
252 ## existing code that relies on this behavior.
13841
0a158dbdb04a Remove 3 unused warning ids
Rik <octave@nomad.inbox5.com>
parents: 12845
diff changeset
253 ## By default, the @code{Octave:possible-matlab-short-circuit-operator} warning
0a158dbdb04a Remove 3 unused warning ids
Rik <octave@nomad.inbox5.com>
parents: 12845
diff changeset
254 ## is enabled.
12477
d1466d956d17 Add a warning description for Matlab-style short-circuiting
Jordi Gutiérrez Hermoso <jordigh@gmail.com>
parents: 11587
diff changeset
255 ##
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
256 ## @item Octave:precedence-change
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
257 ## If the @code{Octave:precedence-change} warning is enabled, Octave
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
258 ## will warn about possible changes in the meaning of some code due to
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
259 ## changes in precedence for some operators. Precedence changes have
13841
0a158dbdb04a Remove 3 unused warning ids
Rik <octave@nomad.inbox5.com>
parents: 12845
diff changeset
260 ## typically been made for @sc{matlab} compatibility.
0a158dbdb04a Remove 3 unused warning ids
Rik <octave@nomad.inbox5.com>
parents: 12845
diff changeset
261 ## By default, the @code{Octave:precedence-change} warning is enabled.
11587
c792872f8942 all script files: untabify and strip trailing whitespace
John W. Eaton <jwe@octave.org>
parents: 11523
diff changeset
262 ##
13842
4aadd3e2c5bc warning_ids.m: Add missing warnings to list. They are not documented.
Rik <octave@nomad.inbox5.com>
parents: 13841
diff changeset
263 ## @item Octave:recursive-path-search
4aadd3e2c5bc warning_ids.m: Add missing warnings to list. They are not documented.
Rik <octave@nomad.inbox5.com>
parents: 13841
diff changeset
264 ## By default, the @code{Octave:recursive-path-search} warning is enabled.
4aadd3e2c5bc warning_ids.m: Add missing warnings to list. They are not documented.
Rik <octave@nomad.inbox5.com>
parents: 13841
diff changeset
265 ##
15605
80a4ded6b89c warning_ids.m: Add 2 missing warning IDs to documentation.
Rik <rik@octave.org>
parents: 14366
diff changeset
266 ## @item Octave:remove-init-dir
80a4ded6b89c warning_ids.m: Add 2 missing warning IDs to documentation.
Rik <rik@octave.org>
parents: 14366
diff changeset
267 ## The @code{path} function changes the search path that Octave uses
80a4ded6b89c warning_ids.m: Add 2 missing warning IDs to documentation.
Rik <rik@octave.org>
parents: 14366
diff changeset
268 ## to find functions. It is possible to set the path to a value which
80a4ded6b89c warning_ids.m: Add 2 missing warning IDs to documentation.
Rik <rik@octave.org>
parents: 14366
diff changeset
269 ## excludes Octave's own built-in functions. If the
80a4ded6b89c warning_ids.m: Add 2 missing warning IDs to documentation.
Rik <rik@octave.org>
parents: 14366
diff changeset
270 ## @code{Octave:remove-init-dir} warning is enabled then Octave will warn
80a4ded6b89c warning_ids.m: Add 2 missing warning IDs to documentation.
Rik <rik@octave.org>
parents: 14366
diff changeset
271 ## when the @code{path} function has been used in a way that may render
80a4ded6b89c warning_ids.m: Add 2 missing warning IDs to documentation.
Rik <rik@octave.org>
parents: 14366
diff changeset
272 ## Octave unworkable.
80a4ded6b89c warning_ids.m: Add 2 missing warning IDs to documentation.
Rik <rik@octave.org>
parents: 14366
diff changeset
273 ## By default, the @code{Octave:remove-init-dir} warning is enabled.
80a4ded6b89c warning_ids.m: Add 2 missing warning IDs to documentation.
Rik <rik@octave.org>
parents: 14366
diff changeset
274 ##
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
275 ## @item Octave:reload-forces-clear
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
276 ## If several functions have been loaded from the same file, Octave must
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
277 ## clear all the functions before any one of them can be reloaded. If
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
278 ## the @code{Octave:reload-forces-clear} warning is enabled, Octave will
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
279 ## warn you when this happens, and print a list of the additional
13841
0a158dbdb04a Remove 3 unused warning ids
Rik <octave@nomad.inbox5.com>
parents: 12845
diff changeset
280 ## functions that it is forced to clear.
0a158dbdb04a Remove 3 unused warning ids
Rik <octave@nomad.inbox5.com>
parents: 12845
diff changeset
281 ## By default, the @code{Octave:reload-forces-clear} warning is enabled.
11587
c792872f8942 all script files: untabify and strip trailing whitespace
John W. Eaton <jwe@octave.org>
parents: 11523
diff changeset
282 ##
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
283 ## @item Octave:resize-on-range-error
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
284 ## If the @code{Octave:resize-on-range-error} warning is enabled, print a
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
285 ## warning when a matrix is resized by an indexed assignment with
13841
0a158dbdb04a Remove 3 unused warning ids
Rik <octave@nomad.inbox5.com>
parents: 12845
diff changeset
286 ## indices outside the current bounds.
0a158dbdb04a Remove 3 unused warning ids
Rik <octave@nomad.inbox5.com>
parents: 12845
diff changeset
287 ## By default, the ## @code{Octave:resize-on-range-error} warning is disabled.
11587
c792872f8942 all script files: untabify and strip trailing whitespace
John W. Eaton <jwe@octave.org>
parents: 11523
diff changeset
288 ##
5794
1138ced03f14 [project @ 2006-05-08 20:23:04 by jwe]
jwe
parents: 5781
diff changeset
289 ## @item Octave:separator-insert
1138ced03f14 [project @ 2006-05-08 20:23:04 by jwe]
jwe
parents: 5781
diff changeset
290 ## Print warning if commas or semicolons might be inserted
1138ced03f14 [project @ 2006-05-08 20:23:04 by jwe]
jwe
parents: 5781
diff changeset
291 ## automatically in literal matrices.
13841
0a158dbdb04a Remove 3 unused warning ids
Rik <octave@nomad.inbox5.com>
parents: 12845
diff changeset
292 ## By default, the @code{Octave:separator-insert} warning is disabled.
11587
c792872f8942 all script files: untabify and strip trailing whitespace
John W. Eaton <jwe@octave.org>
parents: 11523
diff changeset
293 ##
13842
4aadd3e2c5bc warning_ids.m: Add missing warnings to list. They are not documented.
Rik <octave@nomad.inbox5.com>
parents: 13841
diff changeset
294 ## @item Octave:shadowed-function
4aadd3e2c5bc warning_ids.m: Add missing warnings to list. They are not documented.
Rik <octave@nomad.inbox5.com>
parents: 13841
diff changeset
295 ## By default, the @code{Octave:shadowed-function} warning is enabled.
4aadd3e2c5bc warning_ids.m: Add missing warnings to list. They are not documented.
Rik <octave@nomad.inbox5.com>
parents: 13841
diff changeset
296 ##
5794
1138ced03f14 [project @ 2006-05-08 20:23:04 by jwe]
jwe
parents: 5781
diff changeset
297 ## @item Octave:single-quote-string
8325
b93ac0586e4b spelling corrections
Brian Gough<bjg@network-theory.co.uk>
parents: 7017
diff changeset
298 ## Print warning if a single quote character is used to introduce a
5794
1138ced03f14 [project @ 2006-05-08 20:23:04 by jwe]
jwe
parents: 5781
diff changeset
299 ## string constant.
13841
0a158dbdb04a Remove 3 unused warning ids
Rik <octave@nomad.inbox5.com>
parents: 12845
diff changeset
300 ## By default, the @code{Octave:single-quote-string} warning is disabled.
11587
c792872f8942 all script files: untabify and strip trailing whitespace
John W. Eaton <jwe@octave.org>
parents: 11523
diff changeset
301 ##
19610
e97c63531e76 doc: Periodic grammarcheck of documentation.
Rik <rik@octave.org>
parents: 19442
diff changeset
302 ## @item Octave:nearly-singular-matrix
19442
a0c7001cf1a8 consistent messages and IDs for singular matrix warnings
John W. Eaton <jwe@octave.org>
parents: 19226
diff changeset
303 ## @itemx Octave:singular-matrix
a0c7001cf1a8 consistent messages and IDs for singular matrix warnings
John W. Eaton <jwe@octave.org>
parents: 19226
diff changeset
304 ## By default, the @code{Octave:nearly-singular-matrix} and
a0c7001cf1a8 consistent messages and IDs for singular matrix warnings
John W. Eaton <jwe@octave.org>
parents: 19226
diff changeset
305 ## @code{Octave:singular-matrix} warnings are enabled.
13842
4aadd3e2c5bc warning_ids.m: Add missing warnings to list. They are not documented.
Rik <octave@nomad.inbox5.com>
parents: 13841
diff changeset
306 ##
4aadd3e2c5bc warning_ids.m: Add missing warnings to list. They are not documented.
Rik <octave@nomad.inbox5.com>
parents: 13841
diff changeset
307 ## @item Octave:sqrtm:SingularMatrix
4aadd3e2c5bc warning_ids.m: Add missing warnings to list. They are not documented.
Rik <octave@nomad.inbox5.com>
parents: 13841
diff changeset
308 ## By default, the @code{Octave:sqrtm:SingularMatrix} warning is enabled.
4aadd3e2c5bc warning_ids.m: Add missing warnings to list. They are not documented.
Rik <octave@nomad.inbox5.com>
parents: 13841
diff changeset
309 ##
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
310 ## @item Octave:str-to-num
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
311 ## If the @code{Octave:str-to-num} warning is enabled, a warning is printed
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
312 ## for implicit conversions of strings to their numeric ASCII equivalents.
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
313 ## For example,
10821
693e22af08ae Grammarcheck documentation of m-files
Rik <octave@nomad.inbox5.com>
parents: 9051
diff changeset
314 ##
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
315 ## @example
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
316 ## @group
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
317 ## "abc" + 0
14327
4d917a6a858b doc: Use Octave coding conventions in @example blocks of docstrings.
Rik <octave@nomad.inbox5.com>
parents: 14138
diff changeset
318 ## @result{} 97 98 99
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
319 ## @end group
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
320 ## @end example
10821
693e22af08ae Grammarcheck documentation of m-files
Rik <octave@nomad.inbox5.com>
parents: 9051
diff changeset
321 ##
10846
a4f482e66b65 Grammarcheck more of the documentation.
Rik <octave@nomad.inbox5.com>
parents: 10821
diff changeset
322 ## @noindent
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
323 ## elicits a warning if the @code{Octave:str-to-num} warning is enabled.
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
324 ## By default, the @code{Octave:str-to-num} warning is disabled.
11587
c792872f8942 all script files: untabify and strip trailing whitespace
John W. Eaton <jwe@octave.org>
parents: 11523
diff changeset
325 ##
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
326 ## @item Octave:undefined-return-values
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
327 ## If the @code{Octave:undefined-return-values} warning is disabled,
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
328 ## print a warning if a function does not define all the values in
13841
0a158dbdb04a Remove 3 unused warning ids
Rik <octave@nomad.inbox5.com>
parents: 12845
diff changeset
329 ## the return list which are expected.
0a158dbdb04a Remove 3 unused warning ids
Rik <octave@nomad.inbox5.com>
parents: 12845
diff changeset
330 ## By default, the @code{Octave:undefined-return-values} warning is enabled.
11587
c792872f8942 all script files: untabify and strip trailing whitespace
John W. Eaton <jwe@octave.org>
parents: 11523
diff changeset
331 ##
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
332 ## @item Octave:variable-switch-label
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
333 ## If the @code{Octave:variable-switch-label} warning is enabled, Octave
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
334 ## will print a warning if a switch label is not a constant or constant
13841
0a158dbdb04a Remove 3 unused warning ids
Rik <octave@nomad.inbox5.com>
parents: 12845
diff changeset
335 ## expression.
0a158dbdb04a Remove 3 unused warning ids
Rik <octave@nomad.inbox5.com>
parents: 12845
diff changeset
336 ## By default, the @code{Octave:variable-switch-label} warning is disabled.
5781
faafc2d98b8d [project @ 2006-05-02 19:40:19 by jwe]
jwe
parents:
diff changeset
337 ## @end table
17170
d6499c14021c doc: Periodic grammarcheck of documentation.
Rik <rik@octave.org>
parents: 17097
diff changeset
338 ##
d6499c14021c doc: Periodic grammarcheck of documentation.
Rik <rik@octave.org>
parents: 17097
diff changeset
339
8673
9e0f0a7bf858 warning_ids.m: make it a function that just calls help
John W. Eaton <jwe@octave.org>
parents: 8325
diff changeset
340 function warning_ids ()
9e0f0a7bf858 warning_ids.m: make it a function that just calls help
John W. Eaton <jwe@octave.org>
parents: 8325
diff changeset
341 help ("warning_ids");
9e0f0a7bf858 warning_ids.m: make it a function that just calls help
John W. Eaton <jwe@octave.org>
parents: 8325
diff changeset
342 endfunction
12845
29d4b27e485d Remove warning_ids.m from test statistics.
Rik <octave@nomad.inbox5.com>
parents: 12576
diff changeset
343
14363
f3d52523cde1 Use Octave coding conventions in all m-file %!test blocks
Rik <octave@nomad.inbox5.com>
parents: 14327
diff changeset
344
19226
8a8a7bc2a09d Improve docstrings and mark documentation m-files as tested in miscellaneous/ dir.
Rik <rik@octave.org>
parents: 17744
diff changeset
345 ## Mark file as being tested. No real test needed for a documentation .m file
12845
29d4b27e485d Remove warning_ids.m from test statistics.
Rik <octave@nomad.inbox5.com>
parents: 12576
diff changeset
346 %!assert (1)
14363
f3d52523cde1 Use Octave coding conventions in all m-file %!test blocks
Rik <octave@nomad.inbox5.com>
parents: 14327
diff changeset
347