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