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