Changes between Version 11 and Version 12 of BugReporting

Timestamp:

06/29/10 07:59:02 (3 years ago)

Author:

gbooker

Comment:

--

BugReporting

@@ -2 +2 @@
  1. [http://appletv.nanopi.net/trac/search Search] for an existing tickets.  If you find one that matches your report, comment there (if you have something to add)
  1. State whether you are on on AppleTV or Leopard
- 1. Examine the last part of the console.  On the AppleTV, you can execute {{{tail /Library/Logs/Console/501/console.log}}}.  On Leopard, open {{{/Applications/Utilities/Console.app}}}.  This is important even if it crashed, because it may have thrown an exception earlier in the code which caused the crash.  If the console is empty, state that fact.
+ 1. Examine the last part of the console.  On the AppleTV, you can execute {{{tail /Library/Logs/Console/501/console.log}}}.  On Leopard, open {{{/Applications/Utilities/Console.app}}}.  This is important even if it crashed, because it may have thrown an exception earlier in the code which caused the crash.  If the console is empty, state that fact (this is a means to check if you read this document).
    a. Often the AppleTV will not log.  Check the timestamps next to the most recent log entry.  If it is not recent, try restarting Finder as stated above.
    a. Note: If the console mentions something similar to [[BR]] {{{Exception: NSInvalidArgumentException *** +[SapphireFrontRowCompat ...]: selector not recognized}}} [[BR]] the likely culprit is a version of ATVFiles which is too old.  This is due to the fact that both ATVFiles and Sapphire share some code, and Sapphire's is newer.  Either upgrade ATVFiles, or if a newer version of ATVFiles isn't available, trash it, and this should resolve the issue.
- 1. If the console says that a crash log was written, examine that file.  The console tells you the location of this file.
-   a. If this file says that that it crashed due to an uncaught exception, there is no reason to post it, although there are few lines which would be useful to post.  They are lines which state where in memory Sapphire and its components are located.  Search the crash log for lines like the following (You may not have all lines, and they may look different.  Also, I have removed data from these lines which is not necessary for debugging):
+ 1. Follow the steps appropriate to your situation:
+   * Crashes or frozen interface:
+     1. If the console says that a crash log was written, examine that file.  The console tells you the location of this file.
+       a. If this file says that that it crashed due to an uncaught exception, there is no reason to post it, although there are few lines which would be useful to post.  They are lines which state where in memory Sapphire and its components are located.  Search the crash log for lines like the following (You may not have all lines, and they may look different.  Also, I have removed data from these lines which is not necessary for debugging):
 {{{
  0x14cf000 -  0x14d2fff  com.apple.frontrow.appliance.Sapphire.CompatClasses ??? (1.0)
@@ -12 +14 @@
 0x14ba2000 - 0x14ba2ff8  com.apple.frontrow.appliance.Sapphire.LeopardOnly ??? (1.0)
 }}}
- 1. If you are experiencing a frozen user interface (nothing happens no matter what buttons you press), execute {{{sudo sample Finder 5}}} (password is frontrow) or {{{sample "Front Row" 5}}} if you are on Leopard.  It will give you a filename containing the analysis.  Include the contents of that file.
- 1. Prune the information.
-   a. Console log information need only have data about exceptions, errors, and the like that came from Front Row (Finder on the AppleTV).
-   a. Crash logs need only the last log, from the last set of ***** to the end.
+     1. If you are experiencing a frozen user interface (nothing happens no matter what buttons you press), execute {{{sudo sample Finder 5}}} (password is frontrow) or {{{sample "Front Row" 5}}} if you are on Leopard.  It will give you a filename containing the analysis.  Include the contents of that file.
+     1. Prune the information.
+       a. Console log information need only have data about exceptions, errors, and the like that came from Front Row (Finder on the AppleTV).
+       a. Crash logs need only the last log, from the last set of ***** to the end.
+   * Failed importing:
+     1. Include the exact file name of the file which is failing.
+     1. If this is a TV show, state whether this is part of a series to which other files have been successfully imported
+     1. Include whether you were asked for information, and if possible which selections you made.
+     1. If any XML files are used for this file, include it.
  1. Post the above information here.
    a. Upload the file to a trac ticket (a new one if yours is not a duplicate, with the existing one if you found a ticket just like yours).  If you upload a file, please use plain text files.