[08/41] jena git commit: javadoc comments

[an...@apache.org]

javadoc comments

Project: http://git-wip-us.apache.org/repos/asf/jena/repo
Commit: http://git-wip-us.apache.org/repos/asf/jena/commit/30a044a1
Tree: http://git-wip-us.apache.org/repos/asf/jena/tree/30a044a1
Diff: http://git-wip-us.apache.org/repos/asf/jena/diff/30a044a1

Branch: refs/heads/master
Commit: 30a044a162075f176c89e7b0cbf977cea2e1ffe4
Parents: df45458
Author: Franc\u0327ois-Paul Servant <fp...@semanlink.net>
Authored: Fri May 6 13:46:47 2016 +0200
Committer: Franc\u0327ois-Paul Servant <fp...@semanlink.net>
Committed: Fri May 6 13:46:47 2016 +0200

----------------------------------------------------------------------
 .../jena/riot/writer/TestJsonLDWriter.java      | 29 ++++++++++++++++----
 1 file changed, 24 insertions(+), 5 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/jena/blob/30a044a1/jena-arq/src/test/java/org/apache/jena/riot/writer/TestJsonLDWriter.java
----------------------------------------------------------------------
diff --git a/jena-arq/src/test/java/org/apache/jena/riot/writer/TestJsonLDWriter.java b/jena-arq/src/test/java/org/apache/jena/riot/writer/TestJsonLDWriter.java
index 25b10ff..36d37ae 100644
--- a/jena-arq/src/test/java/org/apache/jena/riot/writer/TestJsonLDWriter.java
+++ b/jena-arq/src/test/java/org/apache/jena/riot/writer/TestJsonLDWriter.java
@@ -41,6 +41,10 @@ import com.github.jsonldjava.utils.JsonUtils;
 
 public class TestJsonLDWriter extends BaseTest {
 
+/**
+ * Checks that JSON-LD RDFFormats supposed to be pretty are pretty
+ * and those supposed to be flat are flat
+ */
 @Test public final void prettyIsNotFlat() {
 	Model m = simpleModel();
 	m.setNsPrefix("ex", "http://www.a.com/foo/");
@@ -67,6 +71,10 @@ public class TestJsonLDWriter extends BaseTest {
 	// JSON_LD FRAME case not tested here, but in testFrames
 }
 
+/**
+ * Checks that JSON-LD RDFFormats that are supposed to return a "&context"
+ * actually do so.
+ */
 @Test public final void contextOrNot() {
 	Model m = simpleModel();
 	m.setNsPrefix("ex", "http://www.a.com/foo/");
@@ -101,8 +109,10 @@ private Model simpleModel() {
 	return m;
 }
 
-// write a model and parse it back: you should get the same thing
-// (except with frame)
+/**
+ * Write a model and parse it back: you should get the same thing
+ * (except with frame)
+ */
 @Test public final void roundTrip() {
 	Model m = simpleModel();
 	m.setNsPrefix("ex", "http://www.a.com/foo/");
@@ -131,7 +141,7 @@ private Model simpleModel() {
 //	RDFDataMgr.write(System.out, m, RDFFormat.JSONLD);
 //}
 
-/** verify that one may pass a context, and that it is used by the output */
+/** verify that one may pass a context, and that it is actually used in the output */
 @Test public void testSettingContext() {
 	// 1) get the context generated by default by jena
 	// for a simple model with a prefix declaration
@@ -176,7 +186,7 @@ private Model simpleModel() {
 
 }
 
-/** verify that one may pass a context, and that it is used by the output */
+/** verify that one may pass a context as a JSON string, and that it is actually used in the output */
 @Test public void testSettingContextAsJsonString() {
 	// 1) get the context generated by default by jena
 	// for a simple model with a prefix declaration
@@ -237,6 +247,9 @@ private Model simpleModel() {
 	assertTrue(m4.isIsomorphicWith(m1));
 }
 
+/**
+ * Checks that one can pass a context defined by its URI
+ */
 @Test public final void testContextByUri() {
 	Model m = ModelFactory.createDefaultModel();
 	String ns = "http://schema.org/";
@@ -313,6 +326,9 @@ java.lang.NoSuchMethodError: org.apache.http.impl.client.cache.CacheConfig.custo
 	// How would we do that?
 }
 
+/**
+ * Checking frames
+ */
 @Test public final void testFrames() throws JsonParseException, IOException {
 	Model m = ModelFactory.createDefaultModel();
 	String ns = "http://schema.org/";
@@ -361,7 +377,10 @@ java.lang.NoSuchMethodError: org.apache.http.impl.client.cache.CacheConfig.custo
 	assertTrue(jsonld.trim().indexOf("\n") < 0);
 }
 
-// cf https://mail-archives.apache.org/mod_mbox/jena-users/201604.mbox/%3c218AC4A3-030B-4248-A7DA-2B2597328242@gmail.com%3e
+/**
+ * There was a problem with props taking a string as value.
+ * cf https://mail-archives.apache.org/mod_mbox/jena-users/201604.mbox/%3c218AC4A3-030B-4248-A7DA-2B2597328242@gmail.com%3e
+ */
 @Test public final void testStringPropsInContext() {
 	Model m = ModelFactory.createDefaultModel();
 	String ns = "http://www.a.com/foo/";