Mercurial > web-octave

annotate bugs.md @ 54:98a7ea218860 kai

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Keep displaying page title in case of posts.
author Kai T. Ohlhus <k.ohlhus@gmail.com>
date Tue, 11 Oct 2016 15:54:09 +0200
parents 171ca967fcc9
children a7952259f5d3
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
5
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
1 ---
46
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
2 layout: default
5
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
3 title: Bugs
46
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
4 menu: true
5
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
5 ---
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
6
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
7 <ul class="button-group">
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
8 <li><a href="http://savannah.gnu.org/bugs/?func=additem&group=octave" class="button">Report</a></li>
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
9 <li><a href="http://savannah.gnu.org/bugs/?func=search&group=octave" class="button">Search</a></li>
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
10 <li><a href="http://savannah.gnu.org/bugs/?group=octave" class="button">Browse</a></li>
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
11 </ul>
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
12
46
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
13 Your bug reports play an essential role in making Octave reliable.
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
14 You can make fixing problems easier by following the guidelines below.
5
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
15
46
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
16
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
17 ## Where and How to Send Bug Reports
5
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
18
43
a1cb50997055 Reviewed and reformatted some files.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 5
diff changeset
19 To report a bug in Octave,
46
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
20 <a href="http://savannah.gnu.org/bugs/?func=additem&group=octave">submit
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
21 a bug report</a> using the bug tracker.
5
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
22
46
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
23 Please do <strong>not</strong> send bug reports to the
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
24 <samp>help-octave</samp> mailing list. Most users of Octave do not
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
25 want to receive bug reports.
5
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
26
46
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
27 When you encounter a problem, the first thing to do is to see if it
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
28 is already known. The best place to look for reported problems is
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
29 <a href="http://savannah.gnu.org/bugs/?group=octave">the Octave bug tracker</a>.
5
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
30
46
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
31 The <a href="doc/interpreter/Trouble.html#Trouble">Octave
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
32 reference manual</a> also contains a list of known causes of
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
33 trouble.
5
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
34
46
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
35 If you your problem does not appear to be known, then you should
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
36 report the problem.
5
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
37
43
a1cb50997055 Reviewed and reformatted some files.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 5
diff changeset
38 Reporting a bug may help you by bringing a solution to your problem,
46
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
39 or it may not. In any case, the principal function of a bug report is
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
40 to help the entire community by making the next version of Octave work
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
41 better, so you can contribute to the maintenance of Octave.
43
a1cb50997055 Reviewed and reformatted some files.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 5
diff changeset
42
5
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
43
46
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
44 ## Have You Found a Bug?
5
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
45
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
46 If you are not sure whether you have found a bug, here are some guidelines:
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
47
46
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
48 <ul>
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
49 <li>
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
50 If Octave gets a fatal signal, for any input whatever, that is a bug.
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
51 Reliable interpreters never crash.
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
52 </li>
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
53
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
54 <li>
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
55 If Octave produces incorrect results, for any input whatever,
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
56 that is a bug.
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
57 </li>
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
58
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
59 <li>
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
60 Some output may appear to be incorrect when it is in fact due to a
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
61 program whose behavior is undefined, which happened by chance to give
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
62 the desired results on another system. For example,
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
63 trigonometric functions may produce different results because of
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
64 differences in the math library or the way floating point
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
65 arithmetic is handled on various systems.
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
66 </li>
5
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
67
46
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
68 <li>
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
69 If Octave produces an error message for valid input, that is a
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
70 bug.
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
71 </li>
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
72
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
73 <li>
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
74 If Octave does not produce an error message for invalid input, that is
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
75 a bug. However, you should note that your idea of "invalid input"
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
76 might be my idea of "an extension" or "support for traditional
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
77 practice".
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
78 </li>
5
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
79
46
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
80 <li>
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
81 If you are an experienced user of programs like Octave, your
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
82 suggestions for improvement are welcome in any case.
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
83 </li>
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
84 </ul>
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
85
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
86
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
87 ## Making Your Bug Report Count
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
88
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
89 In order for a bug report to serve its purpose, you must include the
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
90 information that makes it possible to fix the bug.
5
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
91
43
a1cb50997055 Reviewed and reformatted some files.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 5
diff changeset
92 The fundamental principle of reporting bugs usefully is this:
46
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
93 <strong>report all the facts</strong>. If you are not sure whether to
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
94 state a fact or leave it out, state it.
5
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
95
46
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
96 Often people omit facts because they think they know what causes the
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
97 problem and they conclude that some details don't matter. Thus, you
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
98 might assume that the name of the variable you use in an example does
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
99 not matter. Well, probably it doesn't, but one cannot be sure.
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
100 Perhaps the bug is a stray memory reference which happens to fetch
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
101 from the location where that name is stored in memory; perhaps, if the
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
102 name were different, the contents of that location would fool the
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
103 interpreter into doing the right thing despite the bug. Play it safe
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
104 and give a specific, complete example.
5
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
105
46
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
106 Keep in mind that the purpose of a bug report is to enable someone to
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
107 fix the bug if it is not known. Always write your bug reports on
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
108 the assumption that the bug is not known.
5
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
109
46
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
110 Sometimes people give a few sketchy facts and ask, "Does this ring a
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
111 bell?" This cannot help us fix a bug. It is better to send a complete
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
112 bug report to begin with.
5
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
113
46
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
114 Try to make your bug report self-contained. If we have to ask you for
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
115 more information, it is best if you include all the previous information
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
116 in your response, as well as the information that was missing.
5
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
117
43
a1cb50997055 Reviewed and reformatted some files.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 5
diff changeset
118 The bug tracker will prompt you for some basic information like
46
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
119 the version of Octave and the operating system you are using. You
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
120 also need to include the following to enable someone to
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
121 investigate the bug:
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
122
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
123 <ul>
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
124 <li>
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
125 A complete input file that will reproduce the bug.
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
126
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
127 A single statement may not be enough of an example--the bug might
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
128 depend on other details that are missing from the single statement where
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
129 the error finally occurs.
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
130 </li>
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
131
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
132 <li>
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
133 The command arguments you gave Octave to execute that example
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
134 and observe the bug. To guarantee you won't omit something important,
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
135 list all the options.
5
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
136
46
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
137 If we were to try to guess the arguments, we would probably guess wrong
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
138 and then we would not encounter the bug.
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
139 </li>
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
140
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
141 <li>
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
142 A description of what behavior you observe that you believe is
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
143 incorrect. For example, "The interpreter gets a fatal signal," or, "The
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
144 output produced at line 208 is incorrect."
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
145 </li>
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
146
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
147 <li>
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
148 The output you expected to see. Although it might seem obvious
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
149 to you, someone examining the problem might not know what result
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
150 you consider correct.
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
151 </li>
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
152
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
153 <li>
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
154 If you wish to suggest changes to the Octave source, send them
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
155 as context diffs. If you discuss something in the Octave
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
156 source, refer to it by context, not by line number, because the
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
157 line numbers in the development sources probably won't match
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
158 those in your sources.
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
159 </li>
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
160 </ul>
43
a1cb50997055 Reviewed and reformatted some files.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 5
diff changeset
161
5
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
162
46
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
163 ## Sending Patches for Octave
5
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
164
46
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
165 If you have a suggested fix for a bug, please attach it to your
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
166 report in the tracker. Your patch is more likely to be reviewed
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
167 if you follow the guidelines in the Octave manual about to
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
168 <a href="doc/interpreter/Basics-of-Generating-a-Changeset.html#Basics-of-Generating-a-Changeset">generate a changeset</a>
43
a1cb50997055 Reviewed and reformatted some files.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 5
diff changeset
169 and submit patches for Octave.