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