This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
wiki:bugs [2024/07/01 16:35] uli42 |
wiki:bugs [2024/08/02 09:09] (current) gratuxri [X2Go Bug Tracker] |
||
---|---|---|---|
Line 1: | Line 1: | ||
====== X2Go Bug Tracker ====== | ====== X2Go Bug Tracker ====== | ||
- | The information below is deprecated. We are now using the gitlab bug tracker at https:// | + | Please use gitlab bug tracker at https:// |
+ | ====== Viewing Bug History ====== | ||
- | + | For historical reasons you can access the previous bugtracker | |
- | + | ||
- | + | ||
- | < | + | |
- | The X2Go project uses '' | + | |
- | + | ||
- | Before X2Go had a bug tracker, the quest was: we need a BTS that is easily scriptable and a BTS that fully maps issue tracking | + | |
- | + | ||
- | The choice has been well thought of, you may find that there are better bug tracking systems in the world. For X2Go, we think we have found what we wanted. | + | |
- | </ | + | |
- | ===== Viewing Bug History ===== | + | |
- | + | ||
- | <del> | + | |
If you know either the X2Go component or the bug number you can also access the information directly: | If you know either the X2Go component or the bug number you can also access the information directly: | ||
- | * http:// | + | http:// |
- | | + | http:// |
A complete list of X2Go components with open/closed bugs can be viewed with this URL: | A complete list of X2Go components with open/closed bugs can be viewed with this URL: | ||
- | * [[http:// | + | http:// |
- | + | ||
- | </ | + | |
- | + | ||
- | ===== Reporting Bugs ===== | + | |
- | < | + | |
- | + | ||
- | How to report a bug is fully explained [[http:// | + | |
- | + | ||
- | **We strongly encourage you to subscribe to the X2Go-Dev mailing list before submitting your bug.** Its subscription page is here: http:// | + | |
- | + | ||
- | Subscribing has the following advantages: | + | |
- | - Your bug report will show up on X2Go-Dev immediately, | + | |
- | - You will receive all the relevant discussion regarding your report, even if someone forgets to CC the bug tracker in their reply | + | |
- | </ | + | |
- | + | ||
- | ==== Plain bug submission ==== | + | |
- | < | + | |
- | Definition of fields/ | + | |
- | + | ||
- | < | + | |
- | To: submit@bugs.x2go.org | + | |
- | Subject: < | + | |
- | Body: | + | |
- | Package: < | + | |
- | Version: < | + | |
- | <one empty line - so hit [enter] twice after typing the version number> | + | |
- | < | + | |
- | </ | + | |
- | + | ||
- | Example: | + | |
- | < | + | |
- | To: submit@bugs.x2go.org | + | |
- | Subject: Package contains bobcat | + | |
- | Body: | + | |
- | Package: x2goserver | + | |
- | Version: 4.0.1.0 | + | |
- | + | ||
- | When installing x2goserver on Debian stable using apt-get install x2goserver, | + | |
- | instead of running the postinstall script, a bobcat is released: | + | |
- | + | ||
- | // | + | |
- | \\ // , | + | |
- | | + | |
- | \ \ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@@@@, | + | |
- | \ \ (@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@<> | + | |
- | | + | |
- | \@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@@@@@@@@ | + | |
- | __----__ | + | |
- | \@\ @@@@@@@@----__-----_ | + | |
- | | + | |
- | /@/ @@@@ @@@@@ @@@@@ @@@@@ | + | |
- | / | + | |
- | (@( | + | |
- | | + | |
- | \/ | + | |
- | @@@ | + | |
- | ''' | + | |
- | + | ||
- | A detailed log of the installation progress can be found at https:// | + | |
- | + | ||
- | </ | + | |
- | + | ||
- | In the description, | + | |
- | - The steps you took to produce the bug | + | |
- | - Any exact error messages | + | |
- | - What you expected to happen | + | |
- | - What actually happened | + | |
- | + | ||
- | Also, please list the following info: | + | |
- | - The client machine' | + | |
- | - The client machine' | + | |
- | - Any relevant session settings in X2GoClient, PyHoca-GUI or Pyhoca-CLI | + | |
- | - The server' | + | |
- | - The server' | + | |
- | - The server' | + | |
- | - The server' | + | |
- | - The server' | + | |
- | - Any relevant settings in X2GoServer (that you changed from the defaults) | + | |
- | </ | + | |
- | + | ||
- | ==== Bug submission with a Patch ==== | + | |
- | < | + | |
- | + | ||
- | In case you can provide a patch with your bug report, please attach the patch to your bug report. Do __not__ copy+paste the patch into the mail body, as the result will not be usable!!! | + | |
- | + | ||
- | Create patches for master branch and send them in git format. The documentation about creating git patches can be found [[http:// | + | |
- | + | ||
- | Some of you have their own Git clones of X2Go Git. If you want to provide a patch via your public Git clone of an X2Go component, please make sure that the patch is just one commit on one of your Git branches. The rule here is simple: one Git commit on your side, one bug report in X2Go BTS. Everything else will take too much time on the patch reviewer side. | + | |
- | + | ||
- | For submitting your bug report, please use this very similar template: | + | |
- | + | ||
- | < | + | |
- | To: submit@bugs.x2go.org | + | |
- | Subject: < | + | |
- | Body: | + | |
- | Package: < | + | |
- | Version: < | + | |
- | Tag: patch | + | |
- | + | ||
- | < | + | |
- | + | ||
- | Attachment: < | + | |
- | </ | + | |
- | </ | + | |
- | + | ||
- | ==== Feature requests / Wishlist bugs ==== | + | |
- | < | + | |
- | + | ||
- | Feature requests are also handled via the X2Go BTS system. Feature requests are bugs with severity ,, | + | |
- | + | ||
- | < | + | |
- | To: submit@bugs.x2go.org | + | |
- | Subject: < | + | |
- | Body: | + | |
- | Package: < | + | |
- | Version: < | + | |
- | Severity: wishlist | + | |
- | + | ||
- | < | + | |
- | </ | + | |
- | + | ||
- | + | ||
- | </ | + | |
- | + | ||
- | ===== Controlling Bugs ===== | + | |
- | < | + | |
- | + | ||
- | The full control command set is documented [[http:// | + | |
- | + | ||
- | Very common control sequences are shown below. | + | |
- | </ | + | |
- | + | ||
- | ==== Bug has been fixed in X2Go Git ==== | + | |
- | < | + | |
- | + | ||
- | Marking bugs being fixed in X2Go Git has been automatized. | + | |
- | + | ||
- | **Important notice for developers: | + | |
- | </ | + | |
- | + | ||
- | ==== New version with a bug fixed has been released ==== | + | |
- | < | + | |
- | + | ||
- | As part of the X2Go release workflow, bugs that have been fixed for this release have to be closed. Normally, most bugs are already marked (tagged) as pending. | + | |
- | + | ||
- | Some pending bugs, though, may only have been fixed on the master branch, but not yet on a release branch. If the release is taken from a release branch, take a look at the //Fixed in:// field of the bug report and check if the version to be released is mentioned in that field. If unsure, also cross-check with the X2Go component' | + | |
- | + | ||
- | < | + | |
- | To: < | + | |
- | Cc: < | + | |
- | Subject: Issue resolved in < | + | |
- | Body: | + | |
- | Control: close -1 | + | |
- | + | ||
- | The reported issue has been resolved in the lately release version < | + | |
- | + | ||
- | Thanks for reporting this issue, | + | |
- | < | + | |
- | </ | + | |
- | </ | + | |
- | + | ||
- | ==== Bug has been reported against the wrong X2Go Component ==== | + | |
- | < | + | |
- | + | ||
- | Even for X2Go power-users and developers it is not always easy to tell, what X2Go component causes a certain buggy behaviour in X2Go. Once a problem has been narrowed down, we might need to reassign a bug to another X2Go component. | + | |
- | + | ||
- | < | + | |
- | To: < | + | |
- | Cc: < | + | |
- | Subject: < | + | |
- | Body: | + | |
- | Control: reassign -1 < | + | |
- | + | ||
- | The reported issue is actually a bug in < | + | |
- | + | ||
- | < | + | |
- | + | ||
- | Thanks for reporting this issue, | + | |
- | < | + | |
- | </ | + | |
- | + | ||
- | </ | + | |
- | + | ||
- | ==== Bug submitter used a non-appropriate title ==== | + | |
- | < | + | |
- | + | ||
- | People sometimes use inappropriate titles when submitting bugs. Also, the summarizing title of a bug can be improved, once we know what the reason for the occuring error really is. | + | |
- | + | ||
- | < | + | |
- | To: < | + | |
- | Cc: < | + | |
- | Subject: < | + | |
- | Body: | + | |
- | Control: retitle -1 < | + | |
- | + | ||
- | < | + | |
- | + | ||
- | Thanks for reporting this issue, | + | |
- | < | + | |
- | </ | + | |
- | + | ||
- | </ | + | |
- | + | ||
- | ==== Cloning bugs ==== | + | |
- | < | + | |
- | + | ||
- | While fixing a Bug we might become aware of another issue arising in some other X2Go Component that is related to the bug we just fixed. In such a case we have to clone the bug. | + | |
- | + | ||
- | < | + | |
- | To: < | + | |
- | Cc: control@bugs.x2go.org | + | |
- | Subject: < | + | |
- | Body: | + | |
- | clone #< | + | |
- | tag -1 - pending | + | |
- | tag -1 - patch | + | |
- | reassign -1 < | + | |
- | retitle #< | + | |
- | thanks | + | |
- | + | ||
- | < | + | |
- | + | ||
- | Best, | + | |
- | < | + | |
- | </ | + | |
- | </ | + | |
- | + | ||
- | ===== GDPR Notice/ | + | |
- | < | + | |
- | + | ||
- | This is the Privacy Policy that applies when submitting a bug report via E-Mail. | + | |
- | </ | + | |
- | + | ||
- | ==== HERE'S WHERE YOUR BUG REPORT WILL BE STORED AND VISIBLE TO THE PUBLIC ==== | + | |
- | < | + | |
- | + | ||
- | Reporting a bug means that your E-Mail address, as well as the content of your message, will immediately be visible to everyone viewing the public bug tracker of X2Go (https:// | + | |
- | </ | + | |
- | + | ||
- | ==== HERE'S HOW WE HANDLE YOUR E-MAIL ADDRESS DATA ==== | + | |
- | < | + | |
- | + | ||
- | Please understand that we need to keep your E-Mail address stored in our | + | |
- | public bug tracker, so others can contact you about the bug you reported or commented on. This is a justifiable cause as set forth in Article 6 (1) b) of the GDPR https:// | + | |
- | + | ||
- | If you want to keep your real E-Mail address secret from the public, | + | |
- | we suggest you either refrain from submitting the bug, or to submit it using a temporary, " | + | |
- | </ | + | |
- | + | ||
- | ==== HERE'S HOW TO REQUEST MESSAGE DELETION ==== | + | |
- | < | + | |
- | + | ||
- | You have the right to withdraw your consent at any time, as per Article 7 (3) of the GDPR. If you believe an E-Mail you sent should be purged from the public bug tracker or the public archive that we operate (see the link above), please contact the list administrators at | + | |
- | + | ||
- | x2go-dev-owner@lists.x2go.org | + | |
- | + | ||
- | Note that list administrators have no influence what other recipients of | + | |
- | the particular list message do with it - e.g. if others choose to mirror | + | |
- | contents of our list archive on their own web site, you will need to | + | |
- | contact them separately with your deletion request. | + | |
- | </ | + |