Documentation cleanup for Relay|Snoop-Include|Exclude
Uwe Bonnes
bon at elektron.ikp.physik.tu-darmstadt.de
Tue Dec 17 13:56:24 CST 2002
Changelog:
wine/documentation/configuring.sgml
wine/documentation/wine.man.in
wine/documentation/wine.conf.man
Purge traces of the old mechanisme and document new mechanisme
better.
--
Uwe Bonnes bon at elektron.ikp.physik.tu-darmstadt.de
Institut fuer Kernphysik Schlossgartenstrasse 9 64289 Darmstadt
--------- Tel. 06151 162516 -------- Fax. 06151 164321 ----------
Index: wine/documentation/configuring.sgml
===================================================================
RCS file: /home/wine/wine/documentation/configuring.sgml,v
retrieving revision 1.20
diff -u -w -r1.20 configuring.sgml
--- wine/documentation/configuring.sgml 16 Dec 2002 22:09:55 -0000 1.20
+++ wine/documentation/configuring.sgml 17 Dec 2002 19:53:13 -0000
@@ -852,7 +852,7 @@
<para>
In both entries the functions may be specified either as a
function name or as a module and function. In this latter
- case specify an asterisk for the function name to include
+ case specify an asterisk for the function name to include/exclude
all functions in the module.
</para>
<para>
Index: wine/documentation/wine.man.in
===================================================================
RCS file: /home/wine/wine/documentation/wine.man.in,v
retrieving revision 1.43
diff -u -w -r1.43 wine.man.in
--- wine/documentation/wine.man.in 29 Oct 2002 23:13:01 -0000 1.43
+++ wine/documentation/wine.man.in 17 Dec 2002 19:53:13 -0000
@@ -43,7 +43,7 @@
man page to know what Wine requires and how it is installed from source.
.SH OPTIONS
.TP
-.I --debugmsg [xxx]#name[,[xxx1]#name1][,<+|->relay=yyy1[:yyy2]]
+.I --debugmsg [xxx]#name[,[xxx1]#name1]
Turn debugging messages on or off.
.RS +7
.PP
@@ -75,14 +75,9 @@
will turn off all FIXME messages, turn on cursor warning messages, and turn
on all relay messages (API calls).
.br
-.I --debugmsg -relay=rtlleavecriticalsection:RtlEnterCriticalSection
-will turn on all relay messages except for RtlLeaveCriticalSection and
-RtlEnterCriticalSection.
-.br
-.I --debugmsg +relay=advapi32
-will only turn on relay messages into the ADVAPI32 code.
-Never ever use simply --debugmsg +all ! Way too much info, and it crashes
-way too easily, thus confusing unexperienced users.
+.I --debugmsg -relay
+will turn on all relay messages. For more control on including or excluding
+functions and dlls look into the [Debug] section of the wine configuration file.
.PP
The full list of names is:
all, accel, advapi, animate, aspi, atom, avifile, bitblt, bitmap, caret,
Index: wine/documentation/wine.conf.man
===================================================================
RCS file: /home/wine/wine/documentation/wine.conf.man,v
retrieving revision 1.7
diff -u -w -r1.7 wine.conf.man
--- wine/documentation/wine.conf.man 15 Nov 2002 01:01:48 -0000 1.7
+++ wine/documentation/wine.conf.man 17 Dec 2002 19:53:13 -0000
@@ -260,18 +260,46 @@
.br
Used to specify the devices which are used as LPT1 - LPT8.
.PP
-.B [spy]
+.B [Debug]
.br
-.I format: """exclude""=""<message names separated by semicolons>"""
+.I format: """SpyExclude""=""<message names separated by semicolons>"""
.br
default: none
.br
Used to specify which messages will be excluded from the logfile.
.PP
-.I format: """include""=""<message names separated by semicolons>"""
+.I format: """SpyInclude""=""<message names separated by semicolons>"""
.br
default: none
.br Used to specify which messages will be included in the logfile.
+.PP
+.I format: """RelayExclude""=""<function or dll.functions separated by semicolons>"""
+.br
+default: none
+.br
+Used to specify which function will be excluded from a relay debuglog.
+.PP
+.I format: """RelayInclude""=""<message names separated by semicolons>"""
+.br
+default: none
+.br
+Used to specify which function will be included in relay debuglog.
+.PP
+.I format: """SnoopExclude""=""<message names separated by semicolons>"""
+.br
+default: none
+.br
+Used to specify which function will be included in snoop debuglog.
+.PP
+.I format: """SnoopInclude""=""<message names separated by semicolons>"""
+.br
+default: none
+.br
+Used to specify which function will be included in snoop debuglog.
+.PP
+For Relay and Snoop <dllname>.* includes or excludes the whole dll. Exclude
+entries overwrite Include Entries.
+.br
.PP
.B [Tweak.Layout]
.br
More information about the wine-patches
mailing list