diff --git a/framework/service/dtd/services.xsd b/framework/service/dtd/services.xsd
index 580466d49a..91606c3427 100644
--- a/framework/service/dtd/services.xsd
+++ b/framework/service/dtd/services.xsd
@@ -86,6 +86,12 @@ under the License.
+
+
+ If set to true and there is no transaction already in place the Service Engine will begin one.
+ If set to false or there is a transaction already in place the Service Engine will do nothing (this also means that if set to false and a transaction is already in place it will do nothing).
+
+
@@ -94,6 +100,13 @@ under the License.
+
+
+ If set to true and there is a transaction already in place the Service Engine will suspend that transaction, begin a new one just for this service, commit or rollback the local transaction when the service is complete, and will resume the original transaction.
+ If set to true and there is no transaction already in place it will just begin a transaction and manage it as would be done for a normal user-transaction=true.
+ If use-transaction=false this setting is ignored.
+
+
@@ -106,6 +119,8 @@ under the License.
Defines the timeout for the transaction, in seconds.
Defaults to the value set in the TransactionFactory being used (typically 60 seconds).
+ This value is only used if this service begins a transaction (either require-new-transaction=true, or use-transaction=true and there is no other transaction already in place).
+ If use-transaction=false this setting is ignored.