Re: clarifying IRI vs URI [was: HP review for LC]

This adequately addresses the comment.

Jeremy

Dan Connolly wrote:
> On Tue, 2007-02-27 at 18:57 +0000, Jeremy Carroll wrote:
>> The version reviewed was: 2007/02/21 16:25:45 number 1.228
> 
>> 1) IRI throughout
>>
>> Globally substitute URI with IRI, and change normative ref
>> to RFC 3986 to RFC 3987.
>>
>> It is highly likely that this suggestion will be made by last call
>> reviewers, so it is better to address the comment before LC.
> 
> OK.
> 
> I did some spelunking and found that both webarch and XML Schema
> predate the IRI spec, and XQuery seems to cite XML Schema for xs:anyURI.
> 
> So I changed the formal occurrences to "IRI", but left many
> of the informal occurrences as "URI", and added a note,
> in the "Resource Descriptions" subsection of the intro, right
> after we make the point about "unambiguous URIs"...
> 
> [[
> Note that GRDDL follows HTML 4, RDF, and XML Schema in using
> Internationalized Resource Identifiers, i.e. IRIs[RFC3987]. While in
> informal usage, this specification uses the more familiar term URI
> interchangeably with the recently standardized term IRI, the formal
> rules use the relevant terms precisely.
> ]]
> 
> Plus, the algorithm for converting a relative reference to absolute
> form is only in RFC 3986, so I kept that ref while adding RFC 3987.
> 
> http://www.w3.org/2004/01/rdxh/spec
> Revision 1.233  2007/03/01 16:50:06  connolly
> cite RFC3987 and specify IRIs, while
> still using "URI" informally
> 
> A complete diffs is attached.
> 
> Murray or Harry, please confirm that these changes are
> consistent with WG expectations. If you need me to follow
> up by phone, I'm happy to do that.
> 
> 
> 
> 
> ------------------------------------------------------------------------
> 
> Index: spec.html
> ===================================================================
> RCS file: /w3ccvs/WWW/2004/01/rdxh/spec.html,v
> retrieving revision 1.232
> retrieving revision 1.233
> diff -u -u -r1.232 -r1.233
> --- spec.html	1 Mar 2007 16:05:08 -0000	1.232
> +++ spec.html	1 Mar 2007 16:50:06 -0000	1.233
> @@ -5,7 +5,7 @@
>  <head>
>    <title>Gleaning Resource Descriptions from Dialects of Languages
>    (GRDDL)</title>
> -  <meta name="RCS-Id" content="$Id: spec.html,v 1.232 2007/03/01 16:05:08 connolly Exp $"/>
> +  <meta name="RCS-Id" content="$Id: spec.html,v 1.233 2007/03/01 16:50:06 connolly Exp $"/>
>    <style type="text/css">
>  .issue {
>    background-color:#dfd;
> @@ -75,10 +75,10 @@
>  
>  <h1>Gleaning Resource Descriptions from Dialects of Languages (GRDDL)</h1>
>  
> -<h2>editor's draft $Date: 2007/03/01 16:05:08 $</h2>
> +<h2>editor's draft $Date: 2007/03/01 16:50:06 $</h2>
>  <dl>
>    <dt>This Version:</dt>
> -    <dd>$Revision: 1.232 $ (a <a href="#changes">change log</a> is appended)
> +    <dd>$Revision: 1.233 $ (a <a href="#changes">change log</a> is appended)
>  </dd>
>    <dt>Latest Stable Published Version:</dt>
>      <dd><a href="http://www.w3.org/TR/grddl/">http://www.w3.org/TR/grddl/</a>
> @@ -307,6 +307,14 @@
>  <p>Both the entities (subject and object resources) and relationships
>  (predicates) are identified using unambiguous URIs.</p>
>  
> +<p><em>Note that GRDDL follows HTML 4, RDF, and XML Schema in using
> +<em>Internationalized Resource Identifiers</em>, i.e. IRIs<a
> +class="norm" href="#rfc3987">[RFC3987]</a>. While in informal usage,
> +this specification uses the more familiar term <q>URI</q>
> +interchangeably with the recently standardized term <q>IRI</q>, the
> +formal rules use the relevant terms precisely.</em>
> +</p>
> +
>  <p>The publishers of the XML above could also provide the same data in
>  RDF using RDF/XML or one of the other RDF syntaxes.
>  GRDDL provides a relatively inexpensive mechanism for bootstrapping
> @@ -374,8 +382,8 @@
>  <p>The general form of associating a GRDDL transformation link with a
>  well-formed XML document is adding to the root element a
>  <code>grddl</code> namespace declaration and a
> -<code>grddl:transformation</code> attribute whose value is a URI
> -reference, or list of URI references, that refer to executable scripts
> +<code>grddl:transformation</code> attribute whose value is an IRI
> +reference, or list of IRI references, that refer to executable scripts
>  or programs which are expected to transform the source document into
>  RDF.  This method is suitable for use with any XML dialects that can
>  accomodate an extra namespace-qualified attribute on the root
> @@ -454,7 +462,7 @@
>  identified<a class="norm" href="#WEBARCH">[WEBARCH]</a> by the
>  absolute form (see section 5.2 Relative Resolution in <a class="norm"
>  href="#rfc3986">[RFC3986]</a>) of <var>REF</var> with respect to the
> -base URI of <var>E</var> is a <dfn>GRDDL transformation</dfn> of
> +base IRI of <var>E</var> is a <dfn>GRDDL transformation</dfn> of
>  <var>N</var>.
>  </td>
>  <td>
> @@ -502,9 +510,9 @@
>  the resource identified by
>  <tt>http://www.w3.org/2001/sw/grddl-wg/td/titleauthor.html</tt>.  Note
>  that this serialization of the graph contains a relative URI reference
> -(in the value of the <tt>rdf:about</tt> attribute).  The base URI for
> -interpretting relative URI references in a serialization of a
> -graph produced by a GRDDL transformation is the URI of the source
> +(in the value of the <tt>rdf:about</tt> attribute).  The base IRI for
> +interpretting relative IRI references in a serialization of a
> +graph produced by a GRDDL transformation is the IRI of the source
>  document.</p>
>  
>  <p>The <tt>glean_title.xsl</tt> resource specifies a function from
> @@ -670,7 +678,7 @@
>  <td class="assertion">
>     If
>  <ul>
> -<li>an information resource <var>NSDOC</var>, identified by a URI
> +<li>an information resource <var>NSDOC</var>, identified by an IRI
>  <var>NS</var> has a <b>GRDDL result</b> that includes a triple
>  whose
>  <ul>
> @@ -821,7 +829,7 @@
>  <code>profile</code> attribute of the <code>head</code> element, and
>  <code>transformation</code> as the value of the <code>rel</code>
>  attribute of a <code>link</code> or <code>a</code> element whose
> -<code>href</code> attribute value is a URI reference that refers to an
> +<code>href</code> attribute value is an IRI reference that refers to an
>  executable script or program which is expected to transform the source
>  document into RDF.  This method is suitable for use
>  with valid XHTML documents which are constrained by an XML DTD.
> @@ -874,7 +882,7 @@
>  <p>An XHTML document may conform to a number of dialects
>  simultaneously and link to more than one GRDDL transformation.  However,
>  since the <code>href</code> attribute of the <code>link</code> and
> -<code>a</code> elements accept only a single URI reference, multiple
> +<code>a</code> elements accept only a single IRI reference, multiple
>  instances of these elements must be used to assert multiple links:</p>
>  
>  <div class="example">
> @@ -910,7 +918,7 @@
>  for each <tt>a</tt> and <tt>link</tt> descendant element <var>E</var>
>  whose <tt>rel</tt> attribute has value <tt>transformation</tt>,
>  the resource identified by the absolute form of the
> -<tt>href</tt> attribute with respect to the base of <var>E</var>
> +<tt>href</tt> attribute with respect to the base IRI of <var>E</var>
>  is a <dfn>GRDDL transformation</dfn> of <var>N</var>.
>  </td>
>  <td>
> @@ -955,7 +963,7 @@
>  token <var>REF</var> in the value of the <tt>profile</tt>
>  attribute of the <tt>head</tt> element <var>E</var>,
>  the absolute form of <var>REF</var> with respect to the
> -base URI of <var>E</var> is a <dfn>metadata profile name</dfn> of
> +base IRI of <var>E</var> is a <dfn>metadata profile name</dfn> of
>  <var>N</var>.
>  </td>
>  <td>
> @@ -1036,7 +1044,7 @@
>  <td class="assertion">
>  If
>  <ul>
> -<li>an information resource <var>PDOC</var>, identified by a URI
> +<li>an information resource <var>PDOC</var>, identified by an IRI
>  <var>PNAME</var> has a <b>GRDDL result</b> that includes a triple
>  whose
>  <ul>
> @@ -1689,6 +1697,11 @@
>  <h3 id="normativeRefs">Normative References</h3>
>  
>  <dl class="bib">
> +<dt id="rfc3987">RFC3987</dt>
> +<dd><cite><a href="http://www.ietf.org/rfc/rfc3987.txt">Internationalized Resource Identifiers (IRIs)</a></cite> Internet RFC 3987 January 2005. Duerst, Suignard
> +</dd>
> +
> +
>  <dt id="rfc3986">RFC3986</dt>
>  <dd><cite><a href="http://gbiv.com/protocols/uri/rev-2002/rfc2396bis.html">Uniform Resource Identifier (URI): Generic Syntax</a></cite> Internet RFC3986 January 2005. Berners-Lee, Fielding, Masinter
>  </dd>
> @@ -2141,6 +2154,10 @@
>  
>  <pre><!-- next line -->
>  $Log: spec.html,v $
> +Revision 1.233  2007/03/01 16:50:06  connolly
> +cite RFC3987 and specify IRIs, while
> +still using "URI" informally
> +
>  Revision 1.232  2007/03/01 16:05:08  connolly
>  let issues list stand as log of changes before LC candidate
>

Received on Thursday, 1 March 2007 17:37:50 UTC