Mercurial > web-octave

annotate bugs.md @ 93:6f92b43549a4 kai

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Close kai branch
author Kai T. Ohlhus <k.ohlhus@gmail.com>
date Tue, 01 Nov 2016 00:29:31 +0100
parents 5caa2af27956
children
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
84
5caa2af27956 Make more use of Jekyll Makros. Website tabs reconsidering.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 80
diff changeset
11 [1]: {{ site.bugs_url }}
5caa2af27956 Make more use of Jekyll Makros. Website tabs reconsidering.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 80
diff changeset
12 [2]: {{ site.bugs_url }}&func=additem
5caa2af27956 Make more use of Jekyll Makros. Website tabs reconsidering.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 80
diff changeset
13 [3]: {{ site.bugs_url }}&func=search
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
84
5caa2af27956 Make more use of Jekyll Makros. Website tabs reconsidering.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 80
diff changeset
19 <samp>{{ site.help_email }}</samp> mailing list.
74
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
84
5caa2af27956 Make more use of Jekyll Makros. Website tabs reconsidering.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 80
diff changeset
41 - look at the [list of known causes of trouble][4] in the Octave manual.
5
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
42
66
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
43 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
44 then you should report the problem.
5
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
45
43
a1cb50997055 Reviewed and reformatted some files.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 5
diff changeset
46 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
47 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
48 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
49 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
50
80
05b2f0d66aa8 Some website authoring. Should be completed right now.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 74
diff changeset
51 [4]: {{ site.docs_url }}/Trouble.html#Trouble
5
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
52
66
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
53
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 # Is it really a bug?
5
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
56
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
57 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
58
66
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
59 - 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
60 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
61
66
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
62 - 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
63
66
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
64 - 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
65 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
66 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
67 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
68 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
69 systems.
5
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
70
66
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
71 - 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
72
66
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
73 - 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
74 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
75 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
76
66
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
77 - 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
78 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
79
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
80
66
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
81
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
82 # 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
83
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
84 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
85 information that makes it possible to fix the bug.
5
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
86
43
a1cb50997055 Reviewed and reformatted some files.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 5
diff changeset
87 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
88 **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
89 state a fact or leave it out, state it.
5
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
90
46
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
91 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
92 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
93 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
94 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
95 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
96 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
97 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
98 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
99 and give a specific, complete example.
5
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
100
46
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
101 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
102 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
103 the assumption that the bug is not known.
5
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
104
46
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
105 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
106 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
107 bug report to begin with.
5
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
108
46
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
109 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
110 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
111 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
112
43
a1cb50997055 Reviewed and reformatted some files.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 5
diff changeset
113 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
114 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
115 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
116 investigate the bug:
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
117
66
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
118 - 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
119
66
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
120 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
121 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
122 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
123
66
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
124 - 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
125 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
126 list all the options.
5
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
127
66
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
128 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
129 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
130
66
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
131 - 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
132 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
133 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
134
66
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
135 - 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
136 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
137 correct.
46
171ca967fcc9 Start new development branch closer to the current website,
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 43
diff changeset
138
66
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
139 - 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
140 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
141 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
142 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
143
5
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
144
66
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
145
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
146 # Sending Patches for Octave
5
e210b708b330 fill in site content
Alex Krolick <whokilledtheelectricmonk@gmail.com>
parents:
diff changeset
147
66
a7952259f5d3 Markdownify more pages, make better use of SVG and CSS.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 46
diff changeset
148 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
149 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
150 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
151 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
152
84
5caa2af27956 Make more use of Jekyll Makros. Website tabs reconsidering.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents: 80
diff changeset
153 [5]: {{ site.docs_url }}/Basics-of-Generating-a-Changeset.html#Basics-of-Generating-a-Changeset