ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/AnyEvent/Changes
Revision: 1.393
Committed: Thu Apr 15 04:21:15 2010 UTC (14 years, 1 month ago) by root
Branch: MAIN
Changes since 1.392: +3 -0 lines
Log Message:
*** empty log message ***

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