doc updates

Author: d-w-moore

README.md

@@ -162,6 +162,17 @@ the `encryption_*` and `ssl_*` options
 directly to the constructor as keyword arguments, even though it is
 required when they are placed in the environment file.
 
+Creating PAM or Native Credentials File (.irodsA)
+-------------------------------------------------
+
+```Two free functions exist for creating encoded authentication files.
+    irods.client_init.write_credentials_with_native_password
+    irods.client_init.write_credentials_with_pam_password
+```
+
+Each takes a cleartext password and creates an appropriately encoded version of it
+as an .irodsA file in the login environment, if none is pre-existing.
+
 PAM logins
 ----------
 
@@ -171,8 +182,7 @@ iCommands.
 Caveat for iRODS 4.3+: when upgrading from 4.2, the "irods_authentication_scheme" setting must be changed from "pam" to "pam_password" in
 `~/.irods/irods_environment.json` for all file-based client environments.
 
-To replicate iinit's capability for creating valid PAM login credentials file (.irodsA) for the client login environment, we can set these
-two configuration variables:
+To use the PRC PAM login credentials update function for the client login environment, we can set these two configuration variables:
 
 ```
 legacy_auth.pam.password_for_auto_renew "my_pam_password"