[sdk/kdesrc-build] doc: doc: Create table of debug levels

[Andrew Shark]

Git commit fd57dd6695550f522a2c2c16d09d1ca9bfee6ad1 by Andrew Shark.
Committed on 24/02/2024 at 16:26.
Pushed by ashark into branch 'master'.

doc: Create table of debug levels

M  +52   -19   doc/other-features.docbook

https://invent.kde.org/sdk/kdesrc-build/-/commit/fd57dd6695550f522a2c2c16d09d1ca9bfee6ad1

diff --git a/doc/other-features.docbook b/doc/other-features.docbook
index 96215a58..c42d97fe 100644
--- a/doc/other-features.docbook
+++ b/doc/other-features.docbook
@@ -6,25 +6,58 @@
 <para>&kdesrc-build; has several options to control the amount of output the
 script generates. In any case, errors will always be output.</para>
 
-<itemizedlist>
-<listitem><para>The <option>--quiet</option> option (short form is
-<option>-q</option>) causes &kdesrc-build; to be mostly silent. Only important
-messages, warnings, or errors will be shown. When available, build progress
-information is still shown.</para></listitem>
-
-<listitem><para>The <option>--really-quiet</option> option (no short form)
-causes &kdesrc-build; to only display important warnings or errors while it is
-running.</para></listitem>
-
-<listitem><para>The <option>--verbose</option> option (short form is
-<option>-v</option>) causes &kdesrc-build; to be very detailed in its
-output.</para></listitem>
-
-<listitem><para>The <option>--debug</option> option is for debugging purposes
-only, it causes &kdesrc-build; to act as if <option>--verbose</option> was
-turned on, causes commands to also output to the terminal, and will display
-debugging information for many functions.</para></listitem>
-</itemizedlist>
+<table>
+  <title>Table of debug levels</title>
+  <tgroup cols="3">
+  
+  <thead>
+    <row>
+      <entry>Debug level</entry>
+      <entry>Level name</entry>
+      <entry>Command line option</entry>
+    </row>
+  </thead>
+  <tbody>
+  
+  <row>
+    <entry>0</entry>
+    <entry>DEBUG</entry>
+    <entry>--debug</entry>
+  </row>
+    
+  <row>
+    <entry>1</entry>
+    <entry>WHISPER</entry>
+    <entry>--verbose</entry>
+  </row>
+  
+  <row>
+    <entry>2</entry>
+    <entry>INFO</entry>
+    <entry>Selected by default</entry>
+  </row>
+  
+  <row>
+    <entry>3</entry>
+    <entry>NOTE</entry>
+    <entry>--quiet</entry>
+  </row>
+  
+  <row>
+    <entry>4</entry>
+    <entry>WARNING</entry>
+    <entry>--really-quiet</entry>
+  </row>
+  
+  <row>
+    <entry>5</entry>
+    <entry>ERROR</entry>
+    <entry>No way to select</entry>
+  </row>
+  
+  </tbody>
+  </tgroup>
+</table>
 
 </sect2>