X-Git-Url: http://git.indexdata.com/?p=yaz-moved-to-github.git;a=blobdiff_plain;f=doc%2Fzoom.xml;h=2ae3e08cb4737435865e38373dbeb6e3b29b1853;hp=e231da780366fc9e7a40f28a5d168371866ab8aa;hb=7376ec7d3d905accea9593f80da3c11b650e743b;hpb=48b7a077523d1a86c16c9f536c56d6439fe90f42
diff --git a/doc/zoom.xml b/doc/zoom.xml
index e231da7..2ae3e08 100644
--- a/doc/zoom.xml
+++ b/doc/zoom.xml
@@ -422,6 +422,9 @@ ZOOM_query_cql2rpn(ZOOM_query s, const char *str, ZOOM_connection conn)
int ZOOM_query_cql(ZOOM_query s, const char *str);
int ZOOM_query_sortby(ZOOM_query q, const char *criteria);
+
+ int ZOOM_query_sortby2(ZOOM_query q, const char *strategy,
+ const char *criteria);
Create query objects using ZOOM_query_create
@@ -438,13 +441,51 @@ ZOOM_query_cql2rpn(ZOOM_query s, const char *str, ZOOM_connection conn)
sort criteria using the same string notation for sort as offered by
the YAZ client.
- Protocol behavior
-
- The query object is just an interface for the member Query
- in the SearchRequest. The sortby-function is an interface to the
- sortSequence member of the SortRequest.
-
-
+
+ ZOOM_query_sortby2 is similar to
+ ZOOM_query_sortby but allows a strategy for
+ sorting. The reason for the strategy parameter is that some
+ protocols offers multiple ways of performing sorting.
+ For example, Z39.50 has the standard sort, which is performed after
+ search on an existing result set.
+ It's also possible to use CQL in Z39.50 as the query type and use
+ CQL's SORTBY keyword. Finally, Index Data's
+ Zebra server also allows sorting to be specified as part of RPN (Type 7).
+
+