Document bug fixes
[idzebra-moved-to-github.git] / NEWS
1
2 --- 1.3.18 2004/08/..
3
4 Fixed bug in record management. Releasing blocks could result in
5 partial read.
6
7 Fixed bug in isam:b. A tree split could result in a lost item.
8
9 --- 1.3.17 2004/08/17
10
11 Add IDZebra.i to dist so that Perl extension builds again.
12
13 --- 1.3.16 2004/08/16
14
15 Added facility to make attibutes in grs.regx and grs.tcl filter using the
16 data command with argument -attribute <name> . The content of data is
17 the value of the attribute. This command should be used inside a
18 begin element , end element section.
19
20 Update zebra.nsi to NSIS 2.
21
22 Added a new 'cut' directive to charmaps (.chr files) which specifies that
23 only characters after the cutting char should be indexed.
24
25 Update Perl internals so that it matches the current Zebra API.
26 The recordGroup structure is no longer available. A group of resources
27 can still be referenced by setting groupName=>..  in various methods.
28
29 Maximum number of records to be sorted in a result set can be
30 specified by setting "sortmax". Default is 1000.
31
32 Allow use of string use attributes for regular attribute sets. The
33 name matches the name given in the attribute set file. All strings
34 starting with / are considered X-Path as usual.
35
36 Fixed bug in grs.regx. filter . 'end element' could pop off top tag
37 element for XML tree. It may only pop off if -record is given.
38
39 Added grs.danbib filter - for Danish Bibliographic Centre.
40
41 Rename CHANGELOG to NEWS.
42
43 For text filter, return only header if elementSetName=H . elementSetName=R
44 returns contents only. Other elementSetName returns both header+content.
45
46 Added test for charmap and rusmarc.
47
48 Added feature charmaps (.chr) so that characters may be specified in
49 \LXXXX HEX notation.
50
51 Fixed problem with encoding directive for charmap(.chr) files.
52
53 Allow Remote insert/delete/replace/update with record, recordIdNumber
54 (sysno) and/or recordIdOpaque(user supplied record Id). If both
55 IDs are omitted internal record ID match is assumed (recordId: - in
56 zebra cfg).
57
58 --- 1.3.15 2004/01/15
59
60 Fix bug. X-Path attribute expressions with spaces in them now works.
61
62 Fix base address for MARC output.
63
64 --- 1.3.14 2003/11/29
65
66 Fix bug with shadow and result set handling.
67
68 Implement MARCXML to ISO2709 conversion.
69
70 --- 1.3.13 2003/09/26
71
72 Add missing examples for Windows install.
73
74 Fix bug in regx filter to make it "greedy" again. This bug appeared
75 in version 1.3.12.
76
77 Fix a few tests.
78
79 --- 1.3.12 2003/09/08
80
81 Fix XML error handling. Stop XML parse immediately if XML parse error
82 occur (i.e.  produce one error only).
83
84 Zebra ignores "unsupported use attribute" for individual databases
85 when search multiple databases (unless all databases fail).
86
87 New filter grs.marcxml which works like grs.marc but produces MARCXML.
88
89 Added support for database deletion. It is possible to create/drop
90 a database from zebraidx utility. Note: only for isam:b.
91
92 Write zebrasrv.pid to lockdir.
93
94 Bug fix: result sets were not recovered correctly. Had to
95 add ODR handle for zebra_search_RPN in order to make it work.
96
97 Fixed a bug in regx filters that didn't do anchors (^) correctly.
98
99 Fixed a bug in searches with X-Path searches sometimes giving "extra"
100 hits.
101
102 Zebra server checks for zebrasrv.pid and refuses to start if it is already
103 locked by another (running) zebrasrv.
104
105 Fixed a bug with text being chunked in pieces for the grs.xml filter.
106
107 --- 1.3.11 2003/04/25
108
109 xelm code updates. xelm works regardless state of 'xpath enable/disable'
110 Avoid -L/usr/lib since that is already default library path.
111
112 Allow multiple updates within one transaction.
113
114 Fixed a bug with >2GB files (overflow in integer expression).
115
116 --- 1.3.10 2003/04/01
117
118 Fix linker error for Perl module.
119
120 Fix bug in and operation which in some cases could result in "extra"
121 hits. Bug was introduced in 1.3.5.
122
123 Fix bug in handling of schema conversion when producing numeric tags.
124
125 --- 1.3.9 2003/03/27
126
127 Zvrank updates. 
128
129 Add missing files doc/zvrank.txt and doc/marc_indexing.xml.
130
131 --- 1.3.8 2003/03/26
132
133 Zvrank: an experimental ranking algorithm. See doc/zvrank.txt and
134 source in index/zvrank.c. Enable this by using rank: zvrank in zebra.cfg.
135 Contributed by Johannes Leveling <Johannes.Leveling at fernuni-hagen.de>
136
137 livrank: another experimental ranking algorithm. Source in livcode.c.
138 Enable this by using rank: livrank in zebra.cfg and use -DLIV_CODE=1
139 for CFLAGS.
140 Contributed by Pete Mallinson, University of Liverpool. 
141
142 Advanced MARC indexing. See doc/marc_indexing.xml
143  Oleg Kolobov <oleg at lib.tpu.ru>
144
145 Perl API updates and fixes. 
146  Peter Popovics <pop at technomat.hu>
147
148 Fixed 'zebraidx delete'.
149
150 Implemented 'zebraidx clean'.
151
152 64-bit offsets for register files on WIN32 (no 2 GB limit).
153
154 Fixed a few memory leaks WRT sorting.
155
156 --- 1.3.7 2003/02/27
157
158 Fixed error handling : error code was not properly returned.
159
160 Support Truncation 104 (CCL).
161
162 --- 1.3.6 2003/02/25
163
164 Added missing source files for perl extension.
165
166 --- 1.3.5 2003/02/23
167
168 Implemented xelm directive.
169
170 Updated for newer version of YAZ (introduction of string schema).
171
172 Directory examples/zthes now part of distribution (was missing
173 in previous release).
174
175 New .abs directive, systag, that control where to put retrieval
176 information. The directive takes two arguments: system tag, element name.
177 System tag is one of : rank, sysno, size.
178
179 --- 1.3.4 2002/11/26
180
181 Perl Filter and Perl API. By Peter Popovics.
182
183 For zebra.cfg, if no profilePath is specified, directory
184  (prefix)/share/idzebra/tab
185 is used.
186
187 Zebra Examples in examples . Zebra tests in test.
188
189 Bug fix: sort index was not properly modified on 
190 record updates/deletes.
191
192 Fix handling of character entities for sgml filter.
193
194 Move data1 to Zebra (used to be part of YAZ).
195
196 --- 1.3.3 2002/10/05
197
198 Fix character encoding of scan response terms.
199
200 Fix character decoding of scan request terms.
201
202 Fix ESpec handling (requires YAZ 1.9.1)
203
204 Fix searches for complete fields.
205
206 --- 1.3.2 2002/09/09
207
208 When name zebra is used in a filename or directory 'idzebra' is used
209 instead to avoid confusion with GNU zebra (routing software).
210
211 Zebra server stops with a fatal error if config file cannot be read.
212
213 New config setting, followLinks, that controls whether update of files
214 should follow symbolic. Set it to 1 (for enable) or 0 (to disable).
215 By default symbolic links are followed.
216
217 Fix MARC transfer . MARC fields had wrong data for multiple fields.
218
219 XML record reader moved from YAZ to Zebra, to make YAZ less 
220 dependant on external libraries.
221
222 Zebra uses yaz_iconv which is mini iconv library supporting UTF-8,
223 UCS4, ISO-8859-1. This means that Zebra does UNICODE even
224 on systems that doesn't offer iconv.
225
226 XML record reader supports external system entities.
227
228 --- 1.3.1 2002/08/20
229
230 New .abs-directive "xpath" that takes one argument: "enable"
231 or "disable" to enable and disable XPath -indexing. If no "xpath"
232 direcive is found in .abs-file , XPath-indexing is disabled to ensure
233 backwards compatibility. For missing .abs-files XPath-indexing is
234 enabled so that such records are searchable.
235
236 Zebra warns about missing .abs-file only once (for each type).
237
238 Fixed a bug in file update where already-inserted files could
239 be treated as "new".
240
241 --- 1.3.0 2002/08/05
242
243 Zebra license changed to GNU GPL.
244
245 XPath-like queries used when RPN string attributes are used, eg.
246    @attr 1=/portal/title sometitle
247    @attr 1=/portal/title[@xml:lang=da] danishtitle
248    @attr 1=/portal/title/@xml:lang da
249    @attr 1=//title sometitle
250
251 Zebra uses UTF-8 internally:
252 1) New setting "encoding" for zebra.cfg that specifies encoding for
253 OCTET terms in queries and record encoding for most transfer syntaxes
254 (except those that use International Strings, such as GRS-1).
255 2) The encoding of International strings is UTF-8 by default. It
256 may be changed by character set negotiation. If character set
257 negotiation is in effect and if records are selected for conversion
258 these'll be converted to the selected character set - thus overriding
259 the encoding setting in zebra.cfg.
260 3) New directive "encoding" in .abs-files. This specifies the external
261 character encoding for files indexed by zebra. However, if records
262 themselves have an XML header that specifies and encoding that'll be used
263 instead.
264
265 XML filter (-t grs.xml).
266
267 Multiple registers. New setting in resource 'root' that holds base
268 directory for register(s). A group a databases may be put in separate
269 register in directory root/reg by using db name 'reg/db1' ... 'reg/dbN'.
270
271 --- 1.1.1 2002/03/21
272
273 Fixes for Digital Unix
274
275 Implemented hits per term using USR:SearchResult-1.
276
277 New Zebra API. Locking system re-implemented.
278
279 --- 1.1.stable 2002/02/20
280
281 Rank weight can be controlled with attribute type 9. Default
282 value is 34. Recommended values between 1-36.
283
284 --- 1.1 2001/10/25
285
286 Updated for YAZ version 1.8.
287
288 Added support for termsets - a result set of terms matching
289 a given query. For @attr 8=<set> creates termset named <set>.
290
291 Added support for raw retrieval. Element Set Name R forces the
292 text filter which returns the record in its original form.
293
294 Added numerical sort - triggered by structure=numeric (4=109).
295
296 Remote record import using Z39.50 Extended Services and Segments.
297
298 Fixed bug where updating a database with user-defined attributes
299 could corrupt the register (bad storeKeys).
300
301 Multi-threaded version.
302
303 Fixed bug regarding proximity.
304
305 Documentation updates.
306
307 Fixed bug in record retrieval module that occured on 64-bit OSF 
308 architectures.
309
310 --- 1.0.1 2000/2/10
311
312 Fixed bug in makefile for WIN32.
313
314 Fixed bug in configure script - used bash-specific features.
315
316 --- 1.0 1999/12/10
317
318 Added support for multiple records in one file for filter grs.sgml.
319
320 Changed record index structure. New layout is incompatible with
321 previous releases. Added setting "recordcompression" to control
322 compression of records. Possible values are "none" (no
323 compression) and bzip2 (compression using libbz2).
324
325 Added XML transfer syntax support for retrieval of structured records.
326 Schema in CompSpec is recognised in retrieval of structured records.
327
328 Changed Tcl record filter so that it attemps to read  <filt>.tflt. If
329 that fails, the filter reads the file <filt>.flt (regx style filter).
330
331 Implemented new Tcl record filter -  use grs.tcl.<filter> to enable it.
332 Zebra's configure script automatically attempts to locate Tcl. For
333 manual Tcl configuration use option --with-tclconfig=<path> to specify
334 where Tcl's library files are located.
335
336 Implemented "compression" of Dictionary and ISAM system. Dictionary
337 format HAS changed.
338
339 Added "tagsysno" directive to zebra.cfg to control under which tag the
340 system ID is placed. Use tagsysno: 0 to disable Zebra's system number
341 entirely.
342
343 Added "tagrank" as above.
344
345 Changed file naming scheme for register files from <name>.mf.<no> to
346 <name>-<no>.mf.
347
348 Implemented "position"-flag for register type (as defined in
349 default.idx). When set to zero no position (or seqence number) is
350 saved in register for each word occurrence, thus saving some register
351 space.
352
353 Implemented database mapping. Using mapdb one can specify a database
354 to be mapped to one or more physical databases. Usage:
355 mapdb <fromdb> <todb> ..
356
357 Added SOIF-filter. Thanks to Peter Valkenburg.
358
359 For the regx-filter "end element -record" may trigger a mark-of-record
360 if outer level is reached.
361
362 Tag sets may be typed in the reference to it. From the .abs-file the
363 "tagset" directive takes a third optional integer type for the tag set
364 referenced. From a .tag-file the "include" directive takes a third
365 optional type as well. The old "type" directive in the tag set itself
366 is still recognized but acts as the default type for the tag set.
367  
368 Zebra supports the specification of arbitrary attributes sets, schemas
369 and tag sets, because of the change in YAZ' OID management system.
370
371 Fixed bug in Sort that caused it NOT to use character mapping as it
372 should.
373
374 Zebra now uses GNU configure to generate Makefile(s).
375
376 Added un-optimised support for left and left/right truncation attributes.
377
378 Added support for relational operators on text when using RPN queries.
379
380 Added support for sort specifications in RPN queries. Type 7 specifies
381 'sort' where value 1=ascending, value 2=descending. The use attribute
382 specifies the field criteria as usual.  The term specifies priority
383 where 0=first, 1=second, ...
384
385 Changed the way use attributes are specified in the recordId
386 specification.
387
388 Maximum number of databases in one Zebra register increased.
389
390 New setting, databasePath, which specifies that first directory during
391 update traversal is the database name (instead of a fixed one).
392
393 New setting, explainDatabase, which specifies that databases are
394 EXPLAIN aware.
395
396 Modified Zebra so that it works with ASN.1 compiled code for YAZ.
397
398 Implemented EXPLAIN database maintenance. Zebra automatically
399 generate - and update CategoryList, TargetInfo, DatabaseInfo,
400 AttributeSetInfo and AttributeDetails records at this stage. The
401 records may be transferred as GRS-1, SUTRS or Explain.
402
403 Fixed register spec so that colon isn't treated as size separator
404 unless followed by [0-9+-] in order to allow DOS drive specifications.
405
406 Fixed two bugs in ISAMC system.
407
408 Changed the way Zebra keeps its maintenance information about attribute
409 sets, available attributes, etc.. Records in "SGML" notation using an
410 EXPLAIN schema is now used when appropriate.
411
412 Bug fix: Index didn't handle update/insert/delete of the same record
413 (i.e. same recordId) in one run (one invocation of zebraidx). Only the
414 first occurence of a record is considered.
415
416 Most searches now return correct number of hits.
417
418 New modular ranking system. Interested programmers are encouraged to
419 inspect rank1.c and improve the algorithm.
420
421 Bug fix: Lock files weren't removed as they should on NT.
422
423 Implemented Z39.50 Sort. Zebra's sort handler uses use attributes to
424 specify a "sort register". Refer to the gils sample records which refer
425 to index type "s" which is specified as "sort" in the default.idx file.
426 Each sort criteria can either be Ascending or Descending and at most
427 three sort elements can be specified.  
428
429 Bug fix: Character mapping didn't work for text files.
430
431 --- 1.0b1 1998/1/29
432
433 Simple ranked searches now return correct number of hits.
434
435 The test option (-s) only makes a read-lock on the index as well
436 as using read-only operations anywhere.
437
438 Moved towards generic character mapping. Configuration file default.idx
439 specifies character map files for register types w, p, u, etc.
440
441 Implemented "begin variant" for the sgml.regx - filter.
442
443 Fixed a few memory leaks.
444
445 Added support for C++, headers uses extern "C" for public definitions.
446
447 Bug fix: The show records facility (-s) only displayed information for
448 the first record in a file (and not for every record in the file).
449
450 Added option "-f <n>" to limit the logging of record operations. After
451 <n> records has been processed no logging is performed (unless errors
452 occur).
453
454 Bug fix: the compressed ISAM system didn't handle update operations
455 correctly.
456
457 Added setting, "maxResultSetSize", to hold the number of records to 
458 save in a result set.
459
460 Bug fix: Complete phrase did't work for search operations.
461
462 Bug fix: temporary result sets weren't deleted.
463
464 Reduced disk space for saved keys (storeKeys = 1).
465
466 Added optional, physical ANY (key replication)
467
468 Implemented proximity operator in search.
469
470 Bug fix: the path name buffers used by file match traversal routines
471 have been extended to support long file names.
472
473 New C(ompressed) ISAM system. To enable it, specify "isam: c" in the
474 configuration file. The resulting register without "storeKeys" is about
475 half the size, and the memory used by zebraidx during phase 2 (merge) is
476 reduced to a minimum.
477
478 Reworked the way Regexp-2 queries with error tolerance are handled and
479 specified. The documentation has been updated accordingly.
480
481 Bug fix: Zebrasrv didn't search correctly when queries contained masking
482 characters. This bug was introduced in 1.0a8.
483
484 Zebrasrv now tag records with the proper database name.
485
486 New settings, memMax and keyTmpDir.
487
488 Changed name of setting lockDir (previously called lockPath) and
489 setTmpDir (previously called tempSetPath).
490
491 Generalized and changed record type specifications. In short, there are:
492        text                plain SUTRS
493        grs.sgml            structured, "SGML-like" syntax
494        grs.regx.<filter>   structured, Regular expression filter
495        grs.marc.<abs>      Reads *MARC records in the ISO2709 format. <abs>
496                            is the name of an abstract syntax file.                           
497 Bug fix: Result sets weren't sorted in operations involving boolean
498 operations with "ranked" operands.
499
500 --- 1.0a8 1996/6/6
501
502 Added national character-handling subsystem.
503
504 Various fixes.
505
506 Small modifications to input filters and profiles.
507
508 Added support for SOIF syntax (with private OID).
509
510 --- 1.0a7 1996/5/16
511
512 Fixed buffer-size problem in indexing.
513
514 Added compression to temporary files for updating.
515
516 Added phrase registers.
517
518 Added dynamic mapping of search attribute to multiple termlists (ANY).
519
520 Scan support in multiple databases/registers.
521
522 Configuration settings are case-insensitive and single dash (-)
523 characters are ignored in comparisons.
524
525 The index processing ignores empty files - warning given.
526
527 New option to zebraidx (-V) displays version information.
528
529 --- 1.0a6 1996/2/24
530
531 Fixed problem in file-update system.
532
533 Fixed problem in shadow system; register was sometimes corrupted after
534 a commit operation.
535
536 --- 1.0a5 1996/2/10
537
538 Fixed problems in the ISAM subsystem. Caused difficulties when updating
539 existing registers.
540
541 Fixed small problem in SUTRS-filter. A newline was sometimes inserted before
542 the rank and record number.
543
544 Fixed bug in the isam subsystem - caused a malfunction when accessing
545 words which occurred more than 10000 times.
546
547 Distribution should now include YAZ (Z39.50 protocol stack) to simplify
548 installation.
549
550 Server can now run under inetd. Use option -i, and -w <directory> to
551 set working directory to desired location.
552
553 New zebraidx command: clean - removes temporary shadow files.
554
555 Fixed bug in ISAM system. Occurred rarely during register updates.
556
557 Logging during index merge phase is improved. The remaining running
558 time is estimated.
559
560 Temporary files generated by zebraidx are removed after each run.
561
562 Bug fix: Dictionary didn't handle 8-bit characters correctly; was obvious
563 when doing scan operations in dictionaries with European characters.
564
565 --- 1.0a4 1996/01/11
566
567 A whole slew of updates, to make the first publicized release. Get the doc
568 and check it out.
569
570 --- 1.0a3 1995/12/06
571
572 Memory-problems in ISAM fixed. More blocktypes added to the default setup
573 to increase performance on larger databases.
574
575 Various minor changes in data management system.
576
577 --- 1.0a2 1995/12/05
578
579 A couple of portability-problems resolved.
580
581 Changed some malloc() to xmalloc().
582
583 --- 1.0a1 1995/11/28
584
585 First release.