Edit RST user man pages for clarity and accuracy

[krb5.git] / doc / rst_source / krb_users / user_commands / kvno.rst

diff --git a/doc/rst_source/krb_users/user_commands/kvno.rst b/doc/rst_source/krb_users/user_commands/kvno.rst
index 6db4353b5a1e9cc89b3e7503d1f07fdb5cdbadab..4f2e2fd381f7b9500ceea92da508589395cd95aa 100644 (file)
--- a/doc/rst_source/krb_users/user_commands/kvno.rst
+++ b/doc/rst_source/krb_users/user_commands/kvno.rst
@@ -28,8 +28,8 @@ OPTIONS
 -------
 
 **-c** *ccache*
-   Specifies the name of a credentials cache to use (if not the
-   default)
+    Specifies the name of a credentials cache to use (if not the
+    default)
 
 **-e** *etype*
     Specifies the enctype which will be requested for the session key
@@ -37,10 +37,12 @@ OPTIONS
     certain backward compatibility situations.
 
 **-q**
-   Suppress printing
+    Suppress printing output when successful.  If a service ticket
+    cannot be obtained, an error message will still be printed and
+    kvno will exit with nonzero status.
 
 **-h**
-   Prints a usage statement and exits
+    Prints a usage statement and exits.
 
 **-P**
     Specifies that the *service1 service2* ...  arguments are to be
@@ -49,10 +51,11 @@ OPTIONS
     conjunction with protocol transition.
 
 **-S** *sname*
-    Specifies that *krb5_sname_to_principal()* will be used to build
-    principal names.  If this flag is specified, the *service1
-    service2* ...  arguments are interpreted as hostnames (rather than
-    principal names), and *sname* is interpreted as the service name.
+    Specifies that the *service1 service2* ... arguments are
+    interpreted as hostnames, and the service principals are to be
+    constructed from those hostnames and the service name *sname*.
+    The service hostnames will be canonicalized according to the usual
+    rules for constructing service principals.
 
 **-U** *for_user*
     Specifies that protocol transition (S4U2Self) is to be used to