Improve BUGS file wording and layout.

git-svn-id: svn://svn.berlios.de/openocd/trunk@2427 b42882b7-edfa-0310-969c-e2dbd0fdcd60
This commit is contained in:
zwelch 2009-06-30 05:34:44 +00:00
parent 1d61e34e1e
commit 5195405da8
1 changed files with 26 additions and 16 deletions

42
BUGS
View File

@ -5,24 +5,35 @@ posting a message with your report:
openocd-development@lists.berlios.de
To minimize work for OpenOCD developers, you can include
all the information below. If you feel that some of the
items below are unnecessary for a clear bug report, you
leave them out.
To minimize work for OpenOCD developers, you should try to include
all of the information listed below. If you feel that some of the
items below are unnecessary for a clear bug report, you may leave
them out; likewise, feel free to include additional information
that may be important.
- Target PCB/board description
- Config scripts
- Configuration scripts
- OpenOCD command line
- List of commands issued or GDB operations performed
- Expected result
- Actual result
- Logs using @c debug_level 3 (e.g. add '-d 3' to the command line)
- If this is a regression, include logs for working and broken version
- If this is a regression, please find out the precise version that
caused the regression. This can be done via a binary search; For
example: if testing version 550 works but 600 fail, then try 575, etc.
- Logs using <code>debug_level 3</code> (or with '-d 3' on the command line)
- 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.
For example: if testing version 550 works but 600 fail, then try 575, etc.
- If OpenOCD is crashing, you can use GDB to get a trace:@par
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.
Attach all files directly to your posting. The mailing list knows to
transform attachments to links, but attachments must be less than 300KB
in total.
@section bugscrashdump Obtaining Crash Backtraces
If OpenOCD is crashing, you can use GDB to get a trace:@par
@code
% gdb --args openocd ....
(gdb) run
@ -30,8 +41,10 @@ leave them out.
=> here a stack trace is dumped.
@endcode
- To run or debug the in-tree executable (not recommended), you must
use libtool to set up the correct shared library paths:
@section bugsintreedebug Running and Debugging In-Tree
To run or debug the in-tree executable (not recommended), you must
use libtool to set up the correct shared library paths:
@code
libtool gdb --args openocd ....
@endcode
@ -39,9 +52,6 @@ or the more pedantic (and forward-compatible):
@code
libtool --mode=execute gdb --args openocd ....
@endcode
- Attach files directly to the posting. The mailing list knows to
transform attachments to links so you will not be bloating anyones mail
box. Please keep attachments to less than 100KB.
*/
/** @file