1
Changes with APR-util 1.2.7
3
*) Fix apr_dbd_init to be safe to call multiple times
4
[Bojan Smojver <bojan rexursive com>, Nick Kew]
6
*) Win32 / Netware - add missing apu_version.c for apu_version_string()
7
to the Windows and Netware specific builds. Unix platforms supported
8
this API since 0.9.1. [William Rowe, Brad Nicholes].
10
Changes with APR-util 1.2.6
12
*) Stop trying to link against Berkeley DB by default. To enable use
13
of Berkeley DB users must now explicitly pass --with-berkeley-db to
14
configure, since Berkeley DB is released under a viral license that
15
requires distribution of source code for any program that uses it.
18
*) Stop trying to link against GDBM by default. To enable use of GDBM
19
users must now explicitly pass --with-gdbm to configure, since GDBM
20
is licensed under the GPL.
23
*) Fix VPATH builds, and symlink builds where apr and apr-util
24
reside in parallel as symlinks to directories with more explicit
25
names, e.g. apr-1.x and apr-util-1.x. This solves various breakage
26
on Solaris in particular with ./buildconf and ./configure. Also
27
eliminated the nested ../apr-iconv/buildconf, given that apr-util
28
didn't bother with ../apr/buildconf, and this was inconsistant.
31
*) Fix the escape implementations for the sqlite2 and sqlite3 dbd
33
[Ronen Mizrahi <ronen tversity.com>, Garrett Rooney]
35
*) Add support for Berkeley DB 4.4 to the configure scripts.
38
*) Fix bug in test suite that cause testbuckets to write 8GB file
39
on Mac OS X. [Justin Erenkrantz]
41
Changes with APR-util 1.2.2
43
*) Teach configure how to find the Novell LDAP SDK. [Graham Leggett]
45
*) Fix usage of ldapssl_init/ldap_sslinit on platforms that support
46
these API's including Win32. Support APR_HAS_LDAP_START_TLS_S
47
flag in the Win32 LDAP API, to drop usage of ldap_start_ssl_s
48
and ldap_stop_ssl_s on Win32 by default (change the flag in apr_ldap.hw
49
to enable if supported on a given OS level). [William Rowe]
51
Changes with APR-util 1.2.1
53
*) Fix apr_rmm_realloc() offset calculation bug. [Keith Kelleman
54
<keith.kelleman oracle.com>]
56
*) Add sqlite3 support to APR DBD. [Rick Keiner <rick_keiner yahoo.com>]
58
*) Fix build failure with non-threaded APR on AIX. PR 34655.
59
[Ryan Murray <rmurray+apache cyberhqz.com>]
61
*) Add sqlite2 support to APR DBD. [Ryan Phillips <ryan trolocsis.com>]
63
*) Introduction of APR DBD layer. [Nick Kew]
65
Changes with APR-util 1.1.2
67
*) Fix libaprutil.rc for Win32 builds [William Rowe, Justin Erenkrantz]
69
Changes with APR-util 1.1.1
71
*) Fix memory leak in buckets when using APR_POOL_DEBUG mode. [Joe Schaefer]
73
*) find_apu.m4: Try installed APR-util before bundled copy if --with-apr-util
74
not passed to configure. [Justin Erenkrantz]
76
Changes with APR-util 1.1.0
78
*) LDAP: Move all certificate initialisation, and the creation of SSL
79
and TLS connections into the apr_ldap_set_option() API. Add support
80
for client certificates. [Graham Leggett]
82
*) Emit the run-time link path option in apu-config after installation
83
if the user is linking with libtool. [Justin Erenkrantz]
85
*) Port testmd4 and testmd5 to the new test suite. [Thom May]
87
*) Allow passing NULL inbuf/inbytes_left parameters to
88
apr_xlate_conv_buffer(), required to correctly terminate the
89
output buffer for some stateful character set encodings.
92
*) Link libaprutil against the libraries on which it depends.
95
*) Add apr_brigade_insert_file() function, to safely insert a file
96
into a brigade, regardless of size. [Joe Orton]
98
Changes with APR-util 1.0.2
100
*) Teach apr_ldap_init() how to handle STARTTLS in addition to the existing
101
SSL support. Add apr_ldap_option API. [Graham Leggett]
103
*) Rework the LDAP toolkit detection to be more accurate than "OpenLDAP
104
detected regardless", while remaining backwards compatible with v1.0.
107
*) Added the apr_ldap_ssl_add_cert() API to allow multiple certificates
108
to be stored and used when establishing an SSL connection to different
109
LDAP servers. [Brad Nicholes]
111
*) Fix the detection of ldap.h on Solaris - it needs lber.h to be
112
defined first. [Graham Leggett]
114
*) Add a build script to create a solaris package. [Graham Leggett]
116
Changes with APR-util 1.0.1
118
*) Add support for Berkeley DB 4.3. [Jani Averbach <jaa jaa.iki.fi>]
120
*) SECURITY: CAN-2004-0786 (cve.mitre.org)
121
Fix input validation in apr_uri_parse() to avoid passing negative
122
length to memcpy for malformed IPv6 literal addresses.
125
Changes with APR-util 1.0
127
*) Only install apu-$MAJOR-config and add appropriate detection code to
128
find_apu.m4 (APU_FIND_APU). [Max Bowsher <maxb ukf.net>]
130
*) Overhaul support for LDAP URL parsing. Instead of using incompatible
131
URL parsers and memory that needs freeing, apr-util provides a parser
132
which parses the URL and allocates memory from a pool. [Graham Leggett]
134
*) Remove support for LDAP v2.0 SDK toolkits. This will be added
135
back properly later assuming there is demand for it. In the mean
136
time, please use an LDAP v3.0 SDK toolkit. [Graham Leggett]
138
*) Add an apr_ldap_err_t structure to handle the return of LDAP
139
specific error codes. [Graham Leggett, Brad Nicholes]
141
*) Add APR functions to do the job of ldap_init(), hiding toolkit
142
specific SSL/TLS handling. Code derived from httpd util_ldap.
145
*) Add an RPM spec file derived from Fedora Core.
146
[Graham Leggett, Joe Orton]
148
*) The whole codebase was relicensed and is now available under
149
the Apache License, Version 2.0 (http://www.apache.org/licenses).
150
[Apache Software Foundation]
152
*) A new function, apr_reslist_invalidate, was added so that invalid
153
resources can be removed from a reslist instead of being returned
154
to the reslist in a broken state. [Nick Kew <nick webthing.com>]
156
*) Switch to a single, top-level make. [Greg Stein]
158
*) Add timeout feature to apr_reslist_acquire().
159
[Mladen Turk <mturk apache.org>]
161
*) Pass error codes returned from constructors all the way back to
162
the reslist consumer. Also fix a minor reslist memory leak that could
163
happen when a constructor returns an error code. PR 23492.
164
[Snke Tesch <st@kino-fahrplan.de>, Aaron Bannert]
166
*) The following header files have been removed:
170
Changes with APR-util 0.9.5
172
*) Fix corrupt output from the apr_xlate_* interfaces on AIX 4.x.
175
*) Change the order in which ldap.h and lber.h are defined, to fix
176
a compile bug in Solaris v2.8 which requires lber.h then ldap.h.
177
PR 27379. [Andrew Connors <andy.connors idea.com>]
179
*) Restore support for SHA1 passwords in apr_validate_password.
180
PR 17343. [Paul Querna <chip force-elite.com>]
182
*) Fix DESTDIR install for bundled expat library. PR 14076
183
[David S. Madole <david madole.net>]
185
*) Fix occasional crash in apr_rmm_realloc(). PR 22915.
186
[Jay Shrauner <shrauner inktomi.com>]
188
*) Fix apr_dbm_exists() for sdbm when sizeof(int) != sizeof(size_t).
191
*) The whole codebase was relicensed and is now available under
192
the Apache License, Version 2.0 (http://www.apache.org/licenses).
193
[Apache Software Foundation]
195
*) Fix xlate.c compile failure on AIX 5.2. PR 25701. [Jeff Trawick]
197
*) Fixed a bug in apr_rmm that would cause it to mishandle blocks of
198
a size close to the one requested from the allocator.
199
[Kevin Wang <xwang_tech yahoo.com>]
201
Changes with APR-util 0.9.4
203
*) Changed apr_bucket_alloc_create() so that it uses the allocator
204
from the pool that was passed in rather than creating its own.
205
Also, the bucket_allocator is now allocated from the apr_allocator_t
206
rather than using apr_palloc(). Added apr_bucket_alloc_create_ex()
207
which takes an apr_allocator_t* directly rather than an apr_pool_t*.
208
[Cliff Woolley, Jean-Jacques Clar]
210
*) Added debugging consistency checks to the buckets code. Add
211
-DAPR_BUCKET_DEBUG to the build flags to enable.
214
*) Make the version of the db library APU built against visible.
217
*) Fix a problem with VPATH builds copying the APR rules.mk into the
218
source directory rather than the build directory. [Justin Erenkrantz]
220
*) SECURITY [httpd incident CAN-2003-0189] Address a thread safety
221
issue with apr_password_validate() on AIX, Linux, Mac OS X, and
222
possibly other platforms. [Jeff Trawick, Justin Erenkrantz]
224
*) Fix a problem with LDAP configuration which caused subsequent
225
configure tests to fail since LIBS contained LDAP libraries for
226
subsequent tests but LDFLAGS no longer included the path to such
227
LDAP libraries. [Jeff Trawick]
229
*) Fix a problem preventing the use of the bundled Expat when APR-util
230
is built stand-alone. [Jeff Trawick]
232
*) Use the same compiler and preprocessor for the APR-util config tests
233
which were used by APR. The user can override this via CC and CPP.
234
This was done all along for the actual build, but not necessarily
235
for the config tests. [Jeff Trawick]
237
*) Fix apr_uuid_parse() on EBCDIC machines. [Jeff Trawick]
239
*) Fix alignment problem when allocating memory using apr_rmm. The problem
240
showed up while trying to write a double in the memory allocated.
241
[Madhusudan Mathihalli]
243
Changes with APR-util 0.9.3
245
*) Allow apr_date_parse_rfc to parse 'Sun, 06-Nov-1994 08:49:37 GMT' as a
246
valid date. [Dmitri Tikhonov <dmitri@netilla.com>]
248
*) Fix error in apu-config when symlinks are involved.
249
[Garrett Rooney <rooneg@electricjellyfish.net>]
251
Changes with APR-util 0.9.2
253
*) Fix the APR_BUCKET_IS_foo() macros so they parenthesize their parameter.
254
This fixes compile problems with some types of parameters.
255
[Jim Carlson <jcarlson@jnous.com>]
257
*) Queue overwrite, we now return the item pushed, not a reference to it.
258
[Paul Marquis <PMarquis@pobox.com, Jacob Lewallen <jlwalle@cs.ucr.edu>]
260
*) Remove include/apr_ldap.h on distclean. PR 15592. [Justin Erenkrantz]
262
*) Fix race conditions in apr_queue.
263
[Jacob Lewallen <jlwalle@cs.ucr.edu>]
265
*) Stop buildconf copying rules.mk, copy it at configure time.
268
*) Make buildconf copy rules.mk as well.
269
[Garrett Rooney <rooneg@electricjellyfish.net>]
271
*) Add --includedir flag to apu-config. [Justin Erenkrantz]
273
*) Fix brokenness in sdbm when sizeof(int) != sizeof(size_t)
274
(e.g., 64-bit AIX, 64-bit Solaris). PR 14861. [Jeff Trawick]
276
*) Have buildconf copy required files from apr so that apr-util can build
277
on its own. [Craig Rodrigues <rodrigc@attbi.com>]
279
*) Detect OpenLDAP when used with Solaris 9. PR 13427.
280
[Gary Algier <gaa@ulticom.com>]
282
*) Detect Berkeley DB 4.1 when compiled with --with-uniquenames
285
*) Allow apu-config to work in symlinked install directories when
286
'realpath' is available. [Justin Erenkrantz]
288
*) Fix bug in apr_strmatch when used with case-insensitive patterns.
291
*) Allow apr_queue to have greater than int number of elements.
294
*) Detect Berkeley DB 4.0 compiled with --with-uniquenames.
295
[Philip Martin <philip@codematters.co.uk>]
297
*) Allocate brigades from a bucket allocator rather than a pool. [Brian Pane]
299
*) Update with the latest APR renames [Thom May]
301
*) Update doxygen tags. [Justin Erenkrantz]
303
*) Add apr_ldap.hw for Windows build.
304
[Andre Schild <A.Schild@aarboard.ch>]
306
*) Add IPv6 literal address support to apr_uri_parse(), apr_uri_unparse(),
307
and apr_uri_parse_hostinfo(). PR 11887 [Jeff Trawick]
309
*) Add apr_brigade_writev() [Brian Pane]
311
*) Add support for Berkeley DB 4.1. [Justin Erenkrantz]
313
*) Add --bindir option to apu-config. [Justin Erenkrantz]
315
Changes with APR-util 0.9.1
317
*) Add versioning infrastructure.
320
*) Running "make check" in the toplevel directory or the test/ directory
321
will build and run all test programs. [Aaron Bannert]
323
*) Bug #9789 : NDBM support
324
[Toomas Soome <tsoome@muhv.pri.ee>, Ian Holsman]
326
*) Added a Thread safe FIFO bounded buffer (apr_queue) [Ian Holsman]
328
*) Changed file_bucket_setaside() to use apr_file_setaside() instead
329
of turning the file bucket into an mmap bucket. [Brian Pane]
331
*) Install libaprutil support libraries before installing libaprutil
332
itself, since on some platforms libaprutil is relinked during
333
make install and the support libraries need to exist already.
336
*) Added a Resource List API for threadsafe access to persistent
337
and dynamically created user-defined resources. [Aaron Bannert]
339
*) Adopted apr-util/xlate from apr/i18n for inclusion of apr-iconv
340
as required by missing libiconv. [William Rowe]
342
*) Adopted apr-util/crypto/ uuid and md5 from apr. [William Rowe]
344
*) Look for expat in lib64 directories. [Peter Poeml <poeml@suse.de>]
346
*) Faster implementation of apr_brigade_puts() [Brian Pane]
348
*) Fixed a segfault in apr_date_parse_rfc() for some date formats
349
where it was trying to overlay a potentially static input
350
string even though it didn't really need to.
351
[Cliff Woolley, Doug MacEachern]
353
*) Ensure that apu-config does not print libtool libraries when
354
using --libs. [Justin Erenkrantz]
356
*) Added apr_bucket_file_enable_mmap() function to the bucket
357
API to let an application control whether a file bucket may
358
be turned into an mmap bucket upon read. (The default remains
359
to do the mmap, but this function lets the app prevent the
360
mmap in contexts where mmap would be a bad idea. Examples
361
include multiprocessors where mmap doesn't scale well and
362
NFS-mounted filesystems where a bus error can result if
363
a memory-mapped file is removed or truncated.) [Brian Pane]
365
*) Added string-matching API (apr_strmatch.h) [Brian Pane]
367
*) Rearrange INCLUDES so that APRUTIL_PRIV_INCLUDES is always
368
first. [Garrett Rooney <rooneg@electricjellyfish.net>]
370
*) Add --old-expat option to apu-config to allow users of apr-util to
371
determine what expat it should expect to be installed. If the
372
flag is set to yes, it should include xmlparse.h. If it is set to
373
no, it should include expat.h. [Justin Erenkrantz]
375
*) Fix exporting of includes in apu-config. [Justin Erenkrantz]
377
*) Change bucket brigades API to allow a "bucket allocator" to be
378
passed in at certain points. This allows us to implement freelists
379
so that we can stop using malloc/free so frequently.
380
[Cliff Woolley, Brian Pane]
382
*) add apr_rmm_realloc() function
383
[Madhusudan Mathihalli <madhusudan_mathihalli@hp.com>]
385
*) renames: apr_ansi_time_to_apr_time becomes apr_time_ansi_put
386
ap_exploded_time_t becomes apr_time_exp_t
387
[Thom May <thom@planetarytramp.net>]
389
*) Add detection support for FreeBSD's expat and expat2 ports.
392
*) Deprecate check_brigade_flush(), which had several nasty bugs, and
393
which was causing apr_brigade_write()'s logic to be less than obvious.
394
Everything is now done in a slightly rearranged apr_brigade_write().
397
*) Don't add /usr/include to the INCLUDES variable on expat's account.
398
[Joe Orton <joe@manyfish.co.uk>]
400
*) Remove the autoconf 2.5x cache directory in buildconf.
401
[Joe Orton <joe@manyfish.co.uk>]
403
*) BerkleyDB should NULL out the key if it is @EOF in vt_db_nextkey
406
*) Add ability to natively fetch and split brigades based on LF lines.
409
*) add --with-berkeley-db=DIR & --with-gdbm configure flags
410
[Ian Holsman/Justin Erenkrantz]
412
*) Fix expat detection to recognize installed versions.
413
[Eric Gillespie, Jr. <epg@pretzelnet.org>]
415
*) Add find_apu.m4 to allow third-party programs that use APR-util
416
to have a standard m4 macro for detection. [Justin Erenkrantz]
418
*) Add apu-config - a shell script to allow third-party programs
419
easy access to APR configuration parameters. [Justin Erenkrantz]
421
*) Add GMT offset calculation to apr_date_parse_rfc().
424
*) Introduce the apr_rmm api, to allow relocatable memory management
425
of address-independent data stores, such as shared memory.
428
*) Rework and fix VPATH-build support. [Justin Erenkrantz]
430
*) Add support for Berkeley DB4. [Justin Erenkrantz]
432
*) Improve testdbm help. [Justin Erenkrantz]
434
*) Improve autoconf detection of DBMs. [Justin Erenkrantz]
436
*) BerkeleyDBM v2 now checks minor level for cursor ops [Ian Holsman]
438
*) Reading a file bucket bigger than APR_MMAP_LIMIT (4MB) now yields
439
a string of 4MB mmap buckets, rather than a string of 8KB heap buckets
440
plus a 4MB mmap bucket. To accomodate this, the mmap bucket destroy
441
function explicitly deletes the apr_mmap_t after last reference
442
to avoid having too much of a large file mapped at once if possible.
445
*) Multi-DBM support (via apr_dbm_open_ex). [Ian Holsman]
447
*) Use apr_mmap_dup in mmap_setaside(). [Brian Pane <bpane@pacbell.net>]
449
*) Dropped the "w" parameter from apr_bucket_heap_create() and
450
apr_bucket_heap_make(). That parameter was originally intended
451
to return the amount of data copied into the bucket, but it
452
ended up being unnecessary because that amount is invariant from
453
the size of the data and is available as b->length in the
454
resulting bucket anyway. [Cliff Woolley]
456
*) Fix Makefile conversion for BSD/OS. [Cliff Woolley]
458
*) Use APR_XtOffsetOf instead of offsetof() in the ring macros for
459
portability. [Cliff Woolley]
461
*) We now create exports.c and export_vars.h, which in turn create
462
exports.c. From this we generate two more files with different
463
purposes: aprutil.exp - list of exported symbols; and exports.lo
464
(exports.o) - an object file that can be linked with an executable
465
to force resolution of all apr-util symbols. [Aaron Bannert]
467
*) Fix Berkley DBM support [Ian Holsman <ianh@apache.org>]
469
*) Fix apr_brigade_vprintf so that it can handle more than
470
4k of data at one time. [Cody Sherr <csherr@covalent.net>]
472
*) prefix UNP_* flags with APR_URI_
475
apr_uri_components -> apr_uri_t
476
apr_uri_unparse_components -> apr_uri_unparse
477
apr_uri_parse_components -> apr_uri_parse
478
apr_uri_parse_hostinfo_components -> apr_uri_parse_hostinfo
480
s/APU_URI_/APR_URI_/g
483
*) Landed the link-to-LDAP to the build process, and the LDAP v2/v3
484
compatibility functions.
485
[Dave Carrigan <dave@rudedog.org>, Graham Leggett]
487
*) Fix URI unparse function to handle the case where it would place a @
488
when both the username and password were present but omitted.
489
[Jon Travis <jtravis@covalent.net]
491
*) Added apr_xml_parse_file() routine and a testxml program.
492
[Ian Holsman <ianh@cnet.com>]
494
*) Extend apr_bucket struct to add a pointer to a function used
495
to free the bucket. This change enables custom buckets to
496
completely specify how they are to be allocated and freed.
497
Before this change, custom buckets were required to use the
498
same memory allocation scheme as the standard APR buckets.
499
[Saeid Sakhitab, Bill Stoddard, Cliff Woolley, Roy Fielding]
501
*) Install Expat when installing APR-util. [Justin Erenkrantz]
503
*) Make APR-util configure script rely on APR. This removes the locally
504
generated copy of libtool and uses the one in APR. Fix up how we
505
call the expat configure script. Generate config.nice file.
508
*) The apr_bucket lengths are now consistently apr_size_t, while any
509
apr_brigade lengths (short of a read) are consistently apr_off_t.
510
This is required for APR_HAS_LARGE_FILES handling. [William Rowe]
512
*) apr_bucket_file_create() and apr_bucket_file_make() now take a pool
513
parameter which is the pool into which any needed data structures
514
should be created during file_read(). This is used for MMAPing the
515
file and reopening the file if the original apr_file_t is in XTHREAD
516
mode. [Cliff Woolley]
518
*) apr_brigade_partition() now returns an apr_status_t. [Cliff Woolley]
520
*) Add MD4 implementation in crypto. [Sander Striker, Justin Erenkrantz]
522
*) Moved httpd 2.0.18's util_date to apr_date and enhanced its parsing
523
capabilities. [Justin Erenkrantz]
525
*) Moved httpd 2.0.18's util_uri to apr_uri and name-protected its
526
symbols and functions. [Justin Erenkrantz, Roy Fielding]
528
*) Rename field "private" in struct apr_xml_elem to "priv" for C++
529
compatibility. PR #7727 [Joshua MacDonald <jmacd@cs.berkeley.edu>]
531
*) Make APR_IMPLEMENT_EXTERNAL_HOOK_BASE generate a
532
${namespace}_hook_get_${hookname} function to fetch the
533
list of registered hooks [Doug MacEachern]
535
*) Allow LTFLAGS to be overridden by the configure command-line
536
(default="--silent") and introduce LT_LDFLAGS. [Roy Fielding]
538
*) Add APR_SHARELOCK support to apr_sdbm_open(), locking read operations
539
with a shared lock and all write ops with an excl lock. [Will Rowe]
541
*) Namespace protect apr_sdbm, and normalize the return values (including
542
the apr_sdbm_fetch, apr_sdbm_firstkey and apr_sdbm_nextkey functions).
543
Normalized the get/clear error function names, and stores the actual
544
apr error for apr_sdbm_error_get. [Will Rowe]
546
*) Introduce an apr_fileperms_t argument to apr_dbm_open(). [Will Rowe]
548
*) Removed apr_bucket_do_create() macro, which was causing warnings
549
about unreachable code in some compilers (notably MSVC). What
550
used to be done by this macro is now done inline in the various
551
apr_bucket_foo_create() functions. [Cliff Woolley]
553
*) Make clean, distclean, and extraclean consistently according to the
554
Gnu makefile guidelines. [Justin Erenkrantz <jerenkrantz@ebuilt.com>]
556
*) Migrate the --disable-libtool changes from APR to APR-util.
557
This cleans things up, and allows more flexibility when building
558
programs. [Ryan Bloom]
560
*) Allow APR-util to be compiled without libtool. The default is
561
to use libtool, but it can turned off with --disable-libtool
562
on the configure command. [Ryan Bloom]
564
*) Repair calling convention for apr_register_optional_fn to
565
eliminate GP fault on Win32. [William Rowe]
567
*) Substantial changes to correct linkage and declarations for
568
generic hooks on dso architectures. [Ben Laurie, Will Rowe]
570
*) apr_bucket_shared_destroy() now returns a boolean value.
573
*) We have to initialize the heap buckets to the correct length.
574
we were seeing heap buckets with 17 chars in them reporting
575
a length of 9017, because they were initialized to the amount
576
of memory allocated, instead of the amount of memory used.
577
This was only an issue for heap buckets created by the
578
apr_brigade_* functions. [Ryan Bloom]
580
*) apr_bucket_init_types() and apr_bucket_insert_type() have been
581
removed... they're not needed anymore. [Cliff Woolley]
583
*) The apr_bucket_shared and apr_bucket_simple structures have been
584
removed as an API simplification/optimization. This should be
585
transparent outside APR-util except to callers who attempt to
586
directly manipulate the buckets' internal structure (which is
587
not recommended anyway) and to callers who create their own
588
bucket types. [Cliff Woolley]
590
*) apr_bucket_simple_split() and apr_bucket_simple_copy() are now
591
exported functions, which could be helpful in implementing
592
external bucket types. [Cliff Woolley]
594
*) The third parameter to apr_bucket_shared_make() is now
595
'apr_off_t length' rather than 'apr_off_t end', since the
596
end usually had to be computed by the caller and all we
597
really want is the length anyway. [Cliff Woolley]