From: Adam Dickmeiss <adam@indexdata.dk>
Date: Wed, 27 May 2015 10:50:44 +0000 (+0200)
Subject: Document present section in configuration
X-Git-Tag: v0.6~1
X-Git-Url: http://sru.miketaylor.org.uk/cgi-bin?a=commitdiff_plain;h=876978c2d978e86cc7bae354ae356e07a2bf389e;p=mp-sparql-moved-to-github.git

Document present section in configuration
---

diff --git a/doc/filter_sparql.rnc b/doc/filter_sparql.rnc
index 3b6e817..8a644d0 100644
--- a/doc/filter_sparql.rnc
+++ b/doc/filter_sparql.rnc
@@ -3,7 +3,7 @@
 namespace mp = "http://indexdata.com/metaproxy"
 
 filter_sparql =
-  attribute type { "xquery" },
+  attribute type { "sparql" },
   attribute id { xsd:NCName }?,
   attribute name { xsd:NCName }?,
   element mp:defaults {
@@ -20,5 +20,9 @@ filter_sparql =
       attribute type { xsd:string },
       xsd:string
     }*,
+    element mp:present {
+      attribute type { xsd:string },
+      xsd:string
+    }*,
     element mp:modifier { xsd:string }*
   }+
diff --git a/doc/sparql.xml b/doc/sparql.xml
index 8889cc5..afce82b 100644
--- a/doc/sparql.xml
+++ b/doc/sparql.xml
@@ -70,13 +70,24 @@
        Section used to declare RPN use attribute strings (indexes) and map
        them to BIBFRAME graph patterns.
        Items in this section are expanded during RPN query processing and
-       placeholders (%s, %d) are substituted with query terms.
+       placeholders (<literal>%s</literal>, <literal>%d</literal>,
+       <literal>%t</literal>) are substituted with query terms.
        To map a given CQL index (e.g the default keyword index) into
        multiple entity properties, SPARQL constructs like
        `OPTIONAL` or `UNION` could be used.
       </para>
      </listitem>
     </varlistentry>
+    <varlistentry><term>&lt;present type="attribute"/&gt;</term>
+     <listitem>
+      <para>
+       Section used to declare retrieval for a given element-set 
+       (SRU schema). The CDATA is SPARQL where <literal>%u</literal> holds
+       the URI of the record. This can be used to construct the resulting
+       record.
+      </para>
+     </listitem>
+    </varlistentry>
     <varlistentry><term>&lt;modifier/&gt;</term>
      <listitem>
       <para>