ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/Coro/Changes
Revision: 1.628
Committed: Thu Mar 6 06:40:31 2014 UTC (10 years, 2 months ago) by root
Branch: MAIN
Changes since 1.627: +3 -1 lines
Log Message:
*** empty log message ***

File Contents

# User Rev Content
1 root 1.1 Revision history for Perl extension Coro.
2 root 1.113
3 root 1.382 TODO: should explore PerlIO::coroaio (perl leaks like hell).
4 root 1.494 TODO: channel->maxsize(newsize)?
5 root 1.590 TODO: __GCC_HAVE_DWARF2_CFI_ASM
6 root 1.618 TODO: swap_sv, maybe add scope_swap_sv, andallow to unswap by repeat?
7     TODO: swap_sv not undone in pool
8    
9 root 1.628 - croak when cancel is called without a thread context.
10    
11 root 1.627 6.37 Tue Mar 4 13:27:33 CET 2014
12 root 1.628 - *sigh*, removed leftover debugging code from debugging a
13 root 1.627 perl bug, of all things.
14    
15 root 1.626 6.36 Tue Mar 4 07:11:59 CET 2014
16     - semaphores would not clear the destroy hook when interrupted
17     by ->throw, causing segfaults or worse.
18     - ->throw on a thread waiting for a semaphore did not acquire
19     the semaphore, but also didn't wake up other waiters,
20     possibly causing a deadlock.
21     - "FATAL: $Coro::IDLE blocked itself" will now use Carp::confess
22 root 1.622 to report a full stacktrace, which should help find out
23     where the actual call is.
24 root 1.625 - "atomically" destroy data in slf_destroy, because it is
25     the right thing to do, just in case.
26 root 1.624 - disable ecb.h libm dependency, to compile on ancient systems
27     or under adverse conditions.
28 root 1.622
29 root 1.621 6.33 Mon Nov 18 11:26:27 CET 2013
30     - do not crash when freeing padlists with holes (in 5.18).
31 root 1.620 - tentative SVt_BIND 5.19 port/fix.
32    
33 root 1.619 6.32 Tue Nov 5 15:35:35 CET 2013
34 root 1.618 - use a new algorithm to derive padlists for perl 5.18. The old
35 root 1.619 one could lead to 0-pointer accesses inside perl (reported
36     by Darin McBride).
37 root 1.534
38 root 1.617 6.31 Thu May 9 07:39:48 CEST 2013
39     - Coro::AIO requests would crash if the thread was ready'd
40     while the request was ongoing.
41    
42 root 1.616 6.29 Wed May 8 02:55:18 CEST 2013
43 root 1.615 - when an on_destroy handler destructs the coro currently being
44     destructed a perl scalar could be accessed after being freed,
45     likely causing a crash.
46    
47 root 1.614 6.28 Wed Mar 6 06:58:02 CET 2013
48     - clean remnants of existing __DIE__ and __WARN__ handlers so
49 root 1.613 they lose their magic and will not cause segfaults later
50     (testcase by Andrey Sagulin).
51 root 1.608 - improved Coro::State documentation a bit.
52 root 1.609 - Coro::Debug::command now flushes the output.
53 root 1.610 - add hack detection code for x32 abi, because the braindead slugs
54     who designed that made it look exactly like x86_64 without
55     providing proper compile time symbols to test for it. as a result,
56     this detection cannot work reliably.
57 root 1.611 - valgrind stack registering was broken.
58 root 1.612 - do not rely on Time::HiRes anymore in Coro::Debug.
59 root 1.608
60 root 1.607 6.23 Fri Dec 7 23:36:37 CET 2012
61 root 1.604 - use experimental fiber implementation on native windows
62     perls.
63     - use sizeof (void *) as multiplication factor for stack sizes,
64     to accomodate the totally braindamaged microsoft 64 bit "os".
65 root 1.605 - changed verifier host from win2k-ap510-32 to win7-sp516-32/64.
66     activeperl 5.16 crashes when PerlIO_define_layer is called due
67     to some bug in the perl dll, strawberry perl at least passes
68     the testsuite.
69 root 1.606 - implement Coro::Handle->peeraddr/host/port, for slightly
70     improved compatibility with LWP.
71 root 1.602 - implement 5.17 compatibility by almost blindly applying a
72     good-looking patch by Father Chrysostomos.
73 root 1.604 - move stack management functions into libcoro 3.
74 root 1.605 - libcoro version 3 "released".
75 root 1.601 - support magic values as timed_io_once args.
76 root 1.599 - recommend AnyEvent 7+ or EV 4+, also require EV
77     version 4 or newer for Coro::EV.
78    
79 root 1.598 6.10 Tue Oct 9 01:14:27 CEST 2012
80     - updated ecb.h, it had a typo that caused it to not compile on many
81     big endian systems (reported by many people).
82     - disable memory fences in ecb.h to improve portability.
83 root 1.597
84 root 1.596 6.09 Sat Oct 6 23:25:02 CEST 2012
85 root 1.594 - Coro::EV I/O watchers were not interruptible by exceptions
86 root 1.595 (Coro::State::throw) (testcase by sten).
87 root 1.596 - ->throw now puts threads into the ready queue, as this seems to
88     be expected by existing code, and code that doesn't cope with spurious
89     wakeups needs fixing anyway.
90 root 1.593 - use fd -1 in mmap.
91 root 1.592 - cast I32 to int in error message printf.
92 root 1.593 - warn about broken so-called "hardened" kernels.
93 root 1.591
94 root 1.590 6.08 Fri Apr 13 12:05:47 CEST 2012
95 root 1.589 - be more aggressive about exiting like perl does - formerly,
96     exiting from the non-main thread would not execute END blocks.
97    
98 root 1.588 6.07 Fri Nov 11 21:21:48 CET 2011
99 root 1.587 - work around a bug in PerlIO (setting $SIG{__WARN__} to a PVCV).
100     - update ecb.h.
101    
102 root 1.586 6.06 Mon Aug 8 23:59:48 CEST 2011
103     - cygwin unfortunately patches the stack at runtime, so we use the pthreads
104 root 1.587 backend, which is an order of magnitude slower. unfortunately, cygwins
105 root 1.586 pthread implementation isn't very complete either, so allocate the stack
106     twice just to be sure.
107     (note: cygwin also enables mymalloc, which is NOT THREADSAFE ON WINDOWS,
108     in its ithreaded perl - best recompile cygwin and use the 'w'indows
109     backend for much better performance. also disable ithreads for
110     even better performance...).
111    
112 root 1.585 6.05 Thu Aug 4 21:36:36 CEST 2011
113     - blush, condvar values would not be propagated from send to recv anymore
114     (reported by Chip Salzenberg).
115 root 1.584 - use exponential increase for the readline buffer length in
116     Coro::Handle. also reduce initial allocation to 1020 from 4096 bytes.
117    
118 root 1.583 6.04 Wed Aug 3 17:15:45 CEST 2011
119     - use even more efficient and more compatible condvars for
120 root 1.581 compatibility to AnyEvent 6.x :)
121 root 1.582 - more inconsequential ecb.h updates.
122 root 1.581
123 root 1.580 6.03 Wed Aug 3 11:41:30 CEST 2011
124     - change how Coro patches AnyEvent condvars for compatibility to
125     AnyEvent 6.x.
126 root 1.579 - update ecb.h, to no longer include <pthread.h> in case WinNT.h
127     hasn't been included.
128    
129 root 1.578 6.02 Wed Jul 13 04:35:19 CEST 2011
130 root 1.577 - "improve portability to Gentoo" - gentoo manages to put perl variables
131     in memory areas that are farther than 2gb apart, which the jit couldn't
132 root 1.578 handle and barfed. now it's just a bit slower on gentoo and similar
133     systems.
134 root 1.577
135 root 1.576 6.01 Sun Jul 3 12:31:14 CEST 2011
136     - workarounds are good, but the test for whether pthreads are used
137     was not good. thisone should be better.
138     - check differently whether gcc generates cfi instructions itself.
139    
140 root 1.575 6.0 Wed Jun 29 19:43:35 CEST 2011
141 root 1.564 - INCOMPATIBLE CHANGE: unreferenced coro objects will now be
142     destroyed and cleaned up automatically (e.g. async { schedule }).
143 root 1.569 - implement a JIT compiler for part of the thread switch code,
144     which gives a 50% speed improvement on threaded perls, and
145     about 4% on non-thraeded perls (so threaded perls now finally
146     reach about half the speed of non-threaded perls).
147 root 1.574 - slightly modernise Coro::Intro, add section about rouse functions.
148 root 1.569 - avoid DEFSV and ERRSV, giving another 10% improvement
149     in thread switching.
150 root 1.564 - Coro::State->is_destroyed is now called is_zombie.
151 root 1.565 - implement a Coro->safe_cancel method that might fail, but
152     cancels in a "safer" way if it succeeds.
153 root 1.573 - add preliminary support for DEBUGGING perls.
154 root 1.566 - get rid of two hash-accesses when initialising a new Coro - this
155     speeds up coro creation by almost a factor of two.
156 root 1.562 - croak when a coro that is being cancelled tries to block
157     (e.g. while executing a guard block), instead of crashing or
158     deadlocking.
159 root 1.563 - use a more robust and also faster method to identify Coro::State
160     objects - speeds up everything a bit.
161 root 1.555 - implement Coro->cancel in XS for a 20% speed improvement, and to
162     be able to implement mutual cancellation.
163 root 1.561 - speed up context switches by a percent or two by more efficiently
164     allocating context stack entries.
165 root 1.563 - implement Coro->join and Coro->on_destroy in XS for a speedup and
166     a reduction in memory use.
167 root 1.556 - cancelling a coro while it itself is cancelling another coro is
168     now supported and working, instead of triggering an assertion.
169 root 1.554 - be a bit more crash-resistant when calling (buggy) on_destroy
170 root 1.555 callbacks (best effort).
171 root 1.559 - move on_destroy into the slf_frame, to allow extension slf
172     functions to have destructors.
173 root 1.563 - get rid if coro refcounting - simply crash in other interpreter
174     threads by nulling the pointers on clone.
175 root 1.566 - simplify warn/die hook handling when loading Coro - the convoluted
176     logic seems to be no longer neccessary.
177 root 1.568 - use libecb instead of our own home-grown gcc hacks.
178 root 1.570 - document alternatives to Coro::LWP. Please use them :)
179 root 1.571 - work around another mindless idiotic NEEDLESS bug in openbsd/mirbsds
180 root 1.572 sigaltstack. Really. wine suffers from it, erlang suffers from it,
181 root 1.573 and it's known since at least 2006.
182 root 1.554
183 root 1.553 5.372 Wed Feb 23 06:14:30 CET 2011
184     - apparently mingw doesn't provide a working gettimeofday, try to
185     work around that by relying on Time::HiRes (indirectly brought to
186     my attention by Max Maischein).
187     - fix some portability issues when Time::HiRes was used.
188    
189 root 1.552 5.371 Mon Feb 21 14:36:08 CET 2011
190     - backport to windows process emulation code again.
191    
192 root 1.551 5.37 Sat Feb 19 07:49:44 CET 2011
193 root 1.549 - add a big "Coro thread life cycle" section to "man Coro".
194 root 1.548 - try a tentative workaround against the breakage that 5.13 has
195     introduced without depreciation period. sigh.
196 root 1.551 - no longer use Time::HiRes if gettimeofday is available, which
197     saves quite a lot of memory.
198 root 1.548
199 root 1.547 5.36 Sun Feb 13 05:33:41 CET 2011
200 root 1.545 - automatically load Coro::Channel, Coro::RWLock, Coro::Semaphore,
201     Coro::SemaphoreSet, Coro::Signal and Coro::Specific on first "new"
202     method call.
203     - undocument Coro::Timer::sleep and obsolete whole module.
204     - optimise Coro::Timer::timeout memory and cpu usage.
205 root 1.546 - slightly updated Coro::Intro for recent changes.
206 root 1.547 - do not initialise PL_dirty anymore.
207 root 1.545
208 root 1.544 5.25 Thu Nov 11 01:08:39 CET 2010
209 root 1.543 - try a different approach on netbsd - netbsd 5 finally has marginally
210     working pthreads, but still broken ucontext/sigaltstack.
211 root 1.544 - openbsd 4.8 finally got their act together, Coro works out of the box
212     with asm, setjmp and pthreads (no change, just informational).
213 root 1.543
214 root 1.542 5.24 Sat Oct 23 11:27:12 CEST 2010
215     - port to the EV 4.0 API.
216     - work around bugs in mingw32, making strawberry perl work
217     out of the box.
218 root 1.541 - correctly modify Coro::AIO function prototypes
219     so that they reflect the "no optional parameters" rule.
220 root 1.540 - "ported" libcoro to C++.
221    
222 root 1.539 5.23 Mon May 17 18:50:42 CEST 2010
223 root 1.538 - be more resistant to ordering changes when initialising
224     Coro::AnyEvent, Coro::EV and Coro::Event (reported by Matthias
225     Waldorf).
226 root 1.536 - document that perl 5.12 deliberately removed support for cloning.
227    
228 root 1.535 5.22 Wed Apr 14 03:55:35 CEST 2010
229     - correctly return udnef on errors in Coro::Handle::read/write
230 root 1.537 (testcase by Marc Mims).
231 root 1.532 - convert Coro::Util into a "perl compatibility wrapper" - the functions
232     are less useful now, but are drop-in replacements for existing
233     functions, listing better alternatives in the documentation. This also
234     fixes a bug in Coro::LWP which naively substituted Socket::inet_aton
235     with Coro::Util::inet_aton.
236 root 1.533 - do not override $Coro::idle unconditionally in Coro.pm, as other
237     modules could have provided their own idle coro already
238     (for exmaple, Coro::AnyEvent).
239 root 1.532 - fix Coro::Util::gethost* functions.
240 root 1.534 - Coro::Timer corretcly exports it's symbols (reported by Hideki Yamamura).
241 root 1.532
242     5.21 Wed Dec 16 07:19:51 CET 2009
243 root 1.530 - automatically load Coro::AnyEvent when AnyEvent and Coro are used
244     together.
245     - add some examples on how to combine other event loops with Coro in
246 root 1.531 Coro::AnyEvent, and how to run it (and not to block). Seems to be
247     the most common source of confusion.
248     - try to catch people naively blocking in an event callback.
249     - work around the perl filehandle bug issue in conjunction with
250     older common::sense (as indirectly pointed out by ZSystem).
251 root 1.529 - clarify the "not from signal handlers" section.
252    
253 root 1.528 5.2 Sun Oct 4 14:54:24 CEST 2009
254 root 1.524 - Coro::Storable destroyed the prototypes of the functions it wrapped.
255 root 1.527 - export rouse_cb and rouse_wait by default now.
256 root 1.524 - fix various prototype mismatches in Coro::AnyEvent and Coro::Handle.
257 root 1.527 - new method $state->swap_sv.
258 root 1.522 - added section on "windows process emulation" to the manpage,
259     after a not-so-fruitful (nor-friendly) "discussion" with chip
260     salzenberg (discussion implies arguments, but his only arguments
261     were ad-hominems, one wonders why he started it in the first
262 root 1.523 place). I hope this explains it well enough for him to understand,
263     and maybe well enough for others to understand.
264 root 1.524 - use common::sense everywhere now.
265 root 1.525 - idle callbacks are no longer supported, use idle coros instead.
266     - print a thread listing when a deadlock is detected.
267 root 1.522
268 root 1.521 5.17 Sat Aug 22 23:09:31 CEST 2009
269 root 1.520 - work around a bug in the perl debugger causing crashes
270     when running under the debugger by marking _pool_handler as nodebug.
271 root 1.519 - speed up Coro::async considerably.
272 root 1.521 - try some hacks to get netbsd to work "more often" - their broken
273     setjmp/longjmp, ucontext *and* phtreads are really hard on Coro.
274     - convert Coro to AE 5.0 API.
275 root 1.519
276 root 1.518 5.162 Tue Jul 28 04:04:03 CEST 2009
277 root 1.517 - perl 5.8.2 is now minimum requirement.
278 root 1.518 - skip t/19_handle.t on broken windows perls.
279 root 1.517
280 root 1.516 5.161 Wed Jul 22 04:47:38 CEST 2009
281     - Coro::AnyEvent::poll could have a different prototype when EV was
282     used as backend (analyzed by Tatsuhiko Miyagawa).
283 root 1.515 - Coro::AnyEvent errornously initialised the event loop when loaded,
284     not on demand.
285 root 1.516 - try to workaround rare */t/01_unblock.t failures.
286 root 1.515
287 root 1.514 5.16 Tue Jul 21 01:44:37 CEST 2009
288 root 1.512 - Coro::AnyEvent failed to hook into the event loop
289     when no threads had been readied between detecting
290     the event loop and actually running it.
291 root 1.509 - considerably speed up Coro::Select by taking avdantage
292     of AnyEvent > 4.8 and some other optimisations.
293 root 1.514 - implement paragraph readline mode in Coro::Handle
294     (based on patches by Zsbán Ambrus).
295 root 1.513 - replace WSAEINPROGRESS by WSAEWOULDBLOCK (reported
296     and analyzed by Yasuhiro MATSUMOTO).
297 root 1.511 - clarified libcoro license and copyright.
298 root 1.510 - someone stole my EXTRA_META!!!
299 root 1.512 - implement Coro::Select::patch_pp_sselect and it's brother,
300     for hardcode select overriding.
301 root 1.509
302 root 1.508 5.151 Mon Jul 6 05:41:57 CEST 2009
303 root 1.506 - backport to windows process emulation code again (patch by
304     Yasuhiro MATSUMOTO).
305 root 1.507 - slightly update Coro::MakeMaker.
306 root 1.506
307 root 1.505 5.15 Tue Jun 30 10:28:06 CEST 2009
308 root 1.502 - deprecate Coro::Socket, document how to get ipv6 support via
309     AnyEvent::Socket instead.
310 root 1.500 - implement signal->wait ($cb) interface, similar to semaphores.
311 root 1.501 - work around SvOK not supporting getmagic, so we have to getmagic
312     to test for undef :/ (reported by Matthias Waldorf).
313 root 1.502 - load Coro::AnyEvent in all modules using AnyEvent.
314 root 1.503 - work around perl corrupting our internal data structures,
315     reported by Tokuhiro Matsuno.
316 root 1.504 - enable per-coroutine real and cpu time gathering
317     (Coro::State::enable_times).
318 root 1.500
319 root 1.499 5.14 Wed Jun 24 01:37:48 CEST 2009
320 root 1.497 - provide explicit functions to "cede" to the event loop in Coro::AnyEvent,
321     as this seems to have been a difficult concept (poll, sleep, idle,
322     idle_upto).
323     - add Coro::AnyEvent::readable/writable functions.
324     - clarify Coro::EV/Event/AnyEvent manpages.
325 root 1.496 - free per-thread global scalars in the thread calling ->cancel, to
326     avoid crashes when $_, $@ etc., are magical but some of those
327     had already been freed.
328 root 1.499 - "unexperimentalise" the callback interface for Coro::Semaphore.
329 root 1.493 - speed up ready queue management/context switching by using a linked
330 root 1.492 list instead of an array (~5-10%).
331 root 1.493 - implement "watch" command in Coro::Debug shells.
332 root 1.494 - for fun, implement time-slicing as an example in the manpage.
333 root 1.497 - if AnyEvent detects EV or Event, but we don't have Coro::EV or
334     Coro::Event, use the normal AnyEvent handling instead of dieing
335     (the same is true for Coro::Handle).
336     - properly document Coro::EV::timed_io_once.
337 root 1.498 - avoid unneccessary ->cancel calls in Coro::Handle.
338     - maybe make it work on mingw32 with win32 backend
339     (based on patch by Yasuhiro Matsumoto).
340 root 1.492
341 root 1.490 5.132 Fri May 29 09:00:39 CEST 2009
342 root 1.488 - do not keep a reference to the argument itself in
343 root 1.491 Coro::Semaphore::guard, as it could change later.
344 root 1.489 - support SO_RCVBUF/SO_SNDBUF nonstandard Coro::Socket options,
345     should support a prepare callback.
346 root 1.488
347 root 1.487 5.131 Mon Mar 16 23:20:37 CET 2009
348 root 1.485 - implement and document Coro->suspend, Coro->resume.
349 root 1.486 - fix Coro::Select implementation to not (often) close
350     the passed file descriptors (testcase provided by pippijn).
351 root 1.485
352 root 1.484 5.13 Mon Dec 15 21:51:42 CET 2008
353 root 1.481 - EXPERIMENTAL: implement dynamic winds (on_enter/on_leave).
354 root 1.476 - don't set diehook to C<undef> but instead to NULL, to avoid
355     spurious warnings.
356 root 1.478 - fix a lot of bugs in Coro::SemaphoreSet.
357     - Coro::SemaphoreSet will less often create a semaphore needlessly.
358     - add Coro::SemaphoreSet::count and wait methods.
359 root 1.477 - take advantage of the new Guard module.
360     - deprecate Coro::guard.
361 root 1.479 - try to fix the dreaded 01_unblock tests once more. I hate it when
362     testsuites need more fixing than the code they are supposed to test.
363 root 1.480 - croak in more cases when a required callback isn't resolvable.
364     - fix some minor issues in Coro::State->call/eval.
365     - use current coroutine context instead of a temporary one
366     when temporarily switching to another coroutine.
367 root 1.484 - do not call C-level on_destroy handlers during global destruction,
368     to avoid needless segfaults.
369 root 1.476
370 root 1.475 5.12 Sun Dec 7 13:30:38 CET 2008
371 root 1.467 - add default config for MirOS, which seems to be a bug-to-bug
372     compatible fork of openbsd ("world domination by releasing
373     openbsd cvs before the openbsd folks do it" or so :).
374 root 1.468 - free_padlist did destroy the names pad, not good, but didn't
375 root 1.470 seem to bother perl - this could fix issues such as eval ""
376 root 1.477 inside a function called from multiple coroutines.
377 root 1.467 - use a different method to detect destruction time.
378     - be more careful when freeing padlists just before global
379     destruction.
380 root 1.469 - fixed and expanded the call/cc example.
381 root 1.471 - renamed _terminate to _coro_run.
382 root 1.473 - new method Coro::Channel->shutdown.
383     - try pthreads on openbsd <4.4 (broken sigaltstack, will
384     pthreads fare better?).
385     - be less picky about destroying "a" running coroutine.
386 root 1.466
387 root 1.465 5.11 Tue Nov 25 21:49:05 CET 2008
388 root 1.464 - DEBUGGING in 5.10.0 is a mess: it constantly flags perfectly
389     working code with failed assertions, introducing more bugs than
390     it fixes, requiring elaborate workarounds :(
391    
392 root 1.463 5.1 Mon Nov 24 08:54:59 CET 2008
393     - wrote a small introductory tutorial - Coro::Intro.
394 root 1.454 - convert Coro::Timer, Coro::Select and Coro::Util to rouse API.
395 root 1.453 - Coro::Select did errornously dup the file descriptors
396     and didn't work with all AnyEvent backends.
397 root 1.463 - Coro::Select wasn't imported correctly form Coro::LWP, causing blocking
398     LWP data transfers.
399 root 1.458 - disassociate c contexts from coro objects - this is agruably more
400     correct, but mostly allows sharing of cctxs between coro and state
401     objects, for added memory savings and speed increases.
402 root 1.455 - bumped $Coro::POOL_RSS up to 32kb by default.
403 root 1.456 - no longer set the optype to OP_CUSTOM, as B::* understandably
404     doesn't like this very much (and we *are* a type of entersub).
405 root 1.458 - implement state cloning, just to prove that call/cc can be done.
406 root 1.460 - automatically load Coro::AnyEvent in Coro::Handle.
407 root 1.461 - wrap ->cancel calls in eval inside Coro::Handle as EV watchers
408     do not have this method (and don't need it either).
409     - speed up generic anyevent methods in Coro::Handle by using rouse
410     callbacks.
411     - allow coroutines in $Coro::IDLE, speeding up Coro::AnyEvent and
412     others. It also makes the debugger happier, as you can trace
413     through the idle threads now.
414 root 1.462 - add comppad_name* and hints ($^H, %^H) to per-thread variables.
415 root 1.461 - eg/event was pretty broken.
416 root 1.457 - better 5.8.6 compatibility.
417 root 1.453
418 root 1.452 5.0 Thu Nov 20 10:35:05 CET 2008
419 root 1.424 - NEW ARCHITECTURE: use the latest 4.x version if you experience
420     stability issues.
421 root 1.411 - bump API version to 7 - all dependents must be recompiled.
422 root 1.430 - removed timed_* functions - they were not being used anyways
423     and should be replaced by a more generic mechanism -
424 root 1.429 and were annoying to support anyways :)
425 root 1.451 - removed SemaphoreSet's waiter method - use sem method instead.
426 root 1.415 - Coro::Semaphore->adjust didn't correctly wake up enough waiters.
427 root 1.416 - async_pool did free a scalar value twice
428     ("Attempt to unreference...").
429 root 1.420 - fix a longstanding bug where calling terminate on a coro that
430     was waiting for a semaphore that was just becoming available
431     would cause a deadlock (semaphore would get into a state where
432 root 1.433 it was available but waiters were still blocked).
433 root 1.432 - calling throw on a coroutine that is waiting for a semaphore will
434     no longer make it acquire the semaphore (and thus leak a count).
435 root 1.412 - perl's process emulation is now not even theoretically supported
436     anymore.
437 root 1.447 - new functions Coro::rouse_cb and Coro::rouse_wait for easier
438     conversion of callback-style to blocking-style.
439     - new methods $coro->schedule_to and ->cede_to, to specifically
440     schedule or cede to a specific coroutine.
441 root 1.433 - new function Coro::Semaphore::wait.
442 root 1.428 - use named constants in Coro::Channel (Richard Hundt).
443 root 1.412 - directly patch the entersub opcode calling SLF functions (cede,
444     transfer and so on). this does speed up context switching, but
445     more importanly, it frees us from the hardcoded behaviour of
446     entersub, so we might actually be able to return something from
447     those functions and atcually create new ones.
448     - take advantage of __builtin_frame_address on gcc.
449     - expose THX in coroapi (not sure whether this was a wise decision,
450     as "threaded" perls are running at half speed anyways).
451     - implement execute_slf (schedule-like-function) interface that makes
452     it possible to implement schedule-like-functions in XS.
453 root 1.424 - use new SLF interface to massively speed up Coro::EV by roughly a
454     factor of two.
455     - used new SLF interface to massively speed up Coro::Semaphore by a
456     factor of three.
457 root 1.426 - used new SLF interface to speed up Coro::AIO by roughly a factor of
458     four and reduce its memory usage considerably.
459 root 1.429 - implement Coro::SemaphoreSet purely in terms of Coro::Semaphore,
460     for a nice speedup and vastly more correct behaviour. Also implement
461     a new method "sem" to get at the underlying semaphore object.
462 root 1.430 - implement Coro::Channel in terms of Coro::Semaphore, for a moderate
463     (in comparison) 20-40% speedup.
464 root 1.435 - used new SLF interface to reimplement Coro::Signal gaining
465     some unknown (because I was too lazy), but certain, speedup, and also
466     making signals reliable for the first time.
467 root 1.445 - used new SLF interface and other optimisations to speed up async_pool
468     by a factor of two. It also doesn't rely on perl's exception mechanism
469 root 1.446 to exit anymore. The overhead for terminating an async_pool, coro over
470     a normal async is now very small.
471 root 1.444 - sped up coroutine creation/destruction by 40%.
472 root 1.417 - forgot to include Coro/libcoro/README in the dist for all these years.
473 root 1.418 - work around a freebsd pthreads bug (manual testcancel is required as
474     pthread_cond_wait isn't a cancellation point on freebsd).
475 root 1.438 - use new rouse functions to speed up and simplify Coro::BDB.
476 root 1.439 - make "prefer perl native functions" work with threaded perls.
477 root 1.440 - condense Coro::Debug ps output, hint at v and w flags.
478 root 1.436 - (libcoro) lots of minor cleanups and portability improvements.
479 root 1.416
480 root 1.449 4.914 Wed Nov 19 12:54:18 CET 2008
481     - fix a disastrous bug in the readline optimisation
482     introduced in 4.801.
483    
484 root 1.416 4.913 Sat Nov 15 07:58:28 CET 2008
485     - async_pool did free a scalar value twice
486     ("Attempt to unreference...").
487 root 1.408
488 root 1.407 4.912 Thu Nov 13 18:31:23 CET 2008
489 root 1.404 - minor cleanups.
490 root 1.405 - use much larger stacks on linux and perl < 5.8.8.
491 root 1.406 - Coro::Debug::new_unix_server did not unlink the socket
492     when destroyed.
493 root 1.404
494 root 1.403 4.911 Tue Nov 11 04:26:17 CET 2008
495 root 1.401 - "port" to threaded perls.
496    
497 root 1.400 4.91 Mon Nov 10 05:36:38 CET 2008
498     - the ->throw exception object no longer leaks.
499     - creating a new cctx leaked a scopestack entry (memleak).
500     - new coroutines didn't get created with a zero flags field
501     (unknown impact).
502 root 1.399 - calling ->throw on a not-yet-started coroutine should now work
503     instead of being ignored.
504 root 1.400 - ->throw is now supported on Coro::State objects.
505 root 1.398 - clean up cctx creation code a bit.
506 root 1.400 - entersub is actually a UNOP, not a LOGOP (not a bugfix).
507 root 1.398
508 root 1.397 4.9 Sat Nov 8 17:45:27 CET 2008
509 root 1.618 - (libcoro) did not preserve rbp with CORO_ASM (we are getting there).
510 root 1.392 - (libcoro) no longer leak threads in the experimental pthread backend,
511     also speed it up considerably.
512 root 1.394 - (libcoro) do not rely on makecontext passing void *'s unscathed.
513 root 1.392 - fix compiletime dependencies on libcoro in the Makefile.
514     - cctx_count wasn't always updated properly.
515 root 1.393 - Coro::State::cctx_stacksize wasn't applied correctly.
516     - new function Coro::State::cctx_max_idle.
517     - the default max number of idle C contexts is now 4.
518 root 1.394 - (libcoro) try harder to get _setjmp/_longjmp.
519     - (libcoro) cleanup and extend the libcoro API to officially
520     allow the creation of empty source contexts.
521 root 1.395 - very experimental workaround for the totally broken netbsd platform.
522 root 1.396 - tried to hack around openbsd bugs.
523 root 1.391
524 root 1.390 4.804 Wed Nov 5 16:36:00 CET 2008
525 root 1.389 - Coro::Debug::new_unix_server would not create a non-blocking listening
526 root 1.390 socket, sometimes causing freezes.
527 root 1.392 - (libcoro) fix misaligned stack points for setjmp and assembly
528     methods, which can cause crashes on x86/x86_64 with a sufficiently
529     aggressive compiler.
530 root 1.389 - new function: Coro::Debug::new_tcp_server.
531 root 1.388 - move ->throw into the Coro class because it only works on coro objects.
532    
533 root 1.387 4.803 Mon Nov 3 17:16:12 CET 2008
534 root 1.392 - (libcoro) use a global asm statement to become independent of gcc
535     otpimisations for CORO_ASM (thanks to pippijn for the idea).
536 root 1.387 - try to workaround yet another broken bsd, this time dragonfly.
537 root 1.386
538 root 1.385 4.802 Thu Oct 30 10:56:12 CET 2008
539     - support -fno-omit-frame-pointer on x86 with the assembly method.
540 root 1.383 - tune 01_unblock.t tests a bit.
541    
542 root 1.382 4.801 Wed Oct 22 18:33:37 CEST 2008
543 root 1.381 - improve readline speed for very long "lines".
544 root 1.382 - backport to 5.8.8.
545 root 1.381
546 root 1.380 4.8 Thu Oct 2 13:34:40 CEST 2008
547 root 1.378 - new function Coro::AIO::aio_wait.
548     - Coro.:AIO and Coro::BDB now "use Coro::AnyEvent".
549     - greatly speed up and reduce memory usage of Coro::AIO requests.
550 root 1.379 - implement some other µ-optimisations.
551 root 1.378
552 root 1.377 4.749 Mon Sep 29 14:40:12 CEST 2008
553     - port to slow and broken pseudo-threaded perls. (courtesy pippijn).
554    
555 root 1.376 4.748 Sat Sep 27 14:03:19 CEST 2008
556 root 1.374 - implement, but do not document, PerlIO::cede(granularity).
557 root 1.372 - Coro::Storable forgot to wrap Storable::pstore.
558 root 1.374 - work around the multitude of leaks and memory corruption
559 root 1.375 bugs in PerlIO::via by using our own C-level perliol. As a side
560     effect, Coro::Storable is now much, much, much faster.
561 root 1.372
562 root 1.371 4.747 Tue Sep 23 01:59:41 CEST 2008
563 root 1.369 - fix a per-cv memleak (one empty array was leaked per
564     code reference).
565 root 1.370 - avoid a crash in coro->call|rss when the coroutine was already
566     destroyed (most noticably when using Coro::Debug::ps :)
567     - also protect *Storable::FILE.
568 root 1.371 - push up default storable granularity to 20ms.
569 root 1.369
570 root 1.368 4.746 Sun Sep 21 03:22:20 CEST 2008
571     - be more insistent on locking Storable against reentrancy
572     in Coro::Storable.
573 root 1.366 - move swap_def?v and throw to Coro::State, as documented.
574    
575 root 1.365 4.745 Thu Jul 24 00:14:38 CEST 2008
576 root 1.364 - remove debugging code related to MgPV_nolen_const, also try to
577     make it compile with perl 5.8.6 (yes, apple apparently loves
578     outdated software). Reported by John S.
579 root 1.363
580 root 1.362 4.744 Tue Jul 8 22:06:35 CEST 2008
581 root 1.618 - correctly provide default DIE/WARN handlers as documented.
582 root 1.361 - also overwrite PL_vtbl_sigelem.svt_clear, even though current
583     implementations inside perl work fine for us.
584    
585 root 1.360 4.743 Mon Jun 16 00:21:57 CEST 2008
586     - when using Coro::EV without running EV::loop it could
587     result in busy-waiting for events, this has been fixed.
588     - reduce codesize and improve performance by using EV_DEFAULT_UC.
589    
590 root 1.359 4.742 Sat May 31 14:10:21 CEST 2008
591     - implement a workaround for (some) perl <5.8.8 versions.
592     - require EV 3.3+.
593    
594 root 1.358 4.741 Fri May 30 23:33:09 CEST 2008
595     - tell netbsd how utterly broken their imitation of an OS is
596     and refuse to build by default if pthreads are in use.
597     - switch to "s" method on all bsd's by default, as their ucontext
598     stuff seems just too broken.
599     - fix a bug in Coro::Select.
600    
601 root 1.357 4.74 Thu May 29 20:05:31 CEST 2008
602     - do not test Coro::LWP for lack of dependencies.
603     - do not test Coro::Select for lack of working perls.
604    
605     4.73 Thu May 29 2008
606 root 1.356 - fix a bug in Coro::EV which would cause it to block despite
607     there being runnable coroutines.
608 root 1.354 - sprinkle "no warnings" freely over everything, also suppress
609     warnings for some other modules.
610 root 1.355 - fix typo in WSAEWOULDBLOCK.
611 root 1.354
612 root 1.353 4.72 Sun May 25 05:14:36 CEST 2008
613 root 1.618 - tweak META.yaml a bit, unfortunately, there is no documented way
614 root 1.351 to have optional dependencies with CPAN. doh :(
615 root 1.350 - avoid running some tests on windows because they would fail due to
616 root 1.351 perl bug (broken fork, broken pipes...).
617     - work around perl on windows bugs where perl returns undocumented
618     error codes for sysread, syswrite etc. by taking advantage
619     of AnyEvent's workaround for that problem.
620 root 1.350 - use AnyEvent::Util::fh_nonblocking in Coro::Handle to work around
621     a common perl implementation bug on windows.
622     - use unix domain sockets in testsuite to work around
623 root 1.351 common perl implementation bugs on widows (they are emulated by
624     tcp sockets on windows. ugh.)
625 root 1.350
626 root 1.349 4.71 Sat May 24 20:01:27 CEST 2008
627 root 1.618 - fix a bug in Coro::AnyEvent ("Usage: Coro::AnyEvent::_schedule()").
628 root 1.347 - take advantage of async name resolution of AnyEvent::Util.
629     - work around brutal inet_aton override in Coro::LWP.
630 root 1.348 - take advantage of the readyhook in Coro::EV, for smoother
631     scheduling.
632 root 1.347
633 root 1.346 4.7 Sun May 11 00:32:19 CEST 2008
634 root 1.342 - completely reworked the Coro manpage.
635 root 1.618 - added Coro::AnyEvent, generic event loop integration.
636 root 1.341 - implement cancel, ready and kill commands in Coro::Debug.
637     - document find_coro in Coro::Debug.
638 root 1.343 - incompatible change: rename has_stack to has_cctx.
639 root 1.346 - Coro::AIO and Coro::BDB no longer force event model detection,
640     use AnyEvent::AIO and AnyEvent::BDB.
641 root 1.341
642 root 1.340 4.6 Sat Apr 26 10:05:14 CEST 2008
643 root 1.336 - INCOMPATIBLE CHANGE: sub/code attributes are no longer supported
644 root 1.339 by the Coro module. It was a mistake to have it in the first place.
645     - (experimental) support for activestate perl 5.10 (method "w").
646     - (experimental) support for strawberry perl (method "a").
647 root 1.337 - coro_sigelem_set did not return a value although it had to,
648     actual impact unknown.
649 root 1.336
650 root 1.335 4.51 Mon Apr 14 13:28:27 CEST 2008
651     - make it compile again on 5.8.
652    
653 root 1.334 4.50 Thu Apr 10 09:43:17 CEST 2008
654     - I did it twice! (see 4.49).
655    
656 root 1.333 4.49 Sun Apr 6 21:23:31 CEST 2008
657     - grr, instead of compiling the recent changes on 5.10 only they
658     were compiled on 5.8 only.
659    
660 root 1.332 4.48 Sun Apr 6 20:36:46 CEST 2008
661 root 1.331 - allow coroutine switches during eval's under 5.10.x, as it seems
662     the parser is a per-interpreter option now, so this is safe
663     (this might fix the odd crashing bug).
664 root 1.332 - drop support for 5.9.x versions: they are dead, jim.
665 root 1.331
666 root 1.330 4.47 Sun Apr 6 00:37:52 CEST 2008
667 root 1.329 - force cctx allocation on API calls: we know we need to force one
668     and gcc actually manages to confuse our heuristic nowadays,
669     leading to crashes and worse.
670 root 1.330 - document force_cctx.
671 root 1.329
672 root 1.328 4.46 Fri Apr 4 22:05:43 CEST 2008
673     - upgrade libcoro, resulting in pthread-backend (which was only created
674     to fulfill the rules of the programming languages shootout).
675    
676 root 1.327 4.45 Thu Mar 13 11:55:36 CET 2008
677 root 1.322 - fix a file leaking bug in eg/mhyttpd that would allow
678     downloading of any file (reported by oesi).
679 root 1.325 - fix deadlock bug in Coro::Channel (reported by Richard Hundt)
680     (also add testcase).
681 root 1.323 - support Broadcast option in Coro::Socket (patch by Richard Hundt,
682     apparently having loads of fun with that).
683 root 1.324 - implement $state->swap_defsv, ->swap_defav and document ->throw.
684 root 1.322
685 root 1.321 4.4 Wed Feb 13 16:44:29 CET 2008
686 root 1.319 - only assume .cfi pseudo isns exist on GNU/Linux.
687 root 1.320 - add get_timed method to Coro::Channels.
688 root 1.321 - fixed Coro::Debug manpage.
689     - perl 5.11 compatbility improvement based on patch by
690     Andreas König.
691 root 1.319
692 root 1.318 4.37 Sun Jan 20 11:25:23 CET 2008
693 root 1.317 - soften the check for an active parser for perl 5.10 (avoiding
694     "Coro::State::transfer called while parsing" in many cases).
695 root 1.316
696 root 1.315 4.36 Sun Jan 13 10:53:56 CET 2008
697 root 1.314 - reset diehook when terminating from an async_pool as to not
698     trigger any __DIE__ handlers.
699    
700 root 1.313 4.35 Sun Jan 13 04:14:13 CET 2008
701 root 1.308 - "bt" debug command now displays any exceptions
702 root 1.311 from longmess and also skips the innermost
703     stackframes, giving more useufl output.
704 root 1.309 - allow backtraces in coroutines blocked in Coro::EV,
705 root 1.310 at a <1% speed hit.
706 root 1.312 - handle localising of $SIG{__WARN__} and __DIE__
707 root 1.314 properly (with a proper amount of dirty hacking).
708 root 1.308
709 root 1.307 4.34 Sat Dec 22 17:49:53 CET 2007
710 root 1.306 - upgrade to EV version 2.0 API.
711    
712 root 1.305 4.33 Mon Dec 17 08:36:12 CET 2007
713     - make Coro::AIO etc. loadable in the absence of EV.
714    
715 root 1.304 4.32 Mon Dec 17 07:46:02 CET 2007
716 root 1.301 - majorly improved Coro::Handle's performance with Coro::EV.
717 root 1.302 - implemented the until now mythical Coro::BDB module.
718 root 1.304 - specialcase EV in Coro::AIO and Coro::BDB for extra speed.
719 root 1.301
720 root 1.300 4.31 Wed Dec 5 12:32:39 CET 2007
721     - remove warn statement form Coro::Util.
722    
723 root 1.299 4.3 Tue Dec 4 20:33:14 CET 2007
724     - calls to the idle function could cause stack corruption
725     when the stack changed.
726 root 1.295 - do no longer rely on the presence of EV::DNS if EV is used
727     (because it is gone), but instead take avdantage of EV::ADNS
728     if available.
729 root 1.296 - add ($) prototypes to all functions in Coro::Storable.
730 root 1.297 - use a conventional (safer) idle callback in Coro::EV.
731 root 1.298 - do accept quickly in Coro::Debug to avoid endless loops.
732 root 1.295
733 root 1.294 4.22 Fri Nov 30 16:04:04 CET 2007
734 root 1.293 - really use optimised versions for Event and EV in Coro::Util
735     and Coro::Handle.
736    
737 root 1.292 4.21 Sun Nov 25 10:48:59 CET 2007
738 root 1.290 - fix a spurious memory read.
739 root 1.291 - Coro::EV no longer keeps the eventloop "alive".
740 root 1.290
741 root 1.289 4.2 Fri Nov 9 20:47:05 CET 2007
742 root 1.282 - enable/disable tracing from a new coroutine, not a pooled one.
743 root 1.283 - fix a memleak in Coro::Event.
744 root 1.284 - removed killall call from fork_eval.
745     - made sure store_fd is already loaded so that fork_eval
746     does not have to parse autoload in each subprocess.
747 root 1.288 - only use assembly method if -O switch is in $Config{optimize}.
748 root 1.289 - add (optional) Coro::EV module, so far the best event loop module
749     directly supported by Coro.
750     - if the event model is EV, use EV::DNS to resolve
751     stuff in Coro::Util.
752 root 1.286 - don't get confused by multiple event notifications in Coro::Handle.
753 root 1.287 - initial support for EV (libevent interface).
754 root 1.289 - require Event and EV using configure_requires, to force their existance.
755 root 1.282
756 root 1.281 4.13 Wed Oct 24 07:26:45 CEST 2007
757 root 1.277 - add Coro::Storable::blocking_thaw.
758 root 1.278 - use a vastly more complicated technique to localise
759     $SIG{__WARN/DIE__} that also works on perls <= 5.8.8.
760 root 1.279 - use a coroutine for the idle callback Coro::Event,
761     instead of running Event in the current coroutine context.
762     This also catches recursive invocations.
763 root 1.280 - actually report fork errors in gethostbyname and inet_aton.
764 root 1.277
765 root 1.276 4.11 Thu Oct 11 02:40:24 CEST 2007
766     - port to threaded perls.
767    
768 root 1.275 4.1 Thu Oct 11 02:38:16 CEST 2007
769 root 1.618 - incompatible change: $SIG{__DIE__} and $SIG{__WARN__} will now
770 root 1.264 be local to each coro (see Coro::State).
771 root 1.274 - incompatible change: for very deep reasons, cede and cede_notself
772     cannot return anything, so nothing will be returned.
773 root 1.264 - possibly bring back 5.10 compatibility (untested).
774     - work around stupid (and wrong) warning on 5.10 :(.
775     - overlay the saved state over the context stack. This saves
776     a few hundred bytes per coroutine on average and also
777     speeds up context switching a bit.
778 root 1.265 - further tune default stack sizes.
779 root 1.264 - (more) correctly calculate stack usage in coro_rss.
780 root 1.267 - Coro::Storable::blocking_* did not properly lock
781     resulting in races between coroutines.
782     - added Coro::Storable::guard.
783 root 1.268 - stopping to trace a coroutine could destroy the cctx of
784     an unrelated coroutine.
785 root 1.269 - explain the relationship between Perl and C coroutines in
786     more detail in Coro::State.
787 root 1.270 - Coro::Util::inet_aton did not short-circuit dotted quad forms,
788     causing a fork per resolve. This also affected Coro::Socket.
789 root 1.272 - switch to a separate stack in $coro->call/eval to avoid
790     invalidating pointers.
791 root 1.264
792 root 1.263 4.03 Sat Oct 6 21:24:00 CEST 2007
793 root 1.262 - added Coro::throw method.
794     - minor code cleanups.
795    
796 root 1.261 4.02 Sat Oct 6 02:36:47 CEST 2007
797 root 1.258 - fix a very minor per-coroutine memleak (a single codereference).
798 root 1.259 - fixed a bug where the currently in-use c context would be freed
799     prematurely (can happen only when programs change the stacksize
800     or use tracing).
801     - tracing can no longer keep a coro alive after it terminated.
802 root 1.260 - do static branch prediction in the common path for gcc. gives
803     about 2-5% speed improvement here.
804 root 1.258
805 root 1.256 4.01 Fri Oct 5 22:10:49 CEST 2007
806 root 1.257 - instead of recreating *a* standard output handle we simply
807     use STDOUT, which is faster and hopefully more robust.
808 root 1.255
809 root 1.254 4.0 Fri Oct 5 12:56:00 CEST 2007
810 root 1.238 - incompatibly changed Coro::Storable::freeze.
811 root 1.244 - major new feature: added Coro::Debug, for interactive coroutine
812     debugging, tracing and much more.
813 root 1.252 - major bug fix: unbelievable, but true: $_, $/ and many other
814     "saved" variables actually weren't being saved. This has been fixed,
815     of course, while increasing performance while losing all the save
816     flags.
817 root 1.251 - save flags are gone, and all the api functions dealing with them.
818 root 1.232 - added Coro::Semaphore::adjust.
819 root 1.233 - added Coro::Util::fork_eval.
820     - added Coro::Storable::{nfreeze,blocking_{freeze,nfreeze}}.
821 root 1.248 - added Coro::killall.
822 root 1.236 - reduce initial stack sizes to allow for "micro-coroutines".
823 root 1.239 - better async_pool resource management, moved parts of async_pool
824 root 1.240 handling to XS (major speed improvement).
825 root 1.245 - actually croak before modifying important data structures.
826     - refuse to transfer while compiling.
827     - possibly support eval EXPR better now.
828 root 1.249 - enable assembly per default on linux+bsd x86+amd64.
829 root 1.253 - all internal members were renamed _something for easier subclassing.
830 root 1.237 - many minor tweaks.
831 root 1.232
832 root 1.231 3.63 Wed May 16 14:10:06 CEST 2007
833 root 1.230 - implement handcoded assembly for x86/amd64 SVR ABI.
834    
835 root 1.229 3.62 Fri Apr 27 21:36:06 CEST 2007
836     - upgrade libcoro (which might set unwind info correctly).
837 root 1.228 - change default on linux to setjmp/longjmp.
838 root 1.227
839 root 1.226 3.61 Thu Apr 19 12:36:18 CEST 2007
840 root 1.225 - Coro::Storable caused an endless loop when thawing invalid
841     pst's sometimes.
842 root 1.223 - use a Semaphore in Coro::Storable, as Storable doesn't
843 root 1.224 seem to be reentrant (although it is documented to
844     be threadsafe...).
845     - fix Coro::Signal to bring back the original unreliable
846     but stateful semantics.
847 root 1.226 - fixed a lot of typos in Coro.pm (patch submitted by David
848     Steinbrunner, which applied flawlessly).
849 root 1.223
850     3.6 Sat Apr 14 17:13:31 CEST 2007
851 root 1.618 - added some bugfixes to get eg/myhttpd working again.
852 root 1.218 - added Coro::Storable for often-cede'ing freeze/thaw.
853 root 1.219 - try to do a clean exit when a coroutine calls exit
854     (EXPERIMENTAL).
855 root 1.220 - got rid of indirect call through _coro_init.
856     - updated the partly antique examples in eg/ to
857     work again and be a bit less magic, too.
858     - fixed Coro::Signal semantics to work as documented again.
859 root 1.217
860 root 1.216 3.55 Sun Mar 25 01:20:47 CET 2007
861 root 1.215 - add SAVE_DEFFH to save the default filehandle and enable
862     it by default.
863     - finally move socket-operations from Coro::Socket to Coro::Handle
864     to be able to unblock foreign sockets.
865     - add Coro::State::save_also and guarded_save.
866 root 1.211 - add count accessor to Coro::Semaphore.
867 root 1.212 - add Coro::State::cctx_stacksize.
868 root 1.213 - just for the fun of it, do not rely on implicit context,
869     which can dramatically improve performance, but people
870     using windows-process-emulation perls do not care much about
871     performance.
872 root 1.211
873 root 1.210 3.51 Sun Mar 4 14:18:04 CET 2007
874 root 1.209 - fixed a problem when you weakened references to Coro::State's
875     (patch by Yuval Kogman).
876    
877 root 1.208 3.501 Wed Feb 28 12:44:07 CET 2007
878     - rename some global symbols as macosx from hell redefines
879     them without asking.
880    
881 root 1.207 3.5 Tue Feb 13 20:22:53 CET 2007
882 root 1.204 - do AnyEvent model detection earlier, avoiding problems
883     caused by first using AnyEvent and later Coro::Event.
884 root 1.205 - implement and document Coro::Event event objects.
885     - fix a potential problem in Coro::Event causing crashes.
886 root 1.206 - initialise PL_comppad when creating a new coroutine,
887     avoids crashes on early coro destruction.
888 root 1.204
889 root 1.203 3.41 Mon Jan 22 19:19:49 CET 2007
890 root 1.202 - readline on Coro::Handle did not support undefined $/,
891     nor did it deliver partial lines on EOF or error.
892 root 1.203 - implement malloc fallback for stack allocation because
893     stupid broken idiotic OSX has a stupid broken
894     idiotic fits-the-whole-os mmap "implementation" and
895     my dick feels longer if Coro is portable even to
896     obsolete platforms.
897 root 1.202
898 root 1.201 3.4 Fri Jan 19 21:52:54 CET 2007
899 root 1.197 - remove t/09_timer.t, as it isn't really testing much
900     but was rather flaky in practise.
901 root 1.198 - async_pool coro would keep arguments and callback alive until
902     it was reused.
903 root 1.199 - cancellation of a coroutine could cause spurious idle calls
904     in cede_notself.
905 root 1.197
906 root 1.196 3.3 Sat Jan 6 03:45:00 CET 2007
907 root 1.187 - implement $coro->on_destroy.
908 root 1.188 - Coro::Event blocking semantics have been changed,
909     documented and - hopefully - improved.
910 root 1.184 - fix nice adding, not subtracting, from priority.
911 root 1.185 - fix ->prio and api_is_ready (patch by Mark Hinds).
912 root 1.190 - fixed an assert ("... == prev__cctx->idle_te")
913     that could errronously trigger.
914 root 1.192 - fix various large and small memleaks.
915 root 1.191 - use a (hopefully) more stable cancel implementation
916     that immediately frees the coroutine data.
917 root 1.194 - cede/cede_notself return a status now.
918 root 1.191 - added Coro::guard function.
919 root 1.193 - added a global coroutine pool for jobs (on my machine,
920     I can create and execute 48k simple coros/s with async,
921     and 128k coros with async_pool).
922 root 1.195 - Coro::AIO now uses the coroutine priority as io priority.
923 root 1.184
924 root 1.183 3.2 Fri Dec 22 05:07:09 CET 2006
925 root 1.179 - improve portability to slightly older perls.
926 root 1.180 - use cleaner coroutine destruction.
927 root 1.182 - simplify configuration for users.
928     - optionally (unrecommended) prefer perl functions over
929     their coro replacements.
930 root 1.179
931 root 1.178 3.11 Tue Dec 5 13:11:24 CET 2006
932     - fixed some bogus assert's, but as perl.h disables assert even
933     without NDEBUG (thank you very much), not too many people should
934     notice (that did include myself). Andreas König noticed, though :)
935     - do not save/restore PL_sortcxix on >= 5.9.x, it doesn't seem to have
936     it. Also noticed by Andreas König :)
937     - save/restore tainted status.
938     - verified to pass the testsuite on my 5.9.5.
939    
940 root 1.177 3.1 Mon Dec 4 23:03:40 CET 2006
941     - INCOMPATIBLE CHANGE: $/ is now per-coroutine (but slow).
942 root 1.175 - incompatible change: transfer flags are now per-state.
943 root 1.173 - give a better error message on deadlock.
944 root 1.175 - document Coro::nready.
945 root 1.174 - enhanced testsuite.
946 root 1.169
947 root 1.172 3.01 Sun Dec 3 23:47:42 CET 2006
948     - forgot to include Coro::Timer.
949    
950 root 1.171 3.0 Sun Dec 3 22:57:25 CET 2006
951 root 1.163 - the "FINALLY COMPLETELY STABLE" release (coming soon:
952     the "FAMOUS LAST WORDS" release).
953 root 1.166 - implement a new stack sharing algorithm, which uses a stack
954     pool (size currently hardcoded).
955 root 1.155 - make stack sharing mandatory (it no longer uses a heuristic).
956 root 1.157 - eval/die no longer cause weird problems under heavy use.
957 root 1.152 - Coro::Event could cause livelocks if it was used but
958 root 1.161 no Coro::Event watchers were used.
959 root 1.167 - Coro::Event now uses asynccheck as prepare does not
960     check for changed watchers.
961 root 1.170 - Coro::Event allows multiple waiting coros and will wake up one
962     per event.
963 root 1.152 - Coro::Event should be cleaner and more efficient now.
964 root 1.165 - new utility function Coro::unblock_sub.
965 root 1.164 - document the sad fact that Event is no longer reentrant.
966 root 1.163 - putting a coroutine into the ready queue twice could under
967     some circumstances lead to stack corruption.
968 root 1.161 - minor incompatibility: subclassing Coro::State is supported
969     directly now without going through a _coro_state member.
970 root 1.156 - state/coro switching is much faster now.
971 root 1.154 - very minor optimisations and code/documentation cleanup.
972 root 1.153 - avoid problems due to compiler inlining.
973 root 1.154 - removed timers from Coro::Timer -> use AnyEvent instead.
974     - replaced Coro::idle coroutine by (cleaner) idle handler.
975 root 1.156 - updated to newest libcoro.
976 root 1.159 - implement enhanced support for valgrind.
977 root 1.162 - implement is_ready and return value for ready.
978 root 1.168 - removed Coro::Cont, it was a misnomer (it's generators),
979     and it was somewhat annoying to get it right. Will come back
980     if somebody asks for it :)
981 root 1.163 - many ->wait methods and Coro::Event could return
982     spuriously without the event having happened.
983 root 1.146
984 root 1.145 2.5 Tue Nov 7 12:22:33 CET 2006
985 root 1.143 - made Coro::Util, Coro::Select, Coro::Handle and Coro::Socket
986     use AnyEvent, moved them to Coro/.
987 root 1.140 - added Coro::LWP which contains all the uglyness required to
988     make LWP non-blocking.
989     - should work with perl 5.9.x now (Andreas König made me do it).
990 root 1.141 - fixed another bug in Coro::Select when the timeout was undef.
991 root 1.136 - reuse PL_start_env for all coros, saves some memory per coroutine.
992     - manage PL_top_env differently, hopefully to avoid panic: top_env.
993 root 1.137 - timeout argument was not properly used in Coro::Socket.
994     - allow limited forms of subclassing in Coro::Handle/Coro::Socket.
995 root 1.138 - emulate undocumented(!) functionality of IO::Socket required
996     by LWP(!!).
997     - updated eg/lwp to work with newer lwp's.
998 root 1.140 - remove "FATAL: uncaught exception" prefix. Coroutines that die
999     kill the whole process, just as exceptions in the main "coroutine"
1000     did already.
1001 root 1.135
1002 root 1.134 2.1 Wed Nov 1 23:01:13 CET 2006
1003     - fix a long-standing bug in Coro::Select where select with
1004     zero timeout would instead change the current default filehandle.
1005 root 1.132 - use a simpler and hopefully more robust way to clone padlists
1006     (uses less memory and a perl function instead of our own).
1007     - coro can now create a stack guard area on many architectures.
1008 root 1.134 - Coro::AIO properly reexports additional functions from IO::AIO.
1009 root 1.132 - updated libcoro with a workaround for OS X,
1010 root 1.134 pach and testing by Michael Schwern.
1011 root 1.130
1012 root 1.129 2.0 Tue Oct 24 05:47:17 CEST 2006
1013 root 1.128 - support additional aio requests in Coro::AIO.
1014    
1015 root 1.129 1.9 (never properly released due to a glitch)
1016    
1017 root 1.127 1.8 Thu Feb 2 00:59:06 CET 2006
1018 root 1.125 - applied suggested patch by SAMV to avoid problems during stupid
1019     mark & sweep gc run.
1020 root 1.126 - applied patch by Scott Walters for 5.9.3 compatibility.
1021 root 1.125
1022 root 1.124 1.7 Tue Dec 27 01:41:58 CET 2005
1023 root 1.123 - added Coro::AIO, a thin wrapper around IO::AIO.
1024 root 1.122 - improved Makefile.PL explanations.
1025    
1026 root 1.119 1.6 Mon Dec 12 21:30:05 CET 2005
1027 root 1.117 - additionally save PM_curpm might fix as-of-yet
1028 root 1.121 unseen problems with regex matches being attributed to the
1029 root 1.117 wrong package.
1030 root 1.118 - add t/10_bugs.t, which currently checks against imho broken
1031     perls that use 0.26MB of stack space per Perl_magic_get
1032 root 1.121 invocation (newer linuxes) as opposed to the 0.0002MB perl
1033     normally uses.
1034 root 1.120 - make stacksize configurable for the ultimate debian experience.
1035 root 1.117
1036 root 1.116 1.51 Mon Dec 12 18:48:36 CET 2005
1037     - remove debugging warn() accidentally left in Coro::Select.
1038    
1039 root 1.115 1.5 Tue Nov 29 13:32:44 CET 2005
1040 root 1.114 - use Coro::Event inside Coro::Select to avoid spurious deadlocks.
1041 root 1.115 - fix Coro::Select 'select'.
1042     - strict'ify some modules.
1043 root 1.112 - libcoro errornously restored the SIGUSR2 handler to SIGUSR1.
1044 root 1.115 - use XSLoader in selected modules.
1045     - remove some 5.6 compatibility cruft.
1046 root 1.112
1047 root 1.111 1.4 Tue Sep 6 00:11:05 CEST 2005
1048     - libcoro did not take into account the trampoline on amd64,
1049     when 'l'inux method was used.
1050    
1051 root 1.110 1.31 Tue Aug 30 23:31:33 CEST 2005
1052     - some portability fixes/workarounds.
1053    
1054 root 1.107 1.3 Sat Aug 20 03:08:56 CEST 2005
1055 root 1.108 - no code changes. module seems to work fine.
1056 root 1.106 - improve Coro::State docs, remove reference to nonexisting
1057     Coro::State::flush method.
1058 root 1.107 - no longer autodetect windows, present it as an option instead.
1059 root 1.106
1060 root 1.105 1.2 Mon May 16 02:00:55 CEST 2005
1061 root 1.100 - included libcoro.c earlier in State.xs, might improve portability.
1062 root 1.101 - use a faster and possibly more stable Coro::Cont implementation.
1063 root 1.102 - accept x86_64 in addition to amd64 for optimized linux-amd64 support.
1064 root 1.104 - fix bugs Coro::SemaphoreSet that could cause locks never to be freed.
1065 root 1.105 - fix bugs in CoroAPI.h and document it in Coro::MakeMaker.
1066 root 1.100
1067 root 1.99 1.11 Thu Mar 3 18:00:52 CET 2005
1068     - change of contact address.
1069    
1070 root 1.98 1.1 Tue Feb 22 20:51:16 CET 2005
1071 root 1.97 - support [l]inux method on amd64.
1072 root 1.109 - allow some context switches while compiling/eval'ing.
1073 root 1.97
1074 root 1.96 1.0 Tue Aug 10 03:47:27 CEST 2004
1075 root 1.95 - Event 0.89 fixes the bug again.
1076 root 1.96 - fix the remaining(??) memleak. I didn't free the cache-AV for
1077     padlists, so one AV per created anon-sub leaked.
1078 root 1.95
1079 pcg 1.94 0.97 Fri May 14 15:23:32 CEST 2004
1080     - remove stupid gcc extension that was an experiment only anyway.
1081    
1082 pcg 1.93 0.96 Thu May 13 18:09:29 CEST 2004
1083 root 1.103 - tell people if they have yet another broken Event variant.
1084 pcg 1.91 - made Coro to work _better_ with threads (it seems that, as long
1085     as you use Coros in one thread only everything will work fine.
1086     Looking at the perl source the problem might be missing locking
1087     between Coro and some perl internal routines. That's not easily
1088     fixable).
1089 pcg 1.92 - (hopefully) got rid of the static xnext inside transfer.
1090 pcg 1.91
1091 pcg 1.90 0.95 Sun Feb 15 03:20:28 CET 2004
1092 pcg 1.86 - removed Coro::State::flush, implemented a new and much
1093     faster caching mechanism by attaching magic to the CV.
1094 pcg 1.87 - a memleak with (real) closures remains.
1095 pcg 1.88 - dramatically reduced size of stacks to 65536 (linux/x86), after
1096     observing that even myhttpd never had more than a kilobyte
1097     of stack in use (stack is still only physically allocated in
1098     pagesize increments for systems suporting mmap).
1099 pcg 1.89 - fix for a "cygwin-64" architecture added, proposed by Stefan Traby.
1100 pcg 1.90 - fix for threaded perl.
1101 pcg 1.86
1102 pcg 1.85 0.9 Sun Nov 23 04:32:39 CET 2003
1103 pcg 1.84 - fix a few very hard to track down but (of course) stupid
1104     memory leaks.
1105     - stringify version number to avoid locale problems :(.
1106 pcg 1.85 - perl 5.9.0 does not have SvPADBUSY, reported by Scott Walters,
1107     hopefully ignoring it "just works".
1108 pcg 1.84
1109 pcg 1.83 0.8 Wed Nov 5 19:38:40 CET 2003
1110     - port to perl5.005_03, but only 5.8.x+ is supported!
1111 pcg 1.82 - honor LocalAddr even without LocalPort in Coro::Socket.
1112    
1113 root 1.81 0.7 Tue May 27 03:12:38 CEST 2003
1114     - the version jump indicates some level of testing, not gobs
1115     of new features.
1116 root 1.80 - uh... I found the prompt function in ExtUtils::MakeMaker.
1117     Highly correct stuff, that is...
1118 root 1.81 - fixed(?) a bug with die's in coroutines causing "panic: top_env".
1119     the fix is not well understood by the author, so beware :(.
1120 root 1.80
1121 root 1.79 0.652 Thu May 8 02:54:46 CEST 2003
1122 root 1.76 - Applied patch by Slaven Rezic to set default to "s" on FreeBSD,
1123 root 1.78 cause version 4 doesn't have ucontext.
1124 root 1.77 - Benjamin Reed reported that setjmp works fine on darwin,
1125     so preselect it.
1126 root 1.76
1127 root 1.75 0.651 Sat Mar 29 15:00:23 CET 2003
1128     - fix a bug in Coro::Handle where some bytes could get lost
1129     on reading, reported by jason@nichego.net.
1130 root 1.74
1131 root 1.73 0.65 Sun Mar 23 00:08:26 CET 2003
1132 root 1.72 - added a README.linux-glibc.
1133     - new module Coro::Select.
1134     - also save/restore PL_comppad, fixes segfaults with 5.8.1.
1135     (I never claimed that I know what I am doing ;).
1136 root 1.73 - set default to setjmp/longjmp on non-x86-linux.
1137 root 1.72
1138 root 1.71 0.6 Thu Nov 21 11:09:06 CET 2002
1139     - made lazy context switching the default.
1140     - fixed the bug where SemaphoreSet::guard
1141     was the same as timed_guard and timed_guard was missing.
1142     - fix a memleak in Coro::Timer.
1143     - reclassified context sharing as not experimental.
1144    
1145 root 1.70 0.534 Sun Apr 14 03:05:12 CEST 2002
1146 root 1.69 - fixed backspace => tab in header parsing (myhttpd).
1147 root 1.70 - added eg/readline, for elmex.
1148     - Coro::Event now calls ->start on first call instead of
1149     ->again, which created wrong timeouts for the first ->next.
1150     - fixed a bug where Coro::Socket returned a closed socket instead
1151     of nothing on ECONNREFUSED and similar error conditions.
1152 root 1.69
1153 root 1.68 0.533 Mon Feb 18 18:49:40 CET 2002
1154     - adapt to finally working Event-0.85.
1155     - fixed buggy event initialization (trapped under windows, but how
1156     could it possibly have worked anywhere?)
1157    
1158 root 1.67 0.532 Wed Jan 16 02:45:32 CET 2002
1159 root 1.66 - removed the reference to pp_entersub, might work on
1160     (some) win32 perls now (testsuite works under cygwin,
1161     without Event, which freezes).
1162 root 1.65
1163 root 1.64 0.531 Mon Dec 10 22:18:44 CET 2001
1164 root 1.63 - Fixed a bug in SemaphoreSet::timed_down.
1165    
1166 root 1.64 0.53 Tue Nov 27 21:11:13 CET 2001
1167 root 1.60 - some tests for Event.
1168 root 1.61 - slightly different internal architecture to get refcnt into the object
1169     and not the reference. might fix a few bugs, certainly did introduce
1170     new ones.
1171     - Coro::Timer (independent of Event).
1172 root 1.62 - new timed_wait functions for Coro::Signal, Semaphore, SemaphoreSet.
1173 root 1.60
1174 root 1.64 0.52 Tue Nov 6 21:36:18 CET 2001
1175 root 1.58 - ported to cygwin (trivial).
1176     patch by Gerrit P. Haase <gp@familiehaase.de>.
1177     - small setjmp code fix by Sullivan.DanielJ@epamail.epa.gov.
1178    
1179 root 1.64 0.51 Thu Nov 1 20:39:01 CET 2001
1180 root 1.54 - terminate/cancel now work properly (otherwise termination
1181     could cause a "next coroutine is not and contains not..."
1182     error.
1183 root 1.55 - added Coro::Socket::shutdown.
1184 root 1.56 - Coro::Event::loop no is the same as Event::loop.
1185     - implemented terminate with args + join.
1186 root 1.54
1187 root 1.64 0.5 Fri Sep 28 16:15:35 CEST 2001
1188 root 1.53 - fixed "print" on a Coro::Handle. The print method worked.
1189 root 1.50 - small tweaks (seem to reduce memory consumption a lot)
1190     in various modules.
1191     - splendid use of "no warnings" scattered throughout.
1192 root 1.52 - added Coro::Handle::rbuf, fixed Coro::Handle::fh.
1193 root 1.48
1194 root 1.47 0.49 Sun Sep 16 02:42:45 CEST 2001
1195 root 1.43 - changed some method calls to function calls for speed
1196     inside Coro::Handle.
1197 root 1.44 - make Coro::Handle use an array instead of a hash for
1198     speed reasons.
1199     - IRIX mystery solved: it's SGI's NT, after all: "standard, huh?".
1200     sjlj and ucontext should now work.
1201     - IRIX-specific port for libcoro.
1202 root 1.45 - swapped order of accept results to match IO::Socket.
1203 root 1.46 - changed getsock/peername to sock/peername to match IO::Socket.
1204     - fixed a bug that caused segfault when returning to main task
1205     under some circumstances.
1206     - other bugfixes.
1207 root 1.43
1208 root 1.42 0.45 Sun Sep 2 02:54:01 CEST 2001
1209 root 1.36 - new method Coro::Handle::timeout.
1210     - corrected speling of set...name to get...name in Coro::Socket.
1211     - Coro::Socket::accept now returns a Coro::Socket, not a Coro::Handle.
1212     - Coro::Handle now supports fileno and FILENO.
1213     - added eg/myhttpd, a web server.
1214 root 1.37 - Coro::Socket now accepts numeric ports as well as "port(number)"
1215     syntax.
1216 root 1.38 - moved some scheduling primitives into xs code. more to come.
1217 root 1.39 - new simple priority system.
1218 root 1.40 - implemented Coro::Event using XS, almost four times faster!
1219 root 1.41 - small memory corruption problem fixed (boy that was difficult).
1220 root 1.36
1221 root 1.35 0.13 Wed Aug 8 16:53:07 CEST 2001
1222 root 1.31 - new method Coro::Handle::readline.
1223 root 1.34 - added eg/lwp and Coro::Handle::autoflush, to make LWP work.
1224     (see eg/lwp on how to make LWP non-blocking).
1225 root 1.31 - renamed Coro::Socket::new_inet to new.
1226 root 1.32 - added Coro::Util, some utility functions.
1227 root 1.33 - die/eval now works better (still get annoying (but true ;)
1228     "Callback called exit" messages).
1229 root 1.34 - Coro::Handle now supports timeout, and Coro::Socket Timeout.
1230     - much better Coro::Socket support.
1231 root 1.31
1232     0.12 Fri Jul 27 04:19:01 CEST 2001
1233 root 1.29 - do not use mmap if neither MAP_ANON nor MAP_ANONYMOUS is defined.
1234 root 1.34 - very experimental stack sharing algorithm. not 100% safe but
1235 root 1.28 should work well in practise ;)
1236 root 1.30 - added Coro::RWLock.
1237 root 1.31 - Coro::Specific now works.
1238 root 1.28
1239     0.11 Tue Jul 24 22:49:21 CEST 2001
1240 root 1.27 - added specialized hack for newer and older linux versions (fast).
1241     - renamed Coro::Event::IO to Coro::Handle.
1242     - new module Coro::Socket.
1243    
1244 root 1.26 0.1 Tue Jul 24 01:47:53 CEST 2001
1245 root 1.23 - release candidate 3. A rather new internal structure :(
1246 root 1.24 - the great renaming: Damian Conway gave me a suitable replacement
1247     for yield.
1248 root 1.23 - added Coro/libcoro, a portable coroutine implementation for C
1249 root 1.22 (not even perl-dependent!!!), which can be used by Coro::State.
1250 root 1.20 - renamed SAVE_DEFSV (on xs-level only) to avoid symbol clash in
1251     perl-5.6.
1252 root 1.16 - new function Coro::Event::idle.
1253     - the idle process is now overriden
1254     by default in Coro::Event.
1255 root 1.17 - Coro::Channel now enforces the size.
1256 root 1.18 - canceling events now works in all cases.
1257 root 1.19 - Coro state now include $_ and $@.
1258     - yet another bug workaround that I do not really understand :(
1259 root 1.21 - new module Coro::Event::IO (very undocumented) to do
1260     non-blocking i/o.
1261 root 1.25 - performance tuning.
1262 root 1.16
1263 root 1.15 0.08 Thu Jul 19 06:13:25 CEST 2001
1264 root 1.14 - release candidate 2 (new functionality).
1265 root 1.13 - add Coro::State::flush function.
1266     - transfer now supports a flags value (mostly for speed ATM).
1267     - might compile and work in the presence of threads now.
1268 root 1.14 - continuations have a saner syntax.
1269 root 1.19 - no more memleaks.
1270 root 1.13
1271 root 1.12 0.07 Tue Jul 17 17:40:18 CEST 2001
1272     - release candidate 1 ;)
1273     - slightly nicer code.
1274     - fixed a scheduling bug in Coro::Event.
1275    
1276 root 1.11 0.06 Tue Jul 17 04:23:24 CEST 2001
1277     - ok, I found the showstopper - the same sub must not be
1278 root 1.9 re-entered in two different coroutines, otherwise => crash. I
1279     see no easy solution to this problem, except by walking the call
1280     chaing and saving/restoring the cv's, which is what I do now.
1281 root 1.11 - memory leaks still latent, especially at thread termination.
1282     - Coro::Event now works (haha).
1283 root 1.9
1284 root 1.8 0.05 Sun Jul 15 17:32:20 CEST 2001
1285     - fixed a few issues in Coro::Event.
1286     - I forgot to include Coro::Event in 0.04 :(:(:(
1287    
1288 root 1.7 0.04 Sun Jul 15 05:24:59 CEST 2001
1289 root 1.5 - @_ is now properly localized.
1290 root 1.4 - Coro::State is now easier subclassable.
1291     - Coro::Cont now coroutine-aware.
1292     - Coro::Specific is a low-overhead module to create
1293     coroutine-specific vars.
1294 root 1.6 - Coro::Event provides a simple interface to Event.
1295 root 1.4
1296 root 1.3 0.03 Fri Jul 13 14:51:52 CEST 2001
1297 root 1.4 - transfer() now implemented in XS (beware).
1298     - new module Coro::Cont for really faked continuations.
1299     - big internal architecture changes: Coro::State is now
1300 root 1.3 really low-level and can thus be used to implement other
1301 root 1.4 interesting things, While "Coro::" implements a process-like
1302     model. Still crude and subject to change.
1303 root 1.3 - $_ and $@ are no longer being localized.
1304    
1305 root 1.2 0.02 Tue Jul 10 01:38:17 CEST 2001
1306     - implemented "async" attribute.
1307     - $_ and $@ are now localized.
1308     - added Coro::Channel.
1309     - more testcases, still no docs.
1310    
1311 root 1.1 0.01 Tue Jul 3 02:18:41 CEST 2001
1312     - original version; copied from Convert::Scalar.
1313