[GitHub] Bug reporting - wxMaxima-developers/wxmaxima GitHub Wiki

If you think to have found a bug in the wxMaxima application, you can file an issue and report it to the developers of wxMaxima. To solve a bug in the application, any possible information you can provide will be helpful to solve a problem.

Developers must be able to reproduce a bug. So the obvious questions to answer will be:

Anamnesis

Provide information about the wxMaxima version in use and the system it is running on. wxMaxima provides a few functions that gather bug reporting information about the current system.

  • wxbuild_info() gathers information about the currently running version of wxMaxima.
  • wxbug_report() tells how and where to file bugs.

You can execute these functions directly in a mathematical block, inside wxMaxima. This will return the necessary informations.

Exploration

Describe all steps to reproduce a bug in question and all the appearing symptoms.

Catamnesis

Tell what you await and how it should be like if the bug is solved.

File an issue

To file an issue you should choose a meaningful but short title for your issue. Provide all information which you can gather, as structured as possible. File your issue under https://github.com/wxMaxima-developers/wxmaxima/issues.

Developers may will have to ask future questions, stay tuned on to solve your issue together with professionals.

Example for bug reporting

[Bug] wxMaxima does not react when swiping with finger on screen.

wxMaxima version: ?
using wxWidgets version: ?
Maxima version: N.NN.N
Maxima build date: YYYY-MM-DD HH:mm:ss
Host type: ???_??-???-mingwNN
System type: Running System ?
Lisp implementation type: ????
Lisp implementation version: N.N.N
wxMaxima's idea of the directory layout is:
User configuration dir: ?
Help dir: ?

version=N.NN.N
timestamp=YYYY-MM-DD HH:mm:ss
host=???_??-???-mingwNN
lisp_name=SBCL
lisp_version=N.N.N
maxima_userdir=
maxima_tempdir=
maxima_objdir=
maxima_frontend=wxMaxima
maxima_frontend_version=false

I am swiping with my finger on the screen of my desktop computer while wxMaxima is closed.
wxMaxima does not react, and after a while the computer turns into standby mode.

I think wxMaxima should solve all my problems, by it self, when I swipe my screen.

Thank's a lot for looking into that.