From 1bc4c49df704da440d87f9b2d9a753b2a64e5297 Mon Sep 17 00:00:00 2001
From: Adam the Jazz Guy <magicbox@bestweb.net>
Date: Thu, 25 Feb 1999 17:33:29 +0000
Subject: [PATCH] Added "The Easy Way" and "The Hard Way", largely favoring the
 easy way, which uses my bug_report.pl script. Added info on a command that
 can be run on all shells to print debug msgs to a file and not to xterm.

---
 documentation/bugreports | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/documentation/bugreports b/documentation/bugreports
index df849d4c166..ba2dd0cea6a 100644
--- a/documentation/bugreports
+++ b/documentation/bugreports
@@ -1,6 +1,32 @@
 How To Report A Bug
 -------------------
 
+There are two ways for you to make a bug report. One uses a simple perl
+script, and is recommended if you don't want to spend a lot of time
+producing the report. It is designed for use by just about anyone, from
+the newest of newbies to advanced developers. You can also make a bug
+report the hard way -- advanced developers will probably prefer this.
+
+A. The Easy Way
+1) Your computer *must* have perl on it for this method to work. To
+find out if you have perl, run:
+which perl
+If it returns something like "/usr/bin/perl", you're in business.
+Otherwise, skip on down to "The Hard Way". 
+If you aren't sure, just keep on going. When you try to run the script, it
+will become *very* apparent if you don't have perl.
+
+2) Change directory to <dirs to wine>/tools
+
+3) Type in "./bug_report.pl" and follow the directions.
+
+4) Post a message to the comp.emulators.ms-windows.wine newsgroup with the
+"Nice Formatted Report" attatched. If possible, upload the full debug
+output to a web/ftp server and provide the address in your message.
+
+
+B. The Hard Way:
+
 Some simple advice on making your bug report more useful (and thus more
 likely to get answered and fixed):
 
@@ -32,6 +58,12 @@ likely to get answered and fixed):
 
 	To accomplish this, use the following commands:
 
+	all shells:
+	    echo quit|wine -debugmsg +relay,+snoop [other_options] program_name >& filename.out; tail -n 100 filename.out > report_file
+	(This will print wine's debug msgs only to the file and then
+	auto-quit. It's probably a good idea to use this command, since wine
+	prints out so many debug msgs that they flood the terminal, eating CPU.)
+	
 	tcsh and other csh-like shells:
 
 	    wine -debugmsg +relay,+snoop [other_options] program_name |& tee filename.out
-- 
GitLab