ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/AnyEvent/Changes
Revision: 1.606
Committed: Sun Sep 27 08:07:03 2015 UTC (8 years, 7 months ago) by root
Branch: MAIN
Changes since 1.605: +4 -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.410 TODO: document TCP_*** constants
4 root 1.517 TODO: add debug/trace logging to some modules
5 root 1.537 TODO: use the eval-with-cb-call trick also to speed up JSON?
6 root 1.553 TODO: FAQ: common pitfalls? invoke-before-return
7     TODO: FAQ: scope-ids? hosts file order?
8 root 1.551 TODO: AnyEvent::Handle with AnyEvent::IO?
9 root 1.571 TODO: invalid. and localhost. specialcasing inside AEDNS and not AESocket (rfc6761)
10 root 1.576 TODO: maybe implement env variable to give hosts precedence
11 root 1.598 TODO: hosts always read? that's not expected
12 root 1.601 TODO: more formats for parse_ipv6 (single ipv6 address without port, ...p80, ...#80)
13 root 1.554
14 root 1.606 TODO: document run_cmd can share scalar refs as output for multiple
15     - use common name as hostname for tls connects, if Net::SSLeay
16     supports SNI.
17    
18 root 1.605 7.11 Thu Jul 16 14:36:00 CEST 2015
19     - AnyEvent::Socket::parse_ipv6 could accept malformed ipv6
20     addresses (extra "::" at end and similar cases).
21 root 1.604 - add a more explicit warning to AnyEvent::Handle that it doesn't
22     work on files, people keep getting confused.
23 root 1.602 - new function AnyEvent::Socket::tcp_bind.
24 root 1.603 - new functions AnyEvent::fh_block and AnyEvent::fh_unblock.
25 root 1.600 - aligned ipv6 address formatting with RFC 5952 (by not shortening
26     a single :0: to ::).
27 root 1.602 - added stability canary support.
28 root 1.600
29 root 1.599 7.09 Sat May 2 16:38:53 CEST 2015
30 root 1.597 - AnyEvent::Debug called an internal function (AnyEvent::Log::ft)
31     that was renamed to AnyEvent::Log:format_time. uinder its old name
32     (analyzed by Michael Stovenour).
33 root 1.598 - update AnyEvent::DNS fallback resolver addresses:
34     seems google effectively killed most other free dns resolvers,
35     so remove them, but add cable and wireless (ecrc) since it was
36     stable for 20 years or so, official or not, and there should be
37     an alternative to google.
38     - perl5porters broke windows error codes in 5.20, and mapped
39     WSAEWOULDBLOCK on the (different) EWOULDBLOCK error code, and
40     WSAEINPROGRESS into the incompatible ERINPROGRESS code, probably
41     because they were so cool. They probably broke other error codes
42     for no reason, too, but I didn't care for checking, it's too
43     depressing. This version only works around the WSAEWOULDBLOCK
44     issue, because I don't have a nice way to work around the
45     WSAEINPROGRESS bug.
46 root 1.597
47 root 1.596 7.08 Wed Dec 10 05:27:17 CET 2014
48 root 1.588 - work around a newly introduced bug in Socket 2.011 (an
49     errornous sun_length check) (analyzed by Maxime Soulé).
50 root 1.589 - AnyEvent::TLS didn't load (but refer to) AnyEvent::Socket
51     (analyzed by Ben Magistro).
52 root 1.590 - AnyEvent::Strict will now confess, not croak. This is in line with
53     it being a development/debugging tool.
54 root 1.591 - work around a number of libglib bugs (debug builds of libglib enforce
55     certain undocumented behaviour patterns such as not being able to
56     remove a child watch source after it has fired, which we will try
57     to emulate to avoid "criticals". what where they thinking...).
58 root 1.594 - mention json security issues in AnyEvent::Handle, now that Douglas
59     Crockford has foolishly and incompatibly changed JSON.
60 root 1.590 - changed default dns resolver "max_outstanding" value from 1 to 10,
61     the latter beinfg the intended value all along
62     (reported by Ilya Chesnokov).
63 root 1.592 - added new "AnyEvent::Impl::UV" interface module to the UV event lib
64     (written by Mike Lowell).
65 root 1.588
66 root 1.586 7.07 Tue Dec 17 17:45:02 CET 2013
67 root 1.583 - the documentation for custom tls verify schemes was wrong. make it agree
68     with the code (reported by Maxime Soulé).
69 root 1.582 - added cbor read and write types to AnyEvent::Handle (using CBOR::XS).
70 root 1.584 - work around an API change in openssl that could cause wrong tls connection
71     aborts, likely on windows only (analyzed by sten).
72 root 1.579 - calling AnyEvent->now_update with AnyEvent::Impl::Perl caused an
73 root 1.578 endless loop (reported by Dietrich Rebmann).
74 root 1.579 - add tlsv1_1 and tlsv1_2 protocols to AnyEvent::TLS
75     (patch by Maxime Soulé).
76 root 1.583 - document AnyEvent::Impl::IOAsync::set_loop and
77     $AnyEvent::Impl::IOAsync::LOOP. Though only documented now, this
78     functionality has _always_ been available.
79 root 1.577 - force a toplevel domain name in t/81_hosts.t (analyzed by
80     David Jack Wange Olrik).
81 root 1.580 - document that AnyEvent::Log uses AnyEvent::IO.
82 root 1.585 - warn about AnyEvent::Filesys::Notify performance.
83     - praise the joys of AnyEvent::Fork::*.
84 root 1.582 - time for an =encoding directive.
85 root 1.585 - do no longer use JSON to create a default json coder, use
86     JSON::XS or JSON::PP directly.
87 root 1.577
88 root 1.576 7.05 Wed Aug 21 10:38:08 CEST 2013
89 root 1.568 - uts46data.pl couldn't be found due to wrong naming of the file
90     (reported by Fulko Hew).
91 root 1.576 - handle lone \015's properly in AE::Handle's default line read
92     (reported by various people).
93     - untaint ip addresses found in /etc/hosts (patch by José Micó).
94     - the memleak fix in 7.03 caused resolving via /etc/hosts to always
95     fail on first use (reported and testcase by Andrew Whatson).
96 root 1.573 - expose AnyEvent::Log::format_time, and allow users to redefine it.
97     - expose AnyEvent::Log::default_format, and allow redefinition.
98     - expose AnyEvent::Log::fatal_exit, to allow redefinition.
99 root 1.571 - AnyEvent::Debug shell can now run coro shell commands, if available.
100 root 1.563 - t/63* tests were wrongly in MANIFEST.
101 root 1.571 - kernel.org's finger server went MIA, switch to freebsd.org and
102     icculus.org.
103 root 1.576 - clarify that IO::AIO and AnyEvent::AIO are needed for AnyEvent::IO
104     to function asynchronously (reported by Daniel Carosone).
105 root 1.571 - hard-disable $^W in most tests, it generates too much garbage output.
106     - use a (hopefully) more future-proof method to emulate common::sense.
107 root 1.572 - upgrade to UTS-46:6.2.0.
108 root 1.576 - switch to INSTLIB from INSTLIBDIR, as INSTLIBDIR was wrongly
109     documented. should not affect anything.
110 root 1.563
111 root 1.562 7.04 Thu Nov 15 02:23:58 CET 2012
112     - debugging code left in.
113    
114 root 1.561 7.03 Thu Nov 15 02:16:11 CET 2012
115 root 1.556 - AnyEvent::Socket::inet_aton did not work when dns resolution was
116     used to find the addresses (analyzed and patch by Maxime Soulé).
117 root 1.560 - fix a memory leak in the /etc/hosts lookup code when hosts don't
118     resolve and are not in hosts (analyzed by sten).
119 root 1.555
120 root 1.554 7.02 Tue Aug 14 04:27:58 CEST 2012
121     - AnyEvent::Util::run_cmd could block indefinitely (analyzed and test
122     program by Yorhel).
123 root 1.553 - verified that AnyEvent::Socket follows RFC5952.
124     - try to parse "ADDR#PORT" in addition to "ADDR PORT".
125 root 1.467
126 root 1.552 7.01 Sun May 13 01:03:17 CEST 2012
127 root 1.551 - fail with EPROTO in AnyEvent::Handle wqhen TLS is requested but
128     not available, instead of throwing an exception.
129 root 1.550 - use File::Spec to get the tmpdir in t/*, to avoid needless
130     failures on (most, not mine :) windows boxes.
131 root 1.552 - new handle read types: tls_detect and tls_autostart.
132 root 1.550
133 root 1.547 7.0 Fri Apr 13 06:33:30 CEST 2012
134 root 1.539 - child watchers are broken in POE 1.352 (also many earlier
135 root 1.544 versions) and there seems to be no way to work around it, as POE
136     itself is inherently racy. Document this regression and add a delay
137     in t/68_poe_03_child.t for the time being.
138 root 1.533 - new module AnyEvent::IO, that is a frontend to either a pure-perl
139     synchronous I/O implementation (AnyEvent::IO::Perl), or to the
140     asynchronous I/O extension IO::AIO (AnyEvent::IO::IOAIO).
141 root 1.544 - load /etc/hosts only when DNS has no answer.
142 root 1.535 - stat /etc/hosts on every access and reload it if it changed.
143     - load /etc/hosts via AnyEvent::IO - potentially asynchronous.
144 root 1.548 - fix a buggy croak in the dh parameter reading in AnyEvent::TLS.
145 root 1.539 - AnyEvent::Log log_to_file and log_to_path now use AnyEvent::IO. As
146     a side effect, they now use true appending as opposed to libc
147     appending, and the file might not have been opened when the function
148     returns.
149 root 1.529 - the default logging level was not properly documented in a variety of
150     places, this has hopefully been rectified.
151 root 1.526 - updated uts46data.pl for unicode 6.1.0.
152 root 1.548 - made log messages generated by AnyEvent submodules not
153 root 1.528 include the package name anymore, as it will be logged
154     by default already.
155 root 1.530 - upgrade to the trick used by common-sense 3.5 to work
156     around extra warning torture/breakage under perl 5.15.x.
157 root 1.531 - log messages by anyevent are now ucfirst, are usually full
158     sentences and do no longer include the package name.
159 root 1.537 - the storable read type would sometimes throw an exception instead
160     of causing EBADMSG (analyzed by Maxime Soulé).
161 root 1.543 - work around a bug in openssl 1.0.1 which enforces a minimum rsa
162     keysize (reported by Paul Howarth).
163 root 1.537 - documented Rocco fabricating statements about AnyEvent and me.
164 root 1.525
165 root 1.524 6.14 Tue Jan 31 20:00:24 CET 2012
166     - AnyEvent::Impl::Tk was broken due to a mysterious "die" inside,
167     probably an editing mistake (reported by Darin McBride).
168    
169 root 1.523 6.13 Thu Jan 12 07:27:01 CET 2012
170     - AnyEvent::Util::fork_call checked for POSIX availability in the wrong way,
171     causing it to fail if POSIX wasn't loaded already (analysed by Rock Power).
172 root 1.522 - AnyEvent::Handle::push_read (line => did pass $1 directly, so
173     regex-matching inside the callback would change the parameter, despite
174     $1 being dynamically scoped per-block. this perl bug is now being
175     worked around (testcase by Cindy Wang).
176    
177 root 1.521 6.12 Mon Dec 12 13:21:10 CET 2011
178     - $! was clobbered by subsequent calls in tcp_connect, due to
179     the postpone not saving/restoring it (analyzed by Richard Garnish).
180    
181 root 1.520 6.11 Tue Nov 22 10:36:05 CET 2011
182 root 1.519 - Tk cannot create windows when tainted unless you set a title, so
183     set a dummy title for AnyEvent's dummy mainwindow. How dummy.
184 root 1.518 - escape any nonprintable/nonascii characters when stringifying
185     backtraces.
186 root 1.519 - log the reason loading an interface module fails to load at level debug.
187 root 1.518
188 root 1.517 6.1 Tue Oct 4 19:44:30 CEST 2011
189 root 1.507 - INCOMPATIBLE CHANGE: the default log level is now "4" (error
190     and above), and some messages inside AnyEvent have been elevated
191     to higher log levels to print by default.
192 root 1.508 - AnyEvent::log, unlike AnyEvent::Log::log, did not always exit on fatal.
193 root 1.511 - work around yet another signal race bug, newly introduced by POE. My
194     how that module sucks.
195 root 1.507 - add google public ipv6 dns as fallback servers, so AE::DNS can finally
196 root 1.504 support ipv6-only operation even with defaults (also use ::1 instead
197     of 127.0.0.1).
198 root 1.507 - give better guidelines on how to chose a logging level.
199 root 1.513 - AnyEvent::Log can now cap (limit) log message priority by context.
200 root 1.514 - AE::log will now save and restore $! and $@, so callers don't have to.
201 root 1.505 - AE::Strict now checks that registered fds are still valid at regular
202     intervals.
203 root 1.507 - skip frequently called 'require' calls if the module appears loaded.
204 root 1.512 - increase signal latency test timer considerably for poor little osx,
205     which can't be bothered with basic posix functionality such as signal
206     delivery.
207 root 1.503 - mention some debugging aids in the tutorial.
208 root 1.511 - new env variable PERL_ANYEVENT_MAX_SIGNAL_LATENCY.
209 root 1.513 - private (%namespace) log contexts in PERL_ANYEVENT_LOG now have the name
210     of the context as title.
211 root 1.516 - AnyEvent::Strict would not restore read-write access to $_ when a callback
212     died - this is a user bug, but since AE::Strict exists to help dbeugging...
213 root 1.509 - detect the extremely evil IO::Async::Loop::AnyEvent module and refuse
214     to work with it - the author is well aware of the issues but refuses
215     to fix them. This extreme step has been taken because the module actively
216     attacks the goals of AnyEvent and makes it harder for module authors to use
217     AnyEvent.
218 root 1.500
219 root 1.499 6.02 Fri Aug 26 20:08:31 CEST 2011
220 root 1.497 - log_to_syslog now accepts facility strings.
221     - log_to_syslog would not allow facilities - "$facility|$level"
222     *literally* means that string. sheesh.
223     - the CPAN parser got confused and thought we provide Sys::Syslog, try
224     to work around.
225 root 1.498 - renamed AnyEvent::Impl::FLTK2 to FLTK.
226 root 1.497
227 root 1.496 6.01 Fri Aug 26 07:04:11 CEST 2011
228 root 1.477 - INCOMPATIBLE CHANGE: AnyEvent::DNS resource records now include
229     the TTL as fourth element - this affects ->resolve, ->request
230     and ->dns_unpack indirectly. Convenience functions such as
231     AnyEvent::DNS::{a,txt,mx,srv} are not affected, neither is
232     AnyEvent::Socket.
233 root 1.454 - INCOMPATIBLE CHANGE: backend authors now should not implement
234 root 1.455 one_event or loop, but instead the AnyEvent::CondVar::_wait and _poll
235     methods.
236 root 1.475 - INCOMPATIBLE CHANGE: verbosity levels have been redefined, see
237     AnyEvent (PERL_ANYEVENT_VERBOSE) and AnyEvent::Log for details.
238 root 1.455 - DEPRECIATION: please change
239     "use AnyEvent::Impl::Perl" to "use AnyEvent::Loop" and
240     "AnyEvent::Impl::Perl::loop" to "AnyEvent::Loop::run"
241     in your programs, for future compatibility.
242 root 1.460 - *blush* idle watcher emulation was borked.
243 root 1.461 - AnyEvent::Strict now checks the AE::xxx functions as well.
244 root 1.458 - querying too long domain names would barf deep inside AnyEvent::DNS - since
245     this is hard to avoid for applications, AnyEvent:.DNS::request now checks for
246     for too long domain names explicitly and passes an undef to the callback
247     instead (reported by James Bromberger).
248 root 1.464 - make AnyEvent::Util more robust against EINTR (analyzed by Andrew Suffield).
249 root 1.475 - new functions: AnyEvent::postpone, AnyEvent::log.
250     - new module: AnyEvent::Log, for simple logging needs.
251 root 1.487 - new env variable, PERL_ANYEVENT_LOG, for fine-grained logging config.
252 root 1.463 - new env variable, PERL_ANYEVENT_DEBUG_SHELL, to automatically start
253     a debug shell.
254     - new env variable, PERL_ANYEVENT_DEBUG_WRAP, to automatically enable
255 root 1.464 watcher instrumentation/wrapping (see AnyEvent::Debug::wrap).
256 root 1.488 - new env variable, PERL_ANYEVENT_HOSTS, to override the place where
257 root 1.508 /etc/hosts can be found.
258 root 1.486 - an empty PERL_ANYEVENT_RESOLV_CONF now selects the default
259     configuration.
260     - env variables can now be specified using AE_xyz instead of
261     PERL_ANYEVENT_xyz, subject to some rules.
262 root 1.473 - lots of new AnyEvent::Debug functionality.
263 root 1.534 - AnyEvent::Strict now checks for modifications of $_ by the callback
264 root 1.479 (by setting it to readonly while executing the callback, if possible).
265 root 1.459 - IO::Async sometimes cancels the wrong timer when you call cancel_timer.
266     Invest extra overhead to work around this peculiar behaviour.
267 root 1.455 - split the pure perl backend into a loop module and an impl
268     module (AnyEvent::Loop and AnyEvent::Impl::Perl).
269 root 1.450 - some read types (regex, netstring, json, storable) could
270     errornously keep an AE::Handle object alive on their own
271     (reported by Mohammad Toossi).
272 root 1.488 - AnyEvent::Socket::resolve_sockaddr and all functions using it now
273     supports /etc/hosts overrides.
274 root 1.453 - add more workarounds around child watcher bugs in IO::Async
275     and (newly introduced) in POE.
276     - use glib child watchers and try to work around its limitations,
277     if possible (based on a patch by Kevin Ryde).
278 root 1.460 - add support for FLTK (fltk2), via AnyEvent::Impl::FLTK2.
279 root 1.447 - many read types in AnyEvent::Handle would malfunction during
280     transitions to TLS because of a "delete $self->{rbuf}".
281     (reported by Gerald Galster).
282 root 1.452 - improve condvar blocking wait performance (probably only noticable
283     with faster backends), also make it easier for event loops that
284 root 1.453 do not support blocking waits.
285 root 1.459 - PERL_ANYEVENT_MODEL now also allows full module names, although
286     the usefulness of this feature is not yet clear.
287 root 1.460 - add tests for all supported event loops, conditional on PERL_ANYEVENT_LOOP_TESTS.
288     - add t/80_ssltext.t.
289 root 1.461 - no longer use AUTOLOAD for the initial loading (for no very good reason).
290 root 1.465 - tcp_server now tries to unlink unix domain sockets when it gets destroyed.
291 root 1.470 - do not run event loop detection multiple times when programs call their cached
292     copies of AnyEvent::detect.
293 root 1.472 - parse_hostport now accepts absolute paths als unix domain sockets.
294 root 1.495 - suppress the idiotic warning inside POE by patching the POE::Kernel
295     run flags instead of asking the user to jump through contortions.
296 root 1.484 - add Task::Weaken as dependency (as recommends only at this time).
297 root 1.494 - replace PF_UNSPEC by 0, for good old minix.
298 root 1.446
299 root 1.476 6.0 (not officially released, but was on CPAN for about 15 minutes :/)
300    
301 root 1.446 5.34 Thu May 12 09:59:41 CEST 2011
302 root 1.445 - AE::TLS didn't support both cert_file and key at the same time,
303     due to some copy&paste bug (reported and analyzed by vti).
304 root 1.444 - improve AE::Handle timeout documentation slightly.
305    
306     5.33 Mon Feb 7 21:51:41 CET 2011
307 root 1.446 - never appeared on CPAN, for unknown reasons.
308 root 1.443 - AnyEvent::Handle on_connect_error - do not try to destroy a handle
309     object when it's already gone (analyzed by Ryan Bullock).
310 root 1.441 - update idna algorithm(s) to UTS#46 version 6.0.0.
311     - preserve trailing dot in idn_to_ascii - testsuite says to preserve,
312     uts46 says it's an error, and testsuite makes more sense.
313 root 1.442 - remove leading dots in idn_to_ascii - testsuite says to remove,
314     uts46 says it's an error, and testsuite makes more sense.
315 root 1.441 - fixed a bug in idn ignored character processing.
316 root 1.442 - passes the uts46 6.0.0 testsuite except for three cases which
317     apparently are bugs in the testsuite itself.
318     - passes the uts46 6.0.1 testsuite except for eleven cases which
319     apparently are bugs in the testsuite itself.
320 root 1.441
321 root 1.439 5.31 Sun Jan 23 11:49:19 CET 2011
322 root 1.437 - work around a POE bug where POE would first poll for new events and
323     invoke handlers BEFORE handling the message queue.
324 root 1.436 - fix parsing of "domain" statement in resolv.conf (Johannes Plunien).
325 root 1.435 - stop_read now does just that in TLS mode. see its
326     documentation for caveats.
327 root 1.440 - update to common::sense 3.4 warning set (some warnings in perl impose
328     an arbitrary 32kb limit on regex matches, which affects
329     AnyEvent::Handle).
330 root 1.438 - AE::Handle had a broken rbuf_max method and missing wbuf_max method.
331 root 1.439 - new experimental AE::Handle::resettls method.
332 root 1.434
333 root 1.432 5.3 Fri Dec 31 05:48:13 CET 2010
334 root 1.427 - major IOAsync patch by Paul Evans - 0.33 is required, as the major
335     issues with IO::Async have been solved in that version, including
336     the availabilty of a default loop!
337 root 1.429 - implement new wbuf_max parameter for AnyEvent::Handle.
338 root 1.430 - added Cocoa::EventLoop backend by Daisuke Murase.
339 root 1.427 - the default testsuite now honors PERL_ANYEVENT_MODEL (Paul Evans).
340 root 1.431 - clarify handle on_prepare documentation.
341 root 1.425 - set CLOEXEC flag on parent-side fd's in AnyEvent::Util::run_cmd,
342     to avoid leaking them to any child processes.
343 root 1.426 - try to force files into the arch-dependend lib directory, for the
344     half-"turly obsessive compulsive person"(s) that depend on it.
345 root 1.425
346 root 1.423 5.29 Sun Dec 5 10:49:21 CET 2010
347     - convert EV backend to EV 4.00 API (so better upgrade EV too).
348 root 1.415 - AE::Handle: implement dynamic read_size adjustment, add
349     max_read_size parameter, reduce default read_size to 2048.
350 root 1.423 - add some FAQ entries for servers and/or on_eof vs. on_error.
351 root 1.414 - work around OS bugs (cygwin again) when lingering in AE::Handle.
352 root 1.418 - reduce memory usage slightly when connect was used in AE::Handle.
353 root 1.423 - wrok around more segfaults in Tk.
354 root 1.419 - document tls_ctx => undef as valid.
355 root 1.423 - detect WNOHANG value at compiletime.
356 root 1.420 - include some probably linux-only support for building AnyEvent
357     as part of the perl core.
358 root 1.421 - improve compatibility of t/08_idna.t to perl 5.8.
359 root 1.422 - make AnyEvent::Strict truly optional (in case somebody builds a
360     minimal perl...).
361 root 1.414
362 root 1.413 5.28 Wed Oct 13 04:14:23 CEST 2010
363 root 1.408 - due to a glitch, AnyEvent's internal getprotobyname wasn't
364     actually used in tcp_server.
365 root 1.410 - implement AnyEvent::CondVar->new method, which was documented but
366     missing.
367 root 1.409 - support autoloading of read types in unshift_read.
368 root 1.408 - AnyEvent::Strict: do the test for invalid fh arguments differently,
369     resulting in more informative error messages.
370 root 1.411 - new AnyEvent::FAQ manpage.
371 root 1.404 - clarify that you can actually call push_read etc. in on_read.
372 root 1.413 - put keys and certs in /tmp, not into the current directory,
373     and document this in the SECURITY CONSIDERATIONS sections
374     of AnyEvent::TLS.
375 root 1.409 - support ";" as resolv.conf comment character in AnyEvent::DNS, as
376     requested by Ron Isaacson.
377     - document $AnyEvent::DNS::RESOLVER variable.
378 root 1.405 - incorporated major typo patches by Abhijit Menon-Sen.
379 root 1.412 - AnyEvent::Handle now croaks when negative timeouts are passed.
380 root 1.409 - add a shitload of TCP_xxx sockopt name constants to AnyEvent::Util,
381     undocumented, but who knows when they might come in handy.
382 root 1.404
383 root 1.402 5.271 Tue Jun 8 12:05:46 CEST 2010
384 root 1.401 - backport to perl 5.8.x.
385    
386 root 1.400 5.27 Sun Jun 6 12:12:05 CEST 2010
387 root 1.398 - postpone differently in AnyEvent::Socket now, as
388     when not, canceling the connection attempt might fail
389     (found by Felix Antonius Wilhelm Ostmann).
390 root 1.397 - explicitly check for non-stream sockets in AE::Handle, too many
391     clueless people fell into the trap of this somehow working.
392 root 1.395 - simplified and reworked the "OTHER MODULES" section.
393 root 1.399 - better/more condvar examples.
394 root 1.395
395 root 1.394 5.261 Wed Apr 28 16:13:36 CEST 2010
396 root 1.393 - AF_INET6 was not properly used from Socket6 during configuration
397     time (found by Andy Grundman).
398    
399 root 1.392 5.26 Mon Apr 12 04:49:35 CEST 2010
400 root 1.389 - don't generate spurious readyness notifications when select
401     returns EINTR in the pure perl backend (analysed and testcase
402     by Bas Denissen).
403 root 1.391 - give same examples in SYNOPSIS sections of AnyEvent and AE.
404 root 1.390 - provider faster implementations for AE::time/now/now_update for
405     EV and Perl backends.
406     - provide faster AE::cv and AE::time implementations for all
407     backends.
408     - no longer support lower/mixed-case signal names (this was
409     never documented nor universally supported).
410     - some more memory µ-optimisations, and somewhat less messy
411     code to cope with both AnyEvent and AE APIs.
412 root 1.389
413 root 1.386 5.251 Sat Mar 13 00:58:21 CET 2010
414 root 1.387 - make test failed if it was run before make install on perl <=
415     5.8.8, and older versions of perl make our live very difficult,
416     so write constants.pl during Makefile.PL time.
417 root 1.386
418 root 1.384 5.25 Sat Mar 13 00:23:14 CET 2010
419 root 1.383 - fix a race condition in AnyEvent::Handle that would cause
420     a "bio_read: unsupported method" error (in _another_
421     ssl connection) after user code threw an exception.
422 root 1.385 - added AnyEvent::Handle->destroyed method.
423 root 1.376 - speed up AnyEvent::Socket::format_address and ::format_ipv6.
424 root 1.378 - the AnyEvent::Util::fh_nonblocking function worked only
425     by lucky accident on win32.
426 root 1.377 - smaller and faster AnyEvent::Util::fh_nonblocking.
427 root 1.379 - when the (required!) Time::HiRes module is missing, AnyEvent
428     did not fall back to built-in time properly.
429 root 1.381 - do not load Fcntl at runtime, saving memory and loading time.
430     - precompile a number of constants and use them instead of runtime
431     detection and eval.
432     - free detection code after detection and similar memory optimisations.
433 root 1.382 - Perl backend timer interval best effort drift has been improved
434 root 1.388 (same algorithm as EV).
435 root 1.385 - update unicode idna mapping table.
436 root 1.376
437 root 1.375 5.24 Tue Jan 5 11:39:43 CET 2010
438     - cygwin never reports errors from failed connects. 1.5 just gives
439     you continous readyness and EAGAIN, 1.7 is even more broken and
440     just hangs. work around both issues in a cygwin-specific hack.
441 root 1.374 - improve idle watcher documentation slightly.
442    
443 root 1.373 5.23 Sun Dec 20 23:48:00 CET 2009
444 root 1.372 - support IDNs in resolve_sockaddr, and therefore in tcp_connect.
445 root 1.373 - implement punycode_encode/decode, idn_nameprep,
446     idn_to_ascii and idn_to_unicode operations in AnyEvent::Util.
447 root 1.366 - provide $AE::VERSION.
448 root 1.367 - removed traces of "no strict 'refs'".
449 root 1.366
450 root 1.365 5.22 Sat Dec 5 03:51:13 CET 2009
451 root 1.358 - downgrade-or-fail in AnyEvent::Handle::push_write, to
452     diagnose encoding failures earlier and more succinctly.
453 root 1.359 (this works around bugs in perl, throwing away encoding info
454     when passing scalar data to extensions).
455 root 1.360 - add more examples to AnyEvent::Socket manpage.
456 root 1.361 - upgrade internal warning set to the same as common::sense 2.03.
457 root 1.362 - use pack "n/a*" for pre-5.8.9 perl compatibility in AnyEvent::DNS
458     (John Beppu).
459 root 1.364 - AnyEvent::Socket::inet_aton now properly supports ipv6, as documented.
460 root 1.363 - add google public dns servers to fallback server set and make sure
461     we load-balance properly between the three sets. also add all
462     fallback dns servers, not just a random one, to each dns config.
463 root 1.358
464 root 1.357 5.21 Thu Nov 19 02:48:47 CET 2009
465 root 1.356 - fix a problem where socket constants were called with parameters
466 root 1.355 (spotted by David Friedland).
467 root 1.356 - fork_call never use'd POSIX (reported by Daisuke Maki).
468 root 1.355 - improve perl 5.6 compatibility further (but it still won't work
469     unless you rip out everything but the core).
470 root 1.357 - prefer Net::DNS::Resolver over ipconfig, if installed, on win32.
471     uses 10MB of RAM, but doesn't open a console window. *sigh*.
472 root 1.355
473 root 1.354 5.202 Wed Oct 14 22:35:44 CEST 2009
474     - AnyEvent::DNS would unexpectedly clobber $_ under windows
475     (analysed by Matthias Waldorf).
476 root 1.353 - AnyEvent::Handle::run_cmd can now pass the PID of the
477     newly-created process, which is much less useful than it might
478     sound (based on patch by Yann Kerherve).
479    
480 root 1.352 5.201 Tue Sep 29 12:09:25 CEST 2009
481 root 1.350 - AnyEvent:Handle::on_starttls/on_stoptls methods were broken
482     (reported by Torsten Foertsch).
483 root 1.351 - common::sense 2.0 could cause tcp_server to throw an exception
484     (analysed by elmex).
485 root 1.350
486 root 1.349 5.2 Mon Sep 14 07:04:49 CEST 2009
487 root 1.347 - INCOMPATIBLE CHANGE: do no longer support register_read_type
488     and register_write_type in AnyEvent::Handle, instead support
489     package names (the facility was mostly abused).
490 root 1.349 - implement "packagename-as-read/write type" support in
491     AnyEvent::Handle.
492 root 1.345 - AnyEvent::Handle: new options "keepalive" and "oobinline".
493 root 1.346 - oobinline set by default to avoid security issues.
494 root 1.349 - the pure-perl event loop backend wrongly detected times() fallback
495     support (spotted by Pavel Boldin).
496 root 1.345
497 root 1.344 5.12 Tue Sep 1 20:26:50 CEST 2009
498 root 1.343 - be more lenient when parsing resolv.conf files, as some people
499     use hashmarks as comment indicator inside directives (reported
500     by Michael S. Fischer).
501     - use same set of warnings as common::sense 2.0.
502 root 1.342 - fix a potential 32 bit overflow issue due to perl having problems
503     with large hex constants in the Perl backend.
504     - do not use the slower 5.6 version fo the enc_name code in AnyEvent::DNS
505     by default.
506 root 1.343 - fix some prototypes.
507 root 1.344 - (optionally) require Async::Interrupt 1.02.
508 root 1.343 - replace opendns fallbacks by verizon/level3 public dns servers.
509 root 1.342
510 root 1.339 5.112 Fri Aug 21 13:59:04 CEST 2009
511 root 1.338 - AnyEvent::Handle could cause hard crashes in Net::SSLeay when
512     using starttls with an illegal/uncreatable tls context.
513 root 1.339 - port to broken win32 perls.
514 root 1.338
515 root 1.337 5.111 Sun Aug 16 18:44:36 CEST 2009
516     - perl errornously requires sockaddr_un structures returned by the
517     kernel to have a specific length. work around this bug by padding
518     sockaddr_un structures (found to fail on OS X, as perl only uses
519     the correct code for GNU/Linux, but likely to fail on other
520     OSes as well).
521    
522 root 1.336 5.11 Wed Aug 12 17:49:37 CEST 2009
523 elmex 1.335 - fixed a bug in run_cmd with input from filename.
524 root 1.336 - create a json coder object when none is given in write direction
525     to reduce dependency on JSON.
526 elmex 1.335
527 root 1.334 5.1 Tue Aug 11 03:17:32 CEST 2009
528 root 1.333 - tcp_connect now reports the correct error in $!, not an unrelated
529     one (was broken since 4.91).
530     - AE::Handle did not properly clear rtimeout/wtimeout watchers
531     when retrying a tcp_connect.
532     - new functions: AnyEvent::Util::run_cmd and close_all_fds_except.
533 elmex 1.332 - fixed wrong documentation in AE::Socket.
534    
535 root 1.330 5.01 Mon Aug 10 03:16:32 CEST 2009
536     - last release broke EV child watchers :/.
537    
538 root 1.329 5.0 Sun Aug 9 17:32:09 CEST 2009
539     - officially introduce and document the AE API.
540 root 1.323 - lowering the timeout at runtime did not have immediate effect
541     in AnyEvent::Handle.
542 root 1.324 - AE::Handle now has separate and independent read and write timeout
543     settings.
544 root 1.326 - probe for Guard module when AnyEvent::Util is loaded, not at
545     runtime (Event doesn't like eval "use" from callbacks, and it avoids
546     exporting the probe function).
547 root 1.328 - Impl::IOAsync's io watchers did not use the filehandle emulation
548     code to work around it's watcher limits.
549     - work around IO::Async's problems with overloaded objects.
550     - try to disable wearnings inside IO::Async, it's just too buggy.
551 root 1.327 - do no longer use Event by default, only EV or Perl, Event is too buggy.
552 root 1.329 - hackishly provide fast AE:: interface when EV or Perl is the backend.
553 root 1.325 - inherit VERSION from AnyEvent::VERSION in most modules.
554 root 1.322
555 root 1.321 4.91 Thu Aug 6 15:42:45 CEST 2009
556 root 1.319 - AE::Handle::starttls could get out of sync when the read buffer
557     already contains some TLS handshake.
558 root 1.318 - AE::Handle did not properly free the TLS session, causing bigger
559     memory leaks in Net::SSLeay than expected (reported by toaster).
560 root 1.320 - AE::Socket::tcp_connect will now artificially delay invoking
561     the callback to avoid returning after invoking the callback.
562 root 1.321 - convert many internal watcher uses to AE API.
563 root 1.317
564 root 1.316 4.9 Sat Aug 1 11:07:01 CEST 2009
565 root 1.308 - Glib silently fails when registering a timeout with
566     a negative value, so avoid that.
567 root 1.315 - call condvar callback immediately when it is set
568     after the condition is already signalled.
569 root 1.314 - check rbuf_max condition only after trying to consume
570     data.
571 root 1.305 - normalise signal numbers to names when using the ae's
572     signal handling, but do not document this (yet).
573 root 1.308 - pure perl signal emulation did not properly set nonblocking
574     mode on the signal pipe on win32 (this is unlikely to have caused
575     any issues).
576 root 1.310 - new module: AnyEvent::Debug.
577 root 1.309 - AnyEvent::Strict now checks that a signal was specified
578     by name (not name or number).
579     - reduce memory footprint in typical cases by ~50kb by
580 root 1.308 only compiling signal code when necessary.
581 root 1.313 - add AnyEvent::Handle->rbuf_max.
582 root 1.311 - grab the AE namespace for future new API, implement stubs for
583     said future/alternative API.
584 root 1.315 - new function: AnyEvent::Socket::format_hostport.
585 root 1.305
586 root 1.303 4.881 Tue Jul 28 12:51:53 CEST 2009
587     - work around a bug in local in pre-5.10 perls, causing
588 root 1.304 AnyEvent::Handle to recurse when it should not
589 root 1.351 (analysed by elmex).
590 root 1.303
591 root 1.302 4.88 Tue Jul 28 04:04:37 CEST 2009
592 root 1.301 - re-bless the handle into a dummy package after calling
593     AnyEvent::Handle::destroy, so the user does not need to check
594     for errors after every push_write etc.
595 root 1.302 - do not attempt to run t/02_signals.t on obviously broken
596     platforms.
597 root 1.301
598 root 1.300 4.87 Sun Jul 26 02:06:16 CEST 2009
599 root 1.295 - do not attempt to linger when there is no longer a valid fh.
600 root 1.296 - enforce tls mode to be either accept or connect, do not simply
601     segfault in Net::SSLeay.
602 root 1.298 - AnyEvent::Handle can now call tcp_connect itself (new parameters
603 root 1.299 connect, on_prepare, on_connect and on_connect_error). Updated
604     tutorial accordingly.
605 root 1.297 - add AnyEvent::Impl::Irssi backend.
606 root 1.295
607 root 1.294 4.86 Mon Jul 20 23:52:29 CEST 2009
608     - since the verbose warning is not enough, explicitly document
609     that versions before 1.33 of Net::SSLeay are not secure.
610 root 1.292 - work around signal handling races in Event and (...) Event::Lib.
611 root 1.293 - try to align signal-race timer to full-second boundaries.
612     - work around Tk not liking negative timeouts.
613 root 1.292 - don't complain of different grades of environmental unfriendlyness
614 root 1.302 in IO::Async.
615 root 1.292
616 root 1.290 4.85 Sat Jul 18 06:16:14 CEST 2009
617 root 1.287 - nail the signal race problem in perl once and for all
618     (see $AnyEvent::MAX_SIGNAL_LATENCY).
619     - take advantage of Async::Interrupt if it is available.
620     - load Time::HiRes and Guard modules on demand only.
621     - add optional/recommended modules section to AnyEvent
622     documentation.
623 root 1.288 - reduce memory usage considerably (and reduce startup penalty)
624     by not using "strict", "warnings" and "overload" modules.
625 root 1.289 - work around buggy windows/openbsd perls and provide EBADMSG
626     and EPROTO ourselves when missing.
627     - improve perl 5.6 compatibility of the core event loop.
628     - made Net::SSLeay version 1.33 a soft requirement.
629 root 1.286
630 root 1.285 4.83 Fri Jul 17 16:56:26 CEST 2009
631 root 1.284 - implement AnyEvent::Socket::getprotobyname.
632 root 1.283 - AnyEvent::CondVar's will now detect recursive blocking
633 root 1.284 waits and will croak, as too many people fall into
634     this trap.
635 root 1.281 - AnyEvent::Handle will now call ->destroy on itself after
636     executing the on_error callback, instead of doing some
637     half-baked internal shutdown, for fatal errors.
638 root 1.282 - clarify on_eof behaviour w.r.t. the read queue and
639     on_read callbacks.
640 root 1.281 - ignore some possible spurious wake-ups in tcp_connect.
641 root 1.279
642 root 1.278 4.82 Sat Jul 11 00:34:55 CEST 2009
643 root 1.277 - POE and Event backends didn't accept some callable objects as
644     callbacks.
645 root 1.275 - use Config module instead of POSIX module to detect signal names
646     in AnyEvent::Strict and AnyEvent::Impl::EventLib, as the POSIX
647     module doesn't even have all POSIX signals :/.
648 root 1.276 - use more workarounds around the many refcnt/corruption bugs in
649     Event::Lib.
650     - work around a race condition in perl's select, causing t/03_child.t
651     to rarely fail.
652 root 1.275
653 root 1.274 4.81 Thu Jul 9 10:30:30 CEST 2009
654 root 1.272 - AnyEvent::Handle didn't properly diagnose write errors
655     (it expected -1 from syswrite, how lame... :).
656 root 1.268 - support file descriptors in addition to file handles
657     in AnyEvent->io.
658 root 1.265 - new env variables: PERL_ANYEVENT_RESOLV_CONF,
659 root 1.266 PERL_ANYEVENT_MAX_OUTSTANDING_DNS, PERL_ANYEVENT_CA_FILE
660     and PERL_ANYEVENT_CA_PATH.
661 root 1.267 - provide a sensible synopsis section for AnyEvent::TLS.
662 root 1.273 - add a "supported backends" section to the manpage.
663 root 1.270 - added simple io watcher test to testsuite, using a
664     portable_socketpair.
665 root 1.271 - tried to improve the stability of the Event::Lib backend,
666     YMMV.
667 root 1.265
668 root 1.264 4.8 Mon Jul 6 23:45:16 CEST 2009
669 root 1.261 - AnyEvent::DNS did not properly follow CNAME records with
670     uppercase targets.
671 root 1.262 - AnyEvent::DNS would errornously return AAAA records
672     with v4 mapped addresses (a faulty record) as ipv4 addresses,
673     causing AnyEvent::Socket to throw an exception.
674 root 1.260 - added new module AnyEvent::TLS for easier SSL/TLS context
675     creation, with many options including hostname verification,
676     secure default configuration, lots of documentation and,
677     predefined diffie-hellman keys for perfect forward security
678     and much more. get it while it's still fresh!
679     - use AnyEvent::TLS in AnyEvent::Handle for context management.
680 root 1.256 - load AnyEvent::Handle only on demand in AnyEvent::DNS,
681     so AnyEvent::Socket users have smaller memory footprint
682     in the common case.
683 root 1.258 - add AnyEvent::Handle->push_shutdown method.
684     - add an additional error message parameter to AnyEvent::Handle's
685     on_error callback (for TLS, $! is still available).
686 root 1.263 - add AnyEvent::Handle on_starttls/on_stoptls callbacks.
687 root 1.596 - make AnyEvent::Handle more robust against early connection
688 root 1.257 failures (during new), and return C<undef> in that case
689     from the constructor.
690 root 1.259 - AnyEvent::Handle will now try to load only JSON::XS first,
691     then fall back to JSON.
692 root 1.262 - format_ipv4/format_ipv6 are now exported by default, for symmetry,
693     and because it was documented that way.
694 root 1.256
695 root 1.258 4.451 Fri Jul 3 00:28:58 CEST 2009
696     - do not clear rbuf when shutting down an AnyEvent::Handle
697     object - doing so breaks AnyEvent::HTTP.
698    
699 root 1.255 4.45 Mon Jun 29 22:59:26 CEST 2009
700     - a write error could cause AnyEvent::Handle to create
701     an I/O watcher with an undefined $fh.
702 root 1.251 - special-case mapped ipv4 addresses in both
703     AnyEvent::Socket::format_address and parse_address,
704     to treat them just like ipv4 addresses.
705 root 1.254 - updated and overhauled the AnyEvent::Intro doc.
706 root 1.252 - implement AnyEvent::Socket::format_ipv4/ipv6.
707     - slightly speed up portable_pipe/socketpair.
708 root 1.255 - expand condvar begin/end documentation.
709 root 1.250
710 root 1.249 4.42 Fri Jun 26 08:32:18 CEST 2009
711 root 1.248 - preliminary and neccesarily incomplete support for IO::Async.
712 root 1.247 - reset SIGCHLD to DEFAULT when AnyEvent is loaded, in
713     case it was set to IGNORE, to ensure we can catch child statuses
714     even when the calling env acts stupidly.
715 root 1.248 - updated benchmarks with IO::Async, which performs very well.
716 root 1.247
717 root 1.245 4.412 Wed Jun 24 01:35:57 CEST 2009
718 root 1.242 - support an "untaint" attribute for AnyEvent::DNS
719     and set it on the default resolver.
720 root 1.241 - implement and document AnyEvent::Impl::Perl::loop.
721 root 1.242 - remove all anyevent-env variables from %ENV
722     when running in tainted mode.
723 root 1.244 - mention and extend the IO::Lambda benchmark.
724 root 1.241
725 root 1.240 4.411 Sun Jun 7 18:48:02 CEST 2009
726 root 1.239 - do not try to use F_SETFD on windows.
727    
728 root 1.238 4.41 Thu May 14 06:40:11 CEST 2009
729 root 1.236 - work around issues in older perls (5.8.0?) when
730     a signal handler is deleted from the %SIG hash.
731 root 1.237 - use POSIX::_exit in child test, to avoid running
732     destructors.
733     - speed up CHLD handling by relying on SIGCHLD being
734     synchronously delivered, even when we roll our own
735     implementation.
736 root 1.238 - AnyEvent::DNS: add the "dname" resource record name
737     for cosmetic reasons.
738 root 1.235
739 root 1.234 4.4 Sun Apr 26 20:12:33 CEST 2009
740     - implemented idle watchers, where applicable.
741 root 1.232 - AnyEvent->time died when Event backend was in use.
742     - fix a memleak in the Tk backend.
743     - sped up Tk timer handling.
744 root 1.233 - clip negative "after" values to 0 in AnyEvent::Impl::Event
745     to avoid spamming out warning messages.
746 root 1.232 - fix Qt timers without interval.
747 root 1.242 - avoid Qt zero-timeout special case, in old libqt's.
748 root 1.232
749 root 1.231 4.352 Mon Apr 20 16:31:11 CEST 2009
750 root 1.229 - fix AnyEvent::Strict error messages for child watchers.
751 root 1.230 - fix/update Makefile.PL "recommends" versions.
752     - add AnyEvent->now_update.
753 root 1.229
754 root 1.228 4.351 Sat Apr 11 07:56:14 CEST 2009
755 root 1.225 - actually make the signal pipe work under win32.
756 root 1.227 - localise $! in signal handler to avoid changing $!, although
757     perl itself does not seem to save/restore errno either.
758 root 1.226 - set the cloexec flag on the signal pipe (normally set by perl too).
759 root 1.225
760 root 1.224 4.35 Fri Mar 27 11:48:20 CET 2009
761 root 1.220 - event models relying on AnyEvent's signal watcher emulation did
762     invoke the callback asynchronously, contradicting documentation
763     and causing signals to get lost (this includes AnyEvent's own
764     event loop). AnyEvent now uses the standard pipe trick to make
765     callback execution synchronous to the event loop.
766 root 1.224 - AnyEvent::Handle didn't free TLS context data on DESTROY
767 root 1.223 (patch by Pavel Shaydo).
768 root 1.220 - work around the ever-incompatibly-changing API of MakeMaker.
769 root 1.221 - document that changing global variables without restoring them
770     is a bad idea in Perl (noted by Adam Rosenstein).
771 root 1.224 - AnyEvent::Strict now barfs if ->io is passed a file.
772 root 1.220
773 root 1.219 4.34 Thu Feb 12 18:32:45 CET 2009
774 root 1.218 - separately buffer TLS read data, as otherwise the read queue could
775     deadlock as receiving data is not expected while draining the
776     read queue (which cna only happen with TLS).
777 root 1.214 - raise EBADMSG error on JSON decoding errors.
778 root 1.215 - fix some minor manpage bugs (reported by Maximilian Gaß).
779     - speed up select bitmask parsing quite a bit in the pure perl
780     backend.
781 root 1.216 - use CORE::select instead of just select in AnyEvent::Impl::Perl.
782 root 1.214
783 root 1.213 4.331 Tue Jan 6 21:07:25 CET 2009
784 root 1.212 - socketpair fails on many vista machines because vista has
785     completely broken accept/getpeername and getsockname functions,
786     so we provide our own socketpair emulation that kind of works
787     (AnyEvent::Util::portable_pipe).
788     - new function: AnyEvent::Util::portable_socketpair.
789 root 1.211 - take advantage of the Guard module if it exists.
790    
791 root 1.210 4.33 Fri Nov 21 02:35:40 CET 2008
792     - AnyEvent::Strict did errornously flag a fileno of 0 as
793     illegal.
794 root 1.206 - reduce memory usage and slightly speed up the pure perl backend
795     by only storing the file descriptor, not the file handle.
796 root 1.207 - add missing autocork method to AnyEvent::Handle (reported
797     by Adam Rosenstein).
798 root 1.209 - AnyEvent::DNS->resolve errornously documented an $rcode result
799 root 1.208 argument, but there isn't (spotted by Henrik Krohns).
800 root 1.209 - the naked truth about Tk - it's basically unmaintained.
801 root 1.206
802 root 1.205 4.32 Mon Nov 3 22:46:32 CET 2008
803 root 1.204 - fix AnyEvent::Socket::resolve_sockaddr to properly support
804     unix sockets again and choose a proper default for
805     the socket type.
806     - fix call to resolve_sockaddr in tcp_connect.
807    
808 root 1.203 4.31 Thu Oct 30 04:41:48 CET 2008
809 root 1.200 - implemented AnyEvent::Handle->destroy method.
810 root 1.203 - hint about unexpected effects in TLS mode.
811 root 1.200 - speed up AnyEvent::Impl::Perl by using more arrays
812     instead of hashes without the slightest loss of readability :)
813 root 1.201 - work around a perl argument refcounting bug.
814 root 1.202 - with some perl patches applied, AnyEvent now seems leak-free.
815 root 1.198
816 root 1.197 4.3 Fri Oct 3 09:18:43 CEST 2008
817 root 1.196 - AnyEvent will now install a no-op signal handler for SIGPIPE,
818     unless one has been installed already.
819 root 1.197 - warn about not loaidng AnyEvent::Impl::POE early enough
820     (patch by Adam Rosenstein).
821 root 1.390 - fixed a great number of bugs and corner cases in AnyEvent::Handle.
822 root 1.193 - fix a bug in where in SSL connect mode, the
823 root 1.191 client would first wait for some data by the server and
824 root 1.351 otherwise hang. (reported and analysed in an absolutely
825 root 1.191 exemplary manner by Adam Rosenstein).
826 root 1.193 - fix a bug in where SSL EOF would not be treated
827 root 1.191 as stream EOF, putting the connection into a hung state.
828 root 1.351 (reported and analysed in an absolutely exemplary manner by Adam
829 root 1.191 Rosenstein).
830 root 1.193 - fix a potential segfault when the TLS context
831 root 1.191 would go missing in a read callback (e.g. due to stoptls) -
832     Net::SSLeay of course makes no type checking whatsoever.
833 root 1.192 - AnyEvent::Handle will not stop the read watcher in TLS mode.
834     - AnyEvent::Handle->stoptls will send a TLS close notify
835     instead of simply destroying the stream now.
836 root 1.195 - fix a bug where large blocks of data written in TLS mode
837     would not be sent unless triggered by receives.
838 root 1.193 - on_drain will now take the tls write buffer into account.
839     - SSL operations have been streamlined a bit and should be faster
840     now, more to come, though.
841 root 1.194 - added a FAQ section, will document nontrivial issues in there.
842 root 1.191
843 root 1.190 4.234 Mon Sep 29 04:08:13 CEST 2008
844 root 1.189 - fix child watcher documentation: only child exits will be reported,
845     no trace events.
846 root 1.190 - mention SIGPIPE in AnyEvent::Handle.
847     - perl backend will now use POSIX::times as monotonic clock
848 root 1.188 when available and the monotonic clock option is not.
849 root 1.187 - run even without Time::HiRes in some cases now, but do not
850 root 1.190 provide sub-second accuracy (all *supported* perl versions have
851 root 1.187 Time::HiRes).
852    
853 root 1.186 4.233 Fri Aug 22 01:48:05 CEST 2008
854     - fix a bug in the testsuite, causing a hang.
855     - clarified lots of AnyEvent::Handle constructor arguments.
856    
857 root 1.185 4.232 Thu Aug 21 20:44:25 CEST 2008
858     - fix a bug in AnyEvent::Handle that could cause two fatal error
859     callbacks on EOF, which caused AnyEvent::HTTP to signal success twice
860     (testcase by Leon Brocard).
861     - clarified on_eof/on_error documentation a bit.
862    
863 root 1.184 4.231 Tue Jul 29 13:12:15 CEST 2008
864     - remove some debugging code left in AnyEvent::Util::fork_call
865     (and no, it's impossible to implement with the broken windows
866     perls without resource leaks or worse).
867    
868 root 1.183 4.23 Tue Jul 29 12:19:59 CEST 2008
869 root 1.177 - document the first parameter passed to condvar callbacks to be
870     the callback.
871 root 1.178 - add AnyEvent::Socket::{ntoa,aton} aliases.
872 root 1.180 - optimize the AE::Handle->push_read (line) for the default
873 root 1.179 eol marker.
874 root 1.180 - optimize push_read (packstring|storable) for small packets.
875 root 1.182 - invoke on_error callback when no on_eof callback is set.
876 root 1.180 - fix a bug in push_read (storable) of unknown impact.
877 root 1.177
878 root 1.176 4.22 Sun Jul 20 16:34:13 CEST 2008
879 root 1.174 - new function AnyEvent::Socket::parse_hostport.
880 root 1.175 - as the bulkheads at microsoft can't even get getprotobyname reliably
881     working on their shitty fucking broken os we need to hardcode
882     some common protocol numbers in AnyEvent::Socket. How can
883     people even bother with such a pile of shit as windows.
884 root 1.174
885 root 1.173 4.21 Thu Jul 17 14:40:05 CEST 2008
886 root 1.171 - INCOMPATIBLE CHANGE: AnyEvent::Util::fork_call now has a prototype
887     which is incompatible to previous invocation syntax.
888 root 1.172 - work around more windows perl bugs in fork_call. I cannot imagine
889     why anybody would bother implementing fork in such an obviously
890     unusable way.
891     - avoid calling $do_retry if the request has already finished in
892     AnyEvent::DNS, thus avoiding an exception (reported by Anatoly
893     K. Sharifulin).
894 root 1.170
895 root 1.169 4.2 Sat Jul 12 22:42:11 CEST 2008
896 root 1.165 - support an "interval" argument for repeating timers.
897 root 1.164 - fix a bug in the pure perl event loop that caused timers to
898     be delayed under some circumstances.
899 root 1.167 - implement optional argument checking via PERL_ANYEVENT_STRICT.
900 root 1.169 - not importing anything from Event causes it to malfunction
901     and not use Time::HiRes, work around this bug.
902     - more bug workarounds against the endlessly broken Tk module,
903 root 1.168 seems to work now on 32 bit machines, but less so on 64 bit.
904 root 1.164 - minor optimisations applied to most backends.
905    
906 root 1.163 4.161 Fri Jul 4 14:24:48 CEST 2008
907 elmex 1.162 - fixed the t/handle/02_write.t, it read after write, with the
908 root 1.163 assumption that all data could be written before read
909     (reported by Jim Razmus).
910 elmex 1.162
911 root 1.161 4.160 Thu Jul 3 04:02:21 CEST 2008
912 root 1.160 - re-registering signal watchers after unregistering one did
913     not work if a backend falls back on AnyEvent's default
914     implementation (also affected child watchers).
915 root 1.159 - new AnyEvent::Handle options: autocork and no_delay.
916    
917 root 1.158 4.152 Sun Jun 22 14:15:44 CEST 2008
918 root 1.159 - allow for 32-bit perls that implement shifts differently
919     on different architectures in parse_ipv4 (reported and
920 root 1.158 analysed by Keiichi DAIBA).
921    
922 root 1.157 4.151 Fri Jun 6 17:34:24 CEST 2008
923     - make sure specifying _only_ on_read and never pushing reads
924     works.
925    
926 root 1.155 4.15 Fri Jun 6 13:00:46 CEST 2008
927 root 1.154 - the pure perl backend would keep some watchers alive when more than
928     one watcher was registered for the same fd.
929 root 1.155 - new "packstring" and "storable" read and write types
930     for AnyEvent::Handle.
931 root 1.156 - allow on_eof handler to be called after on_error with EPIPE returns.
932 root 1.153 - do not immediately call on_read callback in handle constructor.
933    
934 root 1.152 4.14 Thu Jun 5 20:29:31 CEST 2008
935 elmex 1.149 - Fixed a bug in DNS SRV priority sorting.
936 root 1.150 - AnyEvent::Util::guard now reports runtime errors while
937     executing the guard block as warnings.
938 root 1.152 - handle 0-byte-reads just before EOF correctly in AnyEvent::Handle.
939 elmex 1.149
940 root 1.148 4.13 Thu Jun 5 00:47:59 CEST 2008
941 root 1.146 - AnyEvent::DNS only followed cname chains with length 2,
942     contrary to documentation. bumped it up to 10, thanks to
943     microsoft, the current broken-dns-config-king.
944 root 1.147 - AnyEvent::DNS didn't check for socket return status
945     but instead relied on perl not creating filehandles in that
946     case - too bad it gives you a bogus file handle (reported
947     and analysed by Vladimir Timofeev).
948 root 1.145 - fix queue management logic in AnyEvent::Handle:
949     when on_read was registered, the queue was empty
950     and no progress could be made AnyEvent::Handle would
951     enter an endless loop.
952     - correctly start reading again when the handle became
953     busy again after idling.
954 root 1.146 - correctly treat tls shut-downs as EOF condition
955     (for the time being, would be nice to have a callback for that).
956 root 1.145 - correctly call eof callback under all conditions
957     (hopefully).
958 root 1.146 - the timeout callback did not expect that $self can go
959     away any time.
960 root 1.145
961 root 1.144 4.12 Tue Jun 3 10:58:04 CEST 2008
962     - include AnyEvent::Intro, a tutorial for anyevent,
963     anyevent::socket and anyevent::handle.
964 root 1.143 - allow more options in on_error.
965 root 1.142
966 root 1.141 4.11 Fri May 30 23:42:25 CEST 2008
967 root 1.135 - INCOMPATIBLE CHANGE: replace ptr by real PTR lookup, provide
968     reverse_lookup and reverse_verify to replace it, support
969     v4mapped and v4compat addresses.
970 root 1.129 - provide more documentation for the resolver class.
971 root 1.130 - really replace longest run of :0: by :: in format_address,
972     also properly convert :: and ::1 again.
973 root 1.134 - support NAPTR record name and decode it.
974 root 1.133 - implement random weight sampling for SRV records, as per
975     rfc 2782.
976 root 1.137 - correctly abort on srv-record targets of ".".
977     - added AnyEvent::DNS::wait_for_slot.
978 root 1.138 - in the unlikely event of a virtual circuit connection
979     being invalidated by a delayed udp reply, AnyEvent::DNS
980     could die. this has been fixed.
981     - plug a probable memleak in the DNS vc code.
982     - use configured timeout also for VC request phase.
983 root 1.139 - implement timeout and max_outstanding methods
984     for resolver class.
985 root 1.140 - update version numbers in all modules.
986 root 1.129
987 root 1.128 4.1 Thu May 29 05:45:40 CEST 2008
988 root 1.123 - INCOMPATIBLE CHANGE: renamed xxx_ip functions to xxx_address
989     which mirrors their purpose better (old names still available
990     for a while). Also moved AnyEvent::DNS::addr to
991     AnyEvent::Socket::resolve_sockaddr.
992 root 1.127 - implement AnyEvent->time and AnyEvent->now.
993 root 1.124 - fix IPv6 support in pack_sockaddr.
994 root 1.123 - officially un-experimentalise all newly introduced code.
995     - support unix domain sockets everywhere by specifying
996     a host of "unix/" and the pathname as service.
997 root 1.126 - implement an activity timeout in AnyEvent::Handle.
998 root 1.122 - added a regex read type to AnyEvent::Handle.
999     - added a json read/write type to AnyEvent::Handle.
1000 root 1.118 - always croak in on_error in AnyEvent::Handle.
1001     - document how to subclass AnyEvent::Handle.
1002 root 1.120 - implement AnyEvent::Util::fork_call.
1003 root 1.127 - add support for IPv6 nameservers and nameserver statements.
1004 root 1.121 - work around _yet_ _another_ windows perl bug in where empty
1005     select masks cause errors in the pure perl backend (this
1006     workaround cannot be implemented for the other event loops,
1007     but EV also works around this).
1008 root 1.123 - supply AnyEvent::Socket::address_type and make good use of it.
1009 root 1.122 - clarify and fix the Handle documentation w.r.t $self vs. $handle
1010     vs. callback arguments.
1011 root 1.127 - add some recommends to the META.yml.
1012 root 1.117
1013 root 1.116 4.05 Mon May 26 19:44:06 CEST 2008
1014     - some platforms ignore the rfc and prepend an extra sa_len member to
1015     the sockaddr structure, cater for those. also use sockaddr_family,
1016     didn't know it was there, but comes in handy for the workaround.
1017 root 1.114 - undo the import WIN32 hack.
1018    
1019 root 1.113 4.04 Mon May 26 08:03:31 CEST 2008
1020 root 1.109 - try to work around yet another windows bug: failed connects are reported
1021 root 1.110 as if it were out-of-band data. windows users: you suck. Only
1022     EV, Glib, Event and the pure perl backend can handle this condition.
1023 root 1.111 - optimize write algorithm in AnyEvent::Handle.
1024 root 1.106 - properly parse PERL_ANYEVENT_PROTOCOLS and use the info correctly.
1025 root 1.112 - tcp_connect now properly iterates through all targets.
1026 root 1.104 - check wether IPv6 sockets can actually be created, otherwise, disable ipv6
1027 root 1.114 support entirely. also hardcode some AF_INET6 constants for the
1028 root 1.107 sake of perl 5.8.
1029 root 1.106 - vastly improved nameserver/suffix detection algorithm for windows
1030     (still a hack...)
1031     - try to use a fallback dns server if no dns servers could be found.
1032 root 1.108 - splatter around some local $SIG{__DIE__}'s to work around bad
1033     die handlers.
1034 root 1.104
1035 root 1.102 4.03 Sun May 25 05:05:57 CEST 2008
1036 root 1.100 - work around perl bugs on windows, where perl returns undocumented
1037     error codes for sysread, syswrite etc.
1038 root 1.96 - fix AnyEvent::Handle::unshift_read to really unshift and not push.
1039 root 1.97 - AnyEvent::Handle could sometimes stumble over 0-byte writes.
1040 root 1.101 - fix unpack_sockaddr, now works for AF_INET6 sockaddr's.
1041 root 1.100 - updated documentation.
1042 root 1.103 - lots of workarounds for perl 5.8 quirks.
1043 root 1.98 - implement a more flexible type system for both reads and writes
1044     in AnyEvent::Handle.
1045 root 1.101 - support IPv6 in tcp_server.
1046     - pass local hostname and port to the prepare callback in tcp_server.
1047 root 1.99 - make types extendable in AnyEvent::Handle.
1048 root 1.100 - croak, not die, in AnyEvent::Handle;
1049 root 1.96
1050 root 1.95 4.0 Sat May 24 19:58:08 CEST 2008
1051 root 1.88 - added (experimental) AnyEvent::DNS module.
1052     - added (experimental) AnyEvent::Socket module.
1053 root 1.93 - added (experiemntal) support for TLS/SSL in AnyEvent::Handle.
1054 root 1.90 - make condvar->end call ->send as documented.
1055     - make condvar constructor support the documented cb => argument.
1056 root 1.94 - overload condvars so you can use them instead of code references.
1057 root 1.93 - support more of the POSIX forms instead of a pure dotted quad for
1058 root 1.89 verbatim ip addresses.
1059 root 1.88 - AnyEvent::Socket::inet_aton will use AnyEvent::DNS now and not fork anymore.
1060 root 1.87 - try very hard not to freeze on broken windows perls.
1061 root 1.86 - make on_eof optional in AnyEvent::Handle.
1062 root 1.83 - support service names in tcp_connect and tcp_server.
1063 root 1.84 - work around netbsd/openbsd bug causing unix sockets not to
1064 root 1.121 become writable until empty.
1065 root 1.81 - only make a dummy read for error detection when getpeername
1066     returns ENOTCONN.
1067 root 1.181 - defend AnyEvent::Util::inet_aton against Coro::LWP's brutal
1068 root 1.82 override.
1069 root 1.91 - new AnyEvent::Guard::cancel.
1070 root 1.81
1071 root 1.80 3.5 Sat May 17 23:17:14 CEST 2008
1072 root 1.79 - gracefully deal with systems not defining CLOCK_MONOTONIC
1073     (as opposed to not supporting the clock itself, which worked in 3.41).
1074 root 1.77 - added AnyEvent::Util::tcp_connect and AnyEvent::Util::tcp_server
1075     helpers, to replace the ill-designed AnyEvent::Socket class.
1076     - added some examples (eg/connect, eg/handle).
1077     - added AnyEvent::Util::guard.
1078     - AnyEvent::Util now exports most of its functions.
1079 elmex 1.74 - fixed a bug in *_read_chunk, where the callback was called with $self as
1080     first and second argument.
1081 root 1.77 - simplified and fixed regex handling in AnyEvent::Handle::*_read_line.
1082 root 1.72 - fix manpage condvars examples to use new syntax.
1083 root 1.78 - considerably improve inet_aton with EV::ADNS backend to support
1084     cname chains (common dns configuration bug, e.g. with www.google.de)
1085     and aaaa records if no a record could be found.
1086 root 1.72
1087 root 1.71 3.41 Sun May 11 19:53:13 CEST 2008
1088     - work around a bug in perl 5.8.8's local. Reported by Yi Ma Mao.
1089    
1090 root 1.70 3.4 Sun May 11 00:29:25 CEST 2008
1091 root 1.181 - complete re-implementation of condvars with a hopefully much more useful
1092 root 1.70 API (backward compatible functions exist but are undocumented).
1093 root 1.69 - AnyEvent::Handle fully rewritten with a hopefully more powerful API
1094     (still subject to change).
1095 root 1.63 - take advantage of CLOCK_MONOTONIC, if available, in AnyEvent::Impl::Perl.
1096 root 1.68 - provide AnyEvent::post_detect and @AnyEvent::post_detect, which
1097 root 1.67 allows module authors to avoid forcing event loop detection.
1098     (used by Coro::AIO, Coro::BDB, Coro::AnyEvent for example).
1099 root 1.66 - remove coro backends: Coro now provides generic support for AnyEvent
1100     via Coro::AnyEvent.
1101 root 1.63
1102 root 1.62 3.3 Mon Apr 28 09:51:06 CEST 2008
1103     - added AnyEvent::Handle, AnyEvent::Socket and AnyEvent::Util modules.
1104 root 1.55 - fix a bug in the pure perl backend that kept watchers alive
1105     when multiple watchers were registered for the same fh/poll combo.
1106 root 1.54 - add a benchmark section showing AnyEvent overhead and comparing
1107     the different event loops with each other.
1108 root 1.56 - prefer pure perl over tk when autoprobing, as it's about as fast,
1109     but doesn't crash with many watchers.
1110 root 1.62 - declare Qt support non-experimental.
1111 root 1.56 - clarify the confusing section about the file descriptor being
1112     kept alive.
1113     - document the race between loading of an event module and
1114     child processes exiting.
1115 root 1.53 - support POE as "backend" (with some caveats, POE is not generic
1116 root 1.54 enough, and darn slow).
1117 root 1.53 - support Wx and Prima through POE.
1118 root 1.60 - optimise perl backend to use 20% less memory and take advantage
1119 root 1.62 of typical timeout behaviour. It can now compete with
1120 root 1.60 select/poll-based C event loops in most cases (it is usually
1121     faster than Event and Glib :).
1122 root 1.59 - roughly cut EV memory use in half and increase its speed by 30%,
1123 root 1.62 by removing undocumented functionality. Did something similar
1124     to other event loops where possible.
1125 root 1.53
1126 root 1.50 3.2 Thu Apr 24 10:10:40 CEST 2008
1127 root 1.51 - do not die when anyevent watchers are destroyed while running callbacks
1128     in the pureperl backend (could only happen when two watchers are registered
1129     for the same fh/poll combo).
1130     - support autoloading for child watchers, was broken in all versions.
1131 root 1.47 - implement PERL_ANYEVENT_MODEL env variable.
1132 root 1.49 - (experimental) implement interface to the (very crashy/buggy) Event::Lib module.
1133     - (experimental) implement interface to the Qt module (cannot be autoprobed).
1134 root 1.52 - this release is IO:AnyEvent-proof.
1135 root 1.47
1136 root 1.46 3.12 Tue Apr 22 07:11:46 CEST 2008
1137     - reinstate AUTHOR section that got lost somehow.
1138     - do not hang in the testsuite with badly broken perls (activestate,
1139     strawberry...), but instead diagnose the problem and continue.
1140     - use INT instead of CHLD in an attempt to support broken windows perls
1141     better (this decreases the test quality, unfortunately).
1142     - do not send the signal to the process group
1143     (no problem for CHLD, bad for INT :).
1144    
1145 root 1.45 3.11 Sat Apr 19 06:57:31 CEST 2008
1146     - major documentation rework.
1147     - document the fact that child watchers only watch for zombies.
1148     - fix the child watcher example.
1149    
1150 root 1.43 3.1 Wed Apr 16 17:09:01 CEST 2008
1151 root 1.40 - work around recurring bugs in Tk by dup'ing filehandles, the
1152 root 1.43 only method with good success chances on Tk (the bugs apparently
1153     don't get fixed anytime soon).
1154 root 1.42 - lift the restriction of only one watcher per fh direction
1155     (as the Tk bug workaround also lifts it and only Tk imposed
1156     such strong limits).
1157 root 1.41 - changed probe order to prefer coro adaptors.
1158     - explain why recursion into the event loop is not supported
1159     unless the backend supports it (only Coro::EV does without
1160     any restrictions...).
1161     - add simple manpages for all backend modules.
1162 root 1.40
1163 root 1.39 3.0 Mon Apr 7 21:30:23 CEST 2008
1164 root 1.38 - Coro::Signal changed semantics, roll our own, also cleaning
1165     up the Coro implementation in general.
1166     - rename Coro backend to CoroEvent.
1167     - add some decision helping paragraph to the manpage that should
1168 root 1.44 help people to decide whether AnyEvent is the right thing for them.
1169 root 1.38
1170 root 1.37 2.9 Mon Jan 28 13:31:54 CET 2008
1171     - update for EV 3.0 API changes.
1172    
1173 root 1.36 2.8 Sun Nov 25 15:06:03 CET 2007
1174     - waitpid can validly return 0. accept this fact of life
1175     instead of reporting it to any watchers.
1176    
1177 root 1.35 2.7 Fri Nov 23 11:41:14 CET 2007
1178 root 1.34 - force use of AnyEvent::Impl::Perl in testsuite, there is
1179     too much breakage outside AnyEvent.
1180 root 1.35 - deliver signals synchronously in AnyEvent::Impl::Perl
1181     or any other event loop that relies on AnyEvents child
1182     watcher emulation. *Could* help with hanging testsuite
1183     (except when Event or EV are installed).
1184 root 1.34
1185 root 1.33 2.6 Fri Nov 9 20:36:35 CET 2007
1186 root 1.32 - fix bug in testsuite.
1187     - move EV adaptor modules to AnyEvent.
1188     - add Coro+EV adaptor module.
1189 root 1.26
1190 root 1.31 2.55 Tue Nov 6 17:41:32 CET 2007
1191 root 1.27 - add EV to the list of supported event models.
1192 root 1.30 - do not auto-reset pid watchers, pass pid and status to them.
1193 root 1.29 - allow a pid of zero to watch for all children in child watchers.
1194 root 1.27
1195 root 1.25 2.54 Wed Jul 18 17:36:23 CEST 2007
1196     - work around a perl bug that results in
1197     BEGIN not safe after errors--compilation aborted without
1198     any discernible reason or error message by once
1199     again not use'ing strict.
1200    
1201 root 1.24 2.53 Sun Jul 8 10:51:53 CEST 2007
1202     - make Glib interface work again (spotted by elmex).
1203    
1204 root 1.22 2.52 Wed Mar 7 18:36:16 CET 2007
1205     - child watchers stopped working permanently when
1206 root 1.23 all current child watchers were destroyed.
1207 root 1.22
1208 root 1.21 2.51 Mon Dec 11 21:33:24 CET 2006
1209     - work around bugs in perl where eval "require Module" returns
1210     true even if the module couldn't be loaded :/.
1211    
1212 root 1.20 2.5 Mon Dec 11 02:15:28 CET 2006
1213 root 1.19 - avoid $AUTOLOAD because many perls corrupt it.
1214 root 1.20 - AnyEvent::detect forces autodetection.
1215     - implement signal watchers (experimental)
1216     (Tk does not support async signals (<= 804.027 at least),
1217     so they might get delayed indefinitely on Tk).
1218     - implement child watchers (experimental).
1219     - moved default condvar implementation into base module, simplifying
1220     most implementation modules.
1221 root 1.14
1222 root 1.18 2.1 Fri Nov 24 15:50:48 CET 2006
1223 root 1.16 - better docs.
1224     - simple testsuite.
1225 root 1.17 - added AnyEvent->one_event method for special purposes.
1226 root 1.16
1227 root 1.15 2.0 Wed Nov 1 02:21:30 CET 2006
1228 root 1.13 - INCOMPATIBLE CHANGE: poll can now either be "r" or "w" but not both.
1229     - INCOMPATIBLE CHANGE: io watcher callbacks have no arguments anymore.
1230     - EXPERIMENTAL:
1231     new pure-perl model added, AnyEvent now always finds a suitable
1232     event model.
1233 root 1.12 - improved documentation.
1234     - reduced cpu overhead.
1235    
1236 root 1.11 1.02 Fri Jan 13 14:15:40 CET 2006
1237     - add COPYING to clarify license.
1238    
1239 root 1.10 1.01 Sun Jan 8 05:48:09 CET 2006
1240     - correctly cancel Event timers, avoid memory leaks.
1241    
1242 root 1.9 1.0 Sun Jan 8 05:40:58 CET 2006
1243 root 1.8 - allow third-party interfaces to be added at runtime.
1244     - fix version number.
1245    
1246 root 1.7 0.9 Fri Dec 30 02:25:41 CET 2005
1247 root 1.6 - fixed errors in the documentation.
1248 root 1.7 - going back to using $VERSION as "load check",
1249     as suggested by Jörn Reder. Let's see why I stopped using
1250     this method.
1251     - add 'hup' to the list of events to receive for glib
1252     and generate 'rw' events for it, as some versions of
1253     glib seem to require this, while this breaks other
1254     (older) versions of glib.
1255     - implemented PERL_ANYEVENT_VERBOSE env variable.
1256 root 1.6
1257 root 1.5 0.3 Sun Dec 4 10:43:33 CET 2005
1258     - no changes to the code.
1259     - fixed documentation.
1260     - clarified some corner cases.
1261     - vastly improved documentation with a long example.
1262    
1263 root 1.3 0.2 Thu Dec 1 22:18:49 CET 2005
1264 root 1.44 - check whether a valid method was called, to avoid endless loops.
1265 root 1.4 - move condvars into their own class (cleaner, safer).
1266     - don't die when some modules are not available.
1267     - Tk is too broken to allow for words. Will work once Tk works.
1268 root 1.3
1269 root 1.2 0.1 Thu Dec 1 19:44:57 CET 2005
1270     - spiced up and cleaned up for release.
1271    
1272 root 1.1 0.01 Tue Sep 21 18:12:09 CEST 2004
1273     - original version; copied from Convert::Scalar.
1274