home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 8 Other / 08-Other.zip / odin0813.zip / ReportingBugs.txt < prev    next >
Text File  |  2002-01-08  |  5KB  |  135 lines
  1. This file is a subset of the OdinBug online help file.
  2.  
  3.  
  4. Reporting Bugs:
  5. ===============
  6.  
  7. To make our job easier when dealing with reports of failures to run certain
  8. applications, there's a standard form to report bugs. 
  9. Use OdinBug to create these bug reports.
  10.  
  11. Some remarks:
  12.  
  13. - Always try the debug build with the application unless only the release
  14.   build shows the problem.
  15. - Make sure you have installed Odin properly (using WarpIN). If you installed
  16.   using a ZIP file, do not forget to run OdinInst.EXE after unpacking the ZIP
  17.   file! 
  18. - PE.EXE is the recommended way to run Windows applications; remove Win32K.SYS
  19.   from your CONFIG.SYS
  20. - Use a recent daily build. Bug reports with ancient (> 1 week old) builds are
  21.   not very useful. The problem you report might no longer be present!
  22. - Always send these bug reports to the odinusers mailing list; not directly to
  23.   the developers (so others can respond if the problem is old or already
  24.   fixed).
  25. - Currently the only valid mailing list address is odinusers@yahoogroups.com.
  26.   In order to send a bug report you have to be subscribed to this mailing
  27.   list. 
  28. - Go to http://groups.yahoo.com/groups/odinusers/join in order to subscribe
  29.   (or use the URL object that OdinBug has created in your Odin folder.)
  30.  
  31. Sometimes the small part of the logfile isn't enough for us to determine where
  32. the problem lies.
  33.  
  34. In that case, we'll ask you to mail us the entire file (ZIPped).
  35. So please do not send big logfiles to the mailing list!
  36.  
  37.  
  38. Generating useful logfiles:
  39. ===========================
  40.  
  41. Only those builds, that have "debug" in their name can generate logfiles in
  42. order to show what a win32 application is doing, while it is running. The
  43. logfile is inevitable to determine why certain applications don't run
  44. correctly.
  45.  
  46. The logfile is the main source of bug information for OdinBug.
  47.  
  48. The name of the logfile follows a naming scheme:
  49.  
  50.          odin32_?.log, where ? is 0, 1, 2 etc.
  51.  
  52. The major disadvantage of logging is the overhead. Therefore it has been
  53. disabled by default in all the "debug" builds.
  54.  
  55. You only get logfiles if you use a debug build and have 
  56.  
  57.          SET WIN32LOG_ENABLED=1
  58.  
  59. properly set. This turns on logging for all debug dlls.
  60.  
  61. However, this can result in huge logfiles. To reduce the size, use release
  62. builds of dlls that are not relevant to the problem you're seeing. The general
  63. rule is that usually only the logging information generated by GDI32, KERNEL32
  64. and USER32 is important.
  65.  
  66. Use the release build of GDI32 if the problem you're seeing isn't related to
  67. painting. (GDI32 generates a lot of logging information)
  68.  
  69. To disable logging again, you must clear this variable:
  70.  
  71.          SET WIN32LOG_ENABLED=
  72.  
  73.  
  74. Useful tips:
  75. ============
  76.  
  77. Crashes are always easy to locate in logfiles (search for 'Exception
  78. Information'), but improper behaviour isn't.
  79.  
  80. In the system menu (top left button of a window), there's a menu item called
  81. 'Put mark in debug log'. Selecting this item puts the line 'Mark requested by
  82. user' in the log. 
  83.  
  84. This can be useful e.g. if a window is resized improperly after you click
  85. on a button. To make it easy for us to locate the right log lines, you
  86. should select the 'Put mark in debug log' menu item and then click on the
  87. button that causes the problem.
  88.  
  89.  
  90. Standard form of a bug report:
  91. ==============================
  92.  
  93. --------------------- Begin of Odin Bug Report ----------------------
  94.   
  95. Odin build information:
  96.   
  97.   Current Odin build:     (odin32bin-2001????-debug.wpi or .zip)
  98.   Installation method:    (WarpIN or manually)
  99.   Launching method:       (Win32K.SYS or PE.EXE)
  100.   Last WarpIN install:    (date/time)
  101.   Last OdinInst install:  (date/time)
  102.   Odin "Windows" dir:     (search for "Windows  dir" in logfile!)
  103.   Odin "System32" dir:    (search for "System32 dir" in logfile!)
  104.   Evaluated Odin.INI:     (located in System32 directory)
  105.   
  106. General system information:
  107.   
  108.   OS/2 version:           (Warp 4, 4.5, Warp 3 not officially supported)
  109.   OS/2 reports version:   (2.4, 2.45) kernel revision: (14.0xx)
  110.   FixPack Level:          (15)
  111.   Is xf86sup.sys loaded?  Yes/No
  112.   Display driver:         (Scitech/Matrox/gradd)
  113.   Video Chipset:          (Matrox/Nvidia TNT/Geforec/ATI Rage Pro)
  114.   
  115. Win32 program information:
  116.   
  117.   Odin logfile:           (odin32_?.log found in the application's dir)
  118.   Windows executable:     (commandline of the program)
  119.   Application name:       (name)
  120.   Application version:    (version)
  121.   Available from:         (URL if available)
  122.   
  123. Verbal problem description:
  124.  
  125. (what happened, in your own words, be as accurate as possible)
  126.  
  127. Exception information and stack dump:
  128.  
  129. (search for "[Exception" in the logfile!)
  130.  
  131. ODIN.INI information:
  132.  
  133. (located in x:\Odin\System32 directory)
  134. ---------------------- End of Odin Bug Report -----------------------
  135.