You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@jena.apache.org by an...@apache.org on 2018/03/22 17:40:49 UTC

svn commit: r1827518 - in /jena/site/trunk/content/documentation/txn: transactions_api.md txn.md

Author: andy
Date: Thu Mar 22 17:40:49 2018
New Revision: 1827518

URL: http://svn.apache.org/viewvc?rev=1827518&view=rev
Log:
Txn documentation

Modified:
    jena/site/trunk/content/documentation/txn/transactions_api.md
    jena/site/trunk/content/documentation/txn/txn.md

Modified: jena/site/trunk/content/documentation/txn/transactions_api.md
URL: http://svn.apache.org/viewvc/jena/site/trunk/content/documentation/txn/transactions_api.md?rev=1827518&r1=1827517&r2=1827518&view=diff
==============================================================================
--- jena/site/trunk/content/documentation/txn/transactions_api.md (original)
+++ jena/site/trunk/content/documentation/txn/transactions_api.md Thu Mar 22 17:40:49 2018
@@ -3,6 +3,7 @@ Title: Jena Transactions API
 -   [API for Transactions](#api-for-transactions)
     - [Read transactions](#read-transactions)
     - [Write transactions](#write-transactions)
+    - [Transaction promotion](#types-modes-promotion)
 -   [Txn](txn.html) - A higher level API to transactions
 
 ## API for Transactions
@@ -103,7 +104,7 @@ dataset.
             dataset.end() ;
         }
 
-## Transaction Types, Modes and Promotion.
+## Transaction Types, Modes and Promotion. {#types-modes-promotion}
 
 Transaction hava type (enum `TxnType`) and a mode (enum `ReadWrite`).
 `TxnType.READ` and `TxnType.Write` strart the transaction in

Modified: jena/site/trunk/content/documentation/txn/txn.md
URL: http://svn.apache.org/viewvc/jena/site/trunk/content/documentation/txn/txn.md?rev=1827518&r1=1827517&r2=1827518&view=diff
==============================================================================
--- jena/site/trunk/content/documentation/txn/txn.md (original)
+++ jena/site/trunk/content/documentation/txn/txn.md Thu Mar 22 17:40:49 2018
@@ -42,7 +42,7 @@ and
         . . .
     }) ;
 
-## Usage: Read Transactions
+## Usage
 
 This first example shows how to write a SPARQL query .
 
@@ -123,6 +123,11 @@ results needs to be take:
     }) ;
     // use "resultSet"
 
+The functions `Txn.execute` and `Txn.calculate` start `READ_PROMOTE`
+transactions which start in "read" mode but convert to "write" mode if
+needed.  For details of transaction promtion see the
+c[section in the transaction API documentation](transactions_api.html#types-modes-promotion).
+
 ## Working with RDF Models
 
 The unit of transaction is the dataset.  Model in datasets are just views of that dataset.