Repository: incubator-commonsrdf
Updated Branches:
  refs/heads/master 3897a582d -> f2de2c507


Markdown links


Project: http://git-wip-us.apache.org/repos/asf/incubator-commonsrdf/repo
Commit: 
http://git-wip-us.apache.org/repos/asf/incubator-commonsrdf/commit/9d5e383a
Tree: http://git-wip-us.apache.org/repos/asf/incubator-commonsrdf/tree/9d5e383a
Diff: http://git-wip-us.apache.org/repos/asf/incubator-commonsrdf/diff/9d5e383a

Branch: refs/heads/master
Commit: 9d5e383a484c1922add3fff0ea358d8c1b3bbd4a
Parents: 0da1972
Author: Stian Soiland-Reyes <st...@apache.org>
Authored: Mon Oct 10 09:03:01 2016 +0100
Committer: Stian Soiland-Reyes <st...@apache.org>
Committed: Mon Oct 10 09:03:12 2016 +0100

----------------------------------------------------------------------
 src/site/markdown/implementations.md | 21 +++++++++++++++------
 1 file changed, 15 insertions(+), 6 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-commonsrdf/blob/9d5e383a/src/site/markdown/implementations.md
----------------------------------------------------------------------
diff --git a/src/site/markdown/implementations.md 
b/src/site/markdown/implementations.md
index 1b06b93..9262996 100644
--- a/src/site/markdown/implementations.md
+++ b/src/site/markdown/implementations.md
@@ -25,11 +25,16 @@ implementations.
 
 The Apache Commons RDF distribution includes bindings for the implementations:
 
-* [Commons RDF Simple](#Commons RDF Simple)
-* [Apache Jena](#Apache Jena)
-* [Eclipse RDF4J](#Apache Jena) (formerly Sesame)
+* [Commons RDF Simple](#Commons-RDF-Simple)
+* [Apache Jena](#Apache-Jena)
+* [Eclipse RDF4J](#Eclipse-RDF4J) (formerly Sesame)
 
-One goal of the Commons RDF API is to enable runtime cross-compatibility of 
such implementations, therefore it is perfectly valid to combine these and for 
instance do:
+In addition there can be [External implementations](#External-implementations)
+which are released separately by their respective projects.
+
+One goal of the Commons RDF API is to enable runtime cross-compatibility
+of its implementations, therefore it is perfectly valid to combine them
+and for instance do:
 
 * Copy triples from a Jena `Model` to an RDF4J `Repository`  (e.g. copying 
between two Common RDF `Graph`s)
 * Create an RDF4J-backed `Quad` that use a Jena-backed `BlankNode`
@@ -151,10 +156,14 @@ try (Stream<RDF4JTriple> s : graph.stream(s,p,o)) {
 ```
 
 This will ensure that the underlying RDF4J 
[RepositoryConnection](http://rdf4j.org/javadoc/latest/org/eclipse/rdf4j/repository/RepositoryConnection.html)
 and 
[RepositoryResult](http://rdf4j.org/javadoc/latest/org/eclipse/rdf4j/repository/RepositoryResult.html)
+are closed after use.
 
-Methods like 
[Graph.add()](apidocs/org/apache/commons/rdf/api/Graph.html#add-org.apache.commons.rdf.api.Triple-)
 will use and close separate transactions per method calls and therefore do not 
need any special handling; however this will come with a performance hit when 
calling graph/dataset methods repeatably. (See 
[COMMONSRDF-45](https://issues.apache.org/jira/browse/COMMONSRDF-45))
+Methods that return directly, like
+[Graph.add()](apidocs/org/apache/commons/rdf/api/Graph.html#add-org.apache.commons.rdf.api.Triple-)
+and [Dataset.size()](apidocs/org/apache/commons/rdf/api/Dataset.html#size--)
+will use and close separate transactions per method calls and therefore do not 
need any special handling; however this will come with a performance hit when 
doing multiple graph/dataset modifications. (See 
[COMMONSRDF-45](https://issues.apache.org/jira/browse/COMMONSRDF-45))
 
-[java.util.Iteratable](http://docs.oracle.com/javase/8/docs/api/java/lang/Iterable.html)
 and 
[java.util.Iterator](http://docs.oracle.com/javase/8/docs/api/java/util/Iterator.html)
 does not extend 
[`AutoClosable`](http://docs.oracle.com/javase/8/docs/api/java/lang/AutoCloseable.html),
 and as there are many ways that a for-each loop may not run to exhaustion, 
Commons RDF introduces 
[ClosableIterable](apidocs/org/apache/commons/rdf/rdf4j/ClosableIterable.html), 
which can be used with RDF4J as:
+Java's 
[java.util.Iteratable](http://docs.oracle.com/javase/8/docs/api/java/lang/Iterable.html)
 and 
[java.util.Iterator](http://docs.oracle.com/javase/8/docs/api/java/util/Iterator.html)
 does not extend 
[`AutoClosable`](http://docs.oracle.com/javase/8/docs/api/java/lang/AutoCloseable.html),
 and as there are many ways that a for-each loop may not run to exhaustion, 
Commons RDF introduces 
[ClosableIterable](apidocs/org/apache/commons/rdf/rdf4j/ClosableIterable.html), 
which can be used with RDF4J as:
 
 ```java
 RDF4JGraph graph; // ...

Reply via email to