Add a description for expandContext as being an IRI relative to the containing manifest.

For #369.

Author: gkellogg

tests/README.md

@@ -18,6 +18,9 @@ Tests driven from a top-level [manifest](manifest.jsonld) and are defined into [
 * [expand](expand-manifest.jsonld) tests have _input_ and _expected_ documents.
   The _expected_ results can be compared using [JSON-LD object comparison](#json-ld-object-comparison) with the processor output.
 
+  Expansion tests may have a `expandContext` option, which is treated
+  as an IRI relative to the manifest.
+
   For *NegativeEvaluationTests*, the result is a string associated with the expected error code.
 * [html](html.jsonld) tests have _input_ and _expected_ documents and an optional _context_ document.
   The _expected_ results can be compared using [JSON-LD object comparison](#json-ld-object-comparison) with the processor output
@@ -46,6 +49,9 @@ Tests driven from a top-level [manifest](manifest.jsonld) and are defined into [
 * [toRdf](toRdf-manifest.jsonld) tests have _input_ and _expected_ documents.
   The _expected_ results can be compared using [RDF Dataset Isomorphism](https://www.w3.org/TR/rdf11-concepts/#dfn-dataset-isomorphism).
 
+  ToRdf tests may have a `expandContext` option, which is treated
+  as an IRI relative to the manifest.
+
 Unless `processingMode` is set explicitly in a test entry, `processingMode` is compatible with both `json-ld-1.0` and `json-ld-1.1`.
 
 Test results that include a context input presume that the context is provided locally, and not from the referenced location, thus the results will include the content of the context file, rather than a reference.

tests/expand-manifest.html

@@ -32,6 +32,9 @@ <h3><a href="expand-manifest.jsonld">expand</a> tests have <em>input</em> and <e
 
 <p>The <em>expected</em> results can be compared using <a href="#json-ld-object-comparison">JSON-LD object comparison</a> with the processor output.</p>
 
+<p>Expansion tests may have a <code>expandContext</code> option, which is treated
+as an IRI relative to the manifest.</p>
+
 <p>For <em>NegativeEvaluationTests</em>, the result is a string associated with the expected error code.</p>
 <p>Unless <code>processingMode</code> is set explicitly in a test entry, <code>processingMode</code> is compatible with both <code>json-ld-1.0</code> and <code>json-ld-1.1</code>.</p>
 

tests/html-manifest.html

@@ -37,6 +37,9 @@ <h3><a href="expand-manifest.jsonld">expand</a> tests have <em>input</em> and <e
 
 <p>The <em>expected</em> results can be compared using <a href="#json-ld-object-comparison">JSON-LD object comparison</a> with the processor output.</p>
 
+<p>Expansion tests may have a <code>expandContext</code> option, which is treated
+as an IRI relative to the manifest.</p>
+
 <p>For <em>NegativeEvaluationTests</em>, the result is a string associated with the expected error code.</p>
 <h3><a href="html.jsonld">html</a> tests have <em>input</em> and <em>expected</em> documents and an optional <em>context</em> document.</h3>
 

tests/manifest.html

@@ -37,6 +37,9 @@ <h3><a href="expand-manifest.jsonld">expand</a> tests have <em>input</em> and <e
 
 <p>The <em>expected</em> results can be compared using <a href="#json-ld-object-comparison">JSON-LD object comparison</a> with the processor output.</p>
 
+<p>Expansion tests may have a <code>expandContext</code> option, which is treated
+as an IRI relative to the manifest.</p>
+
 <p>For <em>NegativeEvaluationTests</em>, the result is a string associated with the expected error code.</p>
 <h3><a href="html.jsonld">html</a> tests have <em>input</em> and <em>expected</em> documents and an optional <em>context</em> document.</h3>
 
@@ -70,6 +73,9 @@ <h3><a href="toRdf-manifest.jsonld">toRdf</a> tests have <em>input</em> and <em>
 <p>Some tests require the use of <a href="https://tools.ietf.org/html/draft-rundgren-json-canonicalization-scheme-05">JSON Canonicalization Scheme</a> to properly generate RDF Literals from JSON literal values. This algorithm is non-normative, but is assumed to be used to properly compare results. These tests are marked using the <code>useJCS</code> option.</p>
 
 <p>The <em>expected</em> results can be compared using <a href="https://www.w3.org/TR/rdf11-concepts/#dfn-dataset-isomorphism">RDF Dataset Isomorphism</a>.</p>
+
+<p>ToRdf tests may have a <code>expandContext</code> option, which is treated
+as an IRI relative to the manifest.</p>
 <p>Unless <code>processingMode</code> is set explicitly in a test entry, <code>processingMode</code> is compatible with both <code>json-ld-1.0</code> and <code>json-ld-1.1</code>.</p>
 
 <p>Test results that include a context input presume that the context is provided locally, and not from the referenced location, thus the results will include the content of the context file, rather than a reference.</p>

tests/remote-doc-manifest.html

@@ -32,6 +32,9 @@ <h3><a href="expand-manifest.jsonld">expand</a> tests have <em>input</em> and <e
 
 <p>The <em>expected</em> results can be compared using <a href="#json-ld-object-comparison">JSON-LD object comparison</a> with the processor output.</p>
 
+<p>Expansion tests may have a <code>expandContext</code> option, which is treated
+as an IRI relative to the manifest.</p>
+
 <p>For <em>NegativeEvaluationTests</em>, the result is a string associated with the expected error code.</p>
 <h3><a href="remote-doc-manifest.jsonld">remote-doc</a> tests have <em>input</em> and <em>expected</em> documents.</h3>
 

tests/template.haml

@@ -42,6 +42,9 @@
 
         The _expected_ results can be compared using [JSON-LD object comparison](#json-ld-object-comparison) with the processor output.
 
+        Expansion tests may have a `expandContext` option, which is treated
+        as an IRI relative to the manifest.
+
         For *NegativeEvaluationTests*, the result is a string associated with the expected error code.
 
     - if manifest['sequence'].first.is_a?(String) || manifest['sequence'].any? {|te| te['@type'].include?('jld:HtmlTest')}
@@ -89,6 +92,9 @@
 
         The _expected_ results can be compared using [RDF Dataset Isomorphism](https://www.w3.org/TR/rdf11-concepts/#dfn-dataset-isomorphism).
 
+        ToRdf tests may have a `expandContext` option, which is treated
+        as an IRI relative to the manifest.
+
     :markdown
       Unless `processingMode` is set explicitly in a test entry, `processingMode` is compatible with both `json-ld-1.0` and `json-ld-1.1`.