Towards 2.0.3
[yaz-moved-to-github.git] / CHANGELOG
1 Possible compatibility problems with earlier versions marked with '*'.
2
3 --- 2.0.3 2003/06/04
4
5 * ESFormat-Update updates. Packages with OID 1.2.840.10003.9.5.1 and
6 1.2.840.10003.9.5 are now handled by the same decoder z_IU0Update .
7 Decoder has been updated with ASN.1 changes as listed in
8 http://lcweb.loc.gov/z3950/agency/defns/updateES.html
9 Note that the "latest" DB Update, OID 1.2.840.10003.9.5.1.1 , handler
10 z_IUUpdate, remains unchanged. 
11
12 ZOOM_record_get may now return a record in a specific character set.
13 For type use "form; charset=from[,to]" where form (render, xml, ..) ,
14 "from" is the character set of record as returned by target. "to" is
15 the character set to be returned. If omitted, "to" is UTF-8.
16
17 YAZ ASN.1 compiler renamed from yaz-comp to yaz-asncomp
18
19 New ODR utility, odr_getelement, which returns name of element for
20 which encoding/decoding failed.
21
22 Fixed ODR so that it returns error code OREQUIRED rather than ONONE
23 in cases where a required element was omitted.
24
25 Bug fix: some MARC8 sequences were not converted.
26
27 New ZOOM option "step" which specifies number of records to be
28 retrieved in one chunk. Used in conjunction with "start" and "count".
29
30 SRW support for yaz-client. Use scheme http: to use it, e.g.
31  http://host:port/db
32
33 yaz-client no longer does (un)intelligent character set conversions
34 by default. Can be enabled with charset and marc_charset commands.
35
36 xmalloc trace fix for 64-bit systems such as DEC alpha. 
37
38 Solaris 2.6 compile fix.
39
40 New function, cql_strerror() translates SRW error codes, as returned
41 by cql_transform_error(), into human-readable English strings.  Used
42 in yaz-client diagnostics when appropriate.
43
44 New CQL2RPN query-type for the command-line yaz-client, parses CQL and
45 converts it into a type-1 query which is sent to the server.  This
46 makes CQL available for use with all Z-servers, as opposed to the tiny
47 minority that can handle CQL queries themselves.
48
49 --- 2.0.2 2003/04/28
50
51 New Debian package layout similar to the Redhat Package layout.
52
53 New ZOOM events ZOOM_EVENT_RECV_{RECORD,SEARCH} for receiving a record
54 and search result respectively.
55
56 --- 2.0.1 2003/04/25
57
58 Redhat package is now several packages: libyaz (runtime libraries),
59 libyaz-devel (development and documentation, and yaz (utility programs).
60 Package spec file by Morten Bøgeskov.
61
62 New member 'schema' in struct bend_fetch_rr which the name of requested
63 schema (SRW/SRU) for record (or NULL if none was given). The fetch
64 handler MAY set this to reflect the schema of the returned record.
65
66 New member 'display_term' in struct scan_entry. GFS now sets member entries
67 and allocates scan entries to be filled by user scan handler. In previous
68 version, entries member was allocated by the scan handler. That still works,
69 but the GFS will ignore member display_term - assuming it was NOT set by
70 the handler. The fact that the GFS now allocates the entries both allows
71 for new members and makes a scan handler easier to write.
72
73 Fix CQL lex buffer overflow.
74
75 SRW/SRU recordPacking. For SRW default recordPacking is string. For
76 SRU default recordPacking is string.
77
78 SRU protocol support for frontend server.
79
80 Fix compile bug for systems that have nl_langinfo but CODESET undefined.
81
82 Added missing PQF transform rules for <= and >= . Thanks to Peter Popovics.
83
84 Added scan for the ZOOM shell (zoomsh).
85
86 --- 2.0 2003/02/23
87
88 * String Identifers for Schemas (Amendment 5).
89 http://lcweb.loc.gov/z3950/agency/amend/am5.html
90 Old definition for schema
91   Odr_oid *schema; /* OPT */
92 New:
93   int which;
94   union {
95      Odr_oid *oid;
96      Z_InternationalString *uri;
97   #define Z_Schema_oid 1
98   #define Z_Schema_uri 2
99   } schema; /* OPT */
100
101 * resultCount parameter to Sort Response (Amendment 1).
102 http://lcweb.loc.gov/z3950/agency/amend/am1.html
103
104 Support for SRW 1.0 over HTTP. This is an optional feature and
105 requires libxml2 to operate. Enable SOAP by specifying --with-xml2
106 for configure.
107
108 Generic frontend server supports HTTP/SOAP/SRW and Z39.50/BER
109 on the same port.  SRW SearchRetrieveRequests are mapped
110 to bend_init,bend_search,bend_fetch,bend_close. 
111
112 Z39.50 Query Type-104 added - to facilitate CQL within Z39.50.
113
114 CQL support. Source is directory 'cql'. CQL is supported in ZOOM
115 (both SRW and Z39.50) and the YAZ client (Z39.50 only).
116
117 ZOOM connections are SRW based if schem http is used for hostname
118 in connect, e.g.  z = ZOOM_connection_new("http://myserver");
119 ZOOM_query may be of type CQL, e.g. ZOOM_query_cql(q, "dc.title=x");
120
121 CCL proximity operators !n, %n converts to PQF @prox 0 n 1 2 k 2
122 and @prox 0 n 0 1 k 2 respectively, meaning: exlusion=false,
123 distance=n, order=true/false, relation=le, prox unit=word. If
124 n is omitted, distance 1 is used.
125
126 Fixed problem with C compiler include path in wrong order.
127
128 For TCP/IP COMSTACK, set recv buffer to an appropriate "large" value
129 on Solaris. Patch from Ko van der Sloot.
130
131 New MARC decode API. All new functions operate on a yaz_marc_t
132 handle. The most important new functions are: yaz_marc_create,
133 yaz_marc_decode_{buf,wrbuf}, yaz_marc_destroy, .. to create handler,
134 decode and destroy respectively. Decoder can produce formats
135 MARC line, simple XML, OAI MARC and MARC XML (LoC). See
136 include/yaz/marcdisp.h.
137
138 YAZ Iconv utility now supports MARC8 decoding (marc8.c). Converts
139 to UTF-8, UCS-32, wchar_t or Latin-1.
140
141 * Prototypes for yaz_iconv_-functions moved to separate header 
142 include/yaz/yaz-iconv.h.
143
144 Make a few private functions 'static' in unix.c. This prevents
145 duplicate unix_close in PHP with YAZ and imap. PHP Bug 20977.
146
147 For ZOOM connection, the options targetImplementation{Id,Name,Version}
148 are set when Init Response is received.
149
150 New function ZOOM_connection_error_x similar to ZOOM_connection_error
151 but returns diagnostic set as well.
152
153 New function yaz_strerror which is a portable wrapper for
154 strerror/strerror_r/GetLastMessage.
155
156 * ZOOM_record_get supports type "xml" in which case MARC XML (from LOC)
157 is returned for MARC. If type is "oai", then OAI MARC is returned.
158
159 Fix creation of lib/yaz-config so it works if srcdir != objdir. Patch
160 from Kang-Jin Lee.
161
162 --- 1.9.2 2002/11/26
163
164 yaz_marc_decode uses OAI MARC as XML format for ISO2709 records.
165
166 Fix bad race conditions on SIGTERM and terminate gracefully in
167 frontend server.
168
169 Move retrieval (data1) module to Zebra since nobody seems to be
170 using it.
171
172 Add GRS-1 render for ZOOM using same format as yaz-client.
173
174 --- 1.9.1 2002/10/05
175
176 Added man pages: yaz-client(1), yaz-ztest(8), yaz(7), zoomsh(1).
177
178 Fix broken ESpec handling in data1 module.
179
180 SGML reader parses comments and makes them part of the data1 tree.
181
182 Added several type casts so that YAZ compiles as C++ code.
183
184 ZOOM didn't handle PDU encoding failures properly.
185
186 Added more Bib-1 diagnostics (approved extensions).
187
188 GNU configure: better check for iconv.
189
190 More portable use of accept, getpeername. Check for socklen_t. Use
191 int/size_t if socklen_t is not defined.
192
193 --- 1.9 2002/09/06
194
195 PQF parser rejects bad queries - including those with extra
196 characters in them. PQF parser used to silently ignore that.
197 Cleaner API for PQF added, which allows you to get detailed
198 error information for bad queries (see yaz/pquery.h).
199
200 Fixed bug in ZOOM_record_get for type "database".
201
202 Implemented mini iconv library supporting conversions between
203 UTF-8, UCS4, UCS4LE and ISO-8859-1. Implemented in util/siconv.c.
204
205 * Removed XML reader (d1_expat.c). It's part of Zebra instead.
206
207 --- 1.8.9 2002/08/20
208
209 Fixed ZOOM C record cache so that preferredRecordSyntax and
210 elementSetName is used to check for already fetched records.
211
212 --- 1.8.8 2002/08/02
213
214 Added three members in bend_initrequest structure to facilitate
215 character set negotiation.
216
217 Fixed a bug in frontend server that could cause indefinite
218 loops under rare conditions. 
219
220 Revised character set utilities (charneg.h) so that encoding
221 UCS-4, UCSA-4, UTF-16 and UTF-8 are encoded non-privately.
222
223 For PQF, directive @term <type> sets term type for Scan/Search.
224 Here <type> is general, string, numeric, null. The term type
225 is inherited - just like @attr.
226
227 New call odr_set_charset that sets character set conversion for
228 international-strings on a ODR stream. Prototype is:
229  int odr_set_charset(ODR o, const char *to, const char *from);
230 The InternationalString is still represented as C string in YAZ 
231 so native strings of type UTF-8, ASCII, etc. will work (UTF-16
232 won't). On the protocol level, you can use any encoding.
233
234 Support for UNIX sockets in ZOOM.
235
236 Solaris recv sometimes returns errno == ENOENT. It is treated as
237 EINPROGRESS. COMSTACK patch by Ko van der Sloot.
238
239 New COMSTACK of type UNIX Socket. Use "unix:/path" as address for
240 both client and server. Code by Morten Bøgeskov.
241
242 --- 1.8.7 2002/05/22
243
244 On Windows ZOOM functions are of type __stdcall rather than __cdecl, so
245 that they can be used directly from Visual Basic. You must recompile
246 your windows APP if you're using ZOOM.
247
248 Character Set and Language Negotiation(3) for ZOOM API and YAZ client.
249 Commands "lang" and "charset" sets language and character set respectively.
250 Options "lang" and "charset" is interpreted by the ZOOM API. Note, these
251 are not part of the official ZOOM spec) All is due to Oleg Kolobov. 
252
253 Attributes from multiple CCL fields may be OR'ed rather than merged
254 using directive "@field or". Fields are still merged by default -
255 equivalent to "@field merge".
256
257 Fixed bug in ZOOM connect that occurred on OpenBSD (maybe others). Patch
258 by Oleg Kolobov.
259
260 Fixed bug in zget for parameter ExtendedServicesResponse.
261
262 Fix OID for ILL.
263
264 --- 1.8.6 2002/03/25
265
266 Added PQF feature: '@attr type=value' may be written as '@type=value'.
267
268 Client displays USR.1:SearchResult-1 (hits per term).
269
270 Additional Search Info for search in Generic Frontend Server.
271
272 Fixed CCL parsing of "field=s".
273
274 WIN32 installer - using the excellent NSIS software from nullsoft.
275
276 Fixed CCL parsing of "field = - <number>".
277
278 Added function yaz_marc_decode that decodes MARC for line mode
279 display or XML (similar to that used by JZKit).
280
281 Fixed BER decoding of OPTIONAL CHOICE. The bug didn't affect the
282 Z39.50. But ISO/ILL was, however.
283
284 Added patch by Rustam T. Usmanov that implements Z39.50 duplicate
285 detection service (Z39.50-1995 Amendment 2) and Language Negotiation (3).
286 See:
287  http://lcweb.loc.gov/z3950/agency/amend/am2.html
288  http://lcweb.loc.gov/z3950/agency/defns/charneg-3.html
289
290 --- 1.8.5 2002/02/03
291
292 New YAZ client features: Command completion and new commands:
293 push_command, set_apdufile, set_marcdump, set_cclfields, register_oid.
294 Code provided by Jacob Poulsen.
295
296 New call oid_trav, that visits all registered OIDs via callback.
297
298 Function ZOOM_record_get now returns const char pointer rather than
299 void pointer. It saves a lot of type casts.
300
301 For YAZ client, command "auth" now allows you to set authentication
302 in IdPass style. It is enabled when three tokens are given - order
303 is user, group and password.
304
305 Fix memory leaks in MARC record handling for ZOOM.
306
307 New option for YAZ client, -k <kilobytes> that sets
308 maximum record size. Similar to -k option for generic frontend
309 server and yaz-ztest.
310
311 More fixes for scan. Non-zero stepSize handled. OID's fixes.
312
313 Prefix query parser reports "fail" when bad attribute set is given.
314
315 Fix in MARC decoder. Proximity logging. Fix for attribute set
316 in scan handler for server. Patches by Shigeru Ishida.
317
318 SSL/COMSTACK updates. cs_rcvconnect completes SSL handshake. ZOOM
319 works with SSL.
320
321 Configure option --with-openssl=<dir> now works when a directory is
322 specified. Patch provided by Morten Bøgeskov.
323
324 New option for YAZ client, -u <auth>, that sets authentication.
325
326 ZOOM fix: error information was sometimes "missing", since error
327 was cleared/reset too when it shouldn't.
328
329 ZOOM_record_get returns ISO2709 buffer when "raw" is given.
330
331 --- 1.8.4 2002/01/04
332
333 Scan for ZOOM API. New object ZOOM_scanset. New functions
334 ZOOM_connection_scan, ZOOM_scanset_size, ZOOM_scanset_term and
335 ZOOM_scanset_destroy.
336
337 New ZOOM function, ZOOM_connection_last_event, that returns type
338 of last event (such as "receive data", "send data", "apdu received",
339 etc.
340
341 New ZOOM option, schema, that specifies schema for retrieval.
342
343 New CCL feature. Qualifiers can be aliases for one or more
344 other qualifiers (if more than one is given, OR is used).
345
346 ZOOM uses named result sets if target supports it.
347
348 Two new YAZ client commands: .  (dot, which sources a script of YAZ
349 client commands), and ! (to execute shell command.). Implemented
350 by Jacob Poulsen.
351
352 Working on Debian packages.
353
354 --- 1.8.3 2001/11/19
355
356 YAZ client enables named result sets only if target supports it.
357
358 *** ZOOM. Prefix for ZOOM definitions changed from Z3950_ to ZOOM_.
359
360 * ZOOM. Removed Z3950_connection_host. Use Z3950_connection_option_get
361 with key="host" to get same result.
362
363 * ZOOM. Added Z3950_record_clone and removed Z3950_resultset_get.
364 Function Z3950_resultset_record(s) returns references to records
365 "owned" by resultset. To become owner use Z3950_record_clone.
366
367 Function z_ext_record handles Extended Services. Thanks to
368 Irina Dijour.
369
370 --- 1.8.2 2001/11/12
371
372 CCL Parser fix: ignore token comma when dealing with and-lists.
373
374 Documentation updates for COMSTACK.
375
376 * ZOOM changes. Query object renamed from Z3950_search to Z3950_query.
377 Changed prototype Z3950_records. For some functions, int parameters
378 were changed to size_t.
379
380 TCP/IP COMSTACK no longer uses getprotobyname to avoid memory leak
381 on some Unices.
382
383 New MARC decode/display function, marc_display_exl, which properly rejects
384 non-ISO2709 records. YAZ client uses it.
385
386 --- 1.8.1 2001/10/29
387
388 Fix bug: local attribute set wasn't set correctly in PQF strings.
389
390 --- 1.8 2001/10/25
391
392 * Old Z39.50 codecs no longer supported. 
393
394 Added ZOOM C binding. See http://zoom.z3950.org/
395
396 Renamed states for COMSTACKs to avoid confusion with events.
397
398 Implemented cs_look and proper cs_rcvconnect.
399
400 Fixed COMSTACK error that occurred on HPUX. Fix by Giannis Kosmas.
401
402 Configure detects POSIX threads on OpenBSD.
403
404 When sort flag 'i' was specified in yaz-client the caseSensitivy flag
405 was set to a wrong value.  Thanks to Robert Sanderson for reporting this.
406
407 When error is returned from present handler, non-surrogate diagnostic
408 is returned in present response (and fetch handler is no longer called).
409
410 * Minor adjustments to pquery parser (PQF). Token characters may be
411 escaped by using backslash (C-style).
412
413 PQF parser allows string attribute values to be specified. For @attr,
414 non-numeric characters after the equal-sign are treated as strings
415 (e.g. @attr 9=title).
416
417 CCL trunction character may be defined (@truncation in file)
418
419 * function zget_ExtendedServicesRequest sets waitAction to
420   waitIfPossible (was wait).
421
422 Added cs_set_blocking to set change blocking mode of a COMSTACK. Thanks
423 to Matthew Carey.
424
425 CCL operator names may be set in field definition files (CCL_bibset).
426 See ccl/bib1 for an example.
427
428 Fixes in ASN.1 compiler for C++ compatibility.
429
430 * Renamed members "and" and "or" in struct Z_Operator to "op_and"
431 and "op_or" to avoid conflict with C++.
432
433 Fixed problem with GNU readline detection on Redhat 7.0.
434
435 Added step-size for Scan backend handler.
436
437 Fixed bug that made the frontend server crash when no attribute
438 set was specified for scan.
439
440 Front-end server automatically switches to original working directory
441 when installed as an NT service. Previously -w had to be specified to
442 make it work.
443
444 Added extended attributes for retrieval module (data1), so that data1
445 records carry d1_readXML/SGML attributes. d1_read also supports
446 null-data rules ( <tag/>)
447
448 On UNIX when POSIX threads are available, a separate library libyazthread
449 is created. Programmers should link with that library and the yaz library
450 when using threads. The reason for the split was that some applications
451 on Linux, such as Apache, doesn't work well when using shared objects that
452 relies on threads.
453
454 Added SSL support for the COMSTACK. You start yaz-client and yaz-ztest
455 (or any frontend server) in SSL mode by specifying ssl: followed by
456 address. Only tested on UNIX.
457
458 Added feature for CCL module. Virtual structure s=al or s=ol generates
459 and-list and or-list respectively instead of phrase search.
460
461 Added some OID's.
462
463 * Added prefix "yaz_" for the functions log_init.., log_file..  and
464 log_mask_str. This was done to avoid name conflicts with other libraries
465 (such as other PHP extensions).
466
467 Added raw OID member for preferred record syntax (request_format_raw)
468 and returned record syntax (output_format_raw) for backend fetch method.
469
470 Config file yaz-config now accepts options so that it returns specific
471 compile settings, etc. Thanks to Morten Bøgeskov <morten@bogeskov.dk>
472
473 Shared library support for UNIX using GNU libtool.
474
475 * Modified backend interface. Request/Response struct's replaced by
476 one read/write C struct. For example bend_fetchrequest and
477 bend_fetchresult have been replaced by single bend_fetch_rr struct.
478 Every handler - even search has to be registered in bend_init
479 handler. This means that the YAZ library no longer refers to
480 external functions and it makes it possible to make the whole
481 thing a single DLL/SO.
482
483 Added Segment handler for backend server.
484
485 Added Zmbol/Zebra administrative functions to YAZ client.
486
487 Threaded frontend server on UNIX (when POSIX Threads are available).
488 Starting the server with option -T enables multi-threading.
489
490 --- 1.6 2000/03/03
491
492 Added configure option --enable-comp/disable-comp to control use
493 of YAZ ASN.1 compiler. Use --disable-comp to use the old *coders
494 located in sub directory asn.
495
496 YAZ ASN.1 compiler renamed to yaz-comp in sub directory. It's installed
497 in ${exec_prefix}/bin along with the other programs yaz-client and
498 yaz-ztest.
499
500 GNU automake used to maintain makefiles.
501
502 Added several OID's.
503
504 Changed retrieval module so that we can load records with no abstract
505 syntax defined. Tagpaths in these records are fully composed of string
506 tags.
507
508 Implemented ISO ILL protocol. Refer to stuff in sub directory ill.
509
510 --- 1.5 1999/12/10
511
512 On UNIX, the generated makefile now supports a proper 'make install'.
513 The prefix can be set via GNU configure to set the install location
514 (default is /usr/local).
515
516 * YAZ programs client and ztest were renamed to yaz-client and
517 yaz-ztest to avoid conflicts when users install YAZ in "standard"
518 locations, such as /usr/bin,/usr/local/bin,etc.
519
520 * YAZ Header files were moved from include to include/yaz. YAZ Header
521 files are referred to as include <yaz/log.h> rather than <log.h>.
522 The YAZ include path (-I ..) is therefore the same as before. Programmers
523 should update their #include statements or use -Ipath/include/yaz
524 instead. The main motivation for doing this change is that YAZ header files
525 can be installed in "standard" locations /usr/include,/usr/local/include 
526 without introducing conflicts, since ALL YAZ header files are stored
527 in subdirectory yaz (under /usr/include for example).
528
529 Compilation of YAZ for WIN32 is now handled by an nmake-style makefile 
530 rather than project/workspace files. We switched because project files
531 are incompatible between Visual C++ 5 and 6. Refer to windows.txt for
532 details.
533
534 Changed name of logging function, logf, to yaz_log, to prevent name
535 clash with some math-log functions. The YAZ header log.h defines logf
536 to yaz_log (#define) so there should be no incompatibilities by this
537 modification.
538
539 Added bend_start/bend_stop handlers for server. These handler are
540 called on start/stop of server. For windows they are called whenever
541 a service is started/stopped.
542
543 * YAZ now auto-generates decoders/encoders for the Z39.50 protocol using
544 a fairly small ASN.1 compiler written in Tcl. The compiler is located
545 in util/yc.tcl. The auto-generated C code structures are, in a few
546 cases, incompatible with the old decoders. There are differences in the
547 following C structures Z_DiagRec, Z_External, Z_SortRequest, Z_SortResponse,
548 Z_AttributesPlusTerm, Z_ProximityOperator, Z_DefaultDiagFormat.
549 The preprocessor variable ASN_COMPILED is defined when the compiled
550 ASN.1 is being used. Encoder/decoder routines as well as the Z39.50
551 protocol ASN.1 is located sub directory <tt>z39.50</tt>. If you
552 wish to use the old encoders/decoders you can specify --disable-yc
553 for configure.
554
555 Assigned OID for old DB Update (VAL_DBUPDATE0). Updated YAZ compiled
556 version so that it supports both new - and old version of DB Update
557
558 * Added 'name' parameter to ODR encoder/decoder routines to facilitate
559 pretty ODR print. Updated whole Z39.50 encoder/decoder to reflect the
560 change. The name parameter can be set to 0 in which no name is specified
561 for the construction. The macros odr_implicit and odr_explicit sets name
562 parameter to zero for the construction involved. New macros
563 odr_implicit_tag and odr_explicit_tag are similar to the others,
564 except that a name parameter is added. For programmers' that don't use
565 ODR they probably only need to change the call to z_APDU and z_External.
566
567 Added access control facility by interfacing the TCP wrapper library.
568 YAZ automatically attempts to find the TCP wrapper Library (-lwrap) and
569 tcpd.h on Unix systems. For the server, option -d<daemon> specifies the
570 name of the daemon and enables the access control as specified in
571 hosts.allow/hosts.deny. Refer to man pages tcpd(8) and hosts_access(5).
572
573 Fixed memory leak in ccl_find_str and ccl_qual_rm. Thanks to Hans van
574 den Dool <H.M.vdnDool@kub.nl>.
575
576 Added reference ID parameter to most functions in server API - refer
577 to backend.h. Thanks to Hans van den Dool <H.M.vdnDool@kub.nl>.
578
579 Changed name of ccl library to libccl.a (was ccl.a).
580
581 Fixed bug in decoder for Explain (Category TargetInfo).
582
583 Added support for GNU readline in client. Thanks to Jacob Poulsen
584 <ja7@dbc.dk>. GNU configure attempts to detect if readline is available.
585
586 * CHANGED DEFINITION OF ES: UPDATE (INCLUDING THE OID) to reflect the
587 new definition from the ZIG. NOTE THIS IF YOU HAVE AN UPDATE
588 IMPLEMENTATION! This change was made to the development version before
589 the ZIG decided to retract the amendment. If any users MUST be
590 compatible with the original Update definition, PLEASE CONTACT US, and
591 we will include a separate definition corresponding to the old Update
592 ES. Note that because of the change to the ASN.1 of the
593 TaskPackageRecordStructure we cannot define a single structure that
594 will support both versions.
595
596 * Added const modifier to buffer parameter for some ODR/BER encoding
597 routines: ber_dectag, ber_declen, odp_more_chunks, completeBER,
598 completeWAIS, odr_dumpBER.
599
600 Fixed bug in client.c which caused a crash when a scanResponse didn't
601 contain positionOfTerm.
602
603 * Fixed inconsistency in the ScanResponse/ListEntries protocol. This
604 * will cause an error in a client if a non-YAZ target sends both a
605 * list of Scan entries and non-surrogate diagnostics.
606
607 Retrieval module enhancements. Tag sets may be typed in the reference
608 to it. From the .abs-file the "tagset" directive takes a third optional
609 integer type for the tag set referenced. From a .tag-file the "include"
610 directive takes a third optional type as well. The old "type" directive
611 in the tag set itself is still recognized but acts as the default type
612 for the tag set.
613
614 Backend interface change. Individual Scan terms returned from bend_scan
615 may also be tagged as Surrogate Diagnostics. Refer to struct scan_entry
616 in include/backend.h.
617
618 Retrieval module enhancements. Multiple tag sets and attribute sets may
619 be specified in abstract syntax specs. Revised the error/warning for
620 logging messages reported by the retrieval module when reading the
621 various spec files.
622
623 Object Identifier system (oid_..) changed. The API is backwards
624 compatible but the oid-routines now allocates new OID's when needed.
625 Raw OID's may be specified in oid_getvalbyname.
626
627 YAZ now uses GNU configure to generate Makefile(s).
628
629 * Minor changes in some of the member names of DeleteResultSetRequest and
630 DeleteResultSetResponse. See include/proto.h.
631
632 * Changed some C definitions regarding EXPLAIN record syntax (prt-exp.h)
633 and added member 'languages' in TargetInfo (which was missing).
634
635 Changed the way attribute sets are handled in the retrieval
636 module. These are now cached, just like the abstract syntaxes
637 (schemas).
638
639 Changed YAZ so that it links with compiled ASN.1.
640
641 Added Explain-schema definitions and mapping routines. The following
642 Explain categories have been implemented: AttributeDetails,
643 AttributeSetInfo, DatabaseInfo, CategoryList and TargetInfo.
644
645 Fixed minor bug in Windows version of Server Library.
646
647 --- 1.4pl2+ 1998/4/17 (Released with Zebra)
648
649 Added Extended Services to server (backend.h). Thanks to Charles Woodfield.
650
651 Added EXTERNAL: UNIverse Resource Report (non-standard).
652
653 Implemened odr_enum and odr_set_of functions to handle ASN.1 types
654 ENUMERATED and SET OF.
655
656 * Added 'const' to some of the char pointer arguments for the
657 functions, data1_read_node, data1_getelementbytagname,
658 data1_insert_taggeddata, data1_getesetbyname, data1_getelementbyname,
659 data1_get_absyn.
660
661 Fixed bug in data1_insert_taggeddata - the last_child member of
662 parent wasn't initialised.
663
664 * Changed data1_read_record and data1_read_node so that the supplied
665 "SGML"-buffer is read-only. In particular the resulting data1 - tree
666 doesn't refer to any parts of the "SGML"-buffer.
667
668 Fixed bug in server library (Windows version of statserv_remove).
669
670 * Changed code so that it compiles as C++. The type definition
671 of Odr_fun which is a member of Odr_arm was changed. The result is,
672 that an explicit typecast is needed for the fun pointer when
673 using Odr_arm - as in:
674     {1, -1, -1, Z_IdAuthentication_idPass, (Odr_fun)z_IdPass},
675
676 Updated TagSet-G and -M definitions (tagsetm.tag and tagsetg.tag).
677
678 Implemented the new structured date and time definition as approved
679 by the ZIG. Added schemaId element to the specificTag in Espec-1
680 (also approved at the last ZIG). Thanks to RVDM.
681
682 Added some Object identifiers (RVDM).
683
684 Changed the Update Extended Service (RVDM).
685
686 Added command "refid" to client which specifies referenceId for
687 the following requests.
688
689 Implemented extended service handling for server. See ztest.c
690 for an example as well as backend.h. New handlers are registerd
691 in the Init handler.
692
693 * Changed interface for sort in server.
694
695 Added new members to statserv_options_block. It allows a server
696 to read options from another source than just the command line. Thanks
697 to Charles Woodfield.
698
699 * Changed definition of Z_Triple in file prt-grs.h - member boolean
700 renamed to zboolean. Some C++ compilers complained about the name.
701
702 Minor changes to gils.abs. Added index 's' (sort) on title
703 and date/time-last-modified.
704
705 --- 1.4pl2 1998/1/30
706
707 Fixed bug in server library regarding inetd mode (-i). This bug
708 was introduced by release 1.4.
709
710 --- 1.4pl1 1998/1/29
711
712 Added sort facility in client and backend server interface.
713
714 Fixed problem with dependencies in Makefile(s).
715
716 Fixed bugs for encoders/decoders of extended services and 
717 SearchInfoReport.
718
719 Implemented sub-tree feature for schemas. Sub-trees are
720 referenced in *.abs-files. See explain.abs for an example
721 of the use of this feature.
722
723 Modified bib1.att; local attributes for ANY didn't include
724 ANY itself (only affects use of the retrieval module).
725
726 Fixed bug in plain SGML reader in function data1_read_node:
727 tags with prefix "var" was incorrectly interpreted as variants.
728
729 Added feature "sub-schemas" to enable references to - and definitions
730 of - group of elements.
731
732 * Removed member parent from type data1_element (in data1.h).
733
734 Implemented function odr_nullval() that returns the value of
735 ODR_NULLVAL.
736
737 * Removed member num_children from data1_node (in data1.h).
738
739 Made NT service interface part of the server library. The
740 function statserv_main uses the NT service when required and
741 calls the statserv_start / statserv_close routines.
742
743 Routine zget_SearchRequest and zget_PresentRequest fills
744 resultSetName/Id member with "default" instead of "Default".
745
746 Fixed memory leak in server. Request queue member wasn't freed.
747
748 Fixed nmem_exit so that memory is freed.
749
750 --- 1.4 1997/10/2
751
752 Revised the CCL parser utility to be thread safe.
753
754 Added function, oid_ent_to_oid, to replace the function 
755 oid_getoidbyent, which is not thread safe.
756
757 * Added nmem_init and nmem_exit to initialize and release
758 NMEM resources. Function nmem_init should be called once in the
759 initial thread before NMEM/ODR is used. statserv.c and client.c
760 have been changed accordingly. The change was necessary to make
761 NMEM thread safe. The NMEM memory pool is shared amongst threads
762 in a process. Unix-based applications will still work fine without
763 calling this.
764
765 Added NT Services interface for the the Z39.50 (statserv) Server. 
766 Refer to the ztest.c source on the usage.
767
768 Windows 95/NT port using MSVC5.0. Project files are included in the
769 distribution.
770
771 * Defined new 'global' handle for the retrieval (data1) system. The
772 new handled, data1_handle, describes the state of the data1 system.
773 This handle is passed as first argument to virtually all
774 data1 related routines. The functions data1_create and data1_destroy
775 creates and destroys a data1 handle respectively.
776
777 Added ODR encode stream member to all backend request structures
778 init, search, scan etc. This stream should be used to allocate all
779 memory used for the response when thread safe operation is needed.
780
781 Changed the comstack utility, cs_addstr, to be thread safe. The
782 returned hostname string returned by the function is now part the
783 COMSTACK instance.
784
785 Added comstack utility, cs_straddr, which replaces the tcpip_strtoaddr
786 function. The cs_straddr takes a COMSTACK handle as argument, so this
787 function must be used after cs_create and before bind/connect.
788 This function is thread safe.
789
790 Moved test server to 'ztest' directory - generic server code still
791 in 'server' directory.
792
793 Made prefix query (pquery.c) utility thread safe.
794
795 Added new function modifier YAZ_EXPORT to 'export' public DLL
796 functions when using windows (see include/yconfig.h).
797
798 Added definitions to the OID database (util/oid.c) (RVDM).
799
800 Added new BIB-1 diagnostic messages to the handler diagbib1_str.
801
802 Added call to ccl_rpn_delete in client program.
803
804 Added ODR argument to ccl_rpn_query and ccl_scan_query to provide
805 release of RPN structure.
806
807 Added support for C++, headers uses extern "C" for public definitions.
808 With input from RVDM.
809
810 In handling of SEQUENCE OF: Counter set to zero when SEQUENCE OF is absent.
811 Thanks to Ronald van der Meer (RVDM).
812
813 Added initializers (zget_ routines) for a number of PDUs. Thanks to RVDM.
814
815 Added support for private extensions to the OID database
816 (oid_setprivateoids()). Thanks to RVDM.
817     
818 Added optional, physical ANY (key replication)
819
820 Fixed null-reference problem in GRS-1 output filter.
821
822 Proximity operator added to Prefix Query Format (PQF).
823
824 In test client command "base" accepts multiple databases.
825
826 Fixed bug in cs_close stack that caused trouble with WINSOCK.
827
828 --- 1.3 1996/10/11
829
830 Fixed tagging bug in ResourceReportResponse PDU encoder/decode.
831
832 Smallish bug-fixes in the new encoders/decoders (explain).
833
834 Bug fixed in DeleteRequest.
835
836 Fixed tagging bug of type 101 query in SearchRequest-Query PDU encoder/decoder.
837
838 Fixed tagging bug in ResourceReportResponse PDU encoder/decode.
839
840 Added SOIF syntax (using private OID for now) to retrieval module and client.
841
842 Added Update extended service.
843
844 Added SearchResult-1 additional info structure.
845
846 Added optional CCL (ISO8777) interpreter as separate module. Available
847 in linemode client.
848
849 --- 1.2 1996/6/10 (1st anniversary release)
850
851 Added Summary record syntax. Lightly tested.
852
853 Added OPAC record syntax. Untested.
854
855 Added ResourceReport service encoders/decoders. Untested.
856
857 Fixed bug in z_Unit - wrong tagging on unitSystem.
858
859 Fixed bug in the DiagRecs decoder.
860
861 Added options for max PDU size and session timeout to frontend-server.
862
863 Added documentation of query-language parsers and other supporting utilities.
864
865 [frontend-server] Added Attribute set to the bend_scanrequest API.
866
867 [frontend-server] NextResultSetPosition was sometimes set incorrectly when
868 surrogate diagnostics were generated.
869
870 [retrieval] Allow multiple local values for attribute.
871
872 [retrieval] Allow multiple attributes per element in .abs files. index type.
873
874 [retrieval] Added Summary tagset, abstract syntax, and d1-node/ASN filter.
875
876 --- 1.1pl2  1996/4/10
877
878 Minor changes, mostly specific to Zebra's requirements (retrieval)
879
880 --- 1.1  1996/2/20
881
882 Repaired bug in frontend server when running multiple listening
883 endpoints in dynamic mode.
884
885 z_External() now won't break if a known, ASN.1 value comes encapsulated
886 in an octet-string. The value will pass through unmodified in an Odr_oct.
887
888 Added a bit of code to the demo client to decode & display
889 ASN.1-structured records represented in the octet-aligned branch of
890 the EXTERNAL CHOICE. Thanks to CAS for prodding us to finally do this.
891
892 Added z_ext_getentbyref() to the ASN module. Doc updated.
893
894 * Completed the SCAN definition in the ASN module. This may break SCAN
895 code based on older YAZ-versions at compile-time. The fix is easy -
896 look in proto.h.
897
898 * Added 'displayTerm' and OtherInformation to the TermInfo structure
899 under the SCAN definition. Remember to initialize this, server-people.
900
901 Comstack should now support the WAIS protocol in TCP/IP mode. Note
902 that this does not extend to ODR and ASN.
903
904 Comstack allows insertion of established socket (primarily for
905 inetd-operation of servers). Doc updated.
906
907 Front-end server can now start from the inetd in TCP mode. Doc
908 updated.
909
910 --- 1.0pl4 1996/1/24
911
912 Added Sort PDU.
913
914 Fixed small problem in SUTRS-filter. A newline was sometimes inserted before
915 the rank and record number.
916
917 Adjustments to the frontend server.
918
919 Fixed diagnostic BER dumper. It ignored the file argument.
920
921 --- 1.0pl3 1996/1/2
922
923 Various changes to retrieval module.
924
925 Changed the union discriminators of the protocol files from enums to
926 ints paired with #defines.
927
928 *Changed oident.class to oident.oclass to avoid a reserved word in C++
929  compilers.
930
931 *Changed operator in the RPN structure to 'roperator', again to avoid a
932  conflict with C++.
933
934 Fixed problems in Explain decoders/encoders.
935
936 --- 1.0pl2 1995/12/6
937
938 Memory bug in log module fixed.
939
940 --- 1.0pl1 1995/12/5
941
942 Occasional malloc() of 0 bytes fixed in d1_espec.c.
943
944 Bug in Explain DatabaseInfo module fixed.
945
946 Some '\r' snuck into one or two of the ret'l config tables. A curse on Windows.
947
948 --- 1.0 1995/11/28
949
950 The shift to v1.0 signals that we now consider the *core* functionality
951 of YAZ reasonably stable (the core being more or less equivalent to
952 Z39.50-1992). Some of the really nifty v3 stuff is still not heavily
953 tested (Explain not at all - though that will happen soonish).
954
955 Minor changes to code to support Windows port.
956
957 Various minor changes after we're getting to use GRS-1 & co. more.
958
959 Added Espec-1 format.
960
961 Added VisibleString field body type to GRS-1. It is illegal acc. to my copy
962 of the protocol and it cannot be selected when encoding (maps into 'string'
963 when decoding). Needed to talk to some servers.
964
965 Demo client can request simple element set names.
966
967 Added Diagnostic Format encoders/decoders.
968
969 Added simple Close handling to frontend server (no hooks for resource
970 reporting yet), and demonstration client.
971
972 Added cs_addrstr() command to COMSTACK to retrieve peer hostname/address.
973
974 --- 1.0b3 1995/08/24
975
976 Fixed bug in the frontend-server. The numberOfRecordsReturned field was
977 handled incorrectly when records were requested in the searchResponse. This
978 will only affect you if you use the frontend-server.
979
980 Added GRS-1 encoders/decoders to the service-level API. Lightly tested.
981 Test-client will ask for and print GRS1. Ztest will return dummy records
982 on request.
983
984 Added Explain encoders/decoders to the service-level API. Untested.
985
986 Added Extended Services: Item Order encoders and decoders to the Service-
987 level API. Untested. We could use a recent copy of the pertinent bits
988 of the ILL protocol to add those bits.
989
990 Added diagnostic format 1 encoders/decoders to the service-level API.
991 Untested.
992
993 Moved pretty-printing of structure-wrappers ({..}) from odr_seq.c to
994 odr_cons.c, which causes a more correct output.
995
996 Fixed handling of searchRequest in frontend server. NextResultSetPosition
997 was always set to 0 when no records were requested in the searchRequest.
998
999 * Added better external-handling. This shouldn't harm old code that
1000 *encodes* externals. It can break code that looks for a
1001 'single-ASN1-type' representation, since those types that are known
1002 are now decoded immediately. Look at the SUTRS sample code in
1003 seshigh.c and client.c. Documentation updated.
1004
1005 Handling of structured records in bend_fetchresponse. Length -1 marks
1006 structured record, type is deduced from format field.
1007
1008 --- 1.0b2 1995/06/27
1009 Fairly quick maintenance release to add SUTRS support.
1010
1011 Fixed handling of SUTRS records in the demonstration client.
1012
1013 * Added format field to the bend_fetchrequest and bend_fetchresponce
1014 structures of the backend API (frontend server). When the record is
1015 returned, the value of the format field is mapped to an OID. The
1016 value VAL_SUTRS will also cause a slightly different ASN.1 packaging
1017 of the record. The special value VAL_NONE in the bend_request means
1018 that no specific format was requested by the client. Documentation
1019 updated accordingly. Test server (ztest) will return a fixed dummy
1020 SUTRS record if your client requests SUTRS.
1021
1022 Documentation updated accordingly.
1023
1024 You can now set external libraries and RANLIB support in the top-level
1025 Makefile.
1026
1027 --- 1.0b 1995/06/19
1028 First public release.