--- AnyEvent/Changes 2010/03/13 13:42:05 1.387 +++ AnyEvent/Changes 2012/04/13 15:24:57 1.550 @@ -1,5 +1,294 @@ Revision history for Perl extension AnyEvent. +TODO: document TCP_*** constants +TODO: add debug/trace logging to some modules +TODO: use the eval-with-cb-call trick also to speed up JSON? +TODO: common pitfalls? invoke-before-return + +7.01 + - use File::Spec to get the tmpdir in t/*, to avoid needless + failures on (most, not mine :) windows boxes. + +7.0 Fri Apr 13 06:33:30 CEST 2012 + - child watchers are broken in POE 1.352 (also many earlier + versions) and there seems to be no way to work around it, as POE + itself is inherently racy. Document this regression and add a delay + in t/68_poe_03_child.t for the time being. + - new module AnyEvent::IO, that is a frontend to either a pure-perl + synchronous I/O implementation (AnyEvent::IO::Perl), or to the + asynchronous I/O extension IO::AIO (AnyEvent::IO::IOAIO). + - load /etc/hosts only when DNS has no answer. + - stat /etc/hosts on every access and reload it if it changed. + - load /etc/hosts via AnyEvent::IO - potentially asynchronous. + - fix a buggy croak in the dh parameter reading in AnyEvent::TLS. + - AnyEvent::Log log_to_file and log_to_path now use AnyEvent::IO. As + a side effect, they now use true appending as opposed to libc + appending, and the file might not have been opened when the function + returns. + - the default logging level was not properly documented in a variety of + places, this has hopefully been rectified. + - updated uts46data.pl for unicode 6.1.0. + - made log messages generated by AnyEvent submodules not + include the package name anymore, as it will be logged + by default already. + - upgrade to the trick used by common-sense 3.5 to work + around extra warning torture/breakage under perl 5.15.x. + - log messages by anyevent are now ucfirst, are usually full + sentences and do no longer include the package name. + - the storable read type would sometimes throw an exception instead + of causing EBADMSG (analyzed by Maxime Soulé). + - work around a bug in openssl 1.0.1 which enforces a minimum rsa + keysize (reported by Paul Howarth). + - documented Rocco fabricating statements about AnyEvent and me. + +6.14 Tue Jan 31 20:00:24 CET 2012 + - AnyEvent::Impl::Tk was broken due to a mysterious "die" inside, + probably an editing mistake (reported by Darin McBride). + +6.13 Thu Jan 12 07:27:01 CET 2012 + - AnyEvent::Util::fork_call checked for POSIX availability in the wrong way, + causing it to fail if POSIX wasn't loaded already (analysed by Rock Power). + - AnyEvent::Handle::push_read (line => did pass $1 directly, so + regex-matching inside the callback would change the parameter, despite + $1 being dynamically scoped per-block. this perl bug is now being + worked around (testcase by Cindy Wang). + +6.12 Mon Dec 12 13:21:10 CET 2011 + - $! was clobbered by subsequent calls in tcp_connect, due to + the postpone not saving/restoring it (analyzed by Richard Garnish). + +6.11 Tue Nov 22 10:36:05 CET 2011 + - Tk cannot create windows when tainted unless you set a title, so + set a dummy title for AnyEvent's dummy mainwindow. How dummy. + - escape any nonprintable/nonascii characters when stringifying + backtraces. + - log the reason loading an interface module fails to load at level debug. + +6.1 Tue Oct 4 19:44:30 CEST 2011 + - INCOMPATIBLE CHANGE: the default log level is now "4" (error + and above), and some messages inside AnyEvent have been elevated + to higher log levels to print by default. + - AnyEvent::log, unlike AnyEvent::Log::log, did not always exit on fatal. + - work around yet another signal race bug, newly introduced by POE. My + how that module sucks. + - add google public ipv6 dns as fallback servers, so AE::DNS can finally + support ipv6-only operation even with defaults (also use ::1 instead + of 127.0.0.1). + - give better guidelines on how to chose a logging level. + - AnyEvent::Log can now cap (limit) log message priority by context. + - AE::log will now save and restore $! and $@, so callers don't have to. + - AE::Strict now checks that registered fds are still valid at regular + intervals. + - skip frequently called 'require' calls if the module appears loaded. + - increase signal latency test timer considerably for poor little osx, + which can't be bothered with basic posix functionality such as signal + delivery. + - mention some debugging aids in the tutorial. + - new env variable PERL_ANYEVENT_MAX_SIGNAL_LATENCY. + - private (%namespace) log contexts in PERL_ANYEVENT_LOG now have the name + of the context as title. + - AnyEvent::Strict would not restore read-write access to $_ when a callback + died - this is a user bug, but since AE::Strict exists to help dbeugging... + - detect the extremely evil IO::Async::Loop::AnyEvent module and refuse + to work with it - the author is well aware of the issues but refuses + to fix them. This extreme step has been taken because the module actively + attacks the goals of AnyEvent and makes it harder for module authors to use + AnyEvent. + +6.02 Fri Aug 26 20:08:31 CEST 2011 + - log_to_syslog now accepts facility strings. + - log_to_syslog would not allow facilities - "$facility|$level" + *literally* means that string. sheesh. + - the CPAN parser got confused and thought we provide Sys::Syslog, try + to work around. + - renamed AnyEvent::Impl::FLTK2 to FLTK. + +6.01 Fri Aug 26 07:04:11 CEST 2011 + - INCOMPATIBLE CHANGE: AnyEvent::DNS resource records now include + the TTL as fourth element - this affects ->resolve, ->request + and ->dns_unpack indirectly. Convenience functions such as + AnyEvent::DNS::{a,txt,mx,srv} are not affected, neither is + AnyEvent::Socket. + - INCOMPATIBLE CHANGE: backend authors now should not implement + one_event or loop, but instead the AnyEvent::CondVar::_wait and _poll + methods. + - INCOMPATIBLE CHANGE: verbosity levels have been redefined, see + AnyEvent (PERL_ANYEVENT_VERBOSE) and AnyEvent::Log for details. + - DEPRECIATION: please change + "use AnyEvent::Impl::Perl" to "use AnyEvent::Loop" and + "AnyEvent::Impl::Perl::loop" to "AnyEvent::Loop::run" + in your programs, for future compatibility. + - *blush* idle watcher emulation was borked. + - AnyEvent::Strict now checks the AE::xxx functions as well. + - querying too long domain names would barf deep inside AnyEvent::DNS - since + this is hard to avoid for applications, AnyEvent:.DNS::request now checks for + for too long domain names explicitly and passes an undef to the callback + instead (reported by James Bromberger). + - make AnyEvent::Util more robust against EINTR (analyzed by Andrew Suffield). + - new functions: AnyEvent::postpone, AnyEvent::log. + - new module: AnyEvent::Log, for simple logging needs. + - new env variable, PERL_ANYEVENT_LOG, for fine-grained logging config. + - new env variable, PERL_ANYEVENT_DEBUG_SHELL, to automatically start + a debug shell. + - new env variable, PERL_ANYEVENT_DEBUG_WRAP, to automatically enable + watcher instrumentation/wrapping (see AnyEvent::Debug::wrap). + - new env variable, PERL_ANYEVENT_HOSTS, to override the place where + /etc/hosts can be found. + - an empty PERL_ANYEVENT_RESOLV_CONF now selects the default + configuration. + - env variables can now be specified using AE_xyz instead of + PERL_ANYEVENT_xyz, subject to some rules. + - lots of new AnyEvent::Debug functionality. + - AnyEvent::Strict now checks for modifications of $_ by the callback + (by setting it to readonly while executing the callback, if possible). + - IO::Async sometimes cancels the wrong timer when you call cancel_timer. + Invest extra overhead to work around this peculiar behaviour. + - split the pure perl backend into a loop module and an impl + module (AnyEvent::Loop and AnyEvent::Impl::Perl). + - some read types (regex, netstring, json, storable) could + errornously keep an AE::Handle object alive on their own + (reported by Mohammad Toossi). + - AnyEvent::Socket::resolve_sockaddr and all functions using it now + supports /etc/hosts overrides. + - add more workarounds around child watcher bugs in IO::Async + and (newly introduced) in POE. + - use glib child watchers and try to work around its limitations, + if possible (based on a patch by Kevin Ryde). + - add support for FLTK (fltk2), via AnyEvent::Impl::FLTK2. + - many read types in AnyEvent::Handle would malfunction during + transitions to TLS because of a "delete $self->{rbuf}". + (reported by Gerald Galster). + - improve condvar blocking wait performance (probably only noticable + with faster backends), also make it easier for event loops that + do not support blocking waits. + - PERL_ANYEVENT_MODEL now also allows full module names, although + the usefulness of this feature is not yet clear. + - add tests for all supported event loops, conditional on PERL_ANYEVENT_LOOP_TESTS. + - add t/80_ssltext.t. + - no longer use AUTOLOAD for the initial loading (for no very good reason). + - tcp_server now tries to unlink unix domain sockets when it gets destroyed. + - do not run event loop detection multiple times when programs call their cached + copies of AnyEvent::detect. + - parse_hostport now accepts absolute paths als unix domain sockets. + - suppress the idiotic warning inside POE by patching the POE::Kernel + run flags instead of asking the user to jump through contortions. + - add Task::Weaken as dependency (as recommends only at this time). + - replace PF_UNSPEC by 0, for good old minix. + +6.0 (not officially released, but was on CPAN for about 15 minutes :/) + +5.34 Thu May 12 09:59:41 CEST 2011 + - AE::TLS didn't support both cert_file and key at the same time, + due to some copy&paste bug (reported and analyzed by vti). + - improve AE::Handle timeout documentation slightly. + +5.33 Mon Feb 7 21:51:41 CET 2011 + - never appeared on CPAN, for unknown reasons. + - AnyEvent::Handle on_connect_error - do not try to destroy a handle + object when it's already gone (analyzed by Ryan Bullock). + - update idna algorithm(s) to UTS#46 version 6.0.0. + - preserve trailing dot in idn_to_ascii - testsuite says to preserve, + uts46 says it's an error, and testsuite makes more sense. + - remove leading dots in idn_to_ascii - testsuite says to remove, + uts46 says it's an error, and testsuite makes more sense. + - fixed a bug in idn ignored character processing. + - passes the uts46 6.0.0 testsuite except for three cases which + apparently are bugs in the testsuite itself. + - passes the uts46 6.0.1 testsuite except for eleven cases which + apparently are bugs in the testsuite itself. + +5.31 Sun Jan 23 11:49:19 CET 2011 + - work around a POE bug where POE would first poll for new events and + invoke handlers BEFORE handling the message queue. + - fix parsing of "domain" statement in resolv.conf (Johannes Plunien). + - stop_read now does just that in TLS mode. see its + documentation for caveats. + - update to common::sense 3.4 warning set (some warnings in perl impose + an arbitrary 32kb limit on regex matches, which affects + AnyEvent::Handle). + - AE::Handle had a broken rbuf_max method and missing wbuf_max method. + - new experimental AE::Handle::resettls method. + +5.3 Fri Dec 31 05:48:13 CET 2010 + - major IOAsync patch by Paul Evans - 0.33 is required, as the major + issues with IO::Async have been solved in that version, including + the availabilty of a default loop! + - implement new wbuf_max parameter for AnyEvent::Handle. + - added Cocoa::EventLoop backend by Daisuke Murase. + - the default testsuite now honors PERL_ANYEVENT_MODEL (Paul Evans). + - clarify handle on_prepare documentation. + - set CLOEXEC flag on parent-side fd's in AnyEvent::Util::run_cmd, + to avoid leaking them to any child processes. + - try to force files into the arch-dependend lib directory, for the + half-"turly obsessive compulsive person"(s) that depend on it. + +5.29 Sun Dec 5 10:49:21 CET 2010 + - convert EV backend to EV 4.00 API (so better upgrade EV too). + - AE::Handle: implement dynamic read_size adjustment, add + max_read_size parameter, reduce default read_size to 2048. + - add some FAQ entries for servers and/or on_eof vs. on_error. + - work around OS bugs (cygwin again) when lingering in AE::Handle. + - reduce memory usage slightly when connect was used in AE::Handle. + - wrok around more segfaults in Tk. + - document tls_ctx => undef as valid. + - detect WNOHANG value at compiletime. + - include some probably linux-only support for building AnyEvent + as part of the perl core. + - improve compatibility of t/08_idna.t to perl 5.8. + - make AnyEvent::Strict truly optional (in case somebody builds a + minimal perl...). + +5.28 Wed Oct 13 04:14:23 CEST 2010 + - due to a glitch, AnyEvent's internal getprotobyname wasn't + actually used in tcp_server. + - implement AnyEvent::CondVar->new method, which was documented but + missing. + - support autoloading of read types in unshift_read. + - AnyEvent::Strict: do the test for invalid fh arguments differently, + resulting in more informative error messages. + - new AnyEvent::FAQ manpage. + - clarify that you can actually call push_read etc. in on_read. + - put keys and certs in /tmp, not into the current directory, + and document this in the SECURITY CONSIDERATIONS sections + of AnyEvent::TLS. + - support ";" as resolv.conf comment character in AnyEvent::DNS, as + requested by Ron Isaacson. + - document $AnyEvent::DNS::RESOLVER variable. + - incorporated major typo patches by Abhijit Menon-Sen. + - AnyEvent::Handle now croaks when negative timeouts are passed. + - add a shitload of TCP_xxx sockopt name constants to AnyEvent::Util, + undocumented, but who knows when they might come in handy. + +5.271 Tue Jun 8 12:05:46 CEST 2010 + - backport to perl 5.8.x. + +5.27 Sun Jun 6 12:12:05 CEST 2010 + - postpone differently in AnyEvent::Socket now, as + when not, canceling the connection attempt might fail + (found by Felix Antonius Wilhelm Ostmann). + - explicitly check for non-stream sockets in AE::Handle, too many + clueless people fell into the trap of this somehow working. + - simplified and reworked the "OTHER MODULES" section. + - better/more condvar examples. + +5.261 Wed Apr 28 16:13:36 CEST 2010 + - AF_INET6 was not properly used from Socket6 during configuration + time (found by Andy Grundman). + +5.26 Mon Apr 12 04:49:35 CEST 2010 + - don't generate spurious readyness notifications when select + returns EINTR in the pure perl backend (analysed and testcase + by Bas Denissen). + - give same examples in SYNOPSIS sections of AnyEvent and AE. + - provider faster implementations for AE::time/now/now_update for + EV and Perl backends. + - provide faster AE::cv and AE::time implementations for all + backends. + - no longer support lower/mixed-case signal names (this was + never documented nor universally supported). + - some more memory µ-optimisations, and somewhat less messy + code to cope with both AnyEvent and AE APIs. + 5.251 Sat Mar 13 00:58:21 CET 2010 - make test failed if it was run before make install on perl <= 5.8.8, and older versions of perl make our live very difficult, @@ -21,7 +310,7 @@ detection and eval. - free detection code after detection and similar memory optimisations. - Perl backend timer interval best effort drift has been improved - (ame algorithm as EV). + (same algorithm as EV). - update unicode idna mapping table. 5.24 Tue Jan 5 11:39:43 CET 2010 @@ -408,7 +697,7 @@ unless one has been installed already. - warn about not loaidng AnyEvent::Impl::POE early enough (patch by Adam Rosenstein). - - fixed a great number of bugs and corner cases in AnyEvent::Handle: + - fixed a great number of bugs and corner cases in AnyEvent::Handle. - fix a bug in where in SSL connect mode, the client would first wait for some data by the server and otherwise hang. (reported and analysed in an absolutely