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