Remove superfluous comma; grammar fixes; split sentence

in two for better understanding.
From wiz@NetBSD.org

Describe krb5_set_password_using_ccache


git-svn-id: svn://svn.h5l.se/heimdal/trunk/heimdal@14048 ec53bebd-3082-4978-b11e-865c3cabbd6b

lib/krb5/krb5_set_password.3

@@ -57,7 +57,7 @@ Kerberos 5 Library (libkrb5, -lkrb5)
 .Fa "krb5_context context"
 .Fa "krb5_creds *creds"
 .Fa "char *newpw"
-.Fa "krb5_principal targprinc",
+.Fa "krb5_principal targprinc"
 .Fa "int *result_code"
 .Fa "krb5_data *result_code_string"
 .Fa "krb5_data *result_string"
@@ -83,7 +83,7 @@ protocol (and also fall back to the older set-password protocol if the
 newer protocol doesn't work).
 .Pp
 .Fn krb5_change_password
-set the password
+sets the password
 .Fa newpasswd
 for the client principal in
 .Fa creds .
@@ -91,19 +91,39 @@ The server principal of creds must be
 .Li kadmin/changepw .
 .Pp
 .Fn krb5_set_password
+and
+.Fn krb5_set_password_using_ccache
 changes the password for the principal
-.Fa targprinc ,
+.Fa targprinc .
-if
+.Pp
+.Fn krb5_set_password
+requires that the credential for
+.Li kadmin/changepw@REALM
+is in
+.Fa creds .
+If the user caller isn't an administrator, this credential
+needs to be an initial credential, see
+.Xr krb5_get_init_creds 3
+how to get such credentials.
+.Pp
+.Fn krb5_set_password_using_ccache
+will get the credential from
+.Fa ccache .
+.Pp
+If
 .Fa targprinc
 is
-.Dv NULL
+.Dv NULL ,
-the default principal in
+.Fn krb5_set_password_using_ccache
+uses the the default principal in
 .Fa ccache
-is used.
+and
+.Fn krb5_set_password
+uses the global the default principal.
 .Pp
-Both functions returns and error in
+All three functions returns and error in
 .Fa result_code
-and maybe an error strings to print in
+and maybe an error string to print in
 .Fa result_string .
 .Sh SEE ALSO
 .Xr krb5_ccache 3 ,