X-Git-Url: http://git.indexdata.com/?p=yaz-moved-to-github.git;a=blobdiff_plain;f=doc%2Ftools.xml;h=33de66ecc40d465f336f4caf19a6d8e45f32007b;hp=4b2a9a1c5a615732cfb8302e2aa29a89a7c05ac0;hb=fe4182bf1ca7bebcb3172cde916d4467c2154e7b;hpb=ce853cc4919ab346fd629e7727905d3ee6e1129f diff --git a/doc/tools.xml b/doc/tools.xml index 4b2a9a1..33de66e 100644 --- a/doc/tools.xml +++ b/doc/tools.xml @@ -1,9 +1,9 @@ - + Supporting Tools - + In support of the service API - primarily the ASN module, which - provides the programmatic interface to the Z39.50 APDUs, YAZ contains + provides the programmatic interface to the Z39.50 APDUs, &yaz; contains a collection of tools that support the development of applications. @@ -51,9 +51,8 @@ int p_query_attset (const char *arg); to provide a memory source (the structure created is released on the next call to odr_reset() on the stream), a protocol identifier (one of the constants PROTO_Z3950 and - PROTO_SR), an attribute set - reference, and finally a null-terminated string holding the query - string. + PROTO_SR), an attribute set reference, and + finally a null-terminated string holding the query string. If the parse went well, p_query_rpn() returns a @@ -74,13 +73,13 @@ int p_query_attset (const char *arg); - Query ::= [ AttSet ] QueryStruct. + Query ::= [ '@attrset' AttSet ] QueryStruct. AttSet ::= string. - QueryStruct ::= { Attribute } Simple | Complex. + QueryStruct ::= [ Attribute ] Simple | Complex. - Attribute ::= '@attr' AttributeType '=' AttributeValue. + Attribute ::= '@attr' [ AttSet ] AttributeType '=' AttributeValue. AttributeType ::= integer. @@ -139,6 +138,8 @@ int p_query_attset (const char *arg); @attr 4=1 @attr 1=4 "self portrait" @prox 0 3 1 2 k 2 dylan zimmerman + + @and @attr 2=4 @attr gils 1=2038 -114 @attr 2=2 @attr gils 1=2039 -109 @@ -264,12 +265,12 @@ int p_query_attset (const char *arg); title-index. In this case, the user could specify - > + ti,ranked=knuth computer - and the ranked would map to structure=free-form-text - (4=105) and the ti would map to title (1=4). + and the ranked would map to relation=relevance + (2=102) and the ti would map to title (1=4). @@ -341,8 +342,8 @@ int p_query_attset (const char *arg); To parse a simple string with a FIND query use the function - struct ccl_rpn_node *ccl_find_str (CCL_bibset bibset, const char *str, - int *error, int *pos); +struct ccl_rpn_node *ccl_find_str (CCL_bibset bibset, const char *str, + int *error, int *pos); which takes the CCL profile (bibset) and query @@ -591,7 +592,7 @@ typedef struct oident The function - < + oid_value oid_getvalbyname(const char *name); @@ -686,7 +687,7 @@ typedef struct oident - +