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