Index: spec.html
===================================================================
RCS file: /w3ccvs/WWW/2004/01/rdxh/spec.html,v
retrieving revision 1.254
retrieving revision 1.257
diff -u -u -r1.254 -r1.257
--- spec.html	24 Apr 2007 05:22:45 -0000	1.254
+++ spec.html	26 Apr 2007 23:03:29 -0000	1.257
@@ -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.254 2007/04/24 05:22:45 connolly Exp $"/>
+  <meta name="RCS-Id" content="$Id: spec.html,v 1.257 2007/04/26 23:03:29 connolly Exp $"/>
   <style type="text/css">
 .issue {
   background-color:#dfd;
@@ -75,14 +75,14 @@
 
 <h1>Gleaning Resource Descriptions from Dialects of Languages (GRDDL)</h1>
 
-<h2>editor's draft $Date: 2007/04/24 05:22:45 $</h2>
+<h2>editor's draft $Date: 2007/04/26 23:03:29 $</h2>
 <dl>
   <dt>This Version:</dt>
-    <dd>$Revision: 1.254 $ (a <a href="#changes">change log</a> is appended)
+    <dd>$Revision: 1.257 $ (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>
-      24 Oct 2006
+      2 March 2007
 </dd>
   <dt>Editor:</dt>
     <dd><a
@@ -117,7 +117,10 @@
 <p>A corresponding <a href="#usecases">GRDDL Use Case Working
 Draft</a> provides motivating examples.  A <a href="#primer">GRDDL
 Primer</a> demonstrates the mechanism on XHTML documents which include
-widely-deployed dialects known as microformats.
+widely-deployed dialects known as microformats. A
+<a href="#GRDDL-TESTS">GRDDL Test Cases</a> document illustrates
+specific issues in this design and provides materials to
+aid in test-driven development of GRDDL-aware agents.
 </p>
 
 </div>
@@ -142,9 +145,12 @@
 A few <span class="ed">editorial notes and TODOs in this style</span>
 remain.</p>
 
-<p class="ed">An <a href="spec_lean">extract of normative material
-only</a> has been put on hold for the next release. It may be resumed
-for future releases.
+<p><span class="assertion" id="sotd_ex">Normative assertions are
+marked up in this way.</span>
+<span class="ed">Each assertion bears an ID. An index of rules would
+be nice to have; in the interest of stability, the editor is not
+adding it just yet.  An <a href="spec_lean">extract of normative
+material only</a> has been put on hold indefinitely.</span>
 </p>
 
 
@@ -404,7 +410,7 @@
 
 <h4 id="intro_testcases">GRDDL Test Cases</h4>
 
-<p>The GRDDL Test Cases<a class="norm" href="#GRDDL-TESTS">[GRDDL-TESTS]</a>
+<p>The GRDDL Test Cases<a class="inform" href="#GRDDL-TESTS">[GRDDL-TESTS]</a>
 provides a collection of tests illustrating this specification.
 Some of the tests may help clarify the intended
 reading of the normative text.</p>
@@ -478,7 +484,7 @@
   <th>Normative Statement</th><th>Mechanical Rule<br />(Informative)</th>
 </tr>
 <tr>
-<td class="assertion">
+<td class="assertion" id="rule_GRDDL_transformation">
 Given an XPath<a href="#XPATH">[XPATH]</a> root
 node <var>N</var> with root element <var>E</var>,
 if the expression
@@ -498,8 +504,8 @@
 of <var>E</var> is a <dfn>GRDDL transformation</dfn> of
 <var>N</var>.
 
-<p>
-<dfn id="stok">Space-separated tokens</dfn> are the maximal non-empty
+<p id="stok">
+<dfn>Space-separated tokens</dfn> are the maximal non-empty
 subsequences not containing the whitespace characters #x9, #xA, #xD or
 #x20.
 </p>
@@ -564,7 +570,7 @@
 
 <table border="1">
 <tr>
-<td class="assertion">
+<td class="assertion" id="rule_result">
 If an information resource(<a class="norm" href="#WEBARCH">[WEBARCH]</a>,
 section 2.2) <var>IR</var>
 is represented by an XML document with
@@ -608,7 +614,7 @@
 
 <table border="1">
 <tr>
-<td class="assertion">
+<td class="assertion" id="rule_merge">
 If <var>F</var> and <var>G</var> are <b>GRDDL results</b> of <var>IR</var>,
 then the 
 <a class="norm"
@@ -656,9 +662,10 @@
 but the fixrefs.xsl script doesn't grok citing the
 same document both normatively and informatively. -->
 
-<p>To associate a GRDDL transformation with a whole dialect, have the
-namespace document include the
-<code>grddl:namespaceTransformation</code> property.</p>
+<p>To associate a GRDDL transformation with a whole dialect, include
+a <code>grddl:namespaceTransformation</code> property in a GRDDL
+result of the namespace document.</p>
+
 <p id="sec_rdf_nsdoc">For example, consider this privacy policy written in P3Q, a
 contrived analog to P3P<a href="#P3P">[P3P]</a>:</p>
 
@@ -715,7 +722,7 @@
 </tr>
 
 <tr>
-<td class="assertion">
+<td class="assertion" id="rule_nstx">
    If
 <ul>
 <li>an information resource <var>NSDOC</var>, identified by an IRI
@@ -773,7 +780,7 @@
 </tr>
 
 <tr>
-<td class="assertion">
+<td class="assertion" id="rule_rdfxbase">
 If an information resource <var>IR</var> is represented
 by a 
 <a class="norm" href="http://www.w3.org/TR/2004/REC-rdf-syntax-grammar-20040210/#dfn-conforming-rdf-xml-document">conforming RDF/XML document</a><a href="#RDFX">[RDFX]</a>,
@@ -804,7 +811,7 @@
 "http://www.w3.org/TR/2004/REC-rdf-syntax-grammar-20040210/#start"
 >7.2.1 Grammar start</a> of <a href="#RDFX">[RDFX]</a> leaves open
 "other means" by which an RDF/XML document may be identified.  For the
-purposes of the rule above, root element whose local name is
+purposes of the rule above, a root element whose local name is
 <code>RDF</code> and whose namespace URI is
 <code>http://www.w3.org/1999/02/22-rdf-syntax-ns#</code> is such a
 means. For a case in point, see the <a href=
@@ -959,14 +966,9 @@
 
 <p>The general rule is:</p>
 <table border="1">
-<tr><td class="assertion">
-Given an XHTML family document<a class="norm" href="#XHTML">[XHTML]</a>
-<em class="ed">@@too strict? see
-<a href="http://lists.w3.org/Archives/Public/public-grddl-wg/2007Apr/0140.html" >Invalid XHTML</a> thread 23 Apr
-</em>
-with XPath root
-node <var>N</var>, if
-<var>N</var> has <em>metdata profile name</em>
+<tr><td class="assertion" id="rule_tlrel">
+Given XPath root node <var>N</var>, if
+<var>N</var> has <a href="#rule_metadata_profile_name">metadata profile name</a>
 <tt>http://www.w3.org/2003/g/data-view</tt>, then
 
 for each <tt>a</tt> and <tt>link</tt> descendant element <var>E</var>
@@ -986,7 +988,7 @@
 <pre>
 ?N gspec:profileName "http://www.w3.org/2003/g/data-view".
 (?N
-""".//*[namespace-name()="http://www.w3.org/1999/xhtml" and
+""".//*[namespace-uri()="http://www.w3.org/1999/xhtml" and
         (local-name() = "a"
          or local-name() = "link")"""
 ) gspec:xpath ?E.
@@ -995,7 +997,7 @@
 (?E_REL "[ \t\r\n]+") fn:tokenize [
  list:member "transformation" ].
 (?E "@href") gspec:xpath [ fn:string ?T_REF ].
-?E fn:base-uri ?BASE.
+?E gspec:htmlBase ?BASE.
 (?T_REF ?BASE) fn:resolve-uri ?TURI.
 ?T log:uri ?TURI.
 </pre>
@@ -1015,16 +1017,24 @@
 </tr>
 </table>
 
-<p class="ed">@@cite <a
+<p>Note that the base IRI of an element node in an XHTML document may
+be influenced by factors such as a <a
+href="http://www.w3.org/TR/1999/REC-html401-19991224/struct/links.html#edef-BASE"><tt>base</tt>
+element</a><a class="norm" href="#HTML4">[HTML4]</a> <a
+href="http://gbiv.com/protocols/uri/rev-2002/rfc2396bis.html#base-retrieval">Retrieval
+URI</a><a href="#rfc3986">RFC3986</a>, etc. See test cases such as <a
 href="http://www.w3.org/2001/sw/grddl-wg/td/grddl-tests#htmlbase1">htmlbase1</a>
-to clarify?</p>
+for further clarification.</p>
 
-<p>This rule depends on the following formalization of 
+<p>The rule above depends on the following formalization of 
 metadata profiles in XHTML:</p>
 
 <table border="1">
-<tr><td class="assertion">
-Given an XPath root node <var>N</var> of an XHTML document,
+<tr><td class="assertion" id="rule_metadata_profile_name">
+Given an XPath root node <var>N</var> of an XHTML document
+(that is, an XML document whose root element has
+a local name of <tt>html</tt> and a namespace name of
+<tt>http://www.w3.org/1999/xhtml</tt>)
 for each <a href="#stok">space-separated
 token</a> <var>REF</var> in the value of the <tt>profile</tt>
 attribute<a class="norm" href="#HTML4">[HTML4]</a>
@@ -1040,9 +1050,9 @@
 (?N
  """
 *[local-name()="html" and
-  namespace-name()="http://www.w3.org/1999/xhtml"] /
+  namespace-uri()="http://www.w3.org/1999/xhtml"] /
  *[local-name()="head" and
-   namespace-name()="http://www.w3.org/1999/xhtml"]""")
+   namespace-uri()="http://www.w3.org/1999/xhtml"]""")
  gspec:xpath ?E.
 (?E "@profile") gspec:xpath [ fn:string ?V ].
 ?E fn:base-uri ?BASE.
@@ -1082,10 +1092,9 @@
 This very powerful and flexible mechanism integrates well with 
 <a class="inform" href="http://microformats.org/wiki/faqs-for-rdf#Are_there_Schemas_for_Microformats.3F">microformat profiles</a><a class="inform" href="#MF-RDF-FAQ">[MF-RDF-FAQ]</a> which overlay the normally semantically-poor HTML markup.</p>
 
-<p>The following diagram illustrates an XFN document,
-<tt>friends.html</tt> associated with
-the <tt>grokXFN.xsl</tt> transformation indirectly
-via an XFN profile.
+<p>The following diagram illustrates an XFN document<a class="inform"
+href="#XFN">[XFN]</a>, <tt>friends.html</tt> associated with the
+<tt>grokXFN.xsl</tt> transformation indirectly via an XFN profile.
 </p>
 
 <div class="illustration">
@@ -1108,7 +1117,7 @@
 
 <table border="1">
 <tr>
-<td class="assertion">
+<td class="assertion" id="rule_profiletrans">
 If
 <ul>
 <li>an information resource <var>PDOC</var>, identified by an IRI
@@ -1181,7 +1190,7 @@
 
 <table border="1">
 <tr>
-<td class="assertion">
+<td class="assertion" id="rule_txprop">
 If
 <ul>
 <li><var>RDFXML</var> is the root XPath node of a
@@ -1312,7 +1321,7 @@
 
 <div><h2 id="sec_agt"><span class="gen">7. </span>GRDDL-Aware Agents</h2>
 
-<p class="assertion">A <dfn id="GRDDL_aware_agent">GRDDL-aware
+<p class="assertion" id="GRDDL_aware_agent">A <dfn>GRDDL-aware
 agent</dfn> is a software module that computes <b>GRDDL results</b> of
 information resources.</p>
 
@@ -1324,7 +1333,7 @@
 than in the query service case.
 </p>
 
-<div class="assertion">
+<div class="assertion" id="agt_obl">
 <p>Subject to <a href="#sec">security considerations</a> below and 
 local policy as expressed in its configuration,
 given a URI <var>I</var> of an information resource <var>IR</var>, and
@@ -1783,7 +1792,7 @@
 </blockquote>
 
 <p>The namespace document includes RDF data about the terms in the
-GRDDL Vocuabulary, but these RDF data do not include any triples whose
+GRDDL Vocabulary, but these RDF data do not include any triples whose
 predicate is <tt>grddl:profileTransformation</tt>.</p>
 
 </div>
@@ -1794,16 +1803,6 @@
 <h3 id="normativeRefs">Normative References</h3>
 
 <dl class="bib">
-  <dt>
-    <a name="GRDDL-TESTS" id="GRDDL-TESTS">GRDDL-TESTS</a>
-  </dt>
-  <dd>
-    <cite>
-      <a href="http://www.w3.org/TR/2007/WD-grddl-tests-20070328/">GRDDL Test Cases</a>
-      </cite>, C. Ogbuji,  Editor, W3C Working Draft (work in progress), 28 March 2007, http://www.w3.org/TR/2007/WD-grddl-tests-20070328/ . <a href="http://www.w3.org/TR/grddl-tests/"
-      title="Latest version of GRDDL Test Cases">Latest version</a> available at http://www.w3.org/TR/grddl-tests/ .</dd>
-      
-
 <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>
@@ -1935,30 +1934,49 @@
       http://www.w3.org/TR/grddl-scenarios/ .
   </dd>
 
-  <dt id="SPARQL">SPARQL</dt>
+  <dt>
+    <a name="GRDDL-TESTS" id="GRDDL-TESTS">GRDDL-TESTS</a>
+  </dt>
   <dd>
-    <cite><a href=
-    "http://www.w3.org/TR/2006/WD-rdf-sparql-query-20061004/ ">SPARQL
-    Query Language for RDF</a> </cite>, A. Seaborne, E. Prud'hommeaux,
-    Editors, W3C Working Draft (work in progress), 4 October 2006,
-    http://www.w3.org/TR/2006/WD-rdf-sparql-query-20061004/ . <a
-    href="http://www.w3.org/TR/rdf-sparql-query/" title="Latest
-    version of SPARQL Query Language for RDF">Latest version</a>
-    available at http://www.w3.org/TR/rdf-sparql-query/ .
-  </dd>
+    <cite>
+      <a href="http://www.w3.org/TR/2007/WD-grddl-tests-20070328/">GRDDL Test Cases</a>
+      </cite>, C. Ogbuji,  Editor, W3C Working Draft (work in progress), 28 March 2007, http://www.w3.org/TR/2007/WD-grddl-tests-20070328/ . <a href="http://www.w3.org/TR/grddl-tests/"
+      title="Latest version of GRDDL Test Cases">Latest version</a> available at http://www.w3.org/TR/grddl-tests/ .</dd>
+      
+
+  <dt id="SPARQL">SPARQL</dt>
+         <dd>
+            <cite>
+               <a href="http://www.w3.org/TR/2007/WD-rdf-sparql-query-20070326/">SPARQL Query Language for RDF</a>
+            </cite>, E. Prud'hommeaux, A. Seaborne,  Editors, W3C Working Draft (work in progress), 26 March 2007, http://www.w3.org/TR/2007/WD-rdf-sparql-query-20070326/ . <a href="http://www.w3.org/TR/rdf-sparql-query/"
+               title="Latest version of SPARQL Query Language for RDF">Latest version</a> available at http://www.w3.org/TR/rdf-sparql-query/ .</dd>
+
  
 <dt>
-<a name="XSLT2" id="XSLT2">XSLT2</a>
-</dt>
-<dd>
-<cite>
-<a href="http://www.w3.org/TR/2005/WD-xslt20-20050211/">XSL Transformations (XSLT) Version 2.0</a>
-</cite>, M. Kay,  Editor, W3C Working Draft (work in progress), 11 February 2005, http://www.w3.org/TR/2005/WD-xslt20-20050211/ . <a href="http://www.w3.org/TR/xslt20">Latest version</a> available at http://www.w3.org/TR/xslt20 .</dd>
+            <a name="XSLT2" id="XSLT20">XSLT2</a>
+
+         </dt>
+         <dd>
+            <cite>
+               <a href="http://www.w3.org/TR/2007/REC-xslt20-20070123/">XSL Transformations (XSLT) Version 2.0</a>
+            </cite>, M. Kay,  Editor, W3C Recommendation, 23 January 2007, http://www.w3.org/TR/2007/REC-xslt20-20070123/ . <a href="http://www.w3.org/TR/xslt20"
+               title="Latest version of XSL Transformations (XSLT) Version 2.0">Latest version</a> available at http://www.w3.org/TR/xslt20 .</dd>
+
+
 <dt id="RFC2731">RFC2731</dt>
 <dd>J. Kunze <cite><a
 href="http://www.ietf.org/rfc/rfc2731.txt">Encoding Dublin Core
 Metadata in HTML</a></cite>  in 1999</dd>
 
+<dt id="XFN">XFN</dt>
+
+<dd>
+<cite><a href="http://gmpg.org/xfn/intro">XFN: Introduction and
+Examples</a>
+</cite>
+copyright GMPG 2003-2007. Eric, Tantek, and Matt
+</dd>
+
 <dt id="DCRDF">DCRDF</dt>
 <dd><cite><a href="http://dublincore.org/documents/2002/07/31/dcmes-xml/">Expressing Simple Dublin Core in RDF/XML</a></cite>
 Beckett, Miller, Brickley 2002-07-31</dd>
@@ -1995,7 +2013,7 @@
 
 </div>
 
-<div><h2 id="stylepi">Appendix: Transformations for Styling versus data extraction</h2>
+<div><h2 id="stylepi">Appendix: Transformations for Styling versus data extraction (Informative)</h2>
 
 <p>The xml-stylesheet processing instruction<a class="inform"
 href="#STYPI">[STYPI]</a> is generally deployed for automated
@@ -2005,7 +2023,6 @@
 is not supported by XML tools such as XSLT processors, and grounding
 processing instructions in URI space is not as straightforward as
 using namespaces with attributes.
-<em class="ed">@@todo: integrate <a href="http://lists.w3.org/Archives/Public/public-grddl-wg/2007Apr/0019.html">suggestion by chime</a></em>
 </p>
 </div>
 
@@ -2233,12 +2250,43 @@
 draft</a>. The <a href="#issues">issues list above</a> shows the major
 design decisions since then.</p>
 
-<p>Changes since Revision 1.228, the last-call candidate from our
-<a href="http://lists.w3.org/Archives/Public/public-grddl-wg/2007Feb/att-0204/21-grddl-wg-minutes.html#item04">2007-02-21 discussion</a>
-and <a href="http://www.w3.org/2007/02/28-grddl-wg-minutes.html#item06">2007-02-28 decision</a> are as follows:</p>
+<p>Changes since the 2 March 2007 release are as follows:</p>
 
 <pre><!-- next line -->
 $Log: spec.html,v $
+Revision 1.257  2007/04/26 23:03:29  connolly
+- in response to <a href="http://lists.w3.org/Archives/Public/public-grddl-comments/2007AprJun/0003">Beckett 4 Apr</a>:
+
+-- noted in SOTD that normative assertions are marked up
+   distinctively, to clarify that the long example is informative.
+   Marked "Styling versus..." appendix as informative
+
+-- rephrased confusing sentence about associating a GRDDL
+   transformation with a whole dialect
+
+-- fixed spelling of Vocabulary
+
+- trimmed changelog
+
+Revision 1.256  2007/04/26 22:48:53  connolly
+cite XFN informatively
+update citations for XSLT2, SPARQL
+
+Revision 1.255  2007/04/26 15:47:24  connolly
+- per <a href="http://lists.w3.org/Archives/Public/public-grddl-wg/2007Apr/att-0212/2007_04_25-grddl-minutes.html">24 Apr minutes</a>:
+-- RESOLVED: that the premise of <a href="#rule_tlrel">the rel="transform" rule</a> depend only on (a) XML-wf-ness (b) root element name "html", (c) root element namespace http://www.w3.org/1999/xhtml
+-- ACTION: DanC to yes, cite htmlbase1 to clarify "base IRI of E" in the case of XHTML
+--- replaced fn:base-uri with gspec:htmlBase in mechanical rules [untested]
+-- ACTION: DanC to add test cases to spec abstract
+-- ACTION: DanC to demote test citation to informative
+-- ACTION: DanC to s/metdata/metadata/
+
+- use namespace-uri() XPath function in mechanical rules,
+  replacing bogus namespace-name() [insufficiently tested. oh well.]
+
+- added an ID for reach rule and normative assertion
+- tweaked editor's draft status a bit (postponed an index of rules/assertions)
+
 Revision 1.254  2007/04/24 05:22:45  connolly
 todo += more XHTML than just DTD-valid, base in XHTML
 
@@ -2323,62 +2371,6 @@
 Revision 1.237  2007/03/02 03:59:52  connolly
 in namespace document excerpt, it's rdf:Property not rdfs:Property
 
-Revision 1.236  2007/03/01 22:04:53  connolly
-link checker found a stray reference to HTTP link section
-and a goofy anchor in the issues list
-
-Revision 1.235  2007/03/01 18:15:17  connolly
-2007 copyright
-id on profile rules heading
-
-Revision 1.234  2007/03/01 17:27:07  connolly
-- no special-case needed in the profileTransformation rule,
-  but the "GRDDL vocabulary" section promises there are none
-  in the GRDDL profile.
-  (see jjc's 28 Feb 2007 14:11:41 +0000 in reply to dajobe)
-
-- resolved remaining @@s by moving them to the test materials
-  or to the status section:
--- normative-only extract removed from TOC
--- notes on implementations moves from an appendix to status section
--- mechanical rules appendix got some review, so it stays
-
-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
-
-Revision 1.231  2007/03/01 13:02:08  connolly
-note #issue-conformance-labels closed
-sort issues by closed date
-
-Revision 1.230  2007/03/01 12:52:12  connolly
-take out HTTP link section, reference to Link/Profile draft,
-per WG decision 28 Feb
-
-Revision 1.229  2007/03/01 12:37:41  connolly
-- security section wordsmithing by Murray
-(following comments of Wed, 21 Feb 2007 16:12:09 -0500)
-but retaining "off-the-shelf" as per
-jjc (in a messge that I can't seem to find now)
-
--- s/transform/transformation/
-
-- in GRDDL-Aware Agents section:
--- add missing comma
--- replace unclear 'steps 4 and 5' with 'discovery by...'
-
-- wordsmith 'no clear mechanism' para in intro
-
-- in protocol trace section: s/appendix/example/
-
-- 'identifiable' spelling fix
-
-Revision 1.228  2007/02/21 16:25:45  connolly
-revise "Apply each transformation" point
-
 </pre>
 </div>
 </body>

