Blame SOURCES/Clarify-debug-and-debug_level-in-man-pages.patch

1f3cc3
From d71d354f1020a7deac57f26cc7c2cafb3fa675a3 Mon Sep 17 00:00:00 2001
1f3cc3
From: Robbie Harwood <rharwood@redhat.com>
1f3cc3
Date: Wed, 11 Apr 2018 16:01:21 -0400
1f3cc3
Subject: [PATCH] Clarify debug and debug_level in man pages
1f3cc3
1f3cc3
In particular, add debug_level to gssproxy(5) since it was previously
1f3cc3
accepted but not documented.
1f3cc3
1f3cc3
Signed-off-by: Robbie Harwood <rharwood@redhat.com>
1f3cc3
Reviewed-by: Simo Sorce <simo@redhat.com>
1f3cc3
Merges: #229
1f3cc3
(cherry picked from commit e0e96e46be03102903533a9816b4deefe1adfaf8)
1f3cc3
---
1f3cc3
 man/gssproxy.8.xml      | 24 +++++++++++++++++++++++-
1f3cc3
 man/gssproxy.conf.5.xml |  5 ++++-
1f3cc3
 2 files changed, 27 insertions(+), 2 deletions(-)
1f3cc3
1f3cc3
diff --git a/man/gssproxy.8.xml b/man/gssproxy.8.xml
1f3cc3
index 1df4b0d..21f7e6a 100644
1f3cc3
--- a/man/gssproxy.8.xml
1f3cc3
+++ b/man/gssproxy.8.xml
1f3cc3
@@ -118,13 +118,35 @@
1f3cc3
                     </para>
1f3cc3
                 </listitem>
1f3cc3
             </varlistentry>
1f3cc3
+
1f3cc3
             <varlistentry>
1f3cc3
                 <term>
1f3cc3
                     <option>-d</option>,<option>--debug</option>
1f3cc3
                 </term>
1f3cc3
                 <listitem>
1f3cc3
                     <para>
1f3cc3
-                        Turn on debugging.
1f3cc3
+                        Turn on debugging.  This option is identical to
1f3cc3
+                        --debug-level=1.
1f3cc3
+                    </para>
1f3cc3
+                </listitem>
1f3cc3
+            </varlistentry>
1f3cc3
+
1f3cc3
+            <varlistentry>
1f3cc3
+                <term>
1f3cc3
+                    <option>--debug-level=</option>
1f3cc3
+                </term>
1f3cc3
+                <listitem>
1f3cc3
+                    <para>
1f3cc3
+                        Turn on debugging at the specified level.  0
1f3cc3
+                        corresponds to no logging, while 1 turns on basic
1f3cc3
+                        debug logging.  Level 2 increases verbosity, including
1f3cc3
+                        more detailed credential verification.
1f3cc3
+                    </para>
1f3cc3
+                    <para>
1f3cc3
+                        At level 3 and above, KRB5_TRACE output is logged.  If
1f3cc3
+                        KRB5_TRACE was already set in the execution
1f3cc3
+                        environment, trace output is sent to its value
1f3cc3
+                        instead.
1f3cc3
                     </para>
1f3cc3
                 </listitem>
1f3cc3
             </varlistentry>
1f3cc3
diff --git a/man/gssproxy.conf.5.xml b/man/gssproxy.conf.5.xml
1f3cc3
index de846b4..21c9653 100644
1f3cc3
--- a/man/gssproxy.conf.5.xml
1f3cc3
+++ b/man/gssproxy.conf.5.xml
1f3cc3
@@ -192,7 +192,10 @@
1f3cc3
                 <varlistentry>
1f3cc3
                     <term>debug (boolean)</term>
1f3cc3
                     <listitem>
1f3cc3
-                        <para>Enable debugging to syslog.</para>
1f3cc3
+                        <para>
1f3cc3
+                            Enable debugging to syslog.  Setting to true is
1f3cc3
+                            identical to setting debug_level to 1.
1f3cc3
+                        </para>
1f3cc3
                         <para>Default: debug = false</para>
1f3cc3
                     </listitem>
1f3cc3
                 </varlistentry>