Mercurial > web-octave
diff pages/menu/support.md @ 279:54532ba03391
Redirect and merge /bugs to /support page.
* pages/bugs.md: make redirect to /support.
* pages/menu/support.md: merge content of pages/menu/bugs.md.
* pages/menu/bugs.md: delete page.
author | Kai T. Ohlhus <k.ohlhus@gmail.com> |
---|---|
date | Sun, 08 May 2022 02:29:31 +0900 |
parents | 913a36644f74 |
children |
line wrap: on
line diff
--- a/pages/menu/support.md Sat May 07 23:14:24 2022 +0900 +++ b/pages/menu/support.md Sun May 08 02:29:31 2022 +0900 @@ -46,3 +46,73 @@ - Setup assistance - Custom feature implementation </div> + +#### <i class="fas fa-bug"></i> Report a bug + +GNU Octave uses the bug tracker at [GNU Savannah]({{ site.bugs_url }}). +There you can +[<i class="far fa-plus-square"></i> report a new bug](https://savannah.gnu.org/bugs/?group=octave&func=additem), +[<i class="far fa-list-alt"></i> browse recent bugs]({{ site.bugs_url }}), +or [<i class="fas fa-search"></i> search for bugs](https://savannah.gnu.org/bugs/?group=octave&func=search). + +<a href="{{ "/img/savannah_bug_report.png" | relative_url }}"> + <img src="{{ "/img/savannah_bug_report.png" | relative_url }}" + style="max-height: 250px; width: auto;" alt="Savannah bug report"> +</a> + +1. **Is the bug already known?** + + [<i class="fas fa-search"></i> Search for already reported bugs](https://savannah.gnu.org/bugs/?group=octave&func=search) + at the bug tracker first. + If you your problem **does not appear** to be known, + then you should report the problem. + +2. **Is it really a bug?** + + - If Octave **crashes**, for any input whatever, that is a bug. + Reliable interpreters never crash. + - If Octave produces **incorrect results**, for any input whatever, + that is a bug. + - If Octave produces an **error message** for **valid input**, that is a bug. + - If Octave produces **no error message** for **invalid input**, + that is a bug. + + <p></p> + +3. **Missing function in Octave** + + If a function exists in Matlab, but not in Octave, this is **not** a bug. + + - The function might already be + [part of an Octave package]({{ site.sourceforge_url }}/functions_by_alpha.php). + - You may file a **feature request** for it on the bug tracker. + + <p></p> + + Please be aware that it might take **several months** + until for new features become part of Octave. + Consider [<i class="fas fa-comment-dollar"></i> commercial support]({{ "commercial-support.html" | relative_url }}) + if you don't want to wait that long. + +4. **Make your bug report count** + + - **Report all the facts:**<br> + Include all information that make it possible to fix the bug. + If you are not sure whether to state a fact or leave it out, state it. + This information includes your **operating system**, **Octave version**, + **exact error message** or **exact output**. + - **Give a short, specific, complete example:**<br> + Avoid: pseudocode, uninitialized variables, + calls to unattached scripts or functions. + - **Justify your expectations briefly:**<br> + Although it might seem obvious to you, + someone examining the problem might not know what result you consider + correct. + + +#### Sending Patches for Octave + +If you have a suggested fix for a bug, +please attach it to your report in the tracker. +Your patch is more likely to be reviewed if you follow the guidelines from the +Octave Wiki about the [creation of changesets]({{ site.wiki_url }}/Mercurial).