You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@isis.apache.org by da...@apache.org on 2017/01/09 22:40:29 UTC

[09/22] isis git commit: ISIS-1557: adds docs for isis.service.email.throwExceptionOnFail

ISIS-1557: adds docs for isis.service.email.throwExceptionOnFail


Project: http://git-wip-us.apache.org/repos/asf/isis/repo
Commit: http://git-wip-us.apache.org/repos/asf/isis/commit/15b30aa0
Tree: http://git-wip-us.apache.org/repos/asf/isis/tree/15b30aa0
Diff: http://git-wip-us.apache.org/repos/asf/isis/diff/15b30aa0

Branch: refs/heads/master
Commit: 15b30aa0a2afd2ff0b6511e0980a6a4ceb0f0d04
Parents: a6959fa
Author: Dan Haywood <da...@haywood-associates.co.uk>
Authored: Wed Dec 21 12:32:09 2016 +0000
Committer: Dan Haywood <da...@haywood-associates.co.uk>
Committed: Wed Dec 21 12:32:09 2016 +0000

----------------------------------------------------------------------
 .../main/asciidoc/guides/_rgcfg_configuring-core.adoc   | 12 ++++++++++++
 .../main/asciidoc/guides/_rgsvc_api_EmailService.adoc   |  7 +++++++
 2 files changed, 19 insertions(+)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/isis/blob/15b30aa0/adocs/documentation/src/main/asciidoc/guides/_rgcfg_configuring-core.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgcfg_configuring-core.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgcfg_configuring-core.adoc
index 4b2b83c..6656a86 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgcfg_configuring-core.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgcfg_configuring-core.adoc
@@ -275,6 +275,18 @@ NB: note that the key is mis-spelt, (`isis.service.email` rather than `isis.serv
 
 
 | `isis.service.` +
+`email.` +
+`throwExceptionOnFail`
+|`true`,`false` +
+(`true`)
+|(`1.13.3-SNAPSHOT`) Whether to throw an exception if there the email cannot be sent (probably because of some misconfiguration).
+
+This behaviour is (now) the default; the old behaviour (of just returning `false` from the `send()` method) can be re-enabled by setting this property to `false`.
+
+NB: note that the key is mis-spelt, (`isis.service.email` rather than `isis.services.email`)
+
+
+| `isis.service.` +
 `email.tls.enabled`
 |`true`,`false` +
 (`true`)

http://git-wip-us.apache.org/repos/asf/isis/blob/15b30aa0/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_EmailService.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_EmailService.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_EmailService.adoc
index 1c090c0..f05c63e 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_EmailService.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_EmailService.adoc
@@ -66,6 +66,13 @@ For example, if you create a test email account on gmail, you can configure the
 where "xxx" is the gmail user account and "yyy" is its password
 
 
+In addition (as of `1.13.3-SNAPSHOT`), the following properties can be set:
+
+* `isis.service.email.throwExceptionOnFail` +
++
+Whether to throw an exception if there the email cannot be sent (probably because of some misconfiguration).
+This behaviour is (now) the default; the old behaviour (of just returning `false` from the `send()` method) can be re-enabled by setting this property to `false`.
+
 
 
 == Alternative Implementations