News for release v1.5.4
[pazpar2-moved-to-github.git] / NEWS
1 -- 1.5.4 2011/03/08
2 - Experiental support for DTIC DADS target  
3 - adds dads-pz2.xsl
4 - Support for query_syntax (overrides the default for SRU | Z39.50) 
5 - Support for extraArgs (ZOOM "extraArgs" option) for targets
6 - New commands: status-server and status-session
7
8 -- 1.5.3 2011/02/18
9 - Fix for threaded runs: 
10 Client now have a copy of the database URL, 
11 which can used after the database has been release from the client. 
12 This makes the logging in the connection idle timeout of the client nicer (no NOURL)
13 and should be thread-safe. 
14 - tmarc.xsl: 
15 Add journal-title-abbrev and full text. 
16 - cf.xsl
17 New fields: isbn, issn, journaltitle, volume, issue
18 - Fix for cmd=record before search.
19 - Session Logging clean up
20 - Fix: wrong termlist factor when maxrecs is different from 100.
21
22 -- 1.5.2 2011/01/18
23 Fixes: 
24 - Missing pz:termlist_term_factor in settings.c messed up pz:preferred
25 - Term factor is default enabled but can be diseabled by pz:termlist_term_factor=0
26
27 -- 1.5.1 2011/01/06
28
29 Add scaling of facet count. Currently always enabled, needs fixing.
30 Allow user-defined info for target suffix. This has no meaning in
31 Pazpar2 except to distinguish targets from each other. The suffix
32 data begins with #. For example z3950.indexdata.com/gils#Mydata
33
34 Added exact-match recordfilter; format name=value
35
36 --- 1.5.0 2010/10/05
37
38 SOLR support. Pazpar2 may operate as web service client for SOLR.
39
40 --- 1.4.4 2010/08/17
41
42 Fix for show command and block=1 (dead lock). Bug was introduced in
43 1.4.0.
44
45 --- 1.4.3 2010/07/02
46
47 New RPM packages: pazpar2, pazpar2-js, pazpar2-doc. These have been
48 tested on CentOS 5.5 only.
49
50 --- 1.4.2 2010/06/18
51
52 Fix problem with result sets being removed from a client session
53 if the connection for it was resused by another session. Bug #3489.
54
55 New iphone UI for Pazpar2 (www/iphone).
56
57 --- 1.4.1 2010/05/21
58
59 Fixes for threaded operation.
60
61 New stylesheets for TurboMARC: tmarc.xsl and opac_turbomarc.xsl.
62
63 New example services in etc/services in source. In the Debian packages
64 these are located in /etc/pazpar2/services-available
65
66 Threaded mode operational on Windows. Requires Windows 7 or Windows
67 Server 2008.
68
69 Default value of setting pz:max_connections is 0 which means that there
70 is no limit on number of connections.
71
72 --- 1.4.0 2010/03/29
73
74 Pazpar2 may operate in threaded mode. Enabled by element threads in
75 the configuration. See pazpar2_conf for details.
76
77 New setting setting: pz:max_connections. Setting pz:max_connections is
78 a limit of number of sockets to a host. When this limit is reached,
79 Pazpar2 will wait up to 5 seconds for a connection to becomes available.
80 The client will be marked Client_Error when it can not be searched
81 (other clients in a session may work). If pz:max_connections is not set
82 for a target, a value of 30 will be used. Note: the pz:max_connections
83 will only work in threaded mode.
84
85 pz2.js: JSON support for show.
86
87 Debian package: Enable default service, default.xml, before starting
88 Pazpar2 only if there is no service already in /etc/pazpar2/services-enabled.
89
90 --- 1.3.0 2010/01/25
91
92 Debian version depends on on libyaz4. Note that Pazpar2 will still
93 compile from source with YAZ 3.
94
95 Split services into separate files. The example configuration file
96 pazpar2.cfg.dist now includes a default service default.xml (part of
97 etc). And default.xml includes settings/edu.xml. The default.xml file,
98 not to be confused with settings/defaults.xml, is a template for jsdemo
99 and other services. The Debian package installs /etc/pazpar2/server.xml
100 which is now the main pazpar2 configuration (used to be called pazpar2.cfg).
101 server.xml includes services from /etc/pazpar2/services-enabled/*.xml .
102 The default.xml (from etc) is installed in /etc/pazpar2/services-available
103 and a symlink to it is created from services-enabled. The default.xml
104 service is unnamed and, thus, will be used by jsdemo and test1.
105
106 New setting pz:negotiation_charset. Patch from Andrei V. Toutoukine. The
107 new setting pz:negotiation_charset specifies character set for Z39.50 Init.  
108
109 --- 1.2.4 2010/01/15
110
111 Support for additional fields in cf.xsl and pazpar2.conf.dist:
112 publisher, available, due, location (=locallocation), callno
113 (=callnumber), thumburl and score.
114
115 Describe pz:xslt and the auto setting.
116
117 Move mergekey definition away from the normalization stylesheets and
118 define a mergekey common for all target types in pazpar2.cfg.
119
120 Code update: Use the Odr_int type for hit counts. This is part of
121 YAZ 3.0.47 and later and so configure checks for that.
122
123 --- 1.2.3 2009/11/24
124
125 Metadata attribute 'skiparticle' also works for ICU based
126 normalization. (was only working for the non-ICU/ASCII before).
127
128 Command bytarget with argument settings=1 will show settings per
129 target.. This is to be able to verify correct settings and be able to
130 test that they are correct. The database settings array size is now
131 also stored..  Problems with database settings array is that if not
132 careful it will be too small (smaller than dictionary per-service
133 in settings).
134
135 Make record list sorting stable by comparing mergekey for records if
136 relevance/title or other sorting criteria all match. This is merely to
137 ensure that our regressions tests works (reproducible output).
138
139 Relevance calculation changes: use a different denominator (length) for
140 per-field relevance scoring.. Instead of length of all ranked fields we
141 now use length of individual fields (as if they were individual "free"
142 text fields). This will ensure that documents with a long field with no
143 match (say description) will not "hurt" a title match.
144
145 Diagnostic member was not set on connection error. Fixed
146
147 --- 1.2.2 2009/10/13
148
149 Command search takes two optional parameters, startecs and maxrecs,
150 that specifies the start offset (0, 1, ...) and maximum number of records
151 to fetch for each target.
152
153 XSLTs + MARC maps are cached within a session so we don't re-parse
154 them over and over again. Even for a session with a single search
155 there's much to be gained because many targets use the same
156 transformation.
157
158 The metadata attribute 'mergekey' now takes one of three values 'no',
159 'required', 'optional' .  And the resulting mergekey from metadata
160 is now ordered in the same way as metadata in the service definition.
161 Older Pazpar2 version use the order in which metadata appeared in a
162 record instance.
163
164 The search argument 'filter' now offers a new operator ~ which does a 
165 substring match. The = operator works as before: string match for
166 anything but pz:id, or target match for pz:id.
167
168 New setting pz:recordfilter. The value of this setting takes the
169 form name[~value]. This setting makes Pazpar2 ignore all retrieved
170 records that do not have the metadata element name with value substring
171 (if given).
172
173 Pazpar2 allows YAZ log level to be set (option -v).
174
175 --- 1.2.1 2009/10/05
176
177 For WS responses Pazpar2 creates XML header. Exception: raw record.
178
179 Setting XML files are now stored in etc/settings instead of etc. This
180 reflects the layout with the Debian package layout.
181
182 Settings may be posted for command=settings. The POSTed settings must
183 have root element 'settings' like regular setting files. In order to be
184 recognized, the POST request must use Content-Type=text/xml.
185
186 A service may be posted for command=init. This service will be used
187 during the session. The service may have its own target settings,
188 ICU config, timeout, etc. In order to be recognized, the POST request
189 must use Content-Type=text/xml.
190
191 Timeout values may be given per-service. That's element 'timeout' 
192 which takes three attribute values (a subset may be given): 'session',
193 'z3950_operation', 'z3950_session'. Option -T is no longer supported
194 - used to specify session timeout.
195
196 Option -t tests the Pazpar2 configuration and returns exit code
197 (0=success, non-zero=failure). In previous version of Pazpar2, -t
198 specified local settings.
199
200 In version 1.2.0 the configuration file - after include processing -
201 was dumped to stdout. Now, the configuration is only dumped to the
202 yaz log file if option -d is given.
203
204 --- 1.2.0 2009/09/10
205
206 Configuration may now have multiple server areas. This means that a
207 Pazpar2 instance may listen on multiple ports. Virtual hosting is not
208 yet supported - on a server basis. Configuration may also have multiple
209 services .. That is repeating service elements inside a server. Each
210 has an attribute 'id' which serves as service ID. This ID in turn may
211 be used in a Pazpar2 session, by specifying parameter service=ID for
212 command init. There can be at most one unnamed service inside a server
213 which can be referred to by not specifying an service ID for command
214 init (backwards compatible). In order to partition multiple servers and
215 services a new include directive has been added. This takes an attribute
216 'src' which specifies one or more sub-files. For example to include
217 service files, one might use:
218   <server >.. <include src=/"etc/pazpar2/conf.d/*.xml"/> .. </server>.
219 It is the intention that that completely makes the settings directive
220 redundant.
221
222 Fix problem where the record command would wait forever if there were
223 no targets to wait for (activeclients == 0).
224
225 --- 1.1.1 2009/08/28
226
227 One result set is created per session (last search) rather than for
228 each connection which happen to be shared (bug #3009).
229
230 marc21 stylesheets changed for efficiency.
231
232 --- 1.1.0 2009/08/19
233
234 Session timeout may be specified on the command-line as option -T.
235
236 Pazpar2 may now be operated in a no-merged mode for records.. All records
237 will be considered unique. This mode is enabled if no mergekey is
238 generated by the normalization stylesheet (pz:xslt). 
239
240 Pazpar2 caches original records from each target and the 'record' command
241 with offset returns the original record if 'syntax' and 'esn' are NOT
242 specified. This speeds up retrieval of original records but also means
243 that Pazpar2 uses more memory. The cached records will be freed when the
244 session terminates or a new search is executed.
245
246 Pazpar2 no longer uses its own ICU wrapper. Instead the ICU wrapper
247 library part of YAZ is used.
248
249 Added SRU client support.
250
251 Automatically computes pz:nativesyntax if not provided. Works for XML and
252 MARC.
253
254 --- 1.0.13 2008/11/24
255
256 Command bytarget returns name of target (if defined).
257
258 --- 1.0.12 2008/11/04
259
260 Fixed bug #2021.. location now holds all brief elements.
261
262 --- 1.0.11 2008/10/15
263
264 Fixed check for application/x-www-form-urlencoded parameters.
265
266 --- 1.0.10 2008/10/14
267
268 Fixes for IE in pz2.js.
269
270 Fixed bug #2021: non-merged, brief meta data NOT included for command=show.
271
272 --- 1.0.9 2008/05/23
273
274 Changed the JS library pz2.js to use POST for long URL (+ params).
275
276 Added installation instructions for Windows. Note: NT services is
277 NOT available until we make a new release of YAZ.
278
279 Preserve order of repeated metadata fields (they were reversed before).
280
281 More MARC21 information extracted for metadata.
282
283 --- 1.0.8 2008/04/22
284
285 Fixed bug #1162: HTML entities are not escaped properly.
286
287 Native Windows port of Pazpar2. Makefile for Visual Studio provided.
288
289 --- 1.0.7 2008/04/14
290
291 Marc21 stylesheet updated to reflect multiple full text fields
292
293 --- 1.0.6 2008/03/12
294
295 Fixed bug in pz2.js WRT DOMElement attributes on IE.
296
297 Fixed bug 2100: Database wildcards not working
298
299 --- 1.0.5 2007/11/09
300
301 Added support for retrieval of records in binary.
302
303 Fixed bug 1794: Pazpar2 does not return valid XML.
304
305 Deal with ICU not returning sortkey (resulted in SEGV before).
306
307 --- 1.0.4 2007/09/28
308
309 JavaScript library pzw2.js throws error if WS response (from Pazpar2 or
310 other) is malformed (non-wellformed XML or missing Pazpar2 OK status).
311
312 Improved diagnostics when Pazpar2 HTTP decoding fails.
313
314 Pazpar2 requests may be POSTed as using Content-Type
315 application/x-www-form-urlencoded.
316
317 Pazpar2 honors LF in HTTP headers.
318
319 Handle targets that handle negative hit counts (should not happen, but it
320 does).
321
322 --- 1.0.3 2007/09/19
323
324 ICU is used for tokenization and normalization of the following: mergekey,
325 sorting, relevance terms.
326
327 Debian package now enables ICU tokenization and normalization by default.
328
329 --- 1.0.2 2007/08/22
330
331 Exposed user setting values (i.e. non-pz: names) to the record systems in two
332 ways: Either as parameters to the normalization stylesheets (which would allow the
333 programmer to postprocess or use the values in any way) or after the normalization
334 step, in which case values are made part of the normalized record (and available for
335 sorting, termlists, display, or other interface-related use.
336
337 Implemented sorting by year.
338
339 Option -d dumps records to the current log file instead of stderr.
340
341 Fixes for compilation on cygwin.
342
343 Z39.50 client code uses pz:elements. pz:elements was recognized in
344 earlier Pazpar2 versions but it was not used for anything.
345
346 icu_chain_test is using fgets instead of getline - fixes compilation
347 on MacOSX .
348
349 Loosen the CCL query parsing so that Pazpar2 only returns error if _all_
350 query conversions fail (rather than _any_). This means targets that do
351 not support some fields are ignored in a search.
352
353 --- 1.0.1 2007/07/03
354
355 Improved handling of socket timeout for Z39.50 connections. 
356
357 Misc documentation updates and spell fixes.
358
359 Debian package pazpar2 creates log rotate entry.
360
361 Debian package pazpar2-apache2 reloads Apache2.
362
363 jsdemo included in distribution. It illustrates the use of the js/pz2.js
364 JavaScript library.
365
366 --- 1.0.0 2007/06/20
367
368 First public release.
369