X-Git-Url: https://review.openocd.org/gitweb?p=openocd.git;a=blobdiff_plain;f=BUGS;h=4381c87b5d093071bc030f369ce6c99afa877034;hp=d22417776b4f3cb2309747e42ac4605bc5cb5674;hb=ba2fbe22470915359e1905aaad4c613eacbdf6dc;hpb=03c9e48f88fa8b681b77c6c35d6da0a0e838a7e8 diff --git a/BUGS b/BUGS index d22417776b..4381c87b5d 100644 --- a/BUGS +++ b/BUGS @@ -1,10 +1,16 @@ -// This file is part of the Doyxgen Developer Manual +// This file is part of the Doxygen Developer Manual /** @page bugs Bug Reporting Please report bugs by subscribing to the OpenOCD mailing list and posting a message with your report: - openocd-development@lists.berlios.de + openocd-devel@lists.sourceforge.net + +Also, please check the Trac bug database to see if a ticket for +the bug has already been opened. You might be asked to open +such a ticket, or to update an existing ticket with more data. + + https://sourceforge.net/apps/trac/openocd/ To minimize work for OpenOCD developers, you should try to include all of the information listed below. If you feel that some of the @@ -22,11 +28,12 @@ that may be important. - If the report is for a regression: - Include logs for both working and broken versions. - Find the precise version that caused the regression by binary search. - You can use "git bisect" to expedite this binary search. + You can use "git bisect" to expedite this binary search: + http://www.kernel.org/pub/software/scm/git/docs/git-bisect.html If possible, please develop and attach a patch that helps to expose or -solve the reported problem. See the PATCHES file for more information -for that process. +solve the reported problem. See the HACKING file for information +about that process. Attach all files directly to your posting. The mailing list knows to transform attachments to links, but attachments must be less than 300KB @@ -35,7 +42,7 @@ in total. @section bugscrashdump Obtaining Crash Backtraces If OpenOCD is crashing, there are two very effective things you can do to -improve your chances of getting help on the development mailing list. +improve your chances of getting help on the development mailing list. Try to reproduce the problem using the dummy JTAG interface to allow other developers to replicate your problem robustly and use GDB to get a trace:@par