Mercurial > web-octave
annotate bugs.md @ 90:fbd5bca94df2 kai
Let Jekyll do the current date.
author | Kai T. Ohlhus <k.ohlhus@gmail.com> |
---|---|
date | Mon, 17 Oct 2016 21:08:23 +0200 |
parents | 5caa2af27956 |
children |
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 |