home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / _catalogue / _arcweb / publichtml / bugreports < prev    next >
Text File  |  1996-11-29  |  3KB  |  51 lines
  1. <title>Reporting Bugs</title>
  2. <h1>Bug reporting</h1>
  3.  
  4. Please try to give as much information as possible about what might have
  5. caused the problem.  It may seem obvious, but if you have trouble with a
  6. particular site or particular page, then <em>please</em> include the URL
  7. with your report, because I can then visit the page myself and see if it
  8. fails for me too, and if so whether it fails the same way, and why.
  9.  
  10. If you suffer messages such as "ArcWeb .... must exit immediately", then
  11. you should create a small RAM disc (64K is plenty), and issue the following
  12. command at the F12 prompt or in the <em>New Task</em> submenu on the Task Manager's menu:
  13.  
  14. <dl><dd><tt>*Set DumpRegisters 1</tt></dl>
  15. When reporting bugs, please follow the instructions in the RAM:$.WebRegs file.
  16. This file contains information about what was going on at the time when the
  17. problem occurred, plus a few details about your system.  If you object to
  18. any particular information (such as total machine RAM) being included, then
  19. remove it, bearing in mind that it may be part of the problem (and it may not).
  20. The information logged is currently:<ul>
  21. <li>What error condition occurred
  22. <li>The contents of the RISC OS exception dump area (as you would see if you
  23.     had typed <tt>*ShowRegs</tt> at the CLI prompt.
  24. <li>The register save area maintained by the Shared C Library, not normally
  25.     available, and hacked with great hackery from the data area inside the
  26.     image, as this is far more useful for finding programming errors than
  27.     the RISC OS save register area.
  28. <li>A stack backtrace - an audit trail of which function was calling which
  29.     other function which was etc. so I can see how the address which caused
  30.     the problem was reached.
  31. <li>Your OS version
  32. <li>Your primary processor type (normal ARM or StrongARM)
  33. <li>Your total RAM size
  34. <li>The slot size ArcWeb had when the fault occurred
  35. <li>The amount of memory free at the time the fault occurred
  36. <li>The amount of free disc space on the drive hosting the cache
  37. <li>ArcWeb's build date, build time and build version
  38. <li>A nice message giving instructions about where to mail the file
  39. </ul>
  40.  
  41. <p>
  42. The more information that can be provided, the greater the chance that I can
  43. fix it quickly and issue a new version that corrects it for everyone else.
  44.  
  45. <p>Please note that I cannot guarantee that I will e-mail you back to tell you
  46. that the problem is identified and/or fixed.  I'm afraid I don't have enough
  47. time - and besides, you'd rather I spent what free time I do have fixing bugs
  48. and doing other enhancements, wouldn't you?
  49.  
  50. <hr>
  51. <address><a href="mailto:S.N.Brodie@ecs.soton.ac.uk">S.N.Brodie</a></address>