[elpa] externals/excorporate 5e32d41dfb: Add an OAuth 2.0 debugging suggestion

[Thomas Fitzsimmons]

branch: externals/excorporate
commit 5e32d41dfbbd99cf405e0a33ad507eaafb4cf8aa
Author: Thomas Fitzsimmons <fitzsim@fitzsim.org>
Commit: Thomas Fitzsimmons <fitzsim@fitzsim.org>

    Add an OAuth 2.0 debugging suggestion
    
    * excorporate.texi (Configuration): Format *Messages* as code.
    * excorporate.texi (Troubleshooting): Likewise.  Add note about
    OAuth 2.0 debugging.
---
 excorporate.info | 19 ++++++++++++-------
 excorporate.texi | 16 +++++++++++-----
 2 files changed, 23 insertions(+), 12 deletions(-)

diff --git a/excorporate.info b/excorporate.info
index 70a1097150..ba9a9be174 100644
--- a/excorporate.info
+++ b/excorporate.info
@@ -122,7 +122,7 @@ wizard by running:
 
 You will be prompted for the server configuration information.  Follow
 the prompts and if all goes well, you'll see a message in the minibuffer
-or in *Messages* saying that the connection is ready.  Using the
+or in '*Messages*' saying that the connection is ready.  Using the
 prompts, you can first try with autodiscovery.  If autodiscovery runs
 out of URLs to try, re-run 'excorporate', saying 'n' to the
 autodiscovery attempt, at which point you will be asked for the EWS URL.
@@ -243,14 +243,14 @@ Before even attempting Excorporate, you have to make 
these succeed:
       (url-retrieve-synchronously ews-url)
       (buffer-string))
 
-When this works, you'll see web page text in *Messages*, containing a
+When this works, you'll see web page text in '*Messages*', containing a
 message about having created a service.
 
      (with-current-buffer
       (url-retrieve-synchronously wsdl-url)
       (buffer-string))
 
-When this works, it will show a bunch of WSDL (XML) in *Messages*.
+When this works, it will show a bunch of WSDL (XML) in '*Messages*'.
 
 Debug the above URL retrievals with 'M-:' in an 'emacs -Q' run:
 
@@ -309,6 +309,11 @@ mail.gnu.org:443'
 attempted operation will now complete, usually without needing to retry
 it.
 
+   To debug OAuth 2.0 connections, it may be helpful to uncomment the
+'message' line in, then reevaluate, url-http-oauth-parse-grant.  Beware
+that this results in bearer and refresh tokens being output to the
+'*Messages*' buffer.
+
 
 File: excorporate.info,  Node: API Usage,  Next: Index,  Prev: 
Troubleshooting,  Up: Top
 
@@ -819,10 +824,10 @@ Node: Top1103
 Node: Reporting Bugs2517
 Node: Installation2841
 Node: Configuration3220
-Node: Usage5120
-Node: Troubleshooting8440
-Node: API Usage12123
-Node: Index29719
+Node: Usage5122
+Node: Troubleshooting8442
+Node: API Usage12360
+Node: Index29956
 
 End Tag Table
 
diff --git a/excorporate.texi b/excorporate.texi
index e7e2d082e9..347fed117f 100644
--- a/excorporate.texi
+++ b/excorporate.texi
@@ -136,8 +136,8 @@ wizard by running:
 @noindent
 You will be prompted for the server configuration information.  Follow
 the prompts and if all goes well, you'll see a message in the
-minibuffer or in *Messages* saying that the connection is ready.
-Using the prompts, you can first try with autodiscovery.  If
+minibuffer or in @code{*Messages*} saying that the connection is
+ready.  Using the prompts, you can first try with autodiscovery.  If
 autodiscovery runs out of URLs to try, re-run @code{excorporate},
 saying 'n' to the autodiscovery attempt, at which point you will be
 asked for the EWS URL.
@@ -273,8 +273,8 @@ Before even attempting Excorporate, you have to make these 
succeed:
 @end example
 
 @noindent
-When this works, you'll see web page text in *Messages*, containing a
-message about having created a service.
+When this works, you'll see web page text in @code{*Messages*},
+containing a message about having created a service.
 
 @example
 (with-current-buffer
@@ -283,7 +283,8 @@ message about having created a service.
 @end example
 
 @noindent
-When this works, it will show a bunch of WSDL (XML) in *Messages*.
+When this works, it will show a bunch of WSDL (XML) in
+@code{*Messages*}.
 
 @noindent
 Debug the above URL retrievals with @code{M-:} in an @code{emacs -Q}
@@ -356,6 +357,11 @@ Put the cursor on that line, and type 'd' to delete the 
process.  The
 attempted operation will now complete, usually without needing to retry
 it.
 
+To debug OAuth 2.0 connections, it may be helpful to uncomment the
+@code{message} line in, then reevaluate, url-http-oauth--parse-grant.
+Beware that this results in bearer and refresh tokens being output to
+the @code{*Messages*} buffer.
+
 @node API Usage
 @chapter API Usage