From 8010ebca66a1ba04c1e7517364d16be7434cc25c Mon Sep 17 00:00:00 2001 From: Adam Dickmeiss Date: Wed, 30 Oct 2013 13:23:33 +0100 Subject: [PATCH 1/1] Beginnings of sorting chapter --- doc/tools.xml | 39 +++++++++++++++++++++++++++++++++++++++ doc/yaz-client-man.xml | 4 ++-- 2 files changed, 41 insertions(+), 2 deletions(-) diff --git a/doc/tools.xml b/doc/tools.xml index d19faf9..7310987 100644 --- a/doc/tools.xml +++ b/doc/tools.xml @@ -2511,6 +2511,45 @@ int cql_transform_rpn2cql_wrbuf(cql_transform_t ct, + Sorting + + This chapter describes sorting and how it is supported in YAZ. + Sorting applies to a result-set. + The + Z39.50 sorting facility + + takes one or more input result-sets + and one result-set as output. The most simple case is that + the input-set is the same as the output-set. + + + Z39.50 sorting has a separate APDU (service) that is, thus, performed + following a search (two phases). + + + In SRU/Solr, however, the model is different. Here, sorting is specified + during the the search operation. Note, however, that SRU might + perform sort as separate search, by referring to an existing result-set + in the query (result-set reference). + + Using the Z39.50 sort service + + yaz-client and the ZOOM API supports the Z39.50 sort facility. In any + case the sort sequence or sort critiera is using a string notation. + This notation is a one-line notation suitable for being manually + entered or generated and allows for easy logging (one liner). + For the ZOOM API, the sort is specified in the call to ZOOM_query_sortby + function. For yaz-client the sort is performed and specified using + the sort and sort+ commands. For description of the sort criteria notation + refer to the sort command in the + yaz-client manual. + + + The ZOOM API might choose one of several sort strategies for + sorting. Refer to . + + +