How to report issues

(2Q19)


This article will tell you what information to provide when you report an issue.

Reporting an issue

Bugs can be reported on the Bug Tracker. Data and log files can be attached.

When a (potential) bug is reported, please include as much of the information described below. When more information is provided it is easier for the developers to understand and reproduce the issue, which means that the issue can be picked-up and solved much faster.

General information

When reporting a (suspected) bug please make the report as complete as possible:

  • Try to write a clear (and short) description how to reproduce the problem

  • Include the exact version (and revision), e.g. "1.4.3" (rev1234) or "2.1".

  • Always add the operating system (e.g. "Windows7 64bit"), the exact Java version as is outputted by the command java -version on the console.

  • Include relevant parts of the logfile (logs/exist.log).

  • Mention the changes made in the configuration files, for instance etc/conf.xml, etc/launcher.properties, and etc/jetty/jetty.xml.

XQuery specific

When reporting a potential XQuery bug please:

  • Make the XQuery, if possible, 'self containing', meaning that the XQuery does not require any additional files to run.

  • Describe the actual XQuery result and the expected result

  • Check if the issue has been solved in the latest version of eXist-db; For this the web based tool eXide can be used.

  • Run the XQuery with Kernow for Saxon and check the similarities and differences.