[07/13] incubator-commonsrdf git commit: COMMONSRDF-6 clean up createBlankNode(String)

[st...@apache.org]

COMMONSRDF-6 clean up createBlankNode(String)

Clarify that they MUST be different for other `name` parameter.

I added that they also must be different from createBlankNode(),
note that this means implementations can't support (through this method
at least) equivalent cloning using
createBlankNode(bnode.uniqueReference())


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

Branch: refs/heads/master
Commit: 656022aaf7df51a7385bafe6246aa4e1ac894d45
Parents: 5be69eb
Author: Stian Soiland-Reyes <st...@apache.org>
Authored: Wed Apr 29 10:29:37 2015 +0100
Committer: Stian Soiland-Reyes <st...@apache.org>
Committed: Wed Apr 29 10:29:37 2015 +0100

----------------------------------------------------------------------
 .../org/apache/commons/rdf/api/RDFTermFactory.java     | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-commonsrdf/blob/656022aa/api/src/main/java/org/apache/commons/rdf/api/RDFTermFactory.java
----------------------------------------------------------------------
diff --git a/api/src/main/java/org/apache/commons/rdf/api/RDFTermFactory.java b/api/src/main/java/org/apache/commons/rdf/api/RDFTermFactory.java
index bcba337..2ba4e0e 100644
--- a/api/src/main/java/org/apache/commons/rdf/api/RDFTermFactory.java
+++ b/api/src/main/java/org/apache/commons/rdf/api/RDFTermFactory.java
@@ -56,12 +56,13 @@ public interface RDFTermFactory {
     /**
      * Create a blank node based on the given name.
      * <p>
-     * For a particular instance of <code>RDFTermFactory</code>, all
-     * {@link BlankNode}s created using this method with the same
-     * <code>name</code> parameter MUST be equivalent according to
-     * {@link BlankNode#equals(Object)},
-     * The returned BlankNode MUST NOT be equal to any other
-     * <code>BlankNode</code> instances returned from this instance.
+     * All {@link BlankNode}s created with the given <code>name</code>
+     * <em>on a particular instance</em> of <code>RDFTermFactory</code> MUST be
+     * equivalent according to {@link BlankNode#equals(Object)},
+     * <p>
+     * The returned BlankNode MUST NOT be equal to <code>BlankNode</code>
+     * instances returned for any other <code>name</code> or those returned from
+     * {@link #createBlankNode()}.
      * <p>
      * The returned BlankNode SHOULD NOT be equivalent to any BlankNodes created
      * on a <em>different</em> <code>RDFTermFactory</code> instance, e.g.