web-octave: pages/menu/support.md annotate

annotate 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

rev	line source
216 c8126c010d67 pages: strip unnecessary "menu: false". Kai T. Ohlhus <k.ohlhus@gmail.com> parents: diff changeset	1 ---
c8126c010d67 pages: strip unnecessary "menu: false". Kai T. Ohlhus <k.ohlhus@gmail.com> parents: diff changeset	2 layout: page
241 598d7f098082 Overhaul website, less JavaScript, more FontAwesome. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 216 diff changeset	3 title: Support
598d7f098082 Overhaul website, less JavaScript, more FontAwesome. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 216 diff changeset	4 icon: <i class="fas fa-book-medical"></i>
216 c8126c010d67 pages: strip unnecessary "menu: false". Kai T. Ohlhus <k.ohlhus@gmail.com> parents: diff changeset	5 menu: true
c8126c010d67 pages: strip unnecessary "menu: false". Kai T. Ohlhus <k.ohlhus@gmail.com> parents: diff changeset	6 permalink: support
c8126c010d67 pages: strip unnecessary "menu: false". Kai T. Ohlhus <k.ohlhus@gmail.com> parents: diff changeset	7 ---
c8126c010d67 pages: strip unnecessary "menu: false". Kai T. Ohlhus <k.ohlhus@gmail.com> parents: diff changeset	8
241 598d7f098082 Overhaul website, less JavaScript, more FontAwesome. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 216 diff changeset	9 #### <i class="fas fa-book"></i> Read the GNU Octave Manual
598d7f098082 Overhaul website, less JavaScript, more FontAwesome. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 216 diff changeset	10
598d7f098082 Overhaul website, less JavaScript, more FontAwesome. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 216 diff changeset	11 <div style="margin-left: 2em;" markdown="1">
598d7f098082 Overhaul website, less JavaScript, more FontAwesome. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 216 diff changeset	12 - [<i class="fas fa-globe-americas"></i> Web version]({{ site.docs_url }})
598d7f098082 Overhaul website, less JavaScript, more FontAwesome. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 216 diff changeset	13 - [<i class="fas fa-file-pdf"></i> PDF version]({{ "octave.pdf" \| relative_url }})
598d7f098082 Overhaul website, less JavaScript, more FontAwesome. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 216 diff changeset	14 - Type `doc` inside Octave
598d7f098082 Overhaul website, less JavaScript, more FontAwesome. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 216 diff changeset	15 </div>
598d7f098082 Overhaul website, less JavaScript, more FontAwesome. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 216 diff changeset	16
598d7f098082 Overhaul website, less JavaScript, more FontAwesome. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 216 diff changeset	17
598d7f098082 Overhaul website, less JavaScript, more FontAwesome. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 216 diff changeset	18 #### <i class="fab fa-wikipedia-w"></i> [Octave Wiki]({{ site.wiki_url }})
598d7f098082 Overhaul website, less JavaScript, more FontAwesome. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 216 diff changeset	19
598d7f098082 Overhaul website, less JavaScript, more FontAwesome. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 216 diff changeset	20 <div style="margin-left: 2em;" markdown="1">
598d7f098082 Overhaul website, less JavaScript, more FontAwesome. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 216 diff changeset	21 Find [Frequently Asked Questions (FAQ)]({{ site.faq_url }})
598d7f098082 Overhaul website, less JavaScript, more FontAwesome. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 216 diff changeset	22 </div>
598d7f098082 Overhaul website, less JavaScript, more FontAwesome. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 216 diff changeset	23
598d7f098082 Overhaul website, less JavaScript, more FontAwesome. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 216 diff changeset	24 #### <i class="fas fa-users"></i> User community
216 c8126c010d67 pages: strip unnecessary "menu: false". Kai T. Ohlhus <k.ohlhus@gmail.com> parents: diff changeset	25
c8126c010d67 pages: strip unnecessary "menu: false". Kai T. Ohlhus <k.ohlhus@gmail.com> parents: diff changeset	26 <div style="margin-left: 2em;" markdown="1">
c8126c010d67 pages: strip unnecessary "menu: false". Kai T. Ohlhus <k.ohlhus@gmail.com> parents: diff changeset	27 The Octave user community is a loosely organized association of volunteers.
c8126c010d67 pages: strip unnecessary "menu: false". Kai T. Ohlhus <k.ohlhus@gmail.com> parents: diff changeset	28 Your interactions with the community will be better if you have the
c8126c010d67 pages: strip unnecessary "menu: false". Kai T. Ohlhus <k.ohlhus@gmail.com> parents: diff changeset	29 [right expectations about the support options]({{ "support-expectations.html" \| relative_url }})
c8126c010d67 pages: strip unnecessary "menu: false". Kai T. Ohlhus <k.ohlhus@gmail.com> parents: diff changeset	30 available to you.
c8126c010d67 pages: strip unnecessary "menu: false". Kai T. Ohlhus <k.ohlhus@gmail.com> parents: diff changeset	31 </div>
c8126c010d67 pages: strip unnecessary "menu: false". Kai T. Ohlhus <k.ohlhus@gmail.com> parents: diff changeset	32
c8126c010d67 pages: strip unnecessary "menu: false". Kai T. Ohlhus <k.ohlhus@gmail.com> parents: diff changeset	33 <div style="margin-left: 2em;" markdown="1">
241 598d7f098082 Overhaul website, less JavaScript, more FontAwesome. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 216 diff changeset	34 - [<i class="fab fa-discourse"></i> Discourse]({{ site.discourse_url }}) --
598d7f098082 Overhaul website, less JavaScript, more FontAwesome. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 216 diff changeset	35 the major communication platform for Octave users and developers.
598d7f098082 Overhaul website, less JavaScript, more FontAwesome. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 216 diff changeset	36 - <i class="far fa-comments"></i> IRC: Chat with users and developers on the
254 913a36644f74 Update IRC chat https://webchat.freenode.net/#octave. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 241 diff changeset	37 [Libera `#octave` channel](https://web.libera.chat/#octave).
241 598d7f098082 Overhaul website, less JavaScript, more FontAwesome. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 216 diff changeset	38 - <i class="far fa-envelope"></i> Browse the old
216 c8126c010d67 pages: strip unnecessary "menu: false". Kai T. Ohlhus <k.ohlhus@gmail.com> parents: diff changeset	39 [mailing list archives](https://lists.gnu.org/archive/html/help-octave/).
c8126c010d67 pages: strip unnecessary "menu: false". Kai T. Ohlhus <k.ohlhus@gmail.com> parents: diff changeset	40 </div>
c8126c010d67 pages: strip unnecessary "menu: false". Kai T. Ohlhus <k.ohlhus@gmail.com> parents: diff changeset	41
c8126c010d67 pages: strip unnecessary "menu: false". Kai T. Ohlhus <k.ohlhus@gmail.com> parents: diff changeset	42
241 598d7f098082 Overhaul website, less JavaScript, more FontAwesome. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 216 diff changeset	43 #### <i class="fas fa-comment-dollar"></i> [Commercial support]({{ "commercial-support.html" \| relative_url }})
216 c8126c010d67 pages: strip unnecessary "menu: false". Kai T. Ohlhus <k.ohlhus@gmail.com> parents: diff changeset	44
c8126c010d67 pages: strip unnecessary "menu: false". Kai T. Ohlhus <k.ohlhus@gmail.com> parents: diff changeset	45 <div style="margin-left: 2em;" markdown="1">
c8126c010d67 pages: strip unnecessary "menu: false". Kai T. Ohlhus <k.ohlhus@gmail.com> parents: diff changeset	46 - Setup assistance
c8126c010d67 pages: strip unnecessary "menu: false". Kai T. Ohlhus <k.ohlhus@gmail.com> parents: diff changeset	47 - Custom feature implementation
c8126c010d67 pages: strip unnecessary "menu: false". Kai T. Ohlhus <k.ohlhus@gmail.com> parents: diff changeset	48 </div>
279 54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	49
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	50 #### <i class="fas fa-bug"></i> Report a bug
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	51
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	52 GNU Octave uses the bug tracker at [GNU Savannah]({{ site.bugs_url }}).
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	53 There you can
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	54 [<i class="far fa-plus-square"></i> report a new bug](https://savannah.gnu.org/bugs/?group=octave&func=additem),
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	55 [<i class="far fa-list-alt"></i> browse recent bugs]({{ site.bugs_url }}),
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	56 or [<i class="fas fa-search"></i> search for bugs](https://savannah.gnu.org/bugs/?group=octave&func=search).
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	57
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	58 <a href="{{ "/img/savannah_bug_report.png" \| relative_url }}">
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	59 <img src="{{ "/img/savannah_bug_report.png" \| relative_url }}"
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	60 style="max-height: 250px; width: auto;" alt="Savannah bug report">
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	61 </a>
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	62
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	63 1. Is the bug already known?
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	64
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	65 [<i class="fas fa-search"></i> Search for already reported bugs](https://savannah.gnu.org/bugs/?group=octave&func=search)
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	66 at the bug tracker first.
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	67 If you your problem does not appear to be known,
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	68 then you should report the problem.
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	69
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	70 2. Is it really a bug?
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	71
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	72 - If Octave crashes, for any input whatever, that is a bug.
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	73 Reliable interpreters never crash.
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	74 - If Octave produces incorrect results, for any input whatever,
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	75 that is a bug.
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	76 - If Octave produces an error message for valid input, that is a bug.
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	77 - If Octave produces no error message for invalid input,
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	78 that is a bug.
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	79
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	80 <p></p>
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	81
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	82 3. Missing function in Octave
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	83
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	84 If a function exists in Matlab, but not in Octave, this is not a bug.
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	85
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	86 - The function might already be
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	87 [part of an Octave package]({{ site.sourceforge_url }}/functions_by_alpha.php).
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	88 - You may file a feature request for it on the bug tracker.
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	89
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	90 <p></p>
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	91
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	92 Please be aware that it might take several months
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	93 until for new features become part of Octave.
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	94 Consider [<i class="fas fa-comment-dollar"></i> commercial support]({{ "commercial-support.html" \| relative_url }})
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	95 if you don't want to wait that long.
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	96
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	97 4. Make your bug report count
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	98
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	99 - Report all the facts:<br>
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	100 Include all information that make it possible to fix the bug.
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	101 If you are not sure whether to state a fact or leave it out, state it.
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	102 This information includes your operating system, Octave version,
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	103 exact error message or exact output.
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	104 - Give a short, specific, complete example:<br>
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	105 Avoid: pseudocode, uninitialized variables,
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	106 calls to unattached scripts or functions.
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	107 - Justify your expectations briefly:<br>
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	108 Although it might seem obvious to you,
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	109 someone examining the problem might not know what result you consider
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	110 correct.
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	111
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	112
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	113 #### Sending Patches for Octave
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	114
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	115 If you have a suggested fix for a bug,
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	116 please attach it to your report in the tracker.
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	117 Your patch is more likely to be reviewed if you follow the guidelines from the
54532ba03391 Redirect and merge /bugs to /support page. Kai T. Ohlhus <k.ohlhus@gmail.com> parents: 254 diff changeset	118 Octave Wiki about the [creation of changesets]({{ site.wiki_url }}/Mercurial).

Mercurial > web-octave

annotate pages/menu/support.md @ 279:54532ba03391