branch: externals/excorporate
commit 7df1891759e26541711ccbff739a39be6bca09ac
Author: Thomas Fitzsimmons <[email protected]>
Commit: Thomas Fitzsimmons <[email protected]>
Bump version to 1.1.0
* excorporate.el: Bump version to 1.1.0.
* NEWS, README: Document 1.1.0 changes.
---
NEWS | 14 ++++++++++++++
README | 29 ++++++++++++++++-------------
excorporate.el | 2 +-
3 files changed, 31 insertions(+), 14 deletions(-)
diff --git a/NEWS b/NEWS
index e850ad3c73..4c6a7d7d63 100644
--- a/NEWS
+++ b/NEWS
@@ -1,5 +1,19 @@
GNU Emacs Excorporate NEWS -- history of user-visible changes.
+* New in Excorporate 1.1.0
+
+Released 2023-05-10
+
+** Experimental OAuth 2.0 support
+
+Warning: To deal with OAuth 2.0 refresh tokens, `url-http-oauth' needs
+to delete then rewrite entries in netrc files listed in the
+`auth-sources' variable. The netrc entry rewriting code is new and
+relatively untested so please back up these files before trying OAuth
+2.0 support. Deletion respects the customization value of
+`auth-source-save-behavior'; if it is set to `ask', you will be
+prompted before the entry deletion happens.
+
* New in Excorporate 1.0.0
Released 2021-05-20
diff --git a/README b/README
index 02d733b226..838d726423 100644
--- a/README
+++ b/README
@@ -3,28 +3,31 @@ Excorporate provides Exchange integration for Emacs.
Most Recent Improvements
------------------------
-New in Excorporate 1.0.0, released 2021-05-20:
+New in Excorporate 1.1.0, released 2023-05-10:
-** Declare API stability
+** Experimental OAuth 2.0 support
+
+Warning: To deal with OAuth 2.0 refresh tokens, `url-http-oauth' needs
+to rewrite entries in netrc files listed in the `auth-sources'
+variable. The netrc entry rewriting code is new and relatively
+untested so please back up these files before trying OAuth 2.0
+support.
Quick Start
-----------
-To create a connection to a web service:
+Customize `excorporate-configuration'. To use OAuth 2.0, at a minimum
+you will need to set the "client-identifier" and the "login_hint"
+fields.
-M-x excorporate
+Then:
-Excorporate will prompt for an email address that it will use to
-automatically discover settings. Then it will prompt you for your
-credentials two or three times depending on the server configuration.
+M-x excorporate
You should see a message indicating that the connection is ready
either in the minibuffer or in the *Messages* buffer.
-Finally, run M-x calendar, and press 'e' to show today's meetings.
-
-If autodiscovery fails, customize `excorporate-configuration' to skip
-autodiscovery.
+Run M-x calendar, and press 'e' to show today's meetings.
-For further information including connection troubleshooting, see the
-Excorporate Info node at C-h i d m Excorporate.
+For configuration suggestions and connection troubleshooting tips, see
+the Excorporate Info node at C-h i d m Excorporate.
diff --git a/excorporate.el b/excorporate.el
index 8304ef6fae..e9fa273bab 100644
--- a/excorporate.el
+++ b/excorporate.el
@@ -5,7 +5,7 @@
;; Author: Thomas Fitzsimmons <[email protected]>
;; Maintainer: Thomas Fitzsimmons <[email protected]>
;; Created: 2014-09-19
-;; Version: 1.0.0
+;; Version: 1.1.0
;; Keywords: calendar
;; Homepage: https://www.fitzsim.org/blog/
;; Package-Requires: ((emacs "24.1") (cl-lib "0.6.1") (fsm "0.2.1")
(soap-client "3.2.0") (url-http-ntlm "2.0.4") (nadvice "0.3") (url-http-oauth
"0.8.3"))
