Clarify term and prefix:suffix expansion in the IRIs section.
--- a/spec/latest/json-ld-syntax/index.html Tue Nov 01 14:32:31 2011 -0400
+++ b/spec/latest/json-ld-syntax/index.html Sun Nov 06 18:53:44 2011 -0800
@@ -842,12 +842,13 @@
<li>An <tref>IRI</tref> is generated for the value specified using <code>@type</code>.</li>
<li>An <tref>IRI</tref> is generated for the value specified using the <code>@iri</code>
keyword.</li>
- <li>An <tref>IRI</tref> is generated when there are <code>@coerce</code> rules in
- effect for a key named <code>@iri</code>.</li>
+ <li>An <tref>IRI</tref> is generated for the value of any other key if there are <code>@coerce</code> rules in
+ effect for that key that identify it as a <code>@iri</code>.</li>
</ol>
-<p>IRIs can be expressed directly in the key position like so:
-</p>
+<p>IRIs may be represented as an absolute IRI, a <tref>term</tref>, a <tref>prefix</tref>:suffix construct, or as a value relative to <code>@base</code> or <code>@vocab</code>.</p>
+
+<p>IRIs can be expressed directly in the key position like so:</p>
<pre class="example" data-transform="updateExample">
<!--
@@ -863,7 +864,7 @@
<code>http://xmlns.com/foaf/0.1/name</code> is interpreted as an <tref>IRI</tref>, as
opposed to being interpreted as a string.</p>
-<p>Term expansion occurs for IRIs if a term is defined within the
+<p>Term expansion occurs for IRIs if the value matches a <tref>term</tref> defined within the
<tref>active context</tref>:</p>
<pre class="example" data-transform="updateExample">
@@ -877,7 +878,8 @@
-->
</pre>
-<p><tref>Prefix</tref>es are expanded when used in keys:</p>
+<p><tref>Prefix</tref>es are expanded when if the form of the value is <code>prefix:suffix</code>, and the
+ prefix matches a <tref>term</tref> defined within the <tref>active context</tref>:</p>
<pre class="example" data-transform="updateExample">
<!--
@@ -907,7 +909,7 @@
</pre>
<p>If type coercion rules are specified in the <code>@context</code> for
-a particular vocabulary term, an IRI is generated:</p>
+a particular <tref>term</tref> or property IRI, an IRI is generated:</p>
<pre class="example" data-transform="updateExample">
<!--
@@ -931,8 +933,6 @@
the type coercion rules will transform the value into an IRI when processed
by a JSON-LD Processor</p>
-<p>IRIs may be represented as an absolute IRI, a <tref>term</tref>, a <tref>prefix</tref>:<tref>term</tref> construct, or as a value relative to <code>@base</code> or <code>@vocab</code>.</p>
-
</section>
<section>