2011-03-08.

Extra messages from the m$-api/syscall emulator Wine.
http://wiki.winehq.org/DebugChannels

Occasionally useful as a check of what an m$dinwos program
is going to do to someone else's computer, before recommending
it.


WINEDEBUG=[class][+/-]channel[,[class2][+/-]channel2]

Special "channels"
	all -- logs everything 
	heap -- logs heap functions and turns on extra checks 
	message -- logs Windows messages 
	msgbox -- logs the display of message boxes 
	relay -- logs every function call in Wine builtin DLLs 
	seh -- logs Windows exceptions (Structured Exception Handling) 
	snoop -- logs every function call in native DLLs (may break them) 
	synchronous -- force X11 into synchronous mode 
	tid -- prepends each log message with the ID of the thread it came from 
The whole lost of channels is a huge list, e.g. dmusic, psdrv, ntdll, avifile, ...

Examples:

WINEDEBUG=warn+all 
	will turn on all warning messages. 

WINEDEBUG=warn+dll,+heap 
	will turn on DLL warning messages and all heap messages. 

WINEDEBUG=fixme-all,warn+cursor,+relay 
	will turn off all FIXME messages, turn on cursor warning 
	messages, and turn on all relay messages (API calls). 

WINEDEBUG=+relay 
	will turn on all relay messages. 
	For more control on including or excluding functions and dlls 
	from the relay trace look into the [HKCU\Software\Wine\Debug] 
	registry key (See UsefulRegistryKeys and example below).