From c0f0523761fcae35c844e372b087e63dec319fa7 Mon Sep 17 00:00:00 2001
From: Thomas Schraitle <toms@suse.de>
Date: Thu, 5 May 2022 14:06:44 +0200
Subject: [PATCH] Simplified table

* Get rid of <textdata>
* Get rid of <para>s inside <entry>; they just
  make alignment difficult
* Add explanation of the graphics
* Add align="center" for every <entry>
---
 xml/containers-support.xml | 318 +++++++++++++++++--------------------
 1 file changed, 144 insertions(+), 174 deletions(-)

diff --git a/xml/containers-support.xml b/xml/containers-support.xml
index d998a57ecc..5b23e10c59 100644
--- a/xml/containers-support.xml
+++ b/xml/containers-support.xml
@@ -38,6 +38,7 @@
    
    <table>
     <title>Third-party container host platform</title>
+    <?dbhtml table-width="95%" ?>
     <tgroup cols="8">
      <colspec colname="c1" colnum="1" align="center" colwidth="3*"/>
      <colspec colname="c2" colnum="2" align="center" colwidth="1*"/>
@@ -81,53 +82,25 @@
        <entry>
         <para><emphasis role="strong">Kernel</emphasis></para>
        </entry>
-       <entry>
-        <para>4.4</para>
-       </entry>
-       <entry>
-        <para>4.12</para>
-       </entry>
-       <entry>
-        <para>4.12</para>
-       </entry>
-       <entry>
-        <para>4.12+</para>
-       </entry>
-       <entry>
-        <para>4.12+</para>
-       </entry>
-       <entry>
-        <para>5.3.18</para>
-       </entry>
-       <entry>
-        <para>5.3.18+</para>
-       </entry>
+       <entry align="center">4.4</entry>
+       <entry align="center">4.12</entry>
+       <entry align="center">4.12</entry>
+       <entry align="center">4.12+</entry>
+       <entry align="center">4.12+</entry>
+       <entry align="center">5.3.18</entry>
+       <entry align="center">5.3.18+</entry>
       </row>
       <row>
        <entry>
         <para><emphasis role="strong">glibc</emphasis></para>
        </entry>
-       <entry>
-        <para>2.22</para>
-       </entry>
-       <entry>
-        <para>2.22+</para>
-       </entry>
-       <entry>
-        <para>2.22+</para>
-       </entry>
-       <entry>
-        <para>2.26</para>
-       </entry>
-       <entry>
-        <para>2.26</para>
-       </entry>
-       <entry>
-        <para>2.26</para>
-       </entry>
-       <entry>
-        <para>2.31</para>
-       </entry>
+       <entry align="center">2.22</entry>
+       <entry align="center">2.22+</entry>
+       <entry align="center">2.22+</entry>
+       <entry align="center">2.26</entry>
+       <entry align="center">2.26</entry>
+       <entry align="center">2.26</entry>
+       <entry align="center">2.31</entry>
       </row>
       <row>
        <entry>
@@ -135,226 +108,223 @@
        </entry>
        <entry align="center">
         <?dbhtml bgcolor="#ccffcc"?>
-        <para>&nbsp;<inlinemediaobject>
+        <inlinemediaobject>
           <imageobject>
-           <imagedata fileref="green-checkmark.svg" align="center"/>
+           <imagedata fileref="green-checkmark.svg"/>
           </imageobject>
-          <textobject>
-           <phrase>Ok</phrase>
-          </textobject>
          </inlinemediaobject>
-        </para>
        </entry>
-       <entry>
-        <para>&nbsp;<inlinemediaobject>
+       <entry align="center">
+        <inlinemediaobject>
          <imageobject>
-          <imagedata fileref="green-checkmark.svg" align="center"/>
+          <imagedata fileref="green-checkmark.svg"/>
          </imageobject>
-         <textobject>
-          <phrase>Ok</phrase>
-         </textobject>
-        </inlinemediaobject></para>
+        </inlinemediaobject>
        </entry>
-       <entry>
-        <para>&nbsp;<inlinemediaobject>
+       <entry align="center">
+        <inlinemediaobject>
          <imageobject>
-          <imagedata fileref="green-checkmark.svg" align="center"/>
+          <imagedata fileref="green-checkmark.svg"/>
          </imageobject>
-         <textobject>
-          <phrase>Ok</phrase>
-         </textobject>
-        </inlinemediaobject></para>
+        </inlinemediaobject>
        </entry>
-       <entry>
-        <para>&nbsp;<inlinemediaobject>
+       <entry align="center">
+        <inlinemediaobject>
          <imageobject>
-          <imagedata fileref="blue-checkmark.svg" align="center"/>
+          <imagedata fileref="blue-checkmark.svg"/>
          </imageobject>
-         <textobject>
-          <phrase>Ok</phrase>
-         </textobject>
-        </inlinemediaobject></para>
+        </inlinemediaobject>
        </entry>
-       <entry>
-        <para>&nbsp;<inlinemediaobject>
+       <entry align="center">
+        <inlinemediaobject>
          <imageobject>
-          <imagedata fileref="blue-checkmark.svg" align="center"/>
+          <imagedata fileref="blue-checkmark.svg"/>
          </imageobject>
-         <textobject>
-          <phrase>Ok</phrase>
-         </textobject>
-        </inlinemediaobject></para>
+        </inlinemediaobject>
        </entry>
-       <entry>
-        <para>&nbsp;<inlinemediaobject>
+       <entry align="center">
+        <inlinemediaobject>
          <imageobject>
-          <imagedata fileref="blue-checkmark.svg" align="center"/>
+          <imagedata fileref="blue-checkmark.svg"/>
          </imageobject>
-         <textobject>
-          <phrase>Ok</phrase>
-         </textobject>
-        </inlinemediaobject></para>
+        </inlinemediaobject>
        </entry>
-       <entry>
-        <para>&nbsp;<inlinemediaobject>
+       <entry align="center">
+        <inlinemediaobject>
          <imageobject>
-          <imagedata fileref="blue-checkmark.svg" align="center"/>
+          <imagedata fileref="blue-checkmark.svg"/>
          </imageobject>
-         <textobject>
-          <phrase>Ok</phrase>
-         </textobject>
-        </inlinemediaobject></para>
+        </inlinemediaobject>
        </entry>
       </row>
-
       <row>
-       <entry>
+       <entry align="center">
         <para>SLE 12 SP4</para>
        </entry>
        <entry align="center">
-        <para>&nbsp;<inlinemediaobject>
+        <inlinemediaobject>
          <imageobject>
-          <imagedata fileref="blue-checkmark.svg" align="center"/>
+          <imagedata fileref="blue-checkmark.svg"/>
          </imageobject>
-         <textobject>
-          <phrase>Ok</phrase>
-         </textobject>
         </inlinemediaobject>
-        </para>
        </entry>
-       <entry>
+       <entry align="center">
         <?dbhtml bgcolor="#ccffcc"?>
-        <para>&nbsp;<inlinemediaobject>
+        <inlinemediaobject>
          <imageobject>
-          <imagedata fileref="green-checkmark.svg" align="center"/>
+          <imagedata fileref="green-checkmark.svg"/>
          </imageobject>
-         <textobject>
-          <phrase>Ok</phrase>
-         </textobject>
-        </inlinemediaobject></para>
+        </inlinemediaobject>
        </entry>
-       <entry>
-        <para>&nbsp;<inlinemediaobject>
+       <entry align="center">
+        <inlinemediaobject>
          <imageobject>
-          <imagedata fileref="green-checkmark.svg" align="center"/>
+          <imagedata fileref="green-checkmark.svg"/>
          </imageobject>
-         <textobject>
-          <phrase>Ok</phrase>
-         </textobject>
-        </inlinemediaobject></para>
+        </inlinemediaobject>
        </entry>
-       <entry>
-        <para>&nbsp;<inlinemediaobject>
+       <entry align="center">
+        <inlinemediaobject>
          <imageobject>
-          <imagedata fileref="blue-checkmark.svg" align="center"/>
+          <imagedata fileref="blue-checkmark.svg"/>
          </imageobject>
-         <textobject>
-          <phrase>Ok</phrase>
-         </textobject>
-        </inlinemediaobject></para>
+        </inlinemediaobject>
        </entry>
-       <entry>
-        <para>&nbsp;<inlinemediaobject>
+       <entry align="center">
+        <inlinemediaobject>
          <imageobject>
-          <imagedata fileref="blue-checkmark.svg" align="center"/>
+          <imagedata fileref="blue-checkmark.svg"/>
          </imageobject>
-         <textobject>
-          <phrase>Ok</phrase>
-         </textobject>
-        </inlinemediaobject></para>
+        </inlinemediaobject>
        </entry>
-       <entry>
-        <para>&nbsp;<inlinemediaobject>
+       <entry align="center">
+        <inlinemediaobject>
          <imageobject>
-          <imagedata fileref="blue-checkmark.svg" align="center"/>
+          <imagedata fileref="blue-checkmark.svg"/>
          </imageobject>
-         <textobject>
-          <phrase>Ok</phrase>
-         </textobject>
-        </inlinemediaobject></para>
+        </inlinemediaobject>
        </entry>
-       <entry>
-        <para>&nbsp;<inlinemediaobject>
+       <entry align="center">
+        <inlinemediaobject>
          <imageobject>
-          <imagedata fileref="blue-checkmark.svg" align="center"/>
+          <imagedata fileref="blue-checkmark.svg"/>
          </imageobject>
-         <textobject>
-          <phrase>Ok</phrase>
-         </textobject>
-        </inlinemediaobject></para>
+        </inlinemediaobject>
        </entry>
       </row>
       <row>
-       <entry>
+       <entry align="center">
         <para>SLE 15 SP1</para>
        </entry>
-       <entry>
-        <para>&nbsp;<inlinemediaobject>
+       <entry align="center">
+        <inlinemediaobject>
           <imageobject>
            <imagedata fileref="red-crossmark.svg"/>
           </imageobject>
-          <textobject>
-           <phrase>Ok</phrase>
-          </textobject>
          </inlinemediaobject>
-        </para>
        </entry>
-       <entry>
-        <para>&nbsp;<inlinemediaobject>
+       <entry align="center">
+        <inlinemediaobject>
           <imageobject>
            <imagedata fileref="red-crossmark.svg"/>
           </imageobject>
-          <textobject>
-           <phrase>Ok</phrase>
-          </textobject>
          </inlinemediaobject>
-        </para>
        </entry>
-       <entry>
-        <para>&mdash;</para>
+       <entry align="center">
+        &mdash;
        </entry>
-       <entry>&nbsp;<inlinemediaobject>
+       <entry align="center">
+        <inlinemediaobject>
           <imageobject>
            <imagedata fileref="green-checkmark.svg" align="center"/>
           </imageobject>
-          <textobject>
-           <phrase>Ok</phrase>
-          </textobject>
          </inlinemediaobject>
        </entry>
-       <entry>
+       <entry align="center">
         <?dbhtml bgcolor="#ccffcc"?>
-        <para>&nbsp;<inlinemediaobject>
+        <inlinemediaobject>
           <imageobject>
            <imagedata fileref="green-checkmark.svg"/>
           </imageobject>
-          <textobject>
-           <phrase>Ok</phrase>
-          </textobject>
          </inlinemediaobject>
-        </para>
        </entry>
-       <entry>
-        <para>&nbsp;<inlinemediaobject>
+       <entry align="center">
+        <inlinemediaobject>
+          <imageobject>
+           <imagedata fileref="green-checkmark.svg"/>
+          </imageobject>
+         </inlinemediaobject>
+       </entry>
+       <entry align="center">
+        <inlinemediaobject>
+          <imageobject>
+           <imagedata fileref="blue-checkmark.svg"/>
+          </imageobject>
+         </inlinemediaobject>
+       </entry>
+      </row>
+      <row>
+       <entry namest="c1" nameend="c8" align="left">
+        <variablelist>
+         <title>Explanation</title>
+         <?dbhtml list-presentation="table"?>
+         <?dbhtml term-width="5%" list-width="95%" ?>
+         <?dbhtml term-presentation="bold" ?>
+         <varlistentry>
+          <term><inlinemediaobject>
           <imageobject>
            <imagedata fileref="green-checkmark.svg"/>
           </imageobject>
           <textobject>
            <phrase>Ok</phrase>
           </textobject>
-         </inlinemediaobject>
-        </para>
-       </entry>
-       <entry>
-        <para>&nbsp;<inlinemediaobject>
+         </inlinemediaobject></term>
+          <listitem>
+           <para>Fully compatible and fully supported.</para>
+          </listitem>
+         </varlistentry>
+         <varlistentry>
+          <term><inlinemediaobject>
           <imageobject>
            <imagedata fileref="blue-checkmark.svg"/>
           </imageobject>
           <textobject>
            <phrase>Ok</phrase>
           </textobject>
-         </inlinemediaobject>
-        </para>
+         </inlinemediaobject></term>
+          <listitem>
+           <para>Workaround specific fully supported, but compatibility depends on type
+           of container (privileged or unprivileged) and on the application interactions
+           (direct with kernel-version-specific data structures, kernel-version-specific modules,
+           etc.)
+           </para>
+          </listitem>
+         </varlistentry>
+         <varlistentry>
+          <term>&mdash;</term>
+          <listitem>
+           <para>
+            Limited and commercially viable support: may or may not work, workload-specific,
+            requires verification by customer
+           </para>
+          </listitem>
+         </varlistentry>
+         <varlistentry>
+          <term><inlinemediaobject>
+          <imageobject>
+           <imagedata fileref="red-crossmark.svg"/>
+          </imageobject>
+          <textobject>
+           <phrase>Ok</phrase>
+          </textobject>
+         </inlinemediaobject></term>
+          <listitem>
+           <para>
+            Unsupported
+           </para>
+          </listitem>
+         </varlistentry>
+        </variablelist>
        </entry>
       </row>
      </tbody>