ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/AnyEvent/Changes
Revision: 1.394
Committed: Wed Apr 28 14:15:55 2010 UTC (14 years ago) by root
Branch: MAIN
CVS Tags: rel-5_261
Changes since 1.393: +1 -0 lines
Log Message:
5.261

File Contents

# User Rev Content
1 root 1.1 Revision history for Perl extension AnyEvent.
2    
3 root 1.392 TODO: docs signal for condvar
4    
5 root 1.394 5.261 Wed Apr 28 16:13:36 CEST 2010
6 root 1.393 - AF_INET6 was not properly used from Socket6 during configuration
7     time (found by Andy Grundman).
8    
9 root 1.392 5.26 Mon Apr 12 04:49:35 CEST 2010
10 root 1.389 - don't generate spurious readyness notifications when select
11     returns EINTR in the pure perl backend (analysed and testcase
12     by Bas Denissen).
13 root 1.391 - give same examples in SYNOPSIS sections of AnyEvent and AE.
14 root 1.390 - provider faster implementations for AE::time/now/now_update for
15     EV and Perl backends.
16     - provide faster AE::cv and AE::time implementations for all
17     backends.
18     - no longer support lower/mixed-case signal names (this was
19     never documented nor universally supported).
20     - some more memory µ-optimisations, and somewhat less messy
21     code to cope with both AnyEvent and AE APIs.
22 root 1.389
23 root 1.386 5.251 Sat Mar 13 00:58:21 CET 2010
24 root 1.387 - make test failed if it was run before make install on perl <=
25     5.8.8, and older versions of perl make our live very difficult,
26     so write constants.pl during Makefile.PL time.
27 root 1.386
28 root 1.384 5.25 Sat Mar 13 00:23:14 CET 2010
29 root 1.383 - fix a race condition in AnyEvent::Handle that would cause
30     a "bio_read: unsupported method" error (in _another_
31     ssl connection) after user code threw an exception.
32 root 1.385 - added AnyEvent::Handle->destroyed method.
33 root 1.376 - speed up AnyEvent::Socket::format_address and ::format_ipv6.
34 root 1.378 - the AnyEvent::Util::fh_nonblocking function worked only
35     by lucky accident on win32.
36 root 1.377 - smaller and faster AnyEvent::Util::fh_nonblocking.
37 root 1.379 - when the (required!) Time::HiRes module is missing, AnyEvent
38     did not fall back to built-in time properly.
39 root 1.381 - do not load Fcntl at runtime, saving memory and loading time.
40     - precompile a number of constants and use them instead of runtime
41     detection and eval.
42     - free detection code after detection and similar memory optimisations.
43 root 1.382 - Perl backend timer interval best effort drift has been improved
44 root 1.388 (same algorithm as EV).
45 root 1.385 - update unicode idna mapping table.
46 root 1.376
47 root 1.375 5.24 Tue Jan 5 11:39:43 CET 2010
48     - cygwin never reports errors from failed connects. 1.5 just gives
49     you continous readyness and EAGAIN, 1.7 is even more broken and
50     just hangs. work around both issues in a cygwin-specific hack.
51 root 1.374 - improve idle watcher documentation slightly.
52    
53 root 1.373 5.23 Sun Dec 20 23:48:00 CET 2009
54 root 1.372 - support IDNs in resolve_sockaddr, and therefore in tcp_connect.
55 root 1.373 - implement punycode_encode/decode, idn_nameprep,
56     idn_to_ascii and idn_to_unicode operations in AnyEvent::Util.
57 root 1.366 - provide $AE::VERSION.
58 root 1.367 - removed traces of "no strict 'refs'".
59 root 1.366
60 root 1.365 5.22 Sat Dec 5 03:51:13 CET 2009
61 root 1.358 - downgrade-or-fail in AnyEvent::Handle::push_write, to
62     diagnose encoding failures earlier and more succinctly.
63 root 1.359 (this works around bugs in perl, throwing away encoding info
64     when passing scalar data to extensions).
65 root 1.360 - add more examples to AnyEvent::Socket manpage.
66 root 1.361 - upgrade internal warning set to the same as common::sense 2.03.
67 root 1.362 - use pack "n/a*" for pre-5.8.9 perl compatibility in AnyEvent::DNS
68     (John Beppu).
69 root 1.364 - AnyEvent::Socket::inet_aton now properly supports ipv6, as documented.
70 root 1.363 - add google public dns servers to fallback server set and make sure
71     we load-balance properly between the three sets. also add all
72     fallback dns servers, not just a random one, to each dns config.
73 root 1.358
74 root 1.357 5.21 Thu Nov 19 02:48:47 CET 2009
75 root 1.356 - fix a problem where socket constants were called with parameters
76 root 1.355 (spotted by David Friedland).
77 root 1.356 - fork_call never use'd POSIX (reported by Daisuke Maki).
78 root 1.355 - improve perl 5.6 compatibility further (but it still won't work
79     unless you rip out everything but the core).
80 root 1.357 - prefer Net::DNS::Resolver over ipconfig, if installed, on win32.
81     uses 10MB of RAM, but doesn't open a console window. *sigh*.
82 root 1.355
83 root 1.354 5.202 Wed Oct 14 22:35:44 CEST 2009
84     - AnyEvent::DNS would unexpectedly clobber $_ under windows
85     (analysed by Matthias Waldorf).
86 root 1.353 - AnyEvent::Handle::run_cmd can now pass the PID of the
87     newly-created process, which is much less useful than it might
88     sound (based on patch by Yann Kerherve).
89    
90 root 1.352 5.201 Tue Sep 29 12:09:25 CEST 2009
91 root 1.350 - AnyEvent:Handle::on_starttls/on_stoptls methods were broken
92     (reported by Torsten Foertsch).
93 root 1.351 - common::sense 2.0 could cause tcp_server to throw an exception
94     (analysed by elmex).
95 root 1.350
96 root 1.349 5.2 Mon Sep 14 07:04:49 CEST 2009
97 root 1.347 - INCOMPATIBLE CHANGE: do no longer support register_read_type
98     and register_write_type in AnyEvent::Handle, instead support
99     package names (the facility was mostly abused).
100 root 1.349 - implement "packagename-as-read/write type" support in
101     AnyEvent::Handle.
102 root 1.345 - AnyEvent::Handle: new options "keepalive" and "oobinline".
103 root 1.346 - oobinline set by default to avoid security issues.
104 root 1.349 - the pure-perl event loop backend wrongly detected times() fallback
105     support (spotted by Pavel Boldin).
106 root 1.345
107 root 1.344 5.12 Tue Sep 1 20:26:50 CEST 2009
108 root 1.343 - be more lenient when parsing resolv.conf files, as some people
109     use hashmarks as comment indicator inside directives (reported
110     by Michael S. Fischer).
111     - use same set of warnings as common::sense 2.0.
112 root 1.342 - fix a potential 32 bit overflow issue due to perl having problems
113     with large hex constants in the Perl backend.
114     - do not use the slower 5.6 version fo the enc_name code in AnyEvent::DNS
115     by default.
116 root 1.343 - fix some prototypes.
117 root 1.344 - (optionally) require Async::Interrupt 1.02.
118 root 1.343 - replace opendns fallbacks by verizon/level3 public dns servers.
119 root 1.342
120 root 1.339 5.112 Fri Aug 21 13:59:04 CEST 2009
121 root 1.338 - AnyEvent::Handle could cause hard crashes in Net::SSLeay when
122     using starttls with an illegal/uncreatable tls context.
123 root 1.339 - port to broken win32 perls.
124 root 1.338
125 root 1.337 5.111 Sun Aug 16 18:44:36 CEST 2009
126     - perl errornously requires sockaddr_un structures returned by the
127     kernel to have a specific length. work around this bug by padding
128     sockaddr_un structures (found to fail on OS X, as perl only uses
129     the correct code for GNU/Linux, but likely to fail on other
130     OSes as well).
131    
132 root 1.336 5.11 Wed Aug 12 17:49:37 CEST 2009
133 elmex 1.335 - fixed a bug in run_cmd with input from filename.
134 root 1.336 - create a json coder object when none is given in write direction
135     to reduce dependency on JSON.
136 elmex 1.335
137 root 1.334 5.1 Tue Aug 11 03:17:32 CEST 2009
138 root 1.333 - tcp_connect now reports the correct error in $!, not an unrelated
139     one (was broken since 4.91).
140     - AE::Handle did not properly clear rtimeout/wtimeout watchers
141     when retrying a tcp_connect.
142     - new functions: AnyEvent::Util::run_cmd and close_all_fds_except.
143 elmex 1.332 - fixed wrong documentation in AE::Socket.
144    
145 root 1.330 5.01 Mon Aug 10 03:16:32 CEST 2009
146     - last release broke EV child watchers :/.
147    
148 root 1.329 5.0 Sun Aug 9 17:32:09 CEST 2009
149     - officially introduce and document the AE API.
150 root 1.323 - lowering the timeout at runtime did not have immediate effect
151     in AnyEvent::Handle.
152 root 1.324 - AE::Handle now has separate and independent read and write timeout
153     settings.
154 root 1.326 - probe for Guard module when AnyEvent::Util is loaded, not at
155     runtime (Event doesn't like eval "use" from callbacks, and it avoids
156     exporting the probe function).
157 root 1.328 - Impl::IOAsync's io watchers did not use the filehandle emulation
158     code to work around it's watcher limits.
159     - work around IO::Async's problems with overloaded objects.
160     - try to disable wearnings inside IO::Async, it's just too buggy.
161 root 1.327 - do no longer use Event by default, only EV or Perl, Event is too buggy.
162 root 1.329 - hackishly provide fast AE:: interface when EV or Perl is the backend.
163 root 1.325 - inherit VERSION from AnyEvent::VERSION in most modules.
164 root 1.322
165 root 1.321 4.91 Thu Aug 6 15:42:45 CEST 2009
166 root 1.319 - AE::Handle::starttls could get out of sync when the read buffer
167     already contains some TLS handshake.
168 root 1.318 - AE::Handle did not properly free the TLS session, causing bigger
169     memory leaks in Net::SSLeay than expected (reported by toaster).
170 root 1.320 - AE::Socket::tcp_connect will now artificially delay invoking
171     the callback to avoid returning after invoking the callback.
172 root 1.321 - convert many internal watcher uses to AE API.
173 root 1.317
174 root 1.316 4.9 Sat Aug 1 11:07:01 CEST 2009
175 root 1.308 - Glib silently fails when registering a timeout with
176     a negative value, so avoid that.
177 root 1.315 - call condvar callback immediately when it is set
178     after the condition is already signalled.
179 root 1.314 - check rbuf_max condition only after trying to consume
180     data.
181 root 1.305 - normalise signal numbers to names when using the ae's
182     signal handling, but do not document this (yet).
183 root 1.308 - pure perl signal emulation did not properly set nonblocking
184     mode on the signal pipe on win32 (this is unlikely to have caused
185     any issues).
186 root 1.310 - new module: AnyEvent::Debug.
187 root 1.309 - AnyEvent::Strict now checks that a signal was specified
188     by name (not name or number).
189     - reduce memory footprint in typical cases by ~50kb by
190 root 1.308 only compiling signal code when necessary.
191 root 1.313 - add AnyEvent::Handle->rbuf_max.
192 root 1.311 - grab the AE namespace for future new API, implement stubs for
193     said future/alternative API.
194 root 1.315 - new function: AnyEvent::Socket::format_hostport.
195 root 1.305
196 root 1.303 4.881 Tue Jul 28 12:51:53 CEST 2009
197     - work around a bug in local in pre-5.10 perls, causing
198 root 1.304 AnyEvent::Handle to recurse when it should not
199 root 1.351 (analysed by elmex).
200 root 1.303
201 root 1.302 4.88 Tue Jul 28 04:04:37 CEST 2009
202 root 1.301 - re-bless the handle into a dummy package after calling
203     AnyEvent::Handle::destroy, so the user does not need to check
204     for errors after every push_write etc.
205 root 1.302 - do not attempt to run t/02_signals.t on obviously broken
206     platforms.
207 root 1.301
208 root 1.300 4.87 Sun Jul 26 02:06:16 CEST 2009
209 root 1.295 - do not attempt to linger when there is no longer a valid fh.
210 root 1.296 - enforce tls mode to be either accept or connect, do not simply
211     segfault in Net::SSLeay.
212 root 1.298 - AnyEvent::Handle can now call tcp_connect itself (new parameters
213 root 1.299 connect, on_prepare, on_connect and on_connect_error). Updated
214     tutorial accordingly.
215 root 1.297 - add AnyEvent::Impl::Irssi backend.
216 root 1.295
217 root 1.294 4.86 Mon Jul 20 23:52:29 CEST 2009
218     - since the verbose warning is not enough, explicitly document
219     that versions before 1.33 of Net::SSLeay are not secure.
220 root 1.292 - work around signal handling races in Event and (...) Event::Lib.
221 root 1.293 - try to align signal-race timer to full-second boundaries.
222     - work around Tk not liking negative timeouts.
223 root 1.292 - don't complain of different grades of environmental unfriendlyness
224 root 1.302 in IO::Async.
225 root 1.292
226 root 1.290 4.85 Sat Jul 18 06:16:14 CEST 2009
227 root 1.287 - nail the signal race problem in perl once and for all
228     (see $AnyEvent::MAX_SIGNAL_LATENCY).
229     - take advantage of Async::Interrupt if it is available.
230     - load Time::HiRes and Guard modules on demand only.
231     - add optional/recommended modules section to AnyEvent
232     documentation.
233 root 1.288 - reduce memory usage considerably (and reduce startup penalty)
234     by not using "strict", "warnings" and "overload" modules.
235 root 1.289 - work around buggy windows/openbsd perls and provide EBADMSG
236     and EPROTO ourselves when missing.
237     - improve perl 5.6 compatibility of the core event loop.
238     - made Net::SSLeay version 1.33 a soft requirement.
239 root 1.286
240 root 1.285 4.83 Fri Jul 17 16:56:26 CEST 2009
241 root 1.284 - implement AnyEvent::Socket::getprotobyname.
242 root 1.283 - AnyEvent::CondVar's will now detect recursive blocking
243 root 1.284 waits and will croak, as too many people fall into
244     this trap.
245 root 1.281 - AnyEvent::Handle will now call ->destroy on itself after
246     executing the on_error callback, instead of doing some
247     half-baked internal shutdown, for fatal errors.
248 root 1.282 - clarify on_eof behaviour w.r.t. the read queue and
249     on_read callbacks.
250 root 1.281 - ignore some possible spurious wake-ups in tcp_connect.
251 root 1.279
252 root 1.278 4.82 Sat Jul 11 00:34:55 CEST 2009
253 root 1.277 - POE and Event backends didn't accept some callable objects as
254     callbacks.
255 root 1.275 - use Config module instead of POSIX module to detect signal names
256     in AnyEvent::Strict and AnyEvent::Impl::EventLib, as the POSIX
257     module doesn't even have all POSIX signals :/.
258 root 1.276 - use more workarounds around the many refcnt/corruption bugs in
259     Event::Lib.
260     - work around a race condition in perl's select, causing t/03_child.t
261     to rarely fail.
262 root 1.275
263 root 1.274 4.81 Thu Jul 9 10:30:30 CEST 2009
264 root 1.272 - AnyEvent::Handle didn't properly diagnose write errors
265     (it expected -1 from syswrite, how lame... :).
266 root 1.268 - support file descriptors in addition to file handles
267     in AnyEvent->io.
268 root 1.265 - new env variables: PERL_ANYEVENT_RESOLV_CONF,
269 root 1.266 PERL_ANYEVENT_MAX_OUTSTANDING_DNS, PERL_ANYEVENT_CA_FILE
270     and PERL_ANYEVENT_CA_PATH.
271 root 1.267 - provide a sensible synopsis section for AnyEvent::TLS.
272 root 1.273 - add a "supported backends" section to the manpage.
273 root 1.270 - added simple io watcher test to testsuite, using a
274     portable_socketpair.
275 root 1.271 - tried to improve the stability of the Event::Lib backend,
276     YMMV.
277 root 1.265
278 root 1.264 4.8 Mon Jul 6 23:45:16 CEST 2009
279 root 1.261 - AnyEvent::DNS did not properly follow CNAME records with
280     uppercase targets.
281 root 1.262 - AnyEvent::DNS would errornously return AAAA records
282     with v4 mapped addresses (a faulty record) as ipv4 addresses,
283     causing AnyEvent::Socket to throw an exception.
284 root 1.260 - added new module AnyEvent::TLS for easier SSL/TLS context
285     creation, with many options including hostname verification,
286     secure default configuration, lots of documentation and,
287     predefined diffie-hellman keys for perfect forward security
288     and much more. get it while it's still fresh!
289     - use AnyEvent::TLS in AnyEvent::Handle for context management.
290 root 1.256 - load AnyEvent::Handle only on demand in AnyEvent::DNS,
291     so AnyEvent::Socket users have smaller memory footprint
292     in the common case.
293 root 1.258 - add AnyEvent::Handle->push_shutdown method.
294     - add an additional error message parameter to AnyEvent::Handle's
295     on_error callback (for TLS, $! is still available).
296 root 1.263 - add AnyEvent::Handle on_starttls/on_stoptls callbacks.
297 root 1.257 - make AnyEvent::Handle more robust against early conenction
298     failures (during new), and return C<undef> in that case
299     from the constructor.
300 root 1.259 - AnyEvent::Handle will now try to load only JSON::XS first,
301     then fall back to JSON.
302 root 1.262 - format_ipv4/format_ipv6 are now exported by default, for symmetry,
303     and because it was documented that way.
304 root 1.256
305 root 1.258 4.451 Fri Jul 3 00:28:58 CEST 2009
306     - do not clear rbuf when shutting down an AnyEvent::Handle
307     object - doing so breaks AnyEvent::HTTP.
308    
309 root 1.255 4.45 Mon Jun 29 22:59:26 CEST 2009
310     - a write error could cause AnyEvent::Handle to create
311     an I/O watcher with an undefined $fh.
312 root 1.251 - special-case mapped ipv4 addresses in both
313     AnyEvent::Socket::format_address and parse_address,
314     to treat them just like ipv4 addresses.
315 root 1.254 - updated and overhauled the AnyEvent::Intro doc.
316 root 1.252 - implement AnyEvent::Socket::format_ipv4/ipv6.
317     - slightly speed up portable_pipe/socketpair.
318 root 1.255 - expand condvar begin/end documentation.
319 root 1.250
320 root 1.249 4.42 Fri Jun 26 08:32:18 CEST 2009
321 root 1.248 - preliminary and neccesarily incomplete support for IO::Async.
322 root 1.247 - reset SIGCHLD to DEFAULT when AnyEvent is loaded, in
323     case it was set to IGNORE, to ensure we can catch child statuses
324     even when the calling env acts stupidly.
325 root 1.248 - updated benchmarks with IO::Async, which performs very well.
326 root 1.247
327 root 1.245 4.412 Wed Jun 24 01:35:57 CEST 2009
328 root 1.242 - support an "untaint" attribute for AnyEvent::DNS
329     and set it on the default resolver.
330 root 1.241 - implement and document AnyEvent::Impl::Perl::loop.
331 root 1.242 - remove all anyevent-env variables from %ENV
332     when running in tainted mode.
333 root 1.244 - mention and extend the IO::Lambda benchmark.
334 root 1.241
335 root 1.240 4.411 Sun Jun 7 18:48:02 CEST 2009
336 root 1.239 - do not try to use F_SETFD on windows.
337    
338 root 1.238 4.41 Thu May 14 06:40:11 CEST 2009
339 root 1.236 - work around issues in older perls (5.8.0?) when
340     a signal handler is deleted from the %SIG hash.
341 root 1.237 - use POSIX::_exit in child test, to avoid running
342     destructors.
343     - speed up CHLD handling by relying on SIGCHLD being
344     synchronously delivered, even when we roll our own
345     implementation.
346 root 1.238 - AnyEvent::DNS: add the "dname" resource record name
347     for cosmetic reasons.
348 root 1.235
349 root 1.234 4.4 Sun Apr 26 20:12:33 CEST 2009
350     - implemented idle watchers, where applicable.
351 root 1.232 - AnyEvent->time died when Event backend was in use.
352     - fix a memleak in the Tk backend.
353     - sped up Tk timer handling.
354 root 1.233 - clip negative "after" values to 0 in AnyEvent::Impl::Event
355     to avoid spamming out warning messages.
356 root 1.232 - fix Qt timers without interval.
357 root 1.242 - avoid Qt zero-timeout special case, in old libqt's.
358 root 1.232
359 root 1.231 4.352 Mon Apr 20 16:31:11 CEST 2009
360 root 1.229 - fix AnyEvent::Strict error messages for child watchers.
361 root 1.230 - fix/update Makefile.PL "recommends" versions.
362     - add AnyEvent->now_update.
363 root 1.229
364 root 1.228 4.351 Sat Apr 11 07:56:14 CEST 2009
365 root 1.225 - actually make the signal pipe work under win32.
366 root 1.227 - localise $! in signal handler to avoid changing $!, although
367     perl itself does not seem to save/restore errno either.
368 root 1.226 - set the cloexec flag on the signal pipe (normally set by perl too).
369 root 1.225
370 root 1.224 4.35 Fri Mar 27 11:48:20 CET 2009
371 root 1.220 - event models relying on AnyEvent's signal watcher emulation did
372     invoke the callback asynchronously, contradicting documentation
373     and causing signals to get lost (this includes AnyEvent's own
374     event loop). AnyEvent now uses the standard pipe trick to make
375     callback execution synchronous to the event loop.
376 root 1.224 - AnyEvent::Handle didn't free TLS context data on DESTROY
377 root 1.223 (patch by Pavel Shaydo).
378 root 1.220 - work around the ever-incompatibly-changing API of MakeMaker.
379 root 1.221 - document that changing global variables without restoring them
380     is a bad idea in Perl (noted by Adam Rosenstein).
381 root 1.224 - AnyEvent::Strict now barfs if ->io is passed a file.
382 root 1.220
383 root 1.219 4.34 Thu Feb 12 18:32:45 CET 2009
384 root 1.218 - separately buffer TLS read data, as otherwise the read queue could
385     deadlock as receiving data is not expected while draining the
386     read queue (which cna only happen with TLS).
387 root 1.214 - raise EBADMSG error on JSON decoding errors.
388 root 1.215 - fix some minor manpage bugs (reported by Maximilian Gaß).
389     - speed up select bitmask parsing quite a bit in the pure perl
390     backend.
391 root 1.216 - use CORE::select instead of just select in AnyEvent::Impl::Perl.
392 root 1.214
393 root 1.213 4.331 Tue Jan 6 21:07:25 CET 2009
394 root 1.212 - socketpair fails on many vista machines because vista has
395     completely broken accept/getpeername and getsockname functions,
396     so we provide our own socketpair emulation that kind of works
397     (AnyEvent::Util::portable_pipe).
398     - new function: AnyEvent::Util::portable_socketpair.
399 root 1.211 - take advantage of the Guard module if it exists.
400    
401 root 1.210 4.33 Fri Nov 21 02:35:40 CET 2008
402     - AnyEvent::Strict did errornously flag a fileno of 0 as
403     illegal.
404 root 1.206 - reduce memory usage and slightly speed up the pure perl backend
405     by only storing the file descriptor, not the file handle.
406 root 1.207 - add missing autocork method to AnyEvent::Handle (reported
407     by Adam Rosenstein).
408 root 1.209 - AnyEvent::DNS->resolve errornously documented an $rcode result
409 root 1.208 argument, but there isn't (spotted by Henrik Krohns).
410 root 1.209 - the naked truth about Tk - it's basically unmaintained.
411 root 1.206
412 root 1.205 4.32 Mon Nov 3 22:46:32 CET 2008
413 root 1.204 - fix AnyEvent::Socket::resolve_sockaddr to properly support
414     unix sockets again and choose a proper default for
415     the socket type.
416     - fix call to resolve_sockaddr in tcp_connect.
417    
418 root 1.203 4.31 Thu Oct 30 04:41:48 CET 2008
419 root 1.200 - implemented AnyEvent::Handle->destroy method.
420 root 1.203 - hint about unexpected effects in TLS mode.
421 root 1.200 - speed up AnyEvent::Impl::Perl by using more arrays
422     instead of hashes without the slightest loss of readability :)
423 root 1.201 - work around a perl argument refcounting bug.
424 root 1.202 - with some perl patches applied, AnyEvent now seems leak-free.
425 root 1.198
426 root 1.197 4.3 Fri Oct 3 09:18:43 CEST 2008
427 root 1.196 - AnyEvent will now install a no-op signal handler for SIGPIPE,
428     unless one has been installed already.
429 root 1.197 - warn about not loaidng AnyEvent::Impl::POE early enough
430     (patch by Adam Rosenstein).
431 root 1.390 - fixed a great number of bugs and corner cases in AnyEvent::Handle.
432 root 1.193 - fix a bug in where in SSL connect mode, the
433 root 1.191 client would first wait for some data by the server and
434 root 1.351 otherwise hang. (reported and analysed in an absolutely
435 root 1.191 exemplary manner by Adam Rosenstein).
436 root 1.193 - fix a bug in where SSL EOF would not be treated
437 root 1.191 as stream EOF, putting the connection into a hung state.
438 root 1.351 (reported and analysed in an absolutely exemplary manner by Adam
439 root 1.191 Rosenstein).
440 root 1.193 - fix a potential segfault when the TLS context
441 root 1.191 would go missing in a read callback (e.g. due to stoptls) -
442     Net::SSLeay of course makes no type checking whatsoever.
443 root 1.192 - AnyEvent::Handle will not stop the read watcher in TLS mode.
444     - AnyEvent::Handle->stoptls will send a TLS close notify
445     instead of simply destroying the stream now.
446 root 1.195 - fix a bug where large blocks of data written in TLS mode
447     would not be sent unless triggered by receives.
448 root 1.193 - on_drain will now take the tls write buffer into account.
449     - SSL operations have been streamlined a bit and should be faster
450     now, more to come, though.
451 root 1.194 - added a FAQ section, will document nontrivial issues in there.
452 root 1.191
453 root 1.190 4.234 Mon Sep 29 04:08:13 CEST 2008
454 root 1.189 - fix child watcher documentation: only child exits will be reported,
455     no trace events.
456 root 1.190 - mention SIGPIPE in AnyEvent::Handle.
457     - perl backend will now use POSIX::times as monotonic clock
458 root 1.188 when available and the monotonic clock option is not.
459 root 1.187 - run even without Time::HiRes in some cases now, but do not
460 root 1.190 provide sub-second accuracy (all *supported* perl versions have
461 root 1.187 Time::HiRes).
462    
463 root 1.186 4.233 Fri Aug 22 01:48:05 CEST 2008
464     - fix a bug in the testsuite, causing a hang.
465     - clarified lots of AnyEvent::Handle constructor arguments.
466    
467 root 1.185 4.232 Thu Aug 21 20:44:25 CEST 2008
468     - fix a bug in AnyEvent::Handle that could cause two fatal error
469     callbacks on EOF, which caused AnyEvent::HTTP to signal success twice
470     (testcase by Leon Brocard).
471     - clarified on_eof/on_error documentation a bit.
472    
473 root 1.184 4.231 Tue Jul 29 13:12:15 CEST 2008
474     - remove some debugging code left in AnyEvent::Util::fork_call
475     (and no, it's impossible to implement with the broken windows
476     perls without resource leaks or worse).
477    
478 root 1.183 4.23 Tue Jul 29 12:19:59 CEST 2008
479 root 1.177 - document the first parameter passed to condvar callbacks to be
480     the callback.
481 root 1.178 - add AnyEvent::Socket::{ntoa,aton} aliases.
482 root 1.180 - optimize the AE::Handle->push_read (line) for the default
483 root 1.179 eol marker.
484 root 1.180 - optimize push_read (packstring|storable) for small packets.
485 root 1.182 - invoke on_error callback when no on_eof callback is set.
486 root 1.180 - fix a bug in push_read (storable) of unknown impact.
487 root 1.177
488 root 1.176 4.22 Sun Jul 20 16:34:13 CEST 2008
489 root 1.174 - new function AnyEvent::Socket::parse_hostport.
490 root 1.175 - as the bulkheads at microsoft can't even get getprotobyname reliably
491     working on their shitty fucking broken os we need to hardcode
492     some common protocol numbers in AnyEvent::Socket. How can
493     people even bother with such a pile of shit as windows.
494 root 1.174
495 root 1.173 4.21 Thu Jul 17 14:40:05 CEST 2008
496 root 1.171 - INCOMPATIBLE CHANGE: AnyEvent::Util::fork_call now has a prototype
497     which is incompatible to previous invocation syntax.
498 root 1.172 - work around more windows perl bugs in fork_call. I cannot imagine
499     why anybody would bother implementing fork in such an obviously
500     unusable way.
501     - avoid calling $do_retry if the request has already finished in
502     AnyEvent::DNS, thus avoiding an exception (reported by Anatoly
503     K. Sharifulin).
504 root 1.170
505 root 1.169 4.2 Sat Jul 12 22:42:11 CEST 2008
506 root 1.165 - support an "interval" argument for repeating timers.
507 root 1.164 - fix a bug in the pure perl event loop that caused timers to
508     be delayed under some circumstances.
509 root 1.167 - implement optional argument checking via PERL_ANYEVENT_STRICT.
510 root 1.169 - not importing anything from Event causes it to malfunction
511     and not use Time::HiRes, work around this bug.
512     - more bug workarounds against the endlessly broken Tk module,
513 root 1.168 seems to work now on 32 bit machines, but less so on 64 bit.
514 root 1.164 - minor optimisations applied to most backends.
515    
516 root 1.163 4.161 Fri Jul 4 14:24:48 CEST 2008
517 elmex 1.162 - fixed the t/handle/02_write.t, it read after write, with the
518 root 1.163 assumption that all data could be written before read
519     (reported by Jim Razmus).
520 elmex 1.162
521 root 1.161 4.160 Thu Jul 3 04:02:21 CEST 2008
522 root 1.160 - re-registering signal watchers after unregistering one did
523     not work if a backend falls back on AnyEvent's default
524     implementation (also affected child watchers).
525 root 1.159 - new AnyEvent::Handle options: autocork and no_delay.
526    
527 root 1.158 4.152 Sun Jun 22 14:15:44 CEST 2008
528 root 1.159 - allow for 32-bit perls that implement shifts differently
529     on different architectures in parse_ipv4 (reported and
530 root 1.158 analysed by Keiichi DAIBA).
531    
532 root 1.157 4.151 Fri Jun 6 17:34:24 CEST 2008
533     - make sure specifying _only_ on_read and never pushing reads
534     works.
535    
536 root 1.155 4.15 Fri Jun 6 13:00:46 CEST 2008
537 root 1.154 - the pure perl backend would keep some watchers alive when more than
538     one watcher was registered for the same fd.
539 root 1.155 - new "packstring" and "storable" read and write types
540     for AnyEvent::Handle.
541 root 1.156 - allow on_eof handler to be called after on_error with EPIPE returns.
542 root 1.153 - do not immediately call on_read callback in handle constructor.
543    
544 root 1.152 4.14 Thu Jun 5 20:29:31 CEST 2008
545 elmex 1.149 - Fixed a bug in DNS SRV priority sorting.
546 root 1.150 - AnyEvent::Util::guard now reports runtime errors while
547     executing the guard block as warnings.
548 root 1.152 - handle 0-byte-reads just before EOF correctly in AnyEvent::Handle.
549 elmex 1.149
550 root 1.148 4.13 Thu Jun 5 00:47:59 CEST 2008
551 root 1.146 - AnyEvent::DNS only followed cname chains with length 2,
552     contrary to documentation. bumped it up to 10, thanks to
553     microsoft, the current broken-dns-config-king.
554 root 1.147 - AnyEvent::DNS didn't check for socket return status
555     but instead relied on perl not creating filehandles in that
556     case - too bad it gives you a bogus file handle (reported
557     and analysed by Vladimir Timofeev).
558 root 1.145 - fix queue management logic in AnyEvent::Handle:
559     when on_read was registered, the queue was empty
560     and no progress could be made AnyEvent::Handle would
561     enter an endless loop.
562     - correctly start reading again when the handle became
563     busy again after idling.
564 root 1.146 - correctly treat tls shut-downs as EOF condition
565     (for the time being, would be nice to have a callback for that).
566 root 1.145 - correctly call eof callback under all conditions
567     (hopefully).
568 root 1.146 - the timeout callback did not expect that $self can go
569     away any time.
570 root 1.145
571 root 1.144 4.12 Tue Jun 3 10:58:04 CEST 2008
572     - include AnyEvent::Intro, a tutorial for anyevent,
573     anyevent::socket and anyevent::handle.
574 root 1.143 - allow more options in on_error.
575 root 1.142
576 root 1.141 4.11 Fri May 30 23:42:25 CEST 2008
577 root 1.135 - INCOMPATIBLE CHANGE: replace ptr by real PTR lookup, provide
578     reverse_lookup and reverse_verify to replace it, support
579     v4mapped and v4compat addresses.
580 root 1.129 - provide more documentation for the resolver class.
581 root 1.130 - really replace longest run of :0: by :: in format_address,
582     also properly convert :: and ::1 again.
583 root 1.134 - support NAPTR record name and decode it.
584 root 1.133 - implement random weight sampling for SRV records, as per
585     rfc 2782.
586 root 1.137 - correctly abort on srv-record targets of ".".
587     - added AnyEvent::DNS::wait_for_slot.
588 root 1.138 - in the unlikely event of a virtual circuit connection
589     being invalidated by a delayed udp reply, AnyEvent::DNS
590     could die. this has been fixed.
591     - plug a probable memleak in the DNS vc code.
592     - use configured timeout also for VC request phase.
593 root 1.139 - implement timeout and max_outstanding methods
594     for resolver class.
595 root 1.140 - update version numbers in all modules.
596 root 1.129
597 root 1.128 4.1 Thu May 29 05:45:40 CEST 2008
598 root 1.123 - INCOMPATIBLE CHANGE: renamed xxx_ip functions to xxx_address
599     which mirrors their purpose better (old names still available
600     for a while). Also moved AnyEvent::DNS::addr to
601     AnyEvent::Socket::resolve_sockaddr.
602 root 1.127 - implement AnyEvent->time and AnyEvent->now.
603 root 1.124 - fix IPv6 support in pack_sockaddr.
604 root 1.123 - officially un-experimentalise all newly introduced code.
605     - support unix domain sockets everywhere by specifying
606     a host of "unix/" and the pathname as service.
607 root 1.126 - implement an activity timeout in AnyEvent::Handle.
608 root 1.122 - added a regex read type to AnyEvent::Handle.
609     - added a json read/write type to AnyEvent::Handle.
610 root 1.118 - always croak in on_error in AnyEvent::Handle.
611     - document how to subclass AnyEvent::Handle.
612 root 1.120 - implement AnyEvent::Util::fork_call.
613 root 1.127 - add support for IPv6 nameservers and nameserver statements.
614 root 1.121 - work around _yet_ _another_ windows perl bug in where empty
615     select masks cause errors in the pure perl backend (this
616     workaround cannot be implemented for the other event loops,
617     but EV also works around this).
618 root 1.123 - supply AnyEvent::Socket::address_type and make good use of it.
619 root 1.122 - clarify and fix the Handle documentation w.r.t $self vs. $handle
620     vs. callback arguments.
621 root 1.127 - add some recommends to the META.yml.
622 root 1.117
623 root 1.116 4.05 Mon May 26 19:44:06 CEST 2008
624     - some platforms ignore the rfc and prepend an extra sa_len member to
625     the sockaddr structure, cater for those. also use sockaddr_family,
626     didn't know it was there, but comes in handy for the workaround.
627 root 1.114 - undo the import WIN32 hack.
628    
629 root 1.113 4.04 Mon May 26 08:03:31 CEST 2008
630 root 1.109 - try to work around yet another windows bug: failed connects are reported
631 root 1.110 as if it were out-of-band data. windows users: you suck. Only
632     EV, Glib, Event and the pure perl backend can handle this condition.
633 root 1.111 - optimize write algorithm in AnyEvent::Handle.
634 root 1.106 - properly parse PERL_ANYEVENT_PROTOCOLS and use the info correctly.
635 root 1.112 - tcp_connect now properly iterates through all targets.
636 root 1.104 - check wether IPv6 sockets can actually be created, otherwise, disable ipv6
637 root 1.114 support entirely. also hardcode some AF_INET6 constants for the
638 root 1.107 sake of perl 5.8.
639 root 1.106 - vastly improved nameserver/suffix detection algorithm for windows
640     (still a hack...)
641     - try to use a fallback dns server if no dns servers could be found.
642 root 1.108 - splatter around some local $SIG{__DIE__}'s to work around bad
643     die handlers.
644 root 1.104
645 root 1.102 4.03 Sun May 25 05:05:57 CEST 2008
646 root 1.100 - work around perl bugs on windows, where perl returns undocumented
647     error codes for sysread, syswrite etc.
648 root 1.96 - fix AnyEvent::Handle::unshift_read to really unshift and not push.
649 root 1.97 - AnyEvent::Handle could sometimes stumble over 0-byte writes.
650 root 1.101 - fix unpack_sockaddr, now works for AF_INET6 sockaddr's.
651 root 1.100 - updated documentation.
652 root 1.103 - lots of workarounds for perl 5.8 quirks.
653 root 1.98 - implement a more flexible type system for both reads and writes
654     in AnyEvent::Handle.
655 root 1.101 - support IPv6 in tcp_server.
656     - pass local hostname and port to the prepare callback in tcp_server.
657 root 1.99 - make types extendable in AnyEvent::Handle.
658 root 1.100 - croak, not die, in AnyEvent::Handle;
659 root 1.96
660 root 1.95 4.0 Sat May 24 19:58:08 CEST 2008
661 root 1.88 - added (experimental) AnyEvent::DNS module.
662     - added (experimental) AnyEvent::Socket module.
663 root 1.93 - added (experiemntal) support for TLS/SSL in AnyEvent::Handle.
664 root 1.90 - make condvar->end call ->send as documented.
665     - make condvar constructor support the documented cb => argument.
666 root 1.94 - overload condvars so you can use them instead of code references.
667 root 1.93 - support more of the POSIX forms instead of a pure dotted quad for
668 root 1.89 verbatim ip addresses.
669 root 1.88 - AnyEvent::Socket::inet_aton will use AnyEvent::DNS now and not fork anymore.
670 root 1.87 - try very hard not to freeze on broken windows perls.
671 root 1.86 - make on_eof optional in AnyEvent::Handle.
672 root 1.83 - support service names in tcp_connect and tcp_server.
673 root 1.84 - work around netbsd/openbsd bug causing unix sockets not to
674 root 1.121 become writable until empty.
675 root 1.81 - only make a dummy read for error detection when getpeername
676     returns ENOTCONN.
677 root 1.181 - defend AnyEvent::Util::inet_aton against Coro::LWP's brutal
678 root 1.82 override.
679 root 1.91 - new AnyEvent::Guard::cancel.
680 root 1.81
681 root 1.80 3.5 Sat May 17 23:17:14 CEST 2008
682 root 1.79 - gracefully deal with systems not defining CLOCK_MONOTONIC
683     (as opposed to not supporting the clock itself, which worked in 3.41).
684 root 1.77 - added AnyEvent::Util::tcp_connect and AnyEvent::Util::tcp_server
685     helpers, to replace the ill-designed AnyEvent::Socket class.
686     - added some examples (eg/connect, eg/handle).
687     - added AnyEvent::Util::guard.
688     - AnyEvent::Util now exports most of its functions.
689 elmex 1.74 - fixed a bug in *_read_chunk, where the callback was called with $self as
690     first and second argument.
691 root 1.77 - simplified and fixed regex handling in AnyEvent::Handle::*_read_line.
692 root 1.72 - fix manpage condvars examples to use new syntax.
693 root 1.78 - considerably improve inet_aton with EV::ADNS backend to support
694     cname chains (common dns configuration bug, e.g. with www.google.de)
695     and aaaa records if no a record could be found.
696 root 1.72
697 root 1.71 3.41 Sun May 11 19:53:13 CEST 2008
698     - work around a bug in perl 5.8.8's local. Reported by Yi Ma Mao.
699    
700 root 1.70 3.4 Sun May 11 00:29:25 CEST 2008
701 root 1.181 - complete re-implementation of condvars with a hopefully much more useful
702 root 1.70 API (backward compatible functions exist but are undocumented).
703 root 1.69 - AnyEvent::Handle fully rewritten with a hopefully more powerful API
704     (still subject to change).
705 root 1.63 - take advantage of CLOCK_MONOTONIC, if available, in AnyEvent::Impl::Perl.
706 root 1.68 - provide AnyEvent::post_detect and @AnyEvent::post_detect, which
707 root 1.67 allows module authors to avoid forcing event loop detection.
708     (used by Coro::AIO, Coro::BDB, Coro::AnyEvent for example).
709 root 1.66 - remove coro backends: Coro now provides generic support for AnyEvent
710     via Coro::AnyEvent.
711 root 1.63
712 root 1.62 3.3 Mon Apr 28 09:51:06 CEST 2008
713     - added AnyEvent::Handle, AnyEvent::Socket and AnyEvent::Util modules.
714 root 1.55 - fix a bug in the pure perl backend that kept watchers alive
715     when multiple watchers were registered for the same fh/poll combo.
716 root 1.54 - add a benchmark section showing AnyEvent overhead and comparing
717     the different event loops with each other.
718 root 1.56 - prefer pure perl over tk when autoprobing, as it's about as fast,
719     but doesn't crash with many watchers.
720 root 1.62 - declare Qt support non-experimental.
721 root 1.56 - clarify the confusing section about the file descriptor being
722     kept alive.
723     - document the race between loading of an event module and
724     child processes exiting.
725 root 1.53 - support POE as "backend" (with some caveats, POE is not generic
726 root 1.54 enough, and darn slow).
727 root 1.53 - support Wx and Prima through POE.
728 root 1.60 - optimise perl backend to use 20% less memory and take advantage
729 root 1.62 of typical timeout behaviour. It can now compete with
730 root 1.60 select/poll-based C event loops in most cases (it is usually
731     faster than Event and Glib :).
732 root 1.59 - roughly cut EV memory use in half and increase its speed by 30%,
733 root 1.62 by removing undocumented functionality. Did something similar
734     to other event loops where possible.
735 root 1.53
736 root 1.50 3.2 Thu Apr 24 10:10:40 CEST 2008
737 root 1.51 - do not die when anyevent watchers are destroyed while running callbacks
738     in the pureperl backend (could only happen when two watchers are registered
739     for the same fh/poll combo).
740     - support autoloading for child watchers, was broken in all versions.
741 root 1.47 - implement PERL_ANYEVENT_MODEL env variable.
742 root 1.49 - (experimental) implement interface to the (very crashy/buggy) Event::Lib module.
743     - (experimental) implement interface to the Qt module (cannot be autoprobed).
744 root 1.52 - this release is IO:AnyEvent-proof.
745 root 1.47
746 root 1.46 3.12 Tue Apr 22 07:11:46 CEST 2008
747     - reinstate AUTHOR section that got lost somehow.
748     - do not hang in the testsuite with badly broken perls (activestate,
749     strawberry...), but instead diagnose the problem and continue.
750     - use INT instead of CHLD in an attempt to support broken windows perls
751     better (this decreases the test quality, unfortunately).
752     - do not send the signal to the process group
753     (no problem for CHLD, bad for INT :).
754    
755 root 1.45 3.11 Sat Apr 19 06:57:31 CEST 2008
756     - major documentation rework.
757     - document the fact that child watchers only watch for zombies.
758     - fix the child watcher example.
759    
760 root 1.43 3.1 Wed Apr 16 17:09:01 CEST 2008
761 root 1.40 - work around recurring bugs in Tk by dup'ing filehandles, the
762 root 1.43 only method with good success chances on Tk (the bugs apparently
763     don't get fixed anytime soon).
764 root 1.42 - lift the restriction of only one watcher per fh direction
765     (as the Tk bug workaround also lifts it and only Tk imposed
766     such strong limits).
767 root 1.41 - changed probe order to prefer coro adaptors.
768     - explain why recursion into the event loop is not supported
769     unless the backend supports it (only Coro::EV does without
770     any restrictions...).
771     - add simple manpages for all backend modules.
772 root 1.40
773 root 1.39 3.0 Mon Apr 7 21:30:23 CEST 2008
774 root 1.38 - Coro::Signal changed semantics, roll our own, also cleaning
775     up the Coro implementation in general.
776     - rename Coro backend to CoroEvent.
777     - add some decision helping paragraph to the manpage that should
778 root 1.44 help people to decide whether AnyEvent is the right thing for them.
779 root 1.38
780 root 1.37 2.9 Mon Jan 28 13:31:54 CET 2008
781     - update for EV 3.0 API changes.
782    
783 root 1.36 2.8 Sun Nov 25 15:06:03 CET 2007
784     - waitpid can validly return 0. accept this fact of life
785     instead of reporting it to any watchers.
786    
787 root 1.35 2.7 Fri Nov 23 11:41:14 CET 2007
788 root 1.34 - force use of AnyEvent::Impl::Perl in testsuite, there is
789     too much breakage outside AnyEvent.
790 root 1.35 - deliver signals synchronously in AnyEvent::Impl::Perl
791     or any other event loop that relies on AnyEvents child
792     watcher emulation. *Could* help with hanging testsuite
793     (except when Event or EV are installed).
794 root 1.34
795 root 1.33 2.6 Fri Nov 9 20:36:35 CET 2007
796 root 1.32 - fix bug in testsuite.
797     - move EV adaptor modules to AnyEvent.
798     - add Coro+EV adaptor module.
799 root 1.26
800 root 1.31 2.55 Tue Nov 6 17:41:32 CET 2007
801 root 1.27 - add EV to the list of supported event models.
802 root 1.30 - do not auto-reset pid watchers, pass pid and status to them.
803 root 1.29 - allow a pid of zero to watch for all children in child watchers.
804 root 1.27
805 root 1.25 2.54 Wed Jul 18 17:36:23 CEST 2007
806     - work around a perl bug that results in
807     BEGIN not safe after errors--compilation aborted without
808     any discernible reason or error message by once
809     again not use'ing strict.
810    
811 root 1.24 2.53 Sun Jul 8 10:51:53 CEST 2007
812     - make Glib interface work again (spotted by elmex).
813    
814 root 1.22 2.52 Wed Mar 7 18:36:16 CET 2007
815     - child watchers stopped working permanently when
816 root 1.23 all current child watchers were destroyed.
817 root 1.22
818 root 1.21 2.51 Mon Dec 11 21:33:24 CET 2006
819     - work around bugs in perl where eval "require Module" returns
820     true even if the module couldn't be loaded :/.
821    
822 root 1.20 2.5 Mon Dec 11 02:15:28 CET 2006
823 root 1.19 - avoid $AUTOLOAD because many perls corrupt it.
824 root 1.20 - AnyEvent::detect forces autodetection.
825     - implement signal watchers (experimental)
826     (Tk does not support async signals (<= 804.027 at least),
827     so they might get delayed indefinitely on Tk).
828     - implement child watchers (experimental).
829     - moved default condvar implementation into base module, simplifying
830     most implementation modules.
831 root 1.14
832 root 1.18 2.1 Fri Nov 24 15:50:48 CET 2006
833 root 1.16 - better docs.
834     - simple testsuite.
835 root 1.17 - added AnyEvent->one_event method for special purposes.
836 root 1.16
837 root 1.15 2.0 Wed Nov 1 02:21:30 CET 2006
838 root 1.13 - INCOMPATIBLE CHANGE: poll can now either be "r" or "w" but not both.
839     - INCOMPATIBLE CHANGE: io watcher callbacks have no arguments anymore.
840     - EXPERIMENTAL:
841     new pure-perl model added, AnyEvent now always finds a suitable
842     event model.
843 root 1.12 - improved documentation.
844     - reduced cpu overhead.
845    
846 root 1.11 1.02 Fri Jan 13 14:15:40 CET 2006
847     - add COPYING to clarify license.
848    
849 root 1.10 1.01 Sun Jan 8 05:48:09 CET 2006
850     - correctly cancel Event timers, avoid memory leaks.
851    
852 root 1.9 1.0 Sun Jan 8 05:40:58 CET 2006
853 root 1.8 - allow third-party interfaces to be added at runtime.
854     - fix version number.
855    
856 root 1.7 0.9 Fri Dec 30 02:25:41 CET 2005
857 root 1.6 - fixed errors in the documentation.
858 root 1.7 - going back to using $VERSION as "load check",
859     as suggested by Jörn Reder. Let's see why I stopped using
860     this method.
861     - add 'hup' to the list of events to receive for glib
862     and generate 'rw' events for it, as some versions of
863     glib seem to require this, while this breaks other
864     (older) versions of glib.
865     - implemented PERL_ANYEVENT_VERBOSE env variable.
866 root 1.6
867 root 1.5 0.3 Sun Dec 4 10:43:33 CET 2005
868     - no changes to the code.
869     - fixed documentation.
870     - clarified some corner cases.
871     - vastly improved documentation with a long example.
872    
873 root 1.3 0.2 Thu Dec 1 22:18:49 CET 2005
874 root 1.44 - check whether a valid method was called, to avoid endless loops.
875 root 1.4 - move condvars into their own class (cleaner, safer).
876     - don't die when some modules are not available.
877     - Tk is too broken to allow for words. Will work once Tk works.
878 root 1.3
879 root 1.2 0.1 Thu Dec 1 19:44:57 CET 2005
880     - spiced up and cleaned up for release.
881    
882 root 1.1 0.01 Tue Sep 21 18:12:09 CEST 2004
883     - original version; copied from Convert::Scalar.
884