1 Possible compatibility problems with earlier versions marked with '*'.
5 Fix in MARC decoder. Proximity logging. Fix for attribute set
6 in scan handler for server. Patches by Shigeru Ishida.
8 SSL/COMSTACK updates. cs_rcvconnect completes SSL handshake. ZOOM
11 Configure option --with-openssl=<dir> now works when a directory is
12 specified. Patch provided by Morten Bøgeskov.
14 New option for YAZ client, -u <auth>, that sets authentication.
16 ZOOM fix: error information only cleared for Bib-diagnostics (not
17 fatal errors, like connection failed, etc).
19 ZOOM_record_get returns ISO2709 buffer when "raw" is given.
23 Scan for ZOOM API. New object ZOOM_scanset. New functions
24 ZOOM_connection_scan, ZOOM_scanset_size, ZOOM_scanset_term and
27 New ZOOM function, ZOOM_connection_last_event, that returns type
28 of last event (such as "receive data", "send data", "apdu received",
31 New ZOOM option, schema, that specifies shema OID for retrieval.
33 New CCL feature. Qualifiers can be aliases for one or more
34 other qualifiers (if more than one is given, OR is used).
36 ZOOM uses named result sets if target supports it.
38 Two new YAZ client commands: . (dot, which sources a script of YAZ
39 client commands), and ! (to execute shell command.). Implemented
42 Working on Debian packages.
46 YAZ client enables named result sets only if target supports it.
48 *** ZOOM. Prefix for ZOOM definitions changed from Z3950_ to ZOOM_.
50 * ZOOM. Removed Z3950_connection_host. Use Z3950_connection_option_get
51 with key="host" to get same result.
53 * ZOOM. Added Z3950_record_clone and removed Z3950_resultset_get.
54 Function Z3950_resultset_record(s) returns references to records
55 "owned" by resultset. To become owner use Z3950_record_clone.
57 Function z_ext_record handles Extended Services. Thanks to
62 CCL Parser fix: ignore token comma when dealing with and-lists.
64 Documentation updates for COMSTACK.
66 * ZOOM changes. Query object renamed from Z3950_search to Z3950_query.
67 Changed prototype Z3950_records. For some functions, int parameters
68 were changed to size_t.
70 TCP/IP COMSTACK no longer uses getprotobyname to avoid memory leak
73 New MARC decode/display function, marc_display_exl, which properly rejects
74 non-ISO2709 records. YAZ client uses it.
78 Fix bug: local attribute set wasn't set correctly in PQF strings.
82 * Old Z39.50 codecs no longer supported.
84 Added ZOOM C binding. See http://zoom.z3950.org/
86 Renamed states for COMSTACKs to avoid confusion with events.
88 Implemented cs_look and proper cs_rcvconnect.
90 Fixed COMSTACK error that occurred on HPUX. Fix by Giannis Kosmas.
92 Configure detects POSIX threads on OpenBSD.
94 When sort flag 'i' was specified in yaz-client the caseSensitivy flag
95 was set to a wrong value. Thanks to Robert Sanderson for reporting this.
97 When error is returned from present handler, non-surrogate diagnostic
98 is returned in present response (and fetch handler is no longer called).
100 * Minor adjustments to pquery parser (PQF). Token characters may be
101 escaped by using backslash (C-style).
103 PQF parser allows string attribute values to be specified. For @attr,
104 non-numeric characters after the equal-sign are treated as strings
105 (e.g. @attr 9=title).
107 CCL trunction character may be defined (@truncation in file)
109 * function zget_ExtendedServicesRequest sets waitAction to
110 waitIfPossible (was wait).
112 Added cs_set_blocking to set change blocking mode of a COMSTACK. Thanks
115 CCL operator names may be set in field definition files (CCL_bibset).
116 See ccl/bib1 for an example.
118 Fixes in ASN.1 compiler for C++ compatibility.
120 * Renamed members "and" and "or" in struct Z_Operator to "op_and"
121 and "op_or" to avoid conflict with C++.
123 Fixed problem with GNU readline detection on Redhat 7.0.
125 Added step-size for Scan backend handler.
127 Fixed bug that made the frontend server crash when no attribute
128 set was specified for scan.
130 Front-end server automatically switches to original working directory
131 when installed as an NT service. Previously -w had to be specified to
134 Added extended attributes for retrieval module (data1), so that data1
135 records carry d1_readXML/SGML attributes. d1_read also supports
136 null-data rules ( <tag/>)
138 On UNIX when POSIX threads are available, a separate library libyazthread
139 is created. Programmers should link with that library and the yaz library
140 when using threads. The reason for the split was that some applications
141 on Linux, such as Apache, doesn't work well when using shared objects that
144 Added SSL support for the COMSTACK. You start yaz-client and yaz-ztest
145 (or any frontend server) in SSL mode by specifying ssl: followed by
146 address. Only tested on UNIX.
148 Added feature for CCL module. Virtual structure s=al or s=ol generates
149 and-list and or-list respectively instead of phrase search.
153 * Added prefix "yaz_" for the functions log_init.., log_file.. and
154 log_mask_str. This was done to avoid name conflicts with other libraries
155 (such as other PHP extensions).
157 Added raw OID member for preferred record syntax (request_format_raw)
158 and returned record syntax (output_format_raw) for backend fetch method.
160 Config file yaz-config now accepts options so that it returns specific
161 compile settings, etc. Thanks to Morten Bøgeskov <morten@bogeskov.dk>
163 Shared library support for UNIX using GNU libtool.
165 * Modified backend interface. Request/Response struct's replaced by
166 one read/write C struct. For example bend_fetchrequest and
167 bend_fetchresult have been replaced by single bend_fetch_rr struct.
168 Every handler - even search has to be registered in bend_init
169 handler. This means that the YAZ library no longer refers to
170 external functions and it makes it possible to make the whole
171 thing a single DLL/SO.
173 Added Segment handler for backend server.
175 Added Zmbol/Zebra administrative functions to YAZ client.
177 Threaded frontend server on UNIX (when POSIX Threads are available).
178 Starting the server with option -T enables multi-threading.
182 Added configure option --enable-comp/disable-comp to control use
183 of YAZ ASN.1 compiler. Use --disable-comp to use the old *coders
184 located in sub directory asn.
186 YAZ ASN.1 compiler renamed to yaz-comp in sub directory. It's installed
187 in ${exec_prefix}/bin along with the other programs yaz-client and
190 GNU automake used to maintain makefiles.
194 Changed retrieval module so that we can load records with no abstract
195 syntax defined. Tagpaths in these records are fully composed of string
198 Implemented ISO ILL protocol. Refer to stuff in sub directory ill.
202 On UNIX, the generated makefile now supports a proper 'make install'.
203 The prefix can be set via GNU configure to set the install location
204 (default is /usr/local).
206 * YAZ programs client and ztest were renamed to yaz-client and
207 yaz-ztest to avoid conflicts when users install YAZ in "standard"
208 locations, such as /usr/bin,/usr/local/bin,etc.
210 * YAZ Header files were moved from include to include/yaz. YAZ Header
211 files are referred to as include <yaz/log.h> rather than <log.h>.
212 The YAZ include path (-I ..) is therefore the same as before. Programmers
213 should update their #include statements or use -Ipath/include/yaz
214 instead. The main motivation for doing this change is that YAZ header files
215 can be installed in "standard" locations /usr/include,/usr/local/include
216 without introducing conflicts, since ALL YAZ header files are stored
217 in subdirectory yaz (under /usr/include for example).
219 Compilation of YAZ for WIN32 is now handled by an nmake-style makefile
220 rather than project/workspace files. We switched because project files
221 are incompatible between Visual C++ 5 and 6. Refer to windows.txt for
224 Changed name of logging function, logf, to yaz_log, to prevent name
225 clash with some math-log functions. The YAZ header log.h defines logf
226 to yaz_log (#define) so there should be no incompatibilities by this
229 Added bend_start/bend_stop handlers for server. These handler are
230 called on start/stop of server. For windows they are called whenever
231 a service is started/stopped.
233 * YAZ now auto-generates decoders/encoders for the Z39.50 protocol using
234 a fairly small ASN.1 compiler written in Tcl. The compiler is located
235 in util/yc.tcl. The auto-generated C code structures are, in a few
236 cases, incompatible with the old decoders. There are differences in the
237 following C structures Z_DiagRec, Z_External, Z_SortRequest, Z_SortResponse,
238 Z_AttributesPlusTerm, Z_ProximityOperator, Z_DefaultDiagFormat.
239 The preprocessor variable ASN_COMPILED is defined when the compiled
240 ASN.1 is being used. Encoder/decoder routines as well as the Z39.50
241 protocol ASN.1 is located sub directory <tt>z39.50</tt>. If you
242 wish to use the old encoders/decoders you can specify --disable-yc
245 Assigned OID for old DB Update (VAL_DBUPDATE0). Updated YAZ compiled
246 version so that it supports both new - and old version of DB Update
248 * Added 'name' parameter to ODR encoder/decoder routines to facilitate
249 pretty ODR print. Updated whole Z39.50 encoder/decoder to reflect the
250 change. The name parameter can be set to 0 in which no name is specified
251 for the construction. The macros odr_implicit and odr_explicit sets name
252 parameter to zero for the construction involved. New macros
253 odr_implicit_tag and odr_explicit_tag are similar to the others,
254 except that a name parameter is added. For programmers' that don't use
255 ODR they probably only need to change the call to z_APDU and z_External.
257 Added access control facility by interfacing the TCP wrapper library.
258 YAZ automatically attempts to find the TCP wrapper Library (-lwrap) and
259 tcpd.h on Unix systems. For the server, option -d<daemon> specifies the
260 name of the daemon and enables the access control as specified in
261 hosts.allow/hosts.deny. Refer to man pages tcpd(8) and hosts_access(5).
263 Fixed memory leak in ccl_find_str and ccl_qual_rm. Thanks to Hans van
264 den Dool <H.M.vdnDool@kub.nl>.
266 Added reference ID parameter to most functions in server API - refer
267 to backend.h. Thanks to Hans van den Dool <H.M.vdnDool@kub.nl>.
269 Changed name of ccl library to libccl.a (was ccl.a).
271 Fixed bug in decoder for Explain (Category TargetInfo).
273 Added support for GNU readline in client. Thanks to Jacob Poulsen
274 <ja7@dbc.dk>. GNU configure attempts to detect if readline is available.
276 * CHANGED DEFINITION OF ES: UPDATE (INCLUDING THE OID) to reflect the
277 new definition from the ZIG. NOTE THIS IF YOU HAVE AN UPDATE
278 IMPLEMENTATION! This change was made to the development version before
279 the ZIG decided to retract the amendment. If any users MUST be
280 compatible with the original Update definition, PLEASE CONTACT US, and
281 we will include a separate definition corresponding to the old Update
282 ES. Note that because of the change to the ASN.1 of the
283 TaskPackageRecordStructure we cannot define a single structure that
284 will support both versions.
286 * Added const modifier to buffer parameter for some ODR/BER encoding
287 routines: ber_dectag, ber_declen, odp_more_chunks, completeBER,
288 completeWAIS, odr_dumpBER.
290 Fixed bug in client.c which caused a crash when a scanResponse didn't
291 contain positionOfTerm.
293 * Fixed inconsistency in the ScanResponse/ListEntries protocol. This
294 * will cause an error in a client if a non-YAZ target sends both a
295 * list of Scan entries and non-surrogate diagnostics.
297 Retrieval module enhancements. Tag sets may be typed in the reference
298 to it. From the .abs-file the "tagset" directive takes a third optional
299 integer type for the tag set referenced. From a .tag-file the "include"
300 directive takes a third optional type as well. The old "type" directive
301 in the tag set itself is still recognized but acts as the default type
304 Backend interface change. Individual Scan terms returned from bend_scan
305 may also be tagged as Surrogate Diagnostics. Refer to struct scan_entry
306 in include/backend.h.
308 Retrieval module enhancements. Multiple tag sets and attribute sets may
309 be specified in abstract syntax specs. Revised the error/warning for
310 logging messages reported by the retrieval module when reading the
313 Object Identifier system (oid_..) changed. The API is backwards
314 compatible but the oid-routines now allocates new OID's when needed.
315 Raw OID's may be specified in oid_getvalbyname.
317 YAZ now uses GNU configure to generate Makefile(s).
319 * Minor changes in some of the member names of DeleteResultSetRequest and
320 DeleteResultSetResponse. See include/proto.h.
322 * Changed some C definitions regarding EXPLAIN record syntax (prt-exp.h)
323 and added member 'languages' in TargetInfo (which was missing).
325 Changed the way attribute sets are handled in the retrieval
326 module. These are now cached, just like the abstract syntaxes
329 Changed YAZ so that it links with compiled ASN.1.
331 Added Explain-schema definitions and mapping routines. The following
332 Explain categories have been implemented: AttributeDetails,
333 AttributeSetInfo, DatabaseInfo, CategoryList and TargetInfo.
335 Fixed minor bug in Windows version of Server Library.
337 --- 1.4pl2+ 1998/4/17 (Released with Zebra)
339 Added Extended Services to server (backend.h). Thanks to Charles Woodfield.
341 Added EXTERNAL: UNIverse Resource Report (non-standard).
343 Implemened odr_enum and odr_set_of functions to handle ASN.1 types
344 ENUMERATED and SET OF.
346 * Added 'const' to some of the char pointer arguments for the
347 functions, data1_read_node, data1_getelementbytagname,
348 data1_insert_taggeddata, data1_getesetbyname, data1_getelementbyname,
351 Fixed bug in data1_insert_taggeddata - the last_child member of
352 parent wasn't initialised.
354 * Changed data1_read_record and data1_read_node so that the supplied
355 "SGML"-buffer is read-only. In particular the resulting data1 - tree
356 doesn't refer to any parts of the "SGML"-buffer.
358 Fixed bug in server library (Windows version of statserv_remove).
360 * Changed code so that it compiles as C++. The type definition
361 of Odr_fun which is a member of Odr_arm was changed. The result is,
362 that an explicit typecast is needed for the fun pointer when
363 using Odr_arm - as in:
364 {1, -1, -1, Z_IdAuthentication_idPass, (Odr_fun)z_IdPass},
366 Updated TagSet-G and -M definitions (tagsetm.tag and tagsetg.tag).
368 Implemented the new structured date and time definition as approved
369 by the ZIG. Added schemaId element to the specificTag in Espec-1
370 (also approved at the last ZIG). Thanks to RVDM.
372 Added some Object identifiers (RVDM).
374 Changed the Update Extended Service (RVDM).
376 Added command "refid" to client which specifies referenceId for
377 the following requests.
379 Implemented extended service handling for server. See ztest.c
380 for an example as well as backend.h. New handlers are registerd
383 * Changed interface for sort in server.
385 Added new members to statserv_options_block. It allows a server
386 to read options from another source than just the command line. Thanks
387 to Charles Woodfield.
389 * Changed definition of Z_Triple in file prt-grs.h - member boolean
390 renamed to zboolean. Some C++ compilers complained about the name.
392 Minor changes to gils.abs. Added index 's' (sort) on title
393 and date/time-last-modified.
397 Fixed bug in server library regarding inetd mode (-i). This bug
398 was introduced by release 1.4.
402 Added sort facility in client and backend server interface.
404 Fixed problem with dependencies in Makefile(s).
406 Fixed bugs for encoders/decoders of extended services and
409 Implemented sub-tree feature for schemas. Sub-trees are
410 referenced in *.abs-files. See explain.abs for an example
411 of the use of this feature.
413 Modified bib1.att; local attributes for ANY didn't include
414 ANY itself (only affects use of the retrieval module).
416 Fixed bug in plain SGML reader in function data1_read_node:
417 tags with prefix "var" was incorrectly interpreted as variants.
419 Added feature "sub-schemas" to enable references to - and definitions
420 of - group of elements.
422 * Removed member parent from type data1_element (in data1.h).
424 Implemented function odr_nullval() that returns the value of
427 * Removed member num_children from data1_node (in data1.h).
429 Made NT service interface part of the server library. The
430 function statserv_main uses the NT service when required and
431 calls the statserv_start / statserv_close routines.
433 Routine zget_SearchRequest and zget_PresentRequest fills
434 resultSetName/Id member with "default" instead of "Default".
436 Fixed memory leak in server. Request queue member wasn't freed.
438 Fixed nmem_exit so that memory is freed.
442 Revised the CCL parser utility to be thread safe.
444 Added function, oid_ent_to_oid, to replace the function
445 oid_getoidbyent, which is not thread safe.
447 * Added nmem_init and nmem_exit to initialize and release
448 NMEM resources. Function nmem_init should be called once in the
449 initial thread before NMEM/ODR is used. statserv.c and client.c
450 have been changed accordingly. The change was necessary to make
451 NMEM thread safe. The NMEM memory pool is shared amongst threads
452 in a process. Unix-based applications will still work fine without
455 Added NT Services interface for the the Z39.50 (statserv) Server.
456 Refer to the ztest.c source on the usage.
458 Windows 95/NT port using MSVC5.0. Project files are included in the
461 * Defined new 'global' handle for the retrieval (data1) system. The
462 new handled, data1_handle, describes the state of the data1 system.
463 This handle is passed as first argument to virtually all
464 data1 related routines. The functions data1_create and data1_destroy
465 creates and destroys a data1 handle respectively.
467 Added ODR encode stream member to all backend request structures
468 init, search, scan etc. This stream should be used to allocate all
469 memory used for the response when thread safe operation is needed.
471 Changed the comstack utility, cs_addstr, to be thread safe. The
472 returned hostname string returned by the function is now part the
475 Added comstack utility, cs_straddr, which replaces the tcpip_strtoaddr
476 function. The cs_straddr takes a COMSTACK handle as argument, so this
477 function must be used after cs_create and before bind/connect.
478 This function is thread safe.
480 Moved test server to 'ztest' directory - generic server code still
481 in 'server' directory.
483 Made prefix query (pquery.c) utility thread safe.
485 Added new function modifier YAZ_EXPORT to 'export' public DLL
486 functions when using windows (see include/yconfig.h).
488 Added definitions to the OID database (util/oid.c) (RVDM).
490 Added new BIB-1 diagnostic messages to the handler diagbib1_str.
492 Added call to ccl_rpn_delete in client program.
494 Added ODR argument to ccl_rpn_query and ccl_scan_query to provide
495 release of RPN structure.
497 Added support for C++, headers uses extern "C" for public definitions.
498 With input from RVDM.
500 In handling of SEQUENCE OF: Counter set to zero when SEQUENCE OF is absent.
501 Thanks to Ronald van der Meer (RVDM).
503 Added initializers (zget_ routines) for a number of PDUs. Thanks to RVDM.
505 Added support for private extensions to the OID database
506 (oid_setprivateoids()). Thanks to RVDM.
508 Added optional, physical ANY (key replication)
510 Fixed null-reference problem in GRS-1 output filter.
512 Proximity operator added to Prefix Query Format (PQF).
514 In test client command "base" accepts multiple databases.
516 Fixed bug in cs_close stack that caused trouble with WINSOCK.
520 Fixed tagging bug in ResourceReportResponse PDU encoder/decode.
522 Smallish bug-fixes in the new encoders/decoders (explain).
524 Bug fixed in DeleteRequest.
526 Fixed tagging bug of type 101 query in SearchRequest-Query PDU encoder/decoder.
528 Fixed tagging bug in ResourceReportResponse PDU encoder/decode.
530 Added SOIF syntax (using private OID for now) to retrieval module and client.
532 Added Update extended service.
534 Added SearchResult-1 additional info structure.
536 Added optional CCL (ISO8777) interpreter as separate module. Available
539 --- 1.2 1996/6/10 (1st anniversary release)
541 Added Summary record syntax. Lightly tested.
543 Added OPAC record syntax. Untested.
545 Added ResourceReport service encoders/decoders. Untested.
547 Fixed bug in z_Unit - wrong tagging on unitSystem.
549 Fixed bug in the DiagRecs decoder.
551 Added options for max PDU size and session timeout to frontend-server.
553 Added documentation of query-language parsers and other supporting utilities.
555 [frontend-server] Added Attribute set to the bend_scanrequest API.
557 [frontend-server] NextResultSetPosition was sometimes set incorrectly when
558 surrogate diagnostics were generated.
560 [retrieval] Allow multiple local values for attribute.
562 [retrieval] Allow multiple attributes per element in .abs files. index type.
564 [retrieval] Added Summary tagset, abstract syntax, and d1-node/ASN filter.
568 Minor changes, mostly specific to Zebra's requirements (retrieval)
572 Repaired bug in frontend server when running multiple listening
573 endpoints in dynamic mode.
575 z_External() now won't break if a known, ASN.1 value comes encapsulated
576 in an octet-string. The value will pass through unmodified in an Odr_oct.
578 Added a bit of code to the demo client to decode & display
579 ASN.1-structured records represented in the octet-aligned branch of
580 the EXTERNAL CHOICE. Thanks to CAS for prodding us to finally do this.
582 Added z_ext_getentbyref() to the ASN module. Doc updated.
584 * Completed the SCAN definition in the ASN module. This may break SCAN
585 code based on older YAZ-versions at compile-time. The fix is easy -
588 * Added 'displayTerm' and OtherInformation to the TermInfo structure
589 under the SCAN definition. Remember to initialize this, server-people.
591 Comstack should now support the WAIS protocol in TCP/IP mode. Note
592 that this does not extend to ODR and ASN.
594 Comstack allows insertion of established socket (primarily for
595 inetd-operation of servers). Doc updated.
597 Front-end server can now start from the inetd in TCP mode. Doc
604 Fixed small problem in SUTRS-filter. A newline was sometimes inserted before
605 the rank and record number.
607 Adjustments to the frontend server.
609 Fixed diagnostic BER dumper. It ignored the file argument.
613 Various changes to retrieval module.
615 Changed the union discriminators of the protocol files from enums to
616 ints paired with #defines.
618 *Changed oident.class to oident.oclass to avoid a reserved word in C++
621 *Changed operator in the RPN structure to 'roperator', again to avoid a
624 Fixed problems in Explain decoders/encoders.
628 Memory bug in log module fixed.
632 Occasional malloc() of 0 bytes fixed in d1_espec.c.
634 Bug in Explain DatabaseInfo module fixed.
636 Some '\r' snuck into one or two of the ret'l config tables. A curse on Windows.
640 The shift to v1.0 signals that we now consider the *core* functionality
641 of YAZ reasonably stable (the core being more or less equivalent to
642 Z39.50-1992). Some of the really nifty v3 stuff is still not heavily
643 tested (Explain not at all - though that will happen soonish).
645 Minor changes to code to support Windows port.
647 Various minor changes after we're getting to use GRS-1 & co. more.
649 Added Espec-1 format.
651 Added VisibleString field body type to GRS-1. It is illegal acc. to my copy
652 of the protocol and it cannot be selected when encoding (maps into 'string'
653 when decoding). Needed to talk to some servers.
655 Demo client can request simple element set names.
657 Added Diagnostic Format encoders/decoders.
659 Added simple Close handling to frontend server (no hooks for resource
660 reporting yet), and demonstration client.
662 Added cs_addrstr() command to COMSTACK to retrieve peer hostname/address.
666 Fixed bug in the frontend-server. The numberOfRecordsReturned field was
667 handled incorrectly when records were requested in the searchResponse. This
668 will only affect you if you use the frontend-server.
670 Added GRS-1 encoders/decoders to the service-level API. Lightly tested.
671 Test-client will ask for and print GRS1. Ztest will return dummy records
674 Added Explain encoders/decoders to the service-level API. Untested.
676 Added Extended Services: Item Order encoders and decoders to the Service-
677 level API. Untested. We could use a recent copy of the pertinent bits
678 of the ILL protocol to add those bits.
680 Added diagnostic format 1 encoders/decoders to the service-level API.
683 Moved pretty-printing of structure-wrappers ({..}) from odr_seq.c to
684 odr_cons.c, which causes a more correct output.
686 Fixed handling of searchRequest in frontend server. NextResultSetPosition
687 was always set to 0 when no records were requested in the searchRequest.
689 * Added better external-handling. This shouldn't harm old code that
690 *encodes* externals. It can break code that looks for a
691 'single-ASN1-type' representation, since those types that are known
692 are now decoded immediately. Look at the SUTRS sample code in
693 seshigh.c and client.c. Documentation updated.
695 Handling of structured records in bend_fetchresponse. Length -1 marks
696 structured record, type is deduced from format field.
699 Fairly quick maintenance release to add SUTRS support.
701 Fixed handling of SUTRS records in the demonstration client.
703 * Added format field to the bend_fetchrequest and bend_fetchresponce
704 structures of the backend API (frontend server). When the record is
705 returned, the value of the format field is mapped to an OID. The
706 value VAL_SUTRS will also cause a slightly different ASN.1 packaging
707 of the record. The special value VAL_NONE in the bend_request means
708 that no specific format was requested by the client. Documentation
709 updated accordingly. Test server (ztest) will return a fixed dummy
710 SUTRS record if your client requests SUTRS.
712 Documentation updated accordingly.
714 You can now set external libraries and RANLIB support in the top-level
718 First public release.