|
From: Mark W. <ma...@so...> - 2020-05-13 16:06:34
|
https://sourceware.org/git/gitweb.cgi?p=valgrind.git;h=014bcea452ec8dc7a547f5a7307482eac1db458d commit 014bcea452ec8dc7a547f5a7307482eac1db458d Author: Mark Wielaard <ma...@kl...> Date: Wed May 13 15:37:13 2020 +0200 manual-core.xml: Fix various xmllint issues. Wrap bare CDATA text in a para and make sure that all listitems contain paras. Diff: --- docs/xml/manual-core.xml | 50 ++++++++++++++++++++++++------------------------ 1 file changed, 25 insertions(+), 25 deletions(-) diff --git a/docs/xml/manual-core.xml b/docs/xml/manual-core.xml index 50904ff82a..b36009ed90 100644 --- a/docs/xml/manual-core.xml +++ b/docs/xml/manual-core.xml @@ -578,13 +578,13 @@ lines in a suppression.</para> fun:main } ]]></programlisting> -This suppresses Memcheck memory-leak errors, in the case where +<para>This suppresses Memcheck memory-leak errors, in the case where the allocation was done by <computeroutput>main</computeroutput> calling (though any number of intermediaries, including zero) <computeroutput>ccc</computeroutput>, calling onwards via <computeroutput>ddd</computeroutput> and eventually -to <computeroutput>malloc.</computeroutput>. +to <computeroutput>malloc.</computeroutput>.</para> </sect1> @@ -2646,35 +2646,35 @@ PROGRESS: U 130s, W 134s, 97.0% CPU, EvC 574.90M, TIn 657.5k, TOut 3.0k, #thr 63 ]]></programlisting> Each line shows: <itemizedlist> - <listitem><varname>U</varname>: total user time</listitem> - <listitem><varname>W</varname>: total wallclock time</listitem> - <listitem><varname>CPU</varname>: overall average cpu use</listitem> - <listitem><varname>EvC</varname>: number of event checks. An event + <listitem><para><varname>U</varname>: total user time</para></listitem> + <listitem><para><varname>W</varname>: total wallclock time</para></listitem> + <listitem><para><varname>CPU</varname>: overall average cpu use</para></listitem> + <listitem><para><varname>EvC</varname>: number of event checks. An event check is a backwards branch in the simulated program, so this is a - measure of forward progress of the program</listitem> - <listitem><varname>TIn</varname>: number of code blocks instrumented - by the JIT</listitem> - <listitem><varname>TOut</varname>: number of instrumented code - blocks that have been thrown away</listitem> - <listitem><varname>#thr</varname>: number of threads in the - program</listitem> + measure of forward progress of the program</para></listitem> + <listitem><para><varname>TIn</varname>: number of code blocks instrumented + by the JIT</para></listitem> + <listitem><para><varname>TOut</varname>: number of instrumented code + blocks that have been thrown away</para></listitem> + <listitem><para><varname>#thr</varname>: number of threads in the + program</para></listitem> </itemizedlist> From the progress of these, it is possible to observe: <itemizedlist> - <listitem>when the program is compute bound (<varname>TIn</varname> - rises slowly, <varname>EvC</varname> rises rapidly)</listitem> - <listitem>when the program is in a spinloop + <listitem><para>when the program is compute bound (<varname>TIn</varname> + rises slowly, <varname>EvC</varname> rises rapidly)</para></listitem> + <listitem><para>when the program is in a spinloop (<varname>TIn</varname>/<varname>TOut</varname> - fixed, <varname>EvC</varname> rises rapidly)</listitem> - <listitem>when the program is JIT-bound (<varname>TIn</varname> - rises rapidly)</listitem> - <listitem>when the program is rapidly discarding code - (<varname>TOut</varname> rises rapidly)</listitem> - <listitem>when the program is about to achieve some expected state + fixed, <varname>EvC</varname> rises rapidly)</para></listitem> + <listitem><para>when the program is JIT-bound (<varname>TIn</varname> + rises rapidly)</para></listitem> + <listitem><para>when the program is rapidly discarding code + (<varname>TOut</varname> rises rapidly)</para></listitem> + <listitem><para>when the program is about to achieve some expected state (<varname>EvC</varname> arrives at some value you - expect)</listitem> - <listitem> when the program is idling (<varname>U</varname> rises - more slowly than <varname>W</varname>)</listitem> + expect)</para></listitem> + <listitem><para> when the program is idling (<varname>U</varname> rises + more slowly than <varname>W</varname>)</para></listitem> </itemizedlist> </para> </listitem> |