How To Report Issues

Version 7 (Dan Smith, 12/14/2011 09:14 am)

1 1 Dan Smith
h1. How To Report Issues
2 1 Dan Smith
3 7 Dan Smith
h2. First things first!
4 1 Dan Smith
5 7 Dan Smith
Before you file a bug, please test the latest Development Version of CHIRP to see if your issue has been fixed. These builds are generated automatically every night when there is a change, and they are available from the bottom of the "download page":/projects/chirp/wiki/download.
6 7 Dan Smith
7 2 Dan Smith
h2. Effective Bug Reporting
8 2 Dan Smith
9 1 Dan Smith
Effective reporting of a bug or feature is critical to getting the issue resolved in a timely manner. If bug descriptions are difficult to understand or reproduce, they are less likely to receive attention. When you are crafting your bug report, try to answer the following questions:
10 1 Dan Smith
11 1 Dan Smith
1. What is the behavior you are seeing?
12 1 Dan Smith
2. What is the behavior you were expecting?
13 1 Dan Smith
3. Can you reproduce the problem all the time?
14 1 Dan Smith
4. What are the steps required to reproduce the problem?
15 1 Dan Smith
5. Is this specific to a certain radio model (driver) or something that you can reproduce with another radio?
16 1 Dan Smith
17 1 Dan Smith
In most cases, it is important to attach an image of your radio to the bug so that a developer can look at the exact state and determine what the problem is. It is often helpful describe what you expect to see in a given memory location, as well as what you actually see.
18 5 Dan Smith
19 5 Dan Smith
h2. Getting your debug log
20 5 Dan Smith
21 5 Dan Smith
If you are expecting something to happen (such as importing from a file, or setting a memory) and CHIRP appears to ignore the request, you probably should include your debug log. If you are getting an error message, you should definitely include the log. Here are some tips for getting to it:
22 5 Dan Smith
23 5 Dan Smith
h3. Windows
24 5 Dan Smith
25 6 Dan Smith
Your debug log should be in C:\Program Files\CHIRP\debug.log
26 6 Dan Smith
27 6 Dan Smith
h3. Linux and MacOS
28 6 Dan Smith
29 1 Dan Smith
Your debug log should be in your home directory, in .chirp/debug.log
30 7 Dan Smith
31 7 Dan Smith
h2. Filing your report
32 7 Dan Smith
33 7 Dan Smith
In order to file a new bug report or feature request, you must first create (or sign into) an account. Click the "Register": or "Sign in": link at the top right of this page to do that. Once you are logged in, click the "New issue": link on the menu bar above to get started.