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>