diff --git a/documentation/debugger.sgml b/documentation/debugger.sgml
index 637b79ef7c6..687fbb03114 100644
--- a/documentation/debugger.sgml
+++ b/documentation/debugger.sgml
@@ -327,8 +327,8 @@ winedbg "hl.exe -windowed"
Determine the cause of the crash. Since this is usually
a primary/secondary reaction to a failed or misbehaving
- Wine function, rerun Wine with -debugmsg
- +relay added to the commandline. This will
+ Wine function, rerun Wine with theWINEDEBUG=+relay
+ environment variable set. This will
generate quite a lot of output, but usually the reason is
located in the last call(s). Those lines usually look like
this:
@@ -355,9 +355,8 @@ winedbg "hl.exe -windowed"
why it misbehaves. Find the function in the source code.
Try to make sense of the arguments passed. Usually there is
a WINE_DEFAULT_DEBUG_CHANNEL(<channel>);
- at the beginning of the file. Rerun wine with
- -debugmsg +xyz,+relay added to the
- commandline.
+ at the beginning of the file. Rerun wine with the
+ WINEDEBUG=+xyz,+relay environment variable set.
Occasionally there are additional debug channels defined at the
@@ -380,8 +379,8 @@ winedbg "hl.exe -windowed"
If this information isn't clear enough or if you want to
know more about what's happening in the function itself,
- try running wine with -debugmsg
- +all, which dumps ALL included debug
+ try running wine with WINEDEBUG=+all,
+ which dumps ALL included debug
information in wine.
@@ -446,12 +445,12 @@ winedbg "hl.exe -windowed"
the Messagebox you can start winedbg and set a
breakpoint at MessageBoxA (called by win16
and win32 programs) and proceed with
- continue. With --debugmsg
- +all Wine will now stop directly before setting
+ continue. With WINEDEBUG=+all
+ Wine will now stop directly before setting
up the Messagebox. Proceed as explained above.
- You can also run wine using wine -debugmsg +relay
+ You can also run wine using WINEDEBUG=+relay wine
program.exe 2>&1 | less -i and in
less search for MessageBox
.
@@ -548,7 +547,7 @@ call KERNEL.LSTRLEN
| +---------------------------------------------+
-|marcus@jet $ wine winword.exe -debugmsg +relay -debug
+|marcus@jet $ WINEDEBUG=+relay,-debug wine winword.exe
|CallTo32(wndproc=0x40065bc0,hwnd=000001ac,msg=00000081,wp=00000000,lp=00000000)
|Win16 task 'winword': Breakpoint 1 at 0x01d7:0x001a
|CallTo16(func=0127:0070,ds=0927)
@@ -647,7 +646,7 @@ Wine-dbg>
use the Wine debugger normally, but Wine already executes the program's
start code, then you may use a special trick. You should do a
-wine --debugmsg +relay program
+WINEDEBUG=+relay wine program
to get a listing of the functions the program calls in its start function.
Now you do a
@@ -672,7 +671,7 @@ winedbg winfile.exe
functions executed before MessageBox().
That's why you should re-run the program with e.g.
-wine --debugmsg +relay <program name> &>relmsg
+WINEDEBUG=+relay wine <program name> &>relmsg
Then do a more relmsg and search for the
last occurrence of a call to the string "MESSAGEBOX". This is a line like
@@ -999,7 +998,7 @@ wine -debug myprog.exe
[MACHINE\\Software\\Microsoft\\Windows NT\\CurrentVersion\\AeDebug] 957636538
"Auto"=dword:00000001
-"Debugger"="winedbg --debugmsg -all %ld %ld"
+"Debugger"="winedbg %ld %ld"