svn commit: r48162 - head/en_US.ISO8859-1/articles/committers-guide

[Warren Block]

Author: wblock
Date: Thu Feb 11 01:05:32 2016
New Revision: 48162
URL: https://svnweb.freebsd.org/changeset/doc/48162

Log:
  Clarify the process of setting up a FreeBSD.org Kerberos account for
  the first time.
  
  Submitted by:	sobomax
  Differential Revision:	https://reviews.freebsd.org/D5247

Modified:
  head/en_US.ISO8859-1/articles/committers-guide/article.xml

Modified: head/en_US.ISO8859-1/articles/committers-guide/article.xml
==============================================================================
--- head/en_US.ISO8859-1/articles/committers-guide/article.xml	Tue Feb  9 17:06:20 2016	(r48161)
+++ head/en_US.ISO8859-1/articles/committers-guide/article.xml	Thu Feb 11 01:05:32 2016	(r48162)
@@ -340,8 +340,9 @@ You need a Passphrase to protect your se
       </listitem>
     </itemizedlist>
 
-    <para>To reset a Kerberos password in the &os; cluster using a
-      random password generator:</para>
+    <para>To create a new Kerberos account in the &os; cluster, or to reset
+      a Kerberos password for an existing account using a random password
+      generator:</para>
 
     <screen>&prompt.user; <userinput>ssh kpasswd.freebsd.org</userinput></screen>
 
@@ -356,6 +357,15 @@ You need a Passphrase to protect your se
       running:</para>
 
     <screen>&prompt.user; <userinput>kpasswd</userinput></screen>
+
+    <note>
+      <para>Unless you have used the Kerberos-authenticated service(s) of the
+        &os;.org cluster previously, <errorname>Client unknown</errorname>
+        will be shown.  This error means that the
+        <command>ssh kpasswd.freebsd.org</command> method shown above must
+        be used first to initialize your Kerberos account.</para>
+    </note>
+
   </sect1>
 
   <sect1 xml:id="committer.types">