documentation/bugreports

   1 How to Report a Bug
   2 -------------------
   3
   4 Some simple advice on making your bug report more useful (and thus more
   5 likely to get answered and fixed):
   6
   7 1) Post as much information as possible.
   8
   9         This means we need more information than,
  10         "MS Word crashes whenever I run it.  Do you know why?"  Include at
  11         least the following information:
  12
  13         - Version of Wine you're using (run 'wine -v')
  14         - Operating system you're using, what distribution (if any), and what
  15                 version.
  16         - Compiler and version (run 'gcc -v')
  17         - Program you're trying to run, its version number, and a URL for
  18                 where the program can be obtained (if available).
  19         - Command line you used to start wine
  20         - Any other information you think may be relevant or helpful.
  21
  22 2) Re-run the program with the -debugmsg +relay option
  23    (i.e., 'wine -debugmsg +relay sol.exe').
  24
  25         If Wine crashes while running your program, it is important that we
  26         have this information to have a chance at figuring out what is causing
  27         the crash.  This can put out quite a lot (several MB) of information,
  28         though, so it's best to output it to a file.  When the Wine-dbg> prompt
  29         appears, type 'quit'.
  30
  31         To accomplish this, use the following commands:
  32
  33         tcsh and other csh-like shells:
  34
  35             wine -debugmsg +relay [other_options] program_name |& tee filename.out
  36         head -100 filename.out > report_file
  37
  38         bash and other sh-like shells:
  39
  40             wine -debugmsg +relay [other_options] program_name 2>&1 | tee filename.out
  41             head -100 filename.out > report_file
  42
  43         'report_file' will now contain the last hundred lines of the debugging
  44         output, including the register dump and backtrace, which are the most
  45         important pieces of information.  Please do not delete this part, even
  46         if you don't understand what it means.
  47
  48 3) Post your report to the newsgroup comp.emulators.ms-windows.wine
  49
  50         In your post, include all of the information from part 1), and insert
  51         the text from the output file in part 2).  If you do this, your chances
  52         of receiving some sort of helpful response should be very good.
  53
  54 4) Questions and comments
  55
  56         If after reading this document there is something you couldn't figure
  57         out, or think could be explained better, or that should have been
  58         included, please post to comp.emulators.ms-windows.wine to let us know
  59         how this document can be improved.