From: Greg Hudson <ghudson@mit.edu>
Date: Tue, 17 Dec 2013 21:56:41 +0000 (-0500)
Subject: Clarify klist -s documentation
X-Git-Tag: krb5-1.13-alpha1~286
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=bf1d3c7b0b060be4b3e9e793b633c07e489ac76f;p=thirdparty%2Fkrb5.git

Clarify klist -s documentation

The documentation for klist -s erroneously suggests that it doesn't
affect the exit status behavior and that it merely checks for the
existence of the ccache (only mentioning the expired ticket check at
the end).  Make it clearer and simpler, but avoid going into a lot of
detail about the nature of the expiration check.

ticket: 7806 (new)
target_version: 1.12.1
tags: pullup
---

diff --git a/doc/user/user_commands/klist.rst b/doc/user/user_commands/klist.rst
index d303f34d83..00ad0ffe51 100644
--- a/doc/user/user_commands/klist.rst
+++ b/doc/user/user_commands/klist.rst
@@ -64,10 +64,9 @@ OPTIONS
         a    anonymous
 
 **-s**
-    Causes klist to run silently (produce no output), but to still set
-    the exit status according to whether it finds the credentials
-    cache.  The exit status is '0' if klist finds a credentials cache,
-    and '1' if it does not or if the tickets are expired.
+    Causes klist to run silently (produce no output).  klist will exit
+    with status 1 if the credentials cache cannot be read or is
+    expired, and with status 0 otherwise.
 
 **-a**
     Display list of addresses in credentials.