Creating a good bug report

When reporting a bug or problem, it's good give as much information as possible to get the issue addressed. Some things to always mention:

1. Which ComicTagger version?
   
2. Which OS and version?
   
3. CLI or GUI?
   
4. Binary or source package?

If you can reproduce the problem, information about the file or data that causes the problem are important. The file name, or maybe the series or other tag text might be relevant.

If you're using the CLI, please paste in the exact text of the command that you're entering. Cut and paste any interesting output.

If using the GUI, be sure to mention the settings of the "Style" controls in the upper left. Also, what steps did you take? (i.e. what did you enter, which buttons/menu choices, which dialogs?)

If the app has locked up or seems stuck, console output that shows a crash log might help. The windows binary version should have a console window you can can copy from. On Mac, you may have to bring up Console.app, and search for "ComicTagger"

Thanks!

If you are encountering a "freezing" or "locking up" bug on a Mac, you may need to use the OS X "Console" app (under /Applications/Utilities) to retrieve some data for a bug report.

1. Open the Console application
   
2. Click "Show Log List"
   
3. Select "system.log" under "FILES"
   
4. Type in "ComicTagger" in the search bar in the upper right
   
5. Scroll through the list to find the time you think the error occured
   
6. Copy the text

You want to look for something like this:

Code:

Traceback (most recent call last):
  File "/home/tony/Dropbox/tagger/comictagger/taggerwindow.py", line 1699, in autoTag
    success, match_results = self.identifyAndTagSingleArchive( ca, match_results, atstartdlg )
  File "/home/tony/Dropbox/tagger/comictagger/taggerwindow.py", line 1564, in identifyAndTagSingleArchive
    ii = IssueIdentifier( ca, self.settings )
  File "/home/tony/Dropbox/tagger/comictagger/issueidentifier.py", line 77, in __init__
    foo
NameError: global name 'foo' is not defined