ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/Coro/Changes
Revision: 1.627
Committed: Tue Mar 4 12:32:02 2014 UTC (10 years, 2 months ago) by root
Branch: MAIN
CVS Tags: rel-6_37
Changes since 1.626: +4 -0 lines
Log Message:
6.37

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