Changes between Version 46 and Version 47 of FCS-Specification-ScrapBook

Timestamp:

02/14/14 13:00:55 (10 years ago)

Author:

oschonef

Comment:

--

FCS-Specification-ScrapBook

@@ -525 +525 @@
 http://repos.example.org/fcs-endpoint?operation=explain&version=1.2&x-clarin-fcs-endpoint-description=true
 }}}
-* HTTP Response: Endpoint -> Client
+* HTTP Response: Endpoint -> Client:
 {{{#!xml
 <?xml version='1.0' encoding='utf-8'?>
@@ -595 +595 @@
 
 === Operation ''searchRetrieve'' ===#searchRetrieve
-The ''searchRetrieve'' operation of the SRU protocol is used for searching in the Resources that are provided by an Endpoint. The SRU protocol defines request and response formats in [#REF_SRU_12 OASIS-SRU-12]. Search result hits are encoded down to a record level, i.e. the `<sru:record>` element, and SRU allows records to be serialized in various formats, so called ''record schemas''. Endpoints `MUST` support the CLARIN-FCS record schema (see [#resultFormat above]). The ''responseItemType'' ("record schema identifier") that `MUST` be used for that for that schema is `http://clarin.eu/fcs/1.0`.
-
-In CLARIN-FCS, each record, i.e. `<sru:record>` element, `MUST` represent exactly ''one hit'' within the Resource. to belong in within the resource fragment.
+The ''searchRetrieve'' operation of the SRU protocol is used for searching in the Resources that are provided by an Endpoint. The SRU protocol defines the serialization of request and response formats in [#REF_SRU_12 OASIS-SRU-12]. In SRU, search result hits are encoded down to a record level, i.e. the `<sru:record>` element, and SRU allows records to be serialized in various formats, so called ''record schemas''.
+
+Endpoints `MUST` support the CLARIN-FCS record schema (see section [#resultFormat Result Format]) and `MUST` use the value `http://clarin.eu/fcs/1.0` for the ''responseItemType'' ("record schema identifier").
+Endpoints `MUST` represent exactly ''one hit'' within the Resource as one SRU record, i.e. `<sru:record>` element.
 
 The following example shows a request and response to an ''searchRetrieve'' request with a ''term-only'' query for "cat":
@@ -604 +605 @@
 http://repos.example.org/fcs-endpoint?operation=searchRetrieve&version=1.2&query=cat
 }}}
-* HTTP Response: Endpoint -> Client
+* HTTP Response: Endpoint -> Client:
 {{{#!xml
 <?xml version='1.0' encoding='utf-8'?>