| [6553] | 1 | Odin Bug Report Tool Version 0.3.0
|
|---|
| 2 | ==================================
|
|---|
| [6516] | 3 |
|
|---|
| 4 | 0. DISCLAIMER
|
|---|
| 5 |
|
|---|
| [6553] | 6 | OdinBug is free, but copyrighted software. It is not guaranteed
|
|---|
| 7 | to fulfill any particular purpose. Use it at your own risk. It may
|
|---|
| 8 | be included with every application that comes with Odin files
|
|---|
| [6516] | 9 |
|
|---|
| 10 | 1. INTRODUCTION
|
|---|
| 11 |
|
|---|
| 12 | This little program makes creating proper bug reports for Team Odin
|
|---|
| 13 | quite comfortable. As it is in a rather early stage, please do not
|
|---|
| 14 | expect it to be bug free or feature complete!
|
|---|
| 15 |
|
|---|
| 16 | I don't want to know how often Sander Van Leeuwen and other Team Odin
|
|---|
| 17 | members have written emails, telling us users to bring in proper bug
|
|---|
| 18 | reports (I don't exclude myself).
|
|---|
| 19 |
|
|---|
| 20 | Well, I would like Sander and all the others to spend there time on
|
|---|
| 21 | Odin and not writing emails about things that should be a non-issue.
|
|---|
| 22 |
|
|---|
| 23 | 2. WHAT IT DOES
|
|---|
| 24 |
|
|---|
| 25 | This program presents a form to fill in the information needed by
|
|---|
| 26 | Team Odin and generates a report that follows the standards presented
|
|---|
| 27 | in ReportingBugs.TXT which is part of every Odin build.
|
|---|
| 28 |
|
|---|
| [6553] | 29 | Some of the information is gathered from CONFIG.SYS, SYSLEVEL files,
|
|---|
| 30 | the WarpIN database, from ODIN.INI and also from the odin32_?.log files.
|
|---|
| 31 | And some information has to be filled in manually (only the minor part).
|
|---|
| [6516] | 32 |
|
|---|
| 33 | It also scans the odin_?.log file to find the exception information and
|
|---|
| 34 | the stack dump in case an application traps. The aware that these logfiles
|
|---|
| 35 | can become quite large and that it might take a while until processing is
|
|---|
| 36 | complete.
|
|---|
| 37 |
|
|---|
| 38 | 3. USAGE
|
|---|
| 39 |
|
|---|
| 40 | As OdinBug.EXE is written in VX-REXX it needs the VROBJ.DLL runtime.
|
|---|
| 41 |
|
|---|
| [6553] | 42 | VROBJ.DLL can be found in the directory x:\IMAGES (x=CD-ROM drive) of
|
|---|
| 43 | your original Warp 4 CD-ROM and has to be copied into into d:\OS2\DLL
|
|---|
| 44 | (d=bootdrive), or somewhere else in your LIBPATH.
|
|---|
| [6516] | 45 |
|
|---|
| [6553] | 46 | There is also a VROBJ.WPI package at the following location:
|
|---|
| 47 |
|
|---|
| 48 | http://groups.yahoo.com/group/odinusers/files/vrobj.wpi
|
|---|
| 49 |
|
|---|
| 50 | This package can be installed the usual way using WarpIN.
|
|---|
| 51 |
|
|---|
| [6516] | 52 | Put OdinBug.EXE in a directory in your path.
|
|---|
| 53 |
|
|---|
| 54 | Put OdinBug.CFG into the same directory within your path. If you are not
|
|---|
| 55 | familiar with REXX code, you can also delete OdinBug.CFG, the program
|
|---|
| 56 | itself has reasonable default values.
|
|---|
| 57 |
|
|---|
| [6553] | 58 | Call it after you experienced a trap in a Win32 program and after you
|
|---|
| 59 | have created a log file.
|
|---|
| [6516] | 60 |
|
|---|
| 61 | Every field can be changed manually, but using the "Search"-buttons should
|
|---|
| 62 | be the preferred method.
|
|---|
| 63 |
|
|---|
| [6553] | 64 | When everything is complete press "Create report" button. The program
|
|---|
| 65 | checks for empty fields, and if everything is filled out creates a report.
|
|---|
| [6516] | 66 |
|
|---|
| [6553] | 67 | Pressing "EMail report" starts Netscape Messenger (or any other email
|
|---|
| 68 | program; see OdinBug.CFG) with the appropriate email address and copies
|
|---|
| 69 | the newly created report into the clipboard, so it can be pasted into
|
|---|
| 70 | the email.
|
|---|
| [6516] | 71 |
|
|---|
| 72 | 4. BUG REPORTS AND FEATURE REQUEST FOR THIS PROGRAM
|
|---|
| 73 |
|
|---|
| [6553] | 74 | Just email me and tell me what you think or what you want!
|
|---|
| 75 | I will try to realize it.
|
|---|
| [6516] | 76 |
|
|---|
| 77 | 5. AUTHOR:
|
|---|
| 78 |
|
|---|
| 79 | Herwig Bauernfeind, 10.08.2001
|
|---|
| 80 | EMail: herwig.bauernfeind@aon.at
|
|---|
