branch: master
commit afbad1822a86be1d6a1a61182026f445190cd374
Author: Thomas Fitzsimmons <fitz...@fitzsim.org>
Commit: Thomas Fitzsimmons <fitz...@fitzsim.org>
Excorporate: Document new configuration wizard
* packages/excorporate/excorporate.texi (Configuration): Document
new configuration wizard.
---
packages/excorporate/excorporate.info | 32 ++++++++++++++++----------------
packages/excorporate/excorporate.texi | 27 +++++++++++++--------------
2 files changed, 29 insertions(+), 30 deletions(-)
diff --git a/packages/excorporate/excorporate.info
b/packages/excorporate/excorporate.info
index 1b15e48..f1acc6b 100644
--- a/packages/excorporate/excorporate.info
+++ b/packages/excorporate/excorporate.info
@@ -1,4 +1,4 @@
-This is excorporate.info, produced by makeinfo version 6.4 from
+This is excorporate.info, produced by makeinfo version 6.5 from
excorporate.texi.
Copyright (C) 2016 Free Software Foundation, Inc.
@@ -72,29 +72,29 @@ File: excorporate.info, Node: Configuration, Next: Usage,
Prev: Installation,
2 Configuration
***************
-Ideally you won't need to configure Excorporate at all. On friendly
-Exchange setups, Excorporate can discover the EWS URL automatically.
+Ideally you won't need to configure Excorporate beyond providing your
+account email address. On friendly Exchange setups, Excorporate can
+discover the EWS URL automatically.
-First try:
+Run:
'M-x excorporate'
-which will prompt you for the Exchange account email address. Follow
+which will prompt you for the Exchange account configuration. 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.
+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.
-If autodiscovery runs out of URLs to try, then customize
-'excorporate-configuration':
+To save a working configuration, customize 'excorporate-configuration':
'M-x customize-variable RET excorporate-configuration'
-From the value menu select "Skip autodiscovery". This allows you to
-enter the Exchange account email address and the EWS URL directly. The
-EWS URL is of the form 'https://mail.gnu.org/ews/exchange.asmx'.
-
After saving the configuration, try 'M-x excorporate' again.
-If that doesn't work, *note Troubleshooting::.
+If neither autodiscovery nor specifying the EWS URL work, *note
+Troubleshooting::.
File: excorporate.info, Node: Usage, Next: Troubleshooting, Prev:
Configuration, Up: Top
@@ -230,8 +230,8 @@ Tag Table:
Node: Top1103
Node: Installation2222
Node: Configuration2485
-Node: Usage3445
-Node: Troubleshooting4863
-Node: Reporting Bugs7698
+Node: Usage3505
+Node: Troubleshooting4923
+Node: Reporting Bugs7758
End Tag Table
diff --git a/packages/excorporate/excorporate.texi
b/packages/excorporate/excorporate.texi
index 43c4943..4235708 100644
--- a/packages/excorporate/excorporate.texi
+++ b/packages/excorporate/excorporate.texi
@@ -79,36 +79,35 @@ Install @code{excorporate} from the GNU ELPA repository:
@chapter Configuration
@noindent
-Ideally you won't need to configure Excorporate at all. On friendly
-Exchange setups, Excorporate can discover the EWS URL automatically.
+Ideally you won't need to configure Excorporate beyond providing your
+account email address. On friendly Exchange setups, Excorporate can
+discover the EWS URL automatically.
@noindent
-First try:
+Run:
@code{M-x excorporate}
@noindent
-which will prompt you for the Exchange account email address. 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.
+which will prompt you for the Exchange account configuration. 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 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.
@noindent
-If autodiscovery runs out of URLs to try, then customize
+To save a working configuration, customize
@code{excorporate-configuration}:
@code{M-x customize-variable RET excorporate-configuration}
@noindent
-From the value menu select ``Skip autodiscovery''. This allows you to
-enter the Exchange account email address and the EWS URL directly.
-The EWS URL is of the form
-@code{https://mail.gnu.org/ews/exchange.asmx}.
-
-@noindent
After saving the configuration, try @code{M-x excorporate} again.
@noindent
-If that doesn't work, @pxref{Troubleshooting}.
+If neither autodiscovery nor specifying the EWS URL work,
+@pxref{Troubleshooting}.
@node Usage
@chapter Usage
