X-Git-Url: https://review.openocd.org/gitweb?p=openocd.git;a=blobdiff_plain;f=BUGS;h=4381c87b5d093071bc030f369ce6c99afa877034;hp=0cb99ae63de3721d119541d9d7aade9b5525b11c;hb=0ce2ca748b502d09acf878c338fe23776cf6d8e2;hpb=099e5b69201608b5f52a3e527c180aedb45db905 diff --git a/BUGS b/BUGS index 0cb99ae63d..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,12 +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 @@ -36,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