Mailing-List: contact commits-help@commonsrdf.incubator.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@commonsrdf.incubator.apache.org
Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
From: stain@apache.org
To: commits@commonsrdf.incubator.apache.org
Date: Fri, 07 Oct 2016 14:22:57 -0000
Message-Id: <3daa9adceed844cfb046b4cc9c36c77d@git.apache.org>
In-Reply-To: <bb94c4f66a1f4d01b000ab74402695de@git.apache.org>
References: <bb94c4f66a1f4d01b000ab74402695de@git.apache.org>
Subject: [44/50] incubator-commonsrdf git commit: avoid javadoc warnings
archived-at: Fri, 07 Oct 2016 14:22:21 -0000

avoid javadoc warnings


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

Branch: refs/heads/master
Commit: a072cb96943bc2d72d905502baa5c1212a10c18e
Parents: edc3036
Author: Stian Soiland-Reyes <stain@apache.org>
Authored: Fri Oct 7 14:25:24 2016 +0100
Committer: Stian Soiland-Reyes <stain@apache.org>
Committed: Fri Oct 7 14:25:24 2016 +0100

----------------------------------------------------------------------
 .../apache/commons/rdf/jena/JenaDataset.java    |  6 ++-
 .../commons/rdf/jena/JenaRDFTermFactory.java    | 41 ++++++++------------
 2 files changed, 20 insertions(+), 27 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-commonsrdf/blob/a072cb96/jena/src/main/java/org/apache/commons/rdf/jena/JenaDataset.java
----------------------------------------------------------------------
diff --git a/jena/src/main/java/org/apache/commons/rdf/jena/JenaDataset.java b/jena/src/main/java/org/apache/commons/rdf/jena/JenaDataset.java
index f312c2a..ad8c0ca 100644
--- a/jena/src/main/java/org/apache/commons/rdf/jena/JenaDataset.java
+++ b/jena/src/main/java/org/apache/commons/rdf/jena/JenaDataset.java
@@ -36,8 +36,10 @@ public interface JenaDataset extends org.apache.commons.rdf.api.Dataset {
 	public DatasetGraph asJenaDatasetGraph();
 	
 	/**
-	 * Return a union graph view of this dataset. <p The <em>union graph</em>
-	 * contains triples in any graph (including the default graph).
+	 * Return a union graph view of this dataset.
+	 * <p>
+	 * The <em>union graph</em> contains triples in any graph (including the
+	 * default graph).
 	 * <p>
 	 * Changes in the union graph are reflected in the Commons RDF dataset and
 	 * vice versa. Triples added to the graph are added to the default graph.

http://git-wip-us.apache.org/repos/asf/incubator-commonsrdf/blob/a072cb96/jena/src/main/java/org/apache/commons/rdf/jena/JenaRDFTermFactory.java
----------------------------------------------------------------------
diff --git a/jena/src/main/java/org/apache/commons/rdf/jena/JenaRDFTermFactory.java b/jena/src/main/java/org/apache/commons/rdf/jena/JenaRDFTermFactory.java
index aa4bacf..8b53c76 100644
--- a/jena/src/main/java/org/apache/commons/rdf/jena/JenaRDFTermFactory.java
+++ b/jena/src/main/java/org/apache/commons/rdf/jena/JenaRDFTermFactory.java
@@ -76,10 +76,13 @@ public final class JenaRDFTermFactory implements RDFTermFactory {
 	/**
 	 * Create a JenaRDFTermFactory.
 	 * <p>
-	 * This constructor will use the specified {@link UUID} as a salt 
-	 * for the purposes of {@link BlankNode} identity.
+	 * This constructor will use the specified {@link UUID} as a salt for
+	 * the purposes of {@link BlankNode} identity, and should only be used in
+	 * cases where predictable and consistent
+	 * {@link BlankNode#uniqueReference()} are important.
 	 * 
-	 * @param salt {@link UUID} to use as salt
+	 * @param salt
+	 *            {@link UUID} to use as salt for {@link BlankNode} equality
 	 */	
 	public JenaRDFTermFactory(UUID salt) {
 		this.salt = salt;
@@ -143,13 +146,10 @@ public final class JenaRDFTermFactory implements RDFTermFactory {
 	 * <p>
 	 * The <em>generalized triple</em> supports any {@link RDFTerm} as its
 	 * {@link TripleLike#getSubject()} {@link TripleLike#getPredicate()} or
-	 * {@link TripleLike#getObject()}, including {@link JenaAny} or
-	 * {@link JenaVariable}.
+	 * {@link TripleLike#getObject()}.
 	 *
 	 * @see #createTriple(BlankNodeOrIRI, IRI, RDFTerm)
 	 * @see #createGeneralizedQuad(RDFTerm, RDFTerm, RDFTerm, RDFTerm)
-	 * @see #createAnyVariable()
-	 * @see #createVariable(String)
 	 * 
 	 * @param subject
 	 *            The subject of the statement
@@ -171,13 +171,10 @@ public final class JenaRDFTermFactory implements RDFTermFactory {
 	 * <p>
 	 * The <em>generalized quad</em> supports any {@link RDFTerm} as its
 	 * {@link QuadLike#getSubject()} {@link QuadLike#getPredicate()},
-	 * {@link QuadLike#getObject()} or {@link QuadLike#getObject()} including
-	 * {@link JenaAny} or {@link JenaVariable}.
+	 * {@link QuadLike#getObject()} or {@link QuadLike#getObject()}.
 	 * 
 	 * @see #createQuad(BlankNodeOrIRI, BlankNodeOrIRI, IRI, RDFTerm)
 	 * @see #createGeneralizedTriple(RDFTerm, RDFTerm, RDFTerm)
-	 * @see #createAnyVariable()
-	 * @see #createVariable(String)
 	 * 
 	 * @param subject
 	 *            The subject of the statement
@@ -212,8 +209,7 @@ public final class JenaRDFTermFactory implements RDFTermFactory {
 	 *            <code>true</code>.
 	 * @return Adapted {@link JenaRDFTerm}
 	 * @throws ConversionException If the {@link Node} can't be represented as an {@link RDFTerm}, e.g.
-	 *             if the node is not {@link Node#isConcrete()},
-	 *             is {@link Node#isVariable()}, or is {@link Node.ANY}
+	 *             if the node is not concrete or represents a variable in Jena.
 	 */
 	public JenaRDFTerm fromJena(Node node) throws ConversionException {
 		return JenaFactory.fromJena(node, getSalt());
@@ -233,9 +229,9 @@ public final class JenaRDFTermFactory implements RDFTermFactory {
 	 * @param node
 	 *            The Jena Node to adapt. It's {@link Node#isConcrete()} must be
 	 *            <code>true</code>.
-	 * @return Adapted {@link RDFTerm}            
-	 * @throws ConversionException
-	 *             if the node is not concrete.
+	 * @return Adapted {@link RDFTerm}
+	 * @throws ConversionException If the {@link Node} can't be represented as an {@link RDFTerm}, e.g.
+	 *             if the node is not concrete or represents a variable in Jena.
 	 */
 	public static RDFTerm fromJena(RDFTermFactory factory, Node node) {
 		if (node == null) {
@@ -288,8 +284,7 @@ public final class JenaRDFTermFactory implements RDFTermFactory {
 	 * Adapt a generalized Jena {@link org.apache.jena.graph.Triple} to a CommonsRDF {@link TripleLike}.
 	 * <p>
 	 * The generalized triple supports any {@link RDFTerm} as its {@link TripleLike#getSubject()}
-	 * {@link TripleLike#getPredicate()} or {@link TripleLike#getObject()}, including 
-	 * the extensions {@link JenaAny} and {@link JenaVariable}.
+	 * {@link TripleLike#getPredicate()} or {@link TripleLike#getObject()}.
 	 * <p>
 	 * If the Jena triple contains any {@link Node#isBlank()}, then any corresponding
 	 * {@link BlankNode} will use a {@link UUID} salt from this
@@ -318,9 +313,7 @@ public final class JenaRDFTermFactory implements RDFTermFactory {
 	 * {@link QuadLike#getGraphName()}, 
 	 * {@link QuadLike#getSubject()}
 	 * {@link QuadLike#getPredicate()} or 
-	 * {@link QuadLike#getObject()}, including 
-	 * the extensions 
-	 * {@link JenaAny} and {@link JenaVariable}. 
+	 * {@link QuadLike#getObject()}. 
 	 * <p>
 	 * If the Jena quad contains any {@link Node#isBlank()}, then any corresponding
 	 * {@link BlankNode} will use a {@link UUID} salt from this
@@ -721,10 +714,8 @@ public final class JenaRDFTermFactory implements RDFTermFactory {
 	 * {@link BlankNode#uniqueReference()} for details.
 	 * <p>
 	 * This salt can be used with the constructor 
-	 * {@link JenaRDFTermFactory#JenaRDFTermFactory(UUID)} or
-	 * methods like {@link #fromJena(Node, UUID)} and 
-	 * {@link #fromJena(org.apache.jena.graph.Triple, UUID)}
-	 * to ensure consistent {@link BlankNode}s. 
+	 * {@link JenaRDFTermFactory#JenaRDFTermFactory(UUID)}
+	 * if consistent or reproducible {@link BlankNode}s are desirable. 
 	 * 
 	 * @return The {@link UUID} used as salt
 	 */