From 014bcea452ec8dc7a547f5a7307482eac1db458d Mon Sep 17 00:00:00 2001
From: Mark Wielaard <mark@klomp.org>
Date: Wed, 13 May 2020 15:37:13 +0200
Subject: [PATCH] manual-core.xml: Fix various xmllint issues.

Wrap bare CDATA text in a para and make sure that all listitems contain
paras.
---
 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>
-- 
2.47.2