From: Tom Yu <tlyu@mit.edu>
Date: Wed, 28 Sep 2016 16:33:52 +0000 (-0400)
Subject: Clarify kinit principal selection
X-Git-Tag: krb5-1.15-beta1~20
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=9896d4ffecb69f0262375b2f0db5b275a5e25de9;p=thirdparty%2Fkrb5.git

Clarify kinit principal selection

Describe the principal selection behavior of kinit when the principal
argument is absent.

ticket: 8403
target_version: 1.14-next
tags: pullup
---

diff --git a/doc/user/user_commands/kinit.rst b/doc/user/user_commands/kinit.rst
index 72721c3e32..3f9d5340f1 100644
--- a/doc/user/user_commands/kinit.rst
+++ b/doc/user/user_commands/kinit.rst
@@ -33,7 +33,10 @@ DESCRIPTION
 -----------
 
 kinit obtains and caches an initial ticket-granting ticket for
-*principal*.
+*principal*.  If *principal* is absent, kinit chooses an appropriate
+principal name based on existing credential cache contents or the
+local username of the user invoking kinit.  Some options modify the
+choice of principal name.
 
 
 OPTIONS