Update doc/common
[pazpar2-moved-to-github.git] / NEWS
1 --- 1.6.42 2014/05/06
2
3 Re-ingest native facets PAZ-934
4
5 Fix medium override for solr-pz2.xsl.
6
7 --- 1.6.41 2014/04/23
8
9 Fix URL with leading http:// not working PAZ-933
10
11 Build packages for Ubuntu Trusty Tahr 14.04 LTS
12
13 cf.xsl: handle medium override AND md field
14
15 --- 1.6.40 2014/04/10
16
17 sortmap relevance always uses increasing=1. PAZ-930
18
19 solr-pz2.xsl: ensure medium is also applied if Solr record do not
20 have it. PAZ-929 
21
22 Fix leak in getaddrinfo usage for HTTP listener. Not a big deal because
23 this code is only executed once.
24
25 Fix typos is sortmap documentation.
26
27 Doc: fix misplaced variablelist tag.
28
29 --- 1.6.39 2014/02/19
30
31 Doc: update WRT ICU which is configured for YAZ; not Pazpar2.
32 It's been like that since version 1.1.1 from August 2009.
33
34 Add support for result-set caching via memcached. See description of
35 pz:memcached. Require that Pazpar2 is using YAZ 5.0.12 or later.
36
37 Add support for a <metadata> container tag. Patfh from Sven Porst.
38
39 Add support for XInclude in main configuarion file. Patch from Sven Porst.
40
41 Add client_{lock,unlock} before call to non_block_events in
42 connection_continue. Problem is that if non_block_events fire records,
43 then we will not unlock client at all. And as a result, a dead-lock
44 occurs.
45
46 --- 1.6.38 2014/01/07
47
48 Avoid removing slash and other characters for generic metadata that
49 looks like a URL (contains ://). PAZ-915
50
51 pz2.js: Only use XDR when doing CORS. Favor XHR in all other circumstances.
52
53 Cluster merge fixes. PAZ-901
54
55 Set client state to "working" when waiting for DNS resolver. PAZ-907
56
57 Log when session terminates. PAZ-905
58
59 Fix LSB/HS conformance for /etc/init.d/pazpar2 PAZ-904
60 Debian: add support for /etc/init.d/pazpar2 status
61
62 --- 1.6.37 2013/11/18
63
64 Fix 'Record Missing' for command=show PAZ-903
65
66 Preserve order of records within cluster PAZ-902
67
68 testing: use yaz-ztest -V if possible and use YAZ in sibling directory
69 if present.
70
71 Allow clustered records to be ingested during retrieval. PAZ-900
72
73 Fix void function error which cannot return a value.
74
75 --- 1.6.36 2013/11/11
76
77 SRU pz:authentication="a/b" may end up as x-username=a%2Fb PAZ-899
78
79 Upgrade to debhelper version 7 PAZ-898
80
81 Package with libyaz5 PAZ-897
82
83 Better error message for CCL parse errors PAZ-887
84
85 --- 1.6.35 2013/09/23
86
87 New target setting: pz:authentication_mode. PAZ-896
88
89 pazpar2 PRM: pazpar2 runs as user nobody. PAZ-893
90
91 Strip #-suffix for ZOOM URLs. PAZ-892
92
93 --- 1.6.34 2013/08/30
94
95 Fix issue with hanging show/bytarget. Could happen if new search was
96 fired with filter before show from previous show completed.
97
98 Add 'date' handling for solr-pz2.xsl.
99
100 --- 1.6.33 2013/08/13
101
102 pz:authentication may carry user group password. If pz:authentication
103 has at least one blank in it, that forces Pazpar2 to use idPass Z39.50
104 authentication. Two forms are allowed
105     user password
106     user group password
107 If no blanks are present, open authentication is in use (as before).
108
109 Fix {prev,next}recid elements that are returned by record
110 command. These were incorrect in versions 1.6.23 thru 1.6.32.
111
112 --- 1.6.32 2013/06/14
113
114 Experimental support for snippets. If argument snippets=1 is given
115 for command record or show, the text will include <match>-tags for
116 those area that matches.
117
118 Fix memory leak WRT client structures (incorrect inc ref count).
119
120 Log when a HTTP response is serialized and the time elapsed.
121
122 New command, service, which returns current service XML in use for
123 session.
124
125 --- 1.6.31 2013/05/24
126
127 Local limit for fields of type "generic" (ie text fields) are
128 now normalized by mergekey rule before comparison takes place.
129 Before, no normalization took place and comparsion was, thus, exact.
130
131 New facility: dynamic rank , which allows ranking to be changed
132 for an existing result set. The rank can be set for search or
133 show. This overrides the rank for metadata elements (which fields
134 to rank and weight).
135
136 New facility:dynamic mergekey , which allows mergekey to be changed
137 for an existing result set. The mergekey can be set for search or
138 show.
139
140 HTTP server: host=@ listens on IPV6 and IPV4 if possible.
141 Also, allow ports to be given as names (not just integers).
142 Fix @-notation on systems that don't support IPV6 sockets.
143
144 --- 1.6.30 2013/04/26
145
146 Add MasterKey Connect configuration. Refer to section "non-standard
147 databases" for more information.
148
149 Allow timeformat for log to be specified with option -m (as Metaproxy
150 and YAZ GFS).
151
152 New Debian package pazpar2-dbg.
153
154 Fix NULL ptr reference of se->relevance. If a new search is initiated
155 and a CCL query fails to parse, Pazpar2 could crash.
156
157 Fix problem with host/port mangling in Pazpar2 HTTP server. Problem
158 existed in 1.6.29 only.
159
160 --- 1.6.29 2013/04/05
161
162 IPV6 updates. Allow IPv6 addresses for database hosts and IPv6 address
163 for HTTP server. By default the HTTP server uses IPv4 only, but that can be
164 changed by setting "host" attribute for the "listen" element.
165
166 Change semantics of pz:extendrecs. Allow for repeated fetches .
167 pz:extendrecs is now the number of extra records to fetch (was total
168 count before).
169
170 --- 1.6.28 2013/03/21
171
172 Fix hang or memory violation if show occurred before a search. (not that
173 it makes much sense to perform a show before a search).
174
175 --- 1.6.27 2013/03/08
176
177 pz2.js: Element_parseChildNodes concatenates all Text/CDATA nodes, instead
178 of the first child.
179
180 --- 1.6.26 2013/03/08
181
182 New pz:metadata attribute, empty="empty-value" for Pazpar2's
183 internal representation. With this attribute, Pazpar2 treates an empty
184 pz:metadata type as having the value for "empty"  - if empty.
185
186 New setting, pz:extendrecs, which triggers extended fetch of records
187 for a database beyond pz:maxrecs for a show command.
188
189 Fix warning that was falsely issued for "missing limitmap".
190
191 Log message for Pazpart start/stop changed. Now using same style as
192 Metaproxy, ie Pazpar2 start SHA1 / Pazpar2 stop .
193
194 --- 1.6.25 2013/02/07
195
196 Fix hang of 2nd command=show with esn/syntax given.
197
198 --- 1.6.24 2013/01/18
199
200 New merge attribute type: 'first', which takes all metadata fields
201 from first target that returns the particular field.
202
203 --- 1.6.23 2013/01/02
204
205 Extend info command with hostname and YAZ SHA1
206 Indent results for both command stat and info.
207
208 Allow limit on merged content. The new configuration metadata
209 element, limitcluster, configures that a metadata element (name) be used
210 as limit name for search. Applies to the whole service (ie all targets),
211 unlike pz:limitmap which is configured per-target (database).
212
213 New feature: limitmap local:* matches against all metadata fields.
214
215 Allow repeated list in limitmap spec . Separated by comma. For
216 example: value="local:title,rpn:@attr 1=4".
217
218 New element <message> in bytarget response. Holds diagnostic message
219 of code (say 'Unsupported Use Attribute' for Bib-1 114).
220
221 Improved logging for record ingestion failures.
222
223 Avoid using struct icu_chain in non-YAZ_HAVE_ICU mode. In the rare case,
224 when YAZ is compiled without ICU support.
225
226 --- 1.6.22 2012/10/11
227
228 Requires YAZ-4.2.40 to support native solr support.
229
230 Fix and improve logic handling whether or not to re-do search on sort
231 order changes. A sort order with change in ascending/descending only
232 whould not trigger a new search, which is required for targets with
233 native sorting capabilities. Each client is now checked if instructions
234 (sortmap) exist for native sorting and only client that does requires
235 it is researched. Other clients is just re-ingesting the records,
236 they already have. The resultset is now cleared if any researching
237 is done.
238
239 Connection sharing between session has broken since version 1.6.8 with
240 introduction of logic that would minimize searching if pazpar2 could
241 detect this based on same query and limits and partly sort order.
242 This could lead to segementations violations.
243
244 Added a chapter in the manaul about relevance ranking.
245
246 --- 1.6.21 2012/09/24
247
248 Rank tweak: follow=number will increase mult by number if two terms
249 occur next to each other; number-1 if they are one term apart , .. 0
250 if they are number a part (all in order). Default is 0 (following
251 terms has no effect).
252
253 Rank tweak: lead=k will divide mult by 1 + log2(1+k*l) where k is
254 value given by lead and l is length from beginning of field where
255 term occurs (l=0 for first term, l=1 for second term, ..). Default
256 value of k is 0.0.
257
258 Rank tweak: length=strategy. length="linear" if mult is to be divided
259 by length (existing, default behavior), length="log" if mult is to be
260 divided by log2(1+length), length="none" if mult is not to be affected
261 by length.
262
263 --- 1.6.20 2012/09/21
264
265 Rank algorithm details may be printed as part of show response in
266 element <relevance_info>.. This is only printed if <rank debug="yes"/>
267 is used in service.
268
269 Record as returned by show/record command have a minimal indentation
270 which makes things human-readable.
271
272 New configuration of default sorting criteria (sort-default) in
273 service definition. If no criteria is defined it will be as before
274 'relevance'.
275
276 Search command now supports sort parameter just as the show command.
277 If no parameter is give, it will use the service sort-default value.
278
279 --- 1.6.19 2012/09/18
280
281 Rank algorithm skips strings that gets normalized to empty string.
282 For example, & and ! could map to the empty string. The weight for
283 those terms is now 0 (as if they were not part of the query).
284
285 Rank algorithm does not use CCL from limitmap; only from the query
286 parameter (user query).
287
288 Obey -w dir.
289
290 --- 1.6.18 2012/09/17
291
292 Rank algorithm configurable by 'rank' element inside service. So far
293 only, attribute 'cluster' is recognized. If cluster="yes", multiple
294 records inside a cluster boosts higher than single records. This
295 is default behavior and existing behavior. cluster="no" takes the
296 average score of each record in a cluster.
297
298 --- 1.6.17 2012/09/05
299
300 Fix bad re-use of connections (connections with changing proxy should not
301 be reused).
302
303 --- 1.6.16 2012/08/22
304
305 Fix a bug introduce in 1.6.15 around the position sorting. It resetted the
306 resultset and sorting when the sort order is position. However this will be done on
307 every client poll, which will make pazpar2 continuing reset and fetching.
308 It should only be done on FIRST request where the sort order change.
309
310 Fix an issue on suggestion option: Also disable suggestions on empty string.
311
312 Clean up in turbo marc stylesheet.
313
314 Remove the hardcoded size of termlists.
315
316 --- 1.6.15 2012/06/27
317
318 New facility: ccldirective may be given in service definition. Allows
319 CCL parsing to be customized a bit, such as defining names of operators
320 and, or, not.
321
322 New facility: raw record by checksum, rather than offset. The record
323 command optionally takes checksum which identifies certain record from
324 a database.
325
326 New facility: per field ranking. Rank may be given as M [F N] where
327 M is default rank and N is rank for CCL terms from field F.
328
329 --- 1.6.14 2012/06/04
330
331 Fix for IE7/8 in pz.js
332
333 Applied patch from Giannis Kosmas on keepAlive, which also adds keepAlive to init response.
334
335 Lower log level some places.
336
337 Remove some invalid test results.
338
339 --- 1.6.13 2012/05/23
340
341 Introducing a version=2 parameter for show, termlist and bytarget commands.
342 This enables pazpar2 to return approximation on hit and count count when
343 doing record filtering using the limit parameter on search and a
344 limitmap with a value of "local:"
345
346 Setting pz:xslt may embed local XSLT as an alternative to referring
347 to filenames.
348 Value is not CDATA but XML nodes embedded, so escaping is not necessary
349 but a root element *must* be present. For example:
350 <settings target="target="z3950.indexdata.com/marc">
351      <set name="pz:xslt">
352        <xsl:stylesheet
353           version="1.0"
354         ..
355        </xsl:stylesheet>
356      </set>
357     </settings>
358
359 Metadata field rank may given by XML internal document (pz:xslt
360 result). If rank is not given, the rank from service description is
361 used - as before.
362
363 Metadata field can now configured a default limitmap and facetmap.
364 Setting limitmap to "local:" would work for all kind of targets, but would
365 prob. not be the optimal solution. But at least better than the default behavior
366 of pazpar2 where no filtering is done.
367
368 A service definition can now also contains <set/> that defines service-wide
369 settings. These will override server-wide sets and will be overridded by
370 settings.
371
372 New setting, pz:present_chunk, that specifies number of records to fetch
373 at a time. Zero will disable chunkation; will fetch max_records at once.
374
375 --- 1.6.12 2012/03/14
376
377 Revert the format change in termlist response, that could break
378 some clients / UIs since they were expecting an (empty) element
379 if no facet values was found.
380
381 --- 1.6.11 2012/03/07
382
383 Revert the behavior of returning errors when unable to block
384 on termlist, bytarget and search, when unable to block due to
385 other block. The client will now receive a regular response,
386 but it will be logged in the server. A parameter (report) is
387 added to change behavior to return error response or WARNING
388 status message. Consider this "API" as private, as it is mostly
389 untested and could be changed in future releases.
390
391 Fix spell error in pz2.js fix in 1.6.10.
392
393 New Marc2TurboMarc.xsl (contribution from Sven Porst).
394 Can solve the missing marc21.xsl updates in some cases.
395
396 tmarc.xsl: Simplify the 6xx to subject-long and fix 1-based
397 substring (contribtion from Sven Porst)
398
399 marc21.xsl: fix 1-based substring call
400
401 tmarc.xsl and marc21.xsl: use 856$a as last option for electronic-text.
402
403 Add test_termlist_block to test suite
404
405 --- 1.6.10 2012/02/23
406
407 Fix SEGV for invalid PQFs and SRU/SOLR targets
408 Also refactor a bit the code that converts from PQF to SRU/SOLR queries.
409
410 Fix pz2.js: "null object" due to change in in bytarget result XML.
411
412 Fixes in tmarc.xsl: Subject-long shorten for extra commas only.
413 Added this normalization to the other subject-long fields (d6xx),
414 where it was missing.
415
416 Fixes in marc21.xsl: Updated with most of the new tmarc.xsl.
417 Still differences around medium and holdings. marc21.xsl is not
418 longer active used by Index Data, and should be considered unsupported.
419 Use tmarc.xsl instead.
420
421 --- 1.6.9 2012/01/19
422
423 Fix SEGV that could occur for failed connections.
424
425 --- 1.6.8 2012/01/17
426
427 Fix bug for command sort that could return no results for active clients
428 (from previous search). This bug was present in 1.6.6-1.6.7.
429
430 Fix bug in results that could include results that should have been
431 filtered out. This bug was present in 1.6.6-1.6.7.
432
433 --- 1.6.7 2011/12/23
434
435 Fix bug introduced in 1.6.6 where a connection re-use could stall
436 incoming requests.
437
438 Local filtering may now specify a local metadata field, eg.
439  pz:limitmap:somefield[t]=local:otherfield
440
441 --- 1.6.6 2011/11/25
442
443 For search, when limit and or filtering is in place and search
444 is identical to previous search, the result set is re-used and the
445 target is not searched.
446
447 Limits may work perform local filtering as well, by using "local:"
448 for a limitmap.
449
450 --- 1.6.5 2011/11/01
451
452 Updated bytarget command to contain a suggestions element with misspelled
453 words and suggestions to these. pz2.js has been updated to deliver this
454 onwards as well. Only target that currently delivers this is the solr
455 client in YAZ 4.2.18.
456
457 --- 1.6.4 2011/10/28
458
459 New service definition element, xslt, that allows an embedded stylesheet
460 to be defined. This can be referred to from pz:xslt as an alternative to
461 external files.
462
463 New pz:sortmap:field setting for specifying hints on how to make
464 a target natively sort on a field. This is used for command=show in
465 conjunction with sort.
466
467 New pz:url setting for specifying the actual URL for a target. When
468 this is used the target ID is not used as URL anymore and the target ID
469 may be almost any string (not including []).
470
471 command=termlist without name parameter returns all termlists/facets.
472 Previously if name parameter was omitted, only "subject" was returned.
473
474 --- 1.6.3 2011/09/22
475
476 Make termlist sorting stable. Terms with same frequency are now sorted by
477 their display name. This makes a pretty display and improves our
478 regression test because qsort is not a stable sort.
479
480 New sort parameter value 'position'. The 'position' sorts merged records
481 by their original position from the remote target. This is primarily useful
482 for debugging and may be used for targets that already perform some kind
483 of relevance ranking. Note that sort by default is decreasing; so to get
484 records in their original order sort=position:1 must be used.
485
486 --- 1.6.2 2011/09/15
487
488 tmarc.xsl: yet another 773$g fix. Was broken in 1.6.1 as well.
489
490 Facility to change working directory for pazpar2 daemon. Option -wdir
491 sets working directory to dir. This facility is useful if core dumps
492 must be saved. In this case, the current working directory must be
493 writable by the running user, such as "nobody".
494
495 --- 1.6.1 2011/09/14
496
497 New configuration element <icu_chain> for <server>/<service> which
498 allows a named ICU rule (chain) to be defined. The names relevance,
499 sort, mergekey and facet are used for those operations. The definition
500   <icu_chain id="sort" locale="en"> ..  </icu_chain>
501 is identical to
502   <sort> <icu_chain locale="en> ... </icu_chain> </sort>
503 And so on.. for relevance, mergekey and facet as well. The latter
504 style is deprecated. The facet terms are normalized by the facet
505 rule by default. This may be changed on a metadata field basis by
506 defining the new attribute 'facetrule' for the metadata element.
507 For example:
508   <icu_chain id="myrule" locale="en"> ... </icu_chain>
509   <metadata name="author" termlist="yes" facetrule="myrule"/>
510
511 Preserve rorder for merged metadata. Fixes issue as reported by Sven
512 Porst: http://lists.indexdata.dk/pipermail/yazlist/2011-July/003230.html
513
514 tmarc.xsl: set journal-subpart to 773$ only.
515
516 --- 1.6.0 2011/09/12
517
518 Modify the behavior for the limit parameter (first defined in 1.5.7).
519 Mapping of limit searches are now defined by the new configuration item
520 pz:limitmap. Fix a dead-lock problem with the limit parameter.
521
522 Extend tmarc.xsl to extract 773$g data (OpenURL).
523
524 --- 1.5.7 2011/08/19
525
526 ICU default maps remove backquote (`).
527
528 Command 'search' takes limit parameter (optional).  The limit parameter
529 allows a search to be limited one or more facets and the corresponding
530 values. This is for server side filtering.
531
532 Configure tweak: Use -lm for log(3) if needed
533
534 --- 1.5.6 2011/04/15
535
536 Fix a problem with skiparticle sortkey that could be completely
537 ignored (and reduced to "").
538
539 Fix dependency problem in pazpar2 RPM package (did not require
540 libyaz4 as it should).
541
542 --- 1.5.5 2011/03/28
543
544 Fix memory leak that occurred for command=termlist&name=xtargets .
545
546 Pazpar2 may save HTTP requests. Enabled by option -R.
547
548 --- 1.5.4 2011/03/08
549
550 Experimental support for DTIC DADS target. New dads-pz2.xsl.
551
552 Support for query_syntax (overrides the default for SRU | Z39.50)
553
554 Support for extraArgs (ZOOM "extraArgs" option) for targets
555
556 New commands: status-server and status-session
557
558 --- 1.5.3 2011/02/18
559
560 Fix for threaded runs: Client now have a copy of the database URL,
561 which can used after the database has been release from the client.
562 This makes the logging in the connection idle timeout of the client nicer (no NOURL) and should be thread-safe.
563
564 tmarc.xsl: Add journal-title-abbrev and full text.
565
566 cf.xsl: new fields: isbn, issn, journaltitle, volume, issue
567
568 Fix for cmd=record before search.
569
570 Session Logging clean up.
571
572 Fix wrong termlist factor when maxrecs is different from 100.
573
574 --- 1.5.2 2011/01/18
575
576 Fix missing pz:termlist_term_factor in settings.c messed up pz:preferred.
577 Term factor is default enabled but can be diseabled by
578 pz:termlist_term_factor=0
579
580 --- 1.5.1 2011/01/06
581
582 Add scaling of facet count. Currently always enabled, needs fixing.
583 Allow user-defined info for target suffix. This has no meaning in
584 Pazpar2 except to distinguish targets from each other. The suffix
585 data begins with #. For example z3950.indexdata.com/gils#Mydata
586
587 Added exact-match recordfilter; format name=value
588
589 --- 1.5.0 2010/10/05
590
591 SOLR support. Pazpar2 may operate as web service client for SOLR.
592
593 --- 1.4.4 2010/08/17
594
595 Fix for show command and block=1 (dead lock). Bug was introduced in
596 1.4.0.
597
598 --- 1.4.3 2010/07/02
599
600 New RPM packages: pazpar2, pazpar2-js, pazpar2-doc. These have been
601 tested on CentOS 5.5 only.
602
603 --- 1.4.2 2010/06/18
604
605 Fix problem with result sets being removed from a client session
606 if the connection for it was resused by another session. Bug #3489.
607
608 New iphone UI for Pazpar2 (www/iphone).
609
610 --- 1.4.1 2010/05/21
611
612 Fixes for threaded operation.
613
614 New stylesheets for TurboMARC: tmarc.xsl and opac_turbomarc.xsl.
615
616 New example services in etc/services in source. In the Debian packages
617 these are located in /etc/pazpar2/services-available
618
619 Threaded mode operational on Windows. Requires Windows 7 or Windows
620 Server 2008.
621
622 Default value of setting pz:max_connections is 0 which means that there
623 is no limit on number of connections.
624
625 --- 1.4.0 2010/03/29
626
627 Pazpar2 may operate in threaded mode. Enabled by element threads in
628 the configuration. See pazpar2_conf for details.
629
630 New setting setting: pz:max_connections. Setting pz:max_connections is
631 a limit of number of sockets to a host. When this limit is reached,
632 Pazpar2 will wait up to 5 seconds for a connection to becomes available.
633 The client will be marked Client_Error when it can not be searched
634 (other clients in a session may work). If pz:max_connections is not set
635 for a target, a value of 30 will be used. Note: the pz:max_connections
636 will only work in threaded mode.
637
638 pz2.js: JSON support for show.
639
640 Debian package: Enable default service, default.xml, before starting
641 Pazpar2 only if there is no service already in /etc/pazpar2/services-enabled.
642
643 --- 1.3.0 2010/01/25
644
645 Debian version depends on on libyaz4. Note that Pazpar2 will still
646 compile from source with YAZ 3.
647
648 Split services into separate files. The example configuration file
649 pazpar2.cfg.dist now includes a default service default.xml (part of
650 etc). And default.xml includes settings/edu.xml. The default.xml file,
651 not to be confused with settings/defaults.xml, is a template for jsdemo
652 and other services. The Debian package installs /etc/pazpar2/server.xml
653 which is now the main pazpar2 configuration (used to be called pazpar2.cfg).
654 server.xml includes services from /etc/pazpar2/services-enabled/*.xml .
655 The default.xml (from etc) is installed in /etc/pazpar2/services-available
656 and a symlink to it is created from services-enabled. The default.xml
657 service is unnamed and, thus, will be used by jsdemo and test1.
658
659 New setting pz:negotiation_charset. Patch from Andrei V. Toutoukine. The
660 new setting pz:negotiation_charset specifies character set for Z39.50 Init.
661
662 --- 1.2.4 2010/01/15
663
664 Support for additional fields in cf.xsl and pazpar2.conf.dist:
665 publisher, available, due, location (=locallocation), callno
666 (=callnumber), thumburl and score.
667
668 Describe pz:xslt and the auto setting.
669
670 Move mergekey definition away from the normalization stylesheets and
671 define a mergekey common for all target types in pazpar2.cfg.
672
673 Code update: Use the Odr_int type for hit counts. This is part of
674 YAZ 3.0.47 and later and so configure checks for that.
675
676 --- 1.2.3 2009/11/24
677
678 Metadata attribute 'skiparticle' also works for ICU based
679 normalization. (was only working for the non-ICU/ASCII before).
680
681 Command bytarget with argument settings=1 will show settings per
682 target.. This is to be able to verify correct settings and be able to
683 test that they are correct. The database settings array size is now
684 also stored..  Problems with database settings array is that if not
685 careful it will be too small (smaller than dictionary per-service
686 in settings).
687
688 Make record list sorting stable by comparing mergekey for records if
689 relevance/title or other sorting criteria all match. This is merely to
690 ensure that our regressions tests works (reproducible output).
691
692 Relevance calculation changes: use a different denominator (length) for
693 per-field relevance scoring.. Instead of length of all ranked fields we
694 now use length of individual fields (as if they were individual "free"
695 text fields). This will ensure that documents with a long field with no
696 match (say description) will not "hurt" a title match.
697
698 Diagnostic member was not set on connection error. Fixed
699
700 --- 1.2.2 2009/10/13
701
702 Command search takes two optional parameters, startecs and maxrecs,
703 that specifies the start offset (0, 1, ...) and maximum number of records
704 to fetch for each target.
705
706 XSLTs + MARC maps are cached within a session so we don't re-parse
707 them over and over again. Even for a session with a single search
708 there's much to be gained because many targets use the same
709 transformation.
710
711 The metadata attribute 'mergekey' now takes one of three values 'no',
712 'required', 'optional' .  And the resulting mergekey from metadata
713 is now ordered in the same way as metadata in the service definition.
714 Older Pazpar2 version use the order in which metadata appeared in a
715 record instance.
716
717 The search argument 'filter' now offers a new operator ~ which does a
718 substring match. The = operator works as before: string match for
719 anything but pz:id, or target match for pz:id.
720
721 New setting pz:recordfilter. The value of this setting takes the
722 form name[~value]. This setting makes Pazpar2 ignore all retrieved
723 records that do not have the metadata element name with value substring
724 (if given).
725
726 Pazpar2 allows YAZ log level to be set (option -v).
727
728 --- 1.2.1 2009/10/05
729
730 For WS responses Pazpar2 creates XML header. Exception: raw record.
731
732 Setting XML files are now stored in etc/settings instead of etc. This
733 reflects the layout with the Debian package layout.
734
735 Settings may be posted for command=settings. The POSTed settings must
736 have root element 'settings' like regular setting files. In order to be
737 recognized, the POST request must use Content-Type=text/xml.
738
739 A service may be posted for command=init. This service will be used
740 during the session. The service may have its own target settings,
741 ICU config, timeout, etc. In order to be recognized, the POST request
742 must use Content-Type=text/xml.
743
744 Timeout values may be given per-service. That's element 'timeout'
745 which takes three attribute values (a subset may be given): 'session',
746 'z3950_operation', 'z3950_session'. Option -T is no longer supported
747 - used to specify session timeout.
748
749 Option -t tests the Pazpar2 configuration and returns exit code
750 (0=success, non-zero=failure). In previous version of Pazpar2, -t
751 specified local settings.
752
753 In version 1.2.0 the configuration file - after include processing -
754 was dumped to stdout. Now, the configuration is only dumped to the
755 yaz log file if option -d is given.
756
757 --- 1.2.0 2009/09/10
758
759 Configuration may now have multiple server areas. This means that a
760 Pazpar2 instance may listen on multiple ports. Virtual hosting is not
761 yet supported - on a server basis. Configuration may also have multiple
762 services .. That is repeating service elements inside a server. Each
763 has an attribute 'id' which serves as service ID. This ID in turn may
764 be used in a Pazpar2 session, by specifying parameter service=ID for
765 command init. There can be at most one unnamed service inside a server
766 which can be referred to by not specifying an service ID for command
767 init (backwards compatible). In order to partition multiple servers and
768 services a new include directive has been added. This takes an attribute
769 'src' which specifies one or more sub-files. For example to include
770 service files, one might use:
771   <server >.. <include src=/"etc/pazpar2/conf.d/*.xml"/> .. </server>.
772 It is the intention that that completely makes the settings directive
773 redundant.
774
775 Fix problem where the record command would wait forever if there were
776 no targets to wait for (activeclients == 0).
777
778 --- 1.1.1 2009/08/28
779
780 One result set is created per session (last search) rather than for
781 each connection which happen to be shared (bug #3009).
782
783 marc21 stylesheets changed for efficiency.
784
785 --- 1.1.0 2009/08/19
786
787 Session timeout may be specified on the command-line as option -T.
788
789 Pazpar2 may now be operated in a no-merged mode for records.. All records
790 will be considered unique. This mode is enabled if no mergekey is
791 generated by the normalization stylesheet (pz:xslt).
792
793 Pazpar2 caches original records from each target and the 'record' command
794 with offset returns the original record if 'syntax' and 'esn' are NOT
795 specified. This speeds up retrieval of original records but also means
796 that Pazpar2 uses more memory. The cached records will be freed when the
797 session terminates or a new search is executed.
798
799 Pazpar2 no longer uses its own ICU wrapper. Instead the ICU wrapper
800 library part of YAZ is used.
801
802 Added SRU client support.
803
804 Automatically computes pz:nativesyntax if not provided. Works for XML and
805 MARC.
806
807 --- 1.0.13 2008/11/24
808
809 Command bytarget returns name of target (if defined).
810
811 --- 1.0.12 2008/11/04
812
813 Fixed bug #2021.. location now holds all brief elements.
814
815 --- 1.0.11 2008/10/15
816
817 Fixed check for application/x-www-form-urlencoded parameters.
818
819 --- 1.0.10 2008/10/14
820
821 Fixes for IE in pz2.js.
822
823 Fixed bug #2021: non-merged, brief meta data NOT included for command=show.
824
825 --- 1.0.9 2008/05/23
826
827 Changed the JS library pz2.js to use POST for long URL (+ params).
828
829 Added installation instructions for Windows. Note: NT services is
830 NOT available until we make a new release of YAZ.
831
832 Preserve order of repeated metadata fields (they were reversed before).
833
834 More MARC21 information extracted for metadata.
835
836 --- 1.0.8 2008/04/22
837
838 Fixed bug #1162: HTML entities are not escaped properly.
839
840 Native Windows port of Pazpar2. Makefile for Visual Studio provided.
841
842 --- 1.0.7 2008/04/14
843
844 Marc21 stylesheet updated to reflect multiple full text fields
845
846 --- 1.0.6 2008/03/12
847
848 Fixed bug in pz2.js WRT DOMElement attributes on IE.
849
850 Fixed bug 2100: Database wildcards not working
851
852 --- 1.0.5 2007/11/09
853
854 Added support for retrieval of records in binary.
855
856 Fixed bug 1794: Pazpar2 does not return valid XML.
857
858 Deal with ICU not returning sortkey (resulted in SEGV before).
859
860 --- 1.0.4 2007/09/28
861
862 JavaScript library pzw2.js throws error if WS response (from Pazpar2 or
863 other) is malformed (non-wellformed XML or missing Pazpar2 OK status).
864
865 Improved diagnostics when Pazpar2 HTTP decoding fails.
866
867 Pazpar2 requests may be POSTed as using Content-Type
868 application/x-www-form-urlencoded.
869
870 Pazpar2 honors LF in HTTP headers.
871
872 Handle targets that handle negative hit counts (should not happen, but it
873 does).
874
875 --- 1.0.3 2007/09/19
876
877 ICU is used for tokenization and normalization of the following: mergekey,
878 sorting, relevance terms.
879
880 Debian package now enables ICU tokenization and normalization by default.
881
882 --- 1.0.2 2007/08/22
883
884 Exposed user setting values (i.e. non-pz: names) to the record systems in two
885 ways: Either as parameters to the normalization stylesheets (which would allow the
886 programmer to postprocess or use the values in any way) or after the normalization
887 step, in which case values are made part of the normalized record (and available for
888 sorting, termlists, display, or other interface-related use.
889
890 Implemented sorting by year.
891
892 Option -d dumps records to the current log file instead of stderr.
893
894 Fixes for compilation on cygwin.
895
896 Z39.50 client code uses pz:elements. pz:elements was recognized in
897 earlier Pazpar2 versions but it was not used for anything.
898
899 icu_chain_test is using fgets instead of getline - fixes compilation
900 on MacOSX .
901
902 Loosen the CCL query parsing so that Pazpar2 only returns error if _all_
903 query conversions fail (rather than _any_). This means targets that do
904 not support some fields are ignored in a search.
905
906 --- 1.0.1 2007/07/03
907
908 Improved handling of socket timeout for Z39.50 connections.
909
910 Misc documentation updates and spell fixes.
911
912 Debian package pazpar2 creates log rotate entry.
913
914 Debian package pazpar2-apache2 reloads Apache2.
915
916 jsdemo included in distribution. It illustrates the use of the js/pz2.js
917 JavaScript library.
918
919 --- 1.0.0 2007/06/20
920
921 First public release.
922