branch: elpa/mastodon
commit c4b024c2a7a22565e0c8cc20c107cf30b41cd6a8
Author: marty hiatt <martianhia...@disroot.org>
Commit: marty hiatt <martianhia...@disroot.org>
readme re auth source tokens
---
README.org | 18 ++++++++++++++++--
1 file changed, 16 insertions(+), 2 deletions(-)
diff --git a/README.org b/README.org
index fe1759bfa9..9cfdcee94a 100644
--- a/README.org
+++ b/README.org
@@ -121,8 +121,22 @@ can activate one at a time by changing those two variables
and restarting
Emacs.
If you were using mastodon.el before 2FA was implemented and the above
-steps do not work, delete the old file specified by
-=mastodon-client--token-file= and restart Emacs and follow the steps again.
+steps do not work, call =(mastodon-forget-all-logins)=, restart Emacs and
+follow the steps again.
+
+**** encrypted access tokens (from 1.2.0)
+
+By default, user access tokens are now stored in the user's auth source
+file (typically =~/.authinfo.gpg=). When you first update to 1.2.0, or if
+you encounter issues due to old credentials, call
+=(mastodon-forget-all-logins)= and then authenticate again. If you don't
+want this behaviour, set =mastodon-auth-use-auth-source= to nil. Entries
+will be stored in =mastodon-client--token-file= instead.
+
+And if for some reason you reauthenticate, you'll need to either remove the
+entry in your auth sources file, or manually update the token in it after
+doing so, as mastodon.el is unable to reliably update (or even remove)
+entires.
*** Timelines
