Add documentation on how to modify what --debugmsg +relay reports.

This commit is contained in:
Bill Medland 2002-10-19 01:00:04 +00:00 committed by Alexandre Julliard
parent 0dbab63fa6
commit 8417027c1e
2 changed files with 35 additions and 8 deletions

View File

@ -129,7 +129,7 @@
<entry>Direct port access</entry> <entry>Direct port access</entry>
</row> </row>
<row> <row>
<entry>[spy]</entry> <entry>[Debug]</entry>
<entry>no</entry> <entry>no</entry>
<entry>What to do with certain debug messages</entry> <entry>What to do with certain debug messages</entry>
</row> </row>
@ -807,13 +807,16 @@ OPTIONAL:
</para> </para>
</sect3> </sect3>
<sect3> <sect3 id="config-debug-etc">
<title>The [spy], [Registry], [tweak.layout], and [programs] Sections</title> <title>The [Debug], [Registry], [tweak.layout], and [programs] Sections</title>
<para> <para>
[spy] is used to include or exclude debug messages, and to [Debug] is used to include or exclude debug messages, and to
output them to a file. The latter is rarely used. THESE output them to a file. The latter is rarely used. THESE
ARE ALL OPTIONAL AND YOU PROBABLY DON'T NEED TO ADD OR ARE ALL OPTIONAL AND YOU PROBABLY DON'T NEED TO ADD OR
REMOVE ANYTHING IN THIS SECTION TO YOUR CONFIG. REMOVE ANYTHING IN THIS SECTION TO YOUR CONFIG. (In extreme
cases you may want to use these options to manage the amount
of information generated by the <parameter>--debugmsg +relay
</parameter> option.)
</para> </para>
<para> <para>
<programlisting>"File" = "/blanco"</programlisting> <programlisting>"File" = "/blanco"</programlisting>
@ -821,15 +824,35 @@ OPTIONAL:
THIS IS RARELY USED. THIS IS RARELY USED.
</para> </para>
<para> <para>
<programlisting>"Exclude" = "WM_SIZE;WM_TIMER;"</programlisting> <programlisting>"SpyExclude" = "WM_SIZE;WM_TIMER;"</programlisting>
Excludes debug messages about <constant>WM_SIZE</constant> Excludes debug messages about <constant>WM_SIZE</constant>
and <constant>WM_TIMER</constant> in the logfile. and <constant>WM_TIMER</constant> in the logfile.
</para> </para>
<para> <para>
<programlisting>"Include" = "WM_SIZE;WM_TIMER;"</programlisting> <programlisting>"SpyInclude" = "WM_SIZE;WM_TIMER;"</programlisting>
Includes debug messages about <constant>WM_SIZE</constant> Includes debug messages about <constant>WM_SIZE</constant>
and <constant>WM_TIMER</constant> in the logfile. and <constant>WM_TIMER</constant> in the logfile.
</para> </para>
<para>
<programlisting>"RelayInclude" = "user32.CreateWindowA;comctl32.*"</programlisting>
Include only the listed functions in a
<parameter>--debugmsg +relay</parameter> trace. This entry is
ignored if there is a <parameter>RelayExclude</parameter> entry.
</para>
<para>
<programlisting>"RelayExclude" = "RtlEnterCriticalSection;RtlLeaveCriticalSection"</programlisting>
Exclude the listed functions in a
<parameter>--debugmsg +relay</parameter> trace. This entry
overrides any settings in a <parameter>RelayInclude</parameter>
entry. If neither entry is present then the trace includes
everything.
</para>
<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
all functions in the module.
</para>
<para> <para>
[Registry] can be used to tell wine where your old windows [Registry] can be used to tell wine where your old windows
registry files exist. This section is completely optional registry files exist. This section is completely optional

View File

@ -112,7 +112,11 @@ Options:
complex application, your debug logs can easily top 1 MB and complex application, your debug logs can easily top 1 MB and
higher. A <parameter>relay</parameter> trace can often higher. A <parameter>relay</parameter> trace can often
generate more than 10 MB of log messages, depending on how generate more than 10 MB of log messages, depending on how
long you run the application. Logging does slow down Wine long you run the application. (As described in the
<link linkend = "config-debug-etc">Debug</link>
section of configuring wine you can
modify what the <parameter>relay</parameter> trace reports).
Logging does slow down Wine
quite a bit, so don't use <parameter>--debugmsg</parameter> quite a bit, so don't use <parameter>--debugmsg</parameter>
unless you really do want log files. unless you really do want log files.
</para> </para>