Mercurial > web-octave

annotate bugs.md @ 80:05b2f0d66aa8 kai

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Some website authoring. Should be completed right now.
author Kai T. Ohlhus <k.ohlhus@gmail.com>
date Fri, 14 Oct 2016 03:15:09 +0200
parents 5e297505996c
children 5caa2af27956
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
66
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
7 GNU Octave uses the bug tracker at [Savannah][1].
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
8 There you can [report a new bug][2], [browse recent bugs][1],
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
9 or [search for bugs][3].
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
10
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
11 [1]: https://savannah.gnu.org/bugs/?group=octave
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
12 [2]: https://savannah.gnu.org/bugs/?func=additem&group=octave
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
13 [3]: https://savannah.gnu.org/bugs/?func=search&group=octave
5
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
14
66
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
15 <p>
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
16 <div class="alert">
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
17 {% octicon stop class:"octicon-stop-octave" %}
74
5e297505996c Some minor content changes.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 66
diff changeset
18 Please do <strong>not</strong> send any bug reports to the
5e297505996c Some minor content changes.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 66
diff changeset
19 <samp>help@octave.org</samp> mailing list.
5e297505996c Some minor content changes.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 66
diff changeset
20 Most Octave users do not want to receive bug reports.
66
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
21 </div>
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
22 </p>
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
23
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
24 <p>
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
25 <div class="alert">
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
26 {% octicon stop class:"octicon-stop-octave" %}
74
5e297505996c Some minor content changes.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 66
diff changeset
27 <strong>Before</strong> reporting a new bug, please read the guidelines below.
66
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
28 </div>
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
29 </p>
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
66
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
32
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
33 # Is the bug already known?
5
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
34
66
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
35 When you encounter a problem,
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
36 the first thing to do is to see if it is already known.
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
37 Therefore,
5
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
38
66
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
39 - [search for already reported bugs at the bug tracker][3],
5
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
40
66
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
41 - look at the list of known causes of trouble in the
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
42 [Octave reference manual][4].
5
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
43
66
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
44 If you your problem does not appear to be known,
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
45 then you should report the problem.
5
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
46
43
a1cb50997055 Reviewed and reformatted some files.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 5
diff changeset
47 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
48 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
49 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
50 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
51
80
05b2f0d66aa8 Some website authoring. Should be completed right now.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 74
diff changeset
52 [4]: {{ site.docs_url }}/Trouble.html#Trouble
5
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
53
66
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
54
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
55
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
56 # Is it really a bug?
5
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
57
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
58 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
59
66
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
60 - If Octave gets a fatal signal, for any input whatever, that is a bug.
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
61 Reliable interpreters never crash.
46
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
62
66
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
63 - If Octave produces incorrect results, for any input whatever, that is a bug.
46
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
64
66
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
65 - Some output may appear to be incorrect when it is in fact due to a
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
66 program whose behavior is undefined, which happened by chance to give
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
67 the desired results on another system. For example, trigonometric
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
68 functions may produce different results because of differences in the
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
69 math library or the way floating point arithmetic is handled on various
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
70 systems.
5
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
71
66
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
72 - If Octave produces an error message for valid input, that is a bug.
46
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
73
66
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
74 - If Octave does not produce an error message for invalid input, that is
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
75 a bug. However, you should note that your idea of "invalid input"
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
76 might be my idea of "an extension" or "support for traditional practice".
5
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
77
66
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
78 - If you are an experienced user of programs like Octave, your
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
79 suggestions for improvement are welcome in any case.
46
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
80
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
81
66
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
82
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
83 # Make your bug report count
46
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
84
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
85 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
86 information that makes it possible to fix the bug.
5
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
87
43
a1cb50997055 Reviewed and reformatted some files.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 5
diff changeset
88 The fundamental principle of reporting bugs usefully is this:
66
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
89 **report all the facts**. If you are not sure whether to
46
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
90 state a fact or leave it out, state it.
5
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
91
46
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
92 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
93 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
94 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
95 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
96 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
97 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
98 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
99 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
100 and give a specific, complete example.
5
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
101
46
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
102 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
103 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
104 the assumption that the bug is not known.
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 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
107 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
108 bug report to begin with.
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 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
111 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
112 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
113
43
a1cb50997055 Reviewed and reformatted some files.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 5
diff changeset
114 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
115 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
116 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
117 investigate the bug:
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
118
66
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
119 - A complete input file that will reproduce the bug.
46
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
120
66
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
121 A single statement may not be enough of an example--the bug might
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
122 depend on other details that are missing from the single statement where
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
123 the error finally occurs.
46
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
124
66
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
125 - The command arguments you gave Octave to execute that example
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
126 and observe the bug. To guarantee you won't omit something important,
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
127 list all the options.
5
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
128
66
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
129 If we were to try to guess the arguments, we would probably guess wrong
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
130 and then we would not encounter the bug.
46
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
131
66
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
132 - A description of what behavior you observe that you believe is incorrect.
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
133 For example, "The interpreter gets a fatal signal," or, "The output produced
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
134 at line 208 is incorrect."
46
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
135
66
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
136 - The output you expected to see. Although it might seem obvious to you,
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
137 someone examining the problem might not know what result you consider
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
138 correct.
46
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
139
66
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
140 - If you wish to suggest changes to the Octave source, send them as context
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
141 diffs. If you discuss something in the Octave source, refer to it by
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
142 context, not by line number, because the line numbers in the development
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
143 sources probably won't match those in your sources.
43
a1cb50997055 Reviewed and reformatted some files.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 5
diff changeset
144
5
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
145
66
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
146
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
147 # Sending Patches for Octave
5
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
148
66
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
149 If you have a suggested fix for a bug, please attach it to your report in
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
150 the tracker. Your patch is more likely to be reviewed if you follow the
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
151 guidelines in the Octave manual about to [generate a changeset][5]
43
a1cb50997055 Reviewed and reformatted some files.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 5
diff changeset
152 and submit patches for Octave.
66
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
153
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
154 [5]: {{site.docs_url}}/Basics-of-Generating-a-Changeset.html#Basics-of-Generating-a-Changeset