ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/Coro/Changes
Revision: 1.517
Committed: Thu Jul 23 01:35:18 2009 UTC (14 years, 10 months ago) by root
Branch: MAIN
Changes since 1.516: +2 -0 lines
Log Message:
*** empty log message ***

File Contents

# Content
1 Revision history for Perl extension Coro.
2
3 TODO: should explore PerlIO::coroaio (perl leaks like hell).
4 TODO: maybe implement a default message channel, very much like Erlang's
5 actor model (which is cool in a lot of important aspects (failures!),
6 but very lacking in others (higher level ipc)).
7 TODO: unready_all
8 TODO: myhttpd header parsing
9 TODO: channel->maxsize(newsize)?
10
11 - perl 5.8.2 is now minimum requirement.
12
13 5.161 Wed Jul 22 04:47:38 CEST 2009
14 - Coro::AnyEvent::poll could have a different prototype when EV was
15 used as backend (analyzed by Tatsuhiko Miyagawa).
16 - Coro::AnyEvent errornously initialised the event loop when loaded,
17 not on demand.
18 - try to workaround rare */t/01_unblock.t failures.
19
20 5.16 Tue Jul 21 01:44:37 CEST 2009
21 - Coro::AnyEvent failed to hook into the event loop
22 when no threads had been readied between detecting
23 the event loop and actually running it.
24 - considerably speed up Coro::Select by taking avdantage
25 of AnyEvent > 4.8 and some other optimisations.
26 - implement paragraph readline mode in Coro::Handle
27 (based on patches by Zsbán Ambrus).
28 - replace WSAEINPROGRESS by WSAEWOULDBLOCK (reported
29 and analyzed by Yasuhiro MATSUMOTO).
30 - clarified libcoro license and copyright.
31 - someone stole my EXTRA_META!!!
32 - implement Coro::Select::patch_pp_sselect and it's brother,
33 for hardcode select overriding.
34
35 5.151 Mon Jul 6 05:41:57 CEST 2009
36 - backport to windows process emulation code again (patch by
37 Yasuhiro MATSUMOTO).
38 - slightly update Coro::MakeMaker.
39
40 5.15 Tue Jun 30 10:28:06 CEST 2009
41 - deprecate Coro::Socket, document how to get ipv6 support via
42 AnyEvent::Socket instead.
43 - implement signal->wait ($cb) interface, similar to semaphores.
44 - work around SvOK not supporting getmagic, so we have to getmagic
45 to test for undef :/ (reported by Matthias Waldorf).
46 - load Coro::AnyEvent in all modules using AnyEvent.
47 - work around perl corrupting our internal data structures,
48 reported by Tokuhiro Matsuno.
49 - enable per-coroutine real and cpu time gathering
50 (Coro::State::enable_times).
51
52 5.14 Wed Jun 24 01:37:48 CEST 2009
53 - provide explicit functions to "cede" to the event loop in Coro::AnyEvent,
54 as this seems to have been a difficult concept (poll, sleep, idle,
55 idle_upto).
56 - add Coro::AnyEvent::readable/writable functions.
57 - clarify Coro::EV/Event/AnyEvent manpages.
58 - free per-thread global scalars in the thread calling ->cancel, to
59 avoid crashes when $_, $@ etc., are magical but some of those
60 had already been freed.
61 - "unexperimentalise" the callback interface for Coro::Semaphore.
62 - speed up ready queue management/context switching by using a linked
63 list instead of an array (~5-10%).
64 - implement "watch" command in Coro::Debug shells.
65 - for fun, implement time-slicing as an example in the manpage.
66 - if AnyEvent detects EV or Event, but we don't have Coro::EV or
67 Coro::Event, use the normal AnyEvent handling instead of dieing
68 (the same is true for Coro::Handle).
69 - properly document Coro::EV::timed_io_once.
70 - avoid unneccessary ->cancel calls in Coro::Handle.
71 - maybe make it work on mingw32 with win32 backend
72 (based on patch by Yasuhiro Matsumoto).
73
74 5.132 Fri May 29 09:00:39 CEST 2009
75 - do not keep a reference to the argument itself in
76 Coro::Semaphore::guard, as it could change later.
77 - support SO_RCVBUF/SO_SNDBUF nonstandard Coro::Socket options,
78 should support a prepare callback.
79
80 5.131 Mon Mar 16 23:20:37 CET 2009
81 - implement and document Coro->suspend, Coro->resume.
82 - fix Coro::Select implementation to not (often) close
83 the passed file descriptors (testcase provided by pippijn).
84
85 5.13 Mon Dec 15 21:51:42 CET 2008
86 - EXPERIMENTAL: implement dynamic winds (on_enter/on_leave).
87 - don't set diehook to C<undef> but instead to NULL, to avoid
88 spurious warnings.
89 - fix a lot of bugs in Coro::SemaphoreSet.
90 - Coro::SemaphoreSet will less often create a semaphore needlessly.
91 - add Coro::SemaphoreSet::count and wait methods.
92 - take advantage of the new Guard module.
93 - deprecate Coro::guard.
94 - try to fix the dreaded 01_unblock tests once more. I hate it when
95 testsuites need more fixing than the code they are supposed to test.
96 - croak in more cases when a required callback isn't resolvable.
97 - fix some minor issues in Coro::State->call/eval.
98 - use current coroutine context instead of a temporary one
99 when temporarily switching to another coroutine.
100 - do not call C-level on_destroy handlers during global destruction,
101 to avoid needless segfaults.
102
103 5.12 Sun Dec 7 13:30:38 CET 2008
104 - add default config for MirOS, which seems to be a bug-to-bug
105 compatible fork of openbsd ("world domination by releasing
106 openbsd cvs before the openbsd folks do it" or so :).
107 - free_padlist did destroy the names pad, not good, but didn't
108 seem to bother perl - this could fix issues such as eval ""
109 inside a function called from multiple coroutines.
110 - use a different method to detect destruction time.
111 - be more careful when freeing padlists just before global
112 destruction.
113 - fixed and expanded the call/cc example.
114 - renamed _terminate to _coro_run.
115 - new method Coro::Channel->shutdown.
116 - try pthreads on openbsd <4.4 (broken sigaltstack, will
117 pthreads fare better?).
118 - be less picky about destroying "a" running coroutine.
119
120 5.11 Tue Nov 25 21:49:05 CET 2008
121 - DEBUGGING in 5.10.0 is a mess: it constantly flags perfectly
122 working code with failed assertions, introducing more bugs than
123 it fixes, requiring elaborate workarounds :(
124
125 5.1 Mon Nov 24 08:54:59 CET 2008
126 - wrote a small introductory tutorial - Coro::Intro.
127 - convert Coro::Timer, Coro::Select and Coro::Util to rouse API.
128 - Coro::Select did errornously dup the file descriptors
129 and didn't work with all AnyEvent backends.
130 - Coro::Select wasn't imported correctly form Coro::LWP, causing blocking
131 LWP data transfers.
132 - disassociate c contexts from coro objects - this is agruably more
133 correct, but mostly allows sharing of cctxs between coro and state
134 objects, for added memory savings and speed increases.
135 - bumped $Coro::POOL_RSS up to 32kb by default.
136 - no longer set the optype to OP_CUSTOM, as B::* understandably
137 doesn't like this very much (and we *are* a type of entersub).
138 - implement state cloning, just to prove that call/cc can be done.
139 - automatically load Coro::AnyEvent in Coro::Handle.
140 - wrap ->cancel calls in eval inside Coro::Handle as EV watchers
141 do not have this method (and don't need it either).
142 - speed up generic anyevent methods in Coro::Handle by using rouse
143 callbacks.
144 - allow coroutines in $Coro::IDLE, speeding up Coro::AnyEvent and
145 others. It also makes the debugger happier, as you can trace
146 through the idle threads now.
147 - add comppad_name* and hints ($^H, %^H) to per-thread variables.
148 - eg/event was pretty broken.
149 - better 5.8.6 compatibility.
150
151 5.0 Thu Nov 20 10:35:05 CET 2008
152 - NEW ARCHITECTURE: use the latest 4.x version if you experience
153 stability issues.
154 - bump API version to 7 - all dependents must be recompiled.
155 - removed timed_* functions - they were not being used anyways
156 and should be replaced by a more generic mechanism -
157 and were annoying to support anyways :)
158 - removed SemaphoreSet's waiter method - use sem method instead.
159 - Coro::Semaphore->adjust didn't correctly wake up enough waiters.
160 - async_pool did free a scalar value twice
161 ("Attempt to unreference...").
162 - fix a longstanding bug where calling terminate on a coro that
163 was waiting for a semaphore that was just becoming available
164 would cause a deadlock (semaphore would get into a state where
165 it was available but waiters were still blocked).
166 - calling throw on a coroutine that is waiting for a semaphore will
167 no longer make it acquire the semaphore (and thus leak a count).
168 - perl's process emulation is now not even theoretically supported
169 anymore.
170 - new functions Coro::rouse_cb and Coro::rouse_wait for easier
171 conversion of callback-style to blocking-style.
172 - new methods $coro->schedule_to and ->cede_to, to specifically
173 schedule or cede to a specific coroutine.
174 - new function Coro::Semaphore::wait.
175 - use named constants in Coro::Channel (Richard Hundt).
176 - directly patch the entersub opcode calling SLF functions (cede,
177 transfer and so on). this does speed up context switching, but
178 more importanly, it frees us from the hardcoded behaviour of
179 entersub, so we might actually be able to return something from
180 those functions and atcually create new ones.
181 - take advantage of __builtin_frame_address on gcc.
182 - expose THX in coroapi (not sure whether this was a wise decision,
183 as "threaded" perls are running at half speed anyways).
184 - implement execute_slf (schedule-like-function) interface that makes
185 it possible to implement schedule-like-functions in XS.
186 - use new SLF interface to massively speed up Coro::EV by roughly a
187 factor of two.
188 - used new SLF interface to massively speed up Coro::Semaphore by a
189 factor of three.
190 - used new SLF interface to speed up Coro::AIO by roughly a factor of
191 four and reduce its memory usage considerably.
192 - implement Coro::SemaphoreSet purely in terms of Coro::Semaphore,
193 for a nice speedup and vastly more correct behaviour. Also implement
194 a new method "sem" to get at the underlying semaphore object.
195 - implement Coro::Channel in terms of Coro::Semaphore, for a moderate
196 (in comparison) 20-40% speedup.
197 - used new SLF interface to reimplement Coro::Signal gaining
198 some unknown (because I was too lazy), but certain, speedup, and also
199 making signals reliable for the first time.
200 - used new SLF interface and other optimisations to speed up async_pool
201 by a factor of two. It also doesn't rely on perl's exception mechanism
202 to exit anymore. The overhead for terminating an async_pool, coro over
203 a normal async is now very small.
204 - sped up coroutine creation/destruction by 40%.
205 - forgot to include Coro/libcoro/README in the dist for all these years.
206 - work around a freebsd pthreads bug (manual testcancel is required as
207 pthread_cond_wait isn't a cancellation point on freebsd).
208 - use new rouse functions to speed up and simplify Coro::BDB.
209 - make "prefer perl native functions" work with threaded perls.
210 - condense Coro::Debug ps output, hint at v and w flags.
211 - (libcoro) lots of minor cleanups and portability improvements.
212
213 4.914 Wed Nov 19 12:54:18 CET 2008
214 - fix a disastrous bug in the readline optimisation
215 introduced in 4.801.
216
217 4.913 Sat Nov 15 07:58:28 CET 2008
218 - async_pool did free a scalar value twice
219 ("Attempt to unreference...").
220
221 4.912 Thu Nov 13 18:31:23 CET 2008
222 - minor cleanups.
223 - use much larger stacks on linux and perl < 5.8.8.
224 - Coro::Debug::new_unix_server did not unlink the socket
225 when destroyed.
226
227 4.911 Tue Nov 11 04:26:17 CET 2008
228 - "port" to threaded perls.
229
230 4.91 Mon Nov 10 05:36:38 CET 2008
231 - the ->throw exception object no longer leaks.
232 - creating a new cctx leaked a scopestack entry (memleak).
233 - new coroutines didn't get created with a zero flags field
234 (unknown impact).
235 - calling ->throw on a not-yet-started coroutine should now work
236 instead of being ignored.
237 - ->throw is now supported on Coro::State objects.
238 - clean up cctx creation code a bit.
239 - entersub is actually a UNOP, not a LOGOP (not a bugfix).
240
241 4.9 Sat Nov 8 17:45:27 CET 2008
242 - (libcoro) did not preserve rbp with CORO_ASM (we are getting there).
243 - (libcoro) no longer leak threads in the experimental pthread backend,
244 also speed it up considerably.
245 - (libcoro) do not rely on makecontext passing void *'s unscathed.
246 - fix compiletime dependencies on libcoro in the Makefile.
247 - cctx_count wasn't always updated properly.
248 - Coro::State::cctx_stacksize wasn't applied correctly.
249 - new function Coro::State::cctx_max_idle.
250 - the default max number of idle C contexts is now 4.
251 - (libcoro) try harder to get _setjmp/_longjmp.
252 - (libcoro) cleanup and extend the libcoro API to officially
253 allow the creation of empty source contexts.
254 - very experimental workaround for the totally broken netbsd platform.
255 - tried to hack around openbsd bugs.
256
257 4.804 Wed Nov 5 16:36:00 CET 2008
258 - Coro::Debug::new_unix_server would not create a non-blocking listening
259 socket, sometimes causing freezes.
260 - (libcoro) fix misaligned stack points for setjmp and assembly
261 methods, which can cause crashes on x86/x86_64 with a sufficiently
262 aggressive compiler.
263 - new function: Coro::Debug::new_tcp_server.
264 - move ->throw into the Coro class because it only works on coro objects.
265
266 4.803 Mon Nov 3 17:16:12 CET 2008
267 - (libcoro) use a global asm statement to become independent of gcc
268 otpimisations for CORO_ASM (thanks to pippijn for the idea).
269 - try to workaround yet another broken bsd, this time dragonfly.
270
271 4.802 Thu Oct 30 10:56:12 CET 2008
272 - support -fno-omit-frame-pointer on x86 with the assembly method.
273 - tune 01_unblock.t tests a bit.
274
275 4.801 Wed Oct 22 18:33:37 CEST 2008
276 - improve readline speed for very long "lines".
277 - backport to 5.8.8.
278
279 4.8 Thu Oct 2 13:34:40 CEST 2008
280 - new function Coro::AIO::aio_wait.
281 - Coro.:AIO and Coro::BDB now "use Coro::AnyEvent".
282 - greatly speed up and reduce memory usage of Coro::AIO requests.
283 - implement some other µ-optimisations.
284
285 4.749 Mon Sep 29 14:40:12 CEST 2008
286 - port to slow and broken pseudo-threaded perls. (courtesy pippijn).
287
288 4.748 Sat Sep 27 14:03:19 CEST 2008
289 - implement, but do not document, PerlIO::cede(granularity).
290 - Coro::Storable forgot to wrap Storable::pstore.
291 - work around the multitude of leaks and memory corruption
292 bugs in PerlIO::via by using our own C-level perliol. As a side
293 effect, Coro::Storable is now much, much, much faster.
294
295 4.747 Tue Sep 23 01:59:41 CEST 2008
296 - fix a per-cv memleak (one empty array was leaked per
297 code reference).
298 - avoid a crash in coro->call|rss when the coroutine was already
299 destroyed (most noticably when using Coro::Debug::ps :)
300 - also protect *Storable::FILE.
301 - push up default storable granularity to 20ms.
302
303 4.746 Sun Sep 21 03:22:20 CEST 2008
304 - be more insistent on locking Storable against reentrancy
305 in Coro::Storable.
306 - move swap_def?v and throw to Coro::State, as documented.
307
308 4.745 Thu Jul 24 00:14:38 CEST 2008
309 - remove debugging code related to MgPV_nolen_const, also try to
310 make it compile with perl 5.8.6 (yes, apple apparently loves
311 outdated software). Reported by John S.
312
313 4.744 Tue Jul 8 22:06:35 CEST 2008
314 - correctly provide default DIE/WARN handlers as documented.
315 - also overwrite PL_vtbl_sigelem.svt_clear, even though current
316 implementations inside perl work fine for us.
317
318 4.743 Mon Jun 16 00:21:57 CEST 2008
319 - when using Coro::EV without running EV::loop it could
320 result in busy-waiting for events, this has been fixed.
321 - reduce codesize and improve performance by using EV_DEFAULT_UC.
322
323 4.742 Sat May 31 14:10:21 CEST 2008
324 - implement a workaround for (some) perl <5.8.8 versions.
325 - require EV 3.3+.
326
327 4.741 Fri May 30 23:33:09 CEST 2008
328 - tell netbsd how utterly broken their imitation of an OS is
329 and refuse to build by default if pthreads are in use.
330 - switch to "s" method on all bsd's by default, as their ucontext
331 stuff seems just too broken.
332 - fix a bug in Coro::Select.
333
334 4.74 Thu May 29 20:05:31 CEST 2008
335 - do not test Coro::LWP for lack of dependencies.
336 - do not test Coro::Select for lack of working perls.
337
338 4.73 Thu May 29 2008
339 - fix a bug in Coro::EV which would cause it to block despite
340 there being runnable coroutines.
341 - sprinkle "no warnings" freely over everything, also suppress
342 warnings for some other modules.
343 - fix typo in WSAEWOULDBLOCK.
344
345 4.72 Sun May 25 05:14:36 CEST 2008
346 - tweak META.yaml a bit, unfortunately, there is no documented way
347 to have optional dependencies with CPAN. doh :(
348 - avoid running some tests on windows because they would fail due to
349 perl bug (broken fork, broken pipes...).
350 - work around perl on windows bugs where perl returns undocumented
351 error codes for sysread, syswrite etc. by taking advantage
352 of AnyEvent's workaround for that problem.
353 - use AnyEvent::Util::fh_nonblocking in Coro::Handle to work around
354 a common perl implementation bug on windows.
355 - use unix domain sockets in testsuite to work around
356 common perl implementation bugs on widows (they are emulated by
357 tcp sockets on windows. ugh.)
358
359 4.71 Sat May 24 20:01:27 CEST 2008
360 - fix a bug in Coro::AnyEvent ("Usage: Coro::AnyEvent::_schedule()").
361 - take advantage of async name resolution of AnyEvent::Util.
362 - work around brutal inet_aton override in Coro::LWP.
363 - take advantage of the readyhook in Coro::EV, for smoother
364 scheduling.
365
366 4.7 Sun May 11 00:32:19 CEST 2008
367 - completely reworked the Coro manpage.
368 - added Coro::AnyEvent, generic event loop integration.
369 - implement cancel, ready and kill commands in Coro::Debug.
370 - document find_coro in Coro::Debug.
371 - incompatible change: rename has_stack to has_cctx.
372 - Coro::AIO and Coro::BDB no longer force event model detection,
373 use AnyEvent::AIO and AnyEvent::BDB.
374
375 4.6 Sat Apr 26 10:05:14 CEST 2008
376 - INCOMPATIBLE CHANGE: sub/code attributes are no longer supported
377 by the Coro module. It was a mistake to have it in the first place.
378 - (experimental) support for activestate perl 5.10 (method "w").
379 - (experimental) support for strawberry perl (method "a").
380 - coro_sigelem_set did not return a value although it had to,
381 actual impact unknown.
382
383 4.51 Mon Apr 14 13:28:27 CEST 2008
384 - make it compile again on 5.8.
385
386 4.50 Thu Apr 10 09:43:17 CEST 2008
387 - I did it twice! (see 4.49).
388
389 4.49 Sun Apr 6 21:23:31 CEST 2008
390 - grr, instead of compiling the recent changes on 5.10 only they
391 were compiled on 5.8 only.
392
393 4.48 Sun Apr 6 20:36:46 CEST 2008
394 - allow coroutine switches during eval's under 5.10.x, as it seems
395 the parser is a per-interpreter option now, so this is safe
396 (this might fix the odd crashing bug).
397 - drop support for 5.9.x versions: they are dead, jim.
398
399 4.47 Sun Apr 6 00:37:52 CEST 2008
400 - force cctx allocation on API calls: we know we need to force one
401 and gcc actually manages to confuse our heuristic nowadays,
402 leading to crashes and worse.
403 - document force_cctx.
404
405 4.46 Fri Apr 4 22:05:43 CEST 2008
406 - upgrade libcoro, resulting in pthread-backend (which was only created
407 to fulfill the rules of the programming languages shootout).
408
409 4.45 Thu Mar 13 11:55:36 CET 2008
410 - fix a file leaking bug in eg/mhyttpd that would allow
411 downloading of any file (reported by oesi).
412 - fix deadlock bug in Coro::Channel (reported by Richard Hundt)
413 (also add testcase).
414 - support Broadcast option in Coro::Socket (patch by Richard Hundt,
415 apparently having loads of fun with that).
416 - implement $state->swap_defsv, ->swap_defav and document ->throw.
417
418 4.4 Wed Feb 13 16:44:29 CET 2008
419 - only assume .cfi pseudo isns exist on GNU/Linux.
420 - add get_timed method to Coro::Channels.
421 - fixed Coro::Debug manpage.
422 - perl 5.11 compatbility improvement based on patch by
423 Andreas König.
424
425 4.37 Sun Jan 20 11:25:23 CET 2008
426 - soften the check for an active parser for perl 5.10 (avoiding
427 "Coro::State::transfer called while parsing" in many cases).
428
429 4.36 Sun Jan 13 10:53:56 CET 2008
430 - reset diehook when terminating from an async_pool as to not
431 trigger any __DIE__ handlers.
432
433 4.35 Sun Jan 13 04:14:13 CET 2008
434 - "bt" debug command now displays any exceptions
435 from longmess and also skips the innermost
436 stackframes, giving more useufl output.
437 - allow backtraces in coroutines blocked in Coro::EV,
438 at a <1% speed hit.
439 - handle localising of $SIG{__WARN__} and __DIE__
440 properly (with a proper amount of dirty hacking).
441
442 4.34 Sat Dec 22 17:49:53 CET 2007
443 - upgrade to EV version 2.0 API.
444
445 4.33 Mon Dec 17 08:36:12 CET 2007
446 - make Coro::AIO etc. loadable in the absence of EV.
447
448 4.32 Mon Dec 17 07:46:02 CET 2007
449 - majorly improved Coro::Handle's performance with Coro::EV.
450 - implemented the until now mythical Coro::BDB module.
451 - specialcase EV in Coro::AIO and Coro::BDB for extra speed.
452
453 4.31 Wed Dec 5 12:32:39 CET 2007
454 - remove warn statement form Coro::Util.
455
456 4.3 Tue Dec 4 20:33:14 CET 2007
457 - calls to the idle function could cause stack corruption
458 when the stack changed.
459 - do no longer rely on the presence of EV::DNS if EV is used
460 (because it is gone), but instead take avdantage of EV::ADNS
461 if available.
462 - add ($) prototypes to all functions in Coro::Storable.
463 - use a conventional (safer) idle callback in Coro::EV.
464 - do accept quickly in Coro::Debug to avoid endless loops.
465
466 4.22 Fri Nov 30 16:04:04 CET 2007
467 - really use optimised versions for Event and EV in Coro::Util
468 and Coro::Handle.
469
470 4.21 Sun Nov 25 10:48:59 CET 2007
471 - fix a spurious memory read.
472 - Coro::EV no longer keeps the eventloop "alive".
473
474 4.2 Fri Nov 9 20:47:05 CET 2007
475 - enable/disable tracing from a new coroutine, not a pooled one.
476 - fix a memleak in Coro::Event.
477 - removed killall call from fork_eval.
478 - made sure store_fd is already loaded so that fork_eval
479 does not have to parse autoload in each subprocess.
480 - only use assembly method if -O switch is in $Config{optimize}.
481 - add (optional) Coro::EV module, so far the best event loop module
482 directly supported by Coro.
483 - if the event model is EV, use EV::DNS to resolve
484 stuff in Coro::Util.
485 - don't get confused by multiple event notifications in Coro::Handle.
486 - initial support for EV (libevent interface).
487 - require Event and EV using configure_requires, to force their existance.
488
489 4.13 Wed Oct 24 07:26:45 CEST 2007
490 - add Coro::Storable::blocking_thaw.
491 - use a vastly more complicated technique to localise
492 $SIG{__WARN/DIE__} that also works on perls <= 5.8.8.
493 - use a coroutine for the idle callback Coro::Event,
494 instead of running Event in the current coroutine context.
495 This also catches recursive invocations.
496 - actually report fork errors in gethostbyname and inet_aton.
497
498 4.11 Thu Oct 11 02:40:24 CEST 2007
499 - port to threaded perls.
500
501 4.1 Thu Oct 11 02:38:16 CEST 2007
502 - incompatible change: $SIG{__DIE__} and $SIG{__WARN__} will now
503 be local to each coro (see Coro::State).
504 - incompatible change: for very deep reasons, cede and cede_notself
505 cannot return anything, so nothing will be returned.
506 - possibly bring back 5.10 compatibility (untested).
507 - work around stupid (and wrong) warning on 5.10 :(.
508 - overlay the saved state over the context stack. This saves
509 a few hundred bytes per coroutine on average and also
510 speeds up context switching a bit.
511 - further tune default stack sizes.
512 - (more) correctly calculate stack usage in coro_rss.
513 - Coro::Storable::blocking_* did not properly lock
514 resulting in races between coroutines.
515 - added Coro::Storable::guard.
516 - stopping to trace a coroutine could destroy the cctx of
517 an unrelated coroutine.
518 - explain the relationship between Perl and C coroutines in
519 more detail in Coro::State.
520 - Coro::Util::inet_aton did not short-circuit dotted quad forms,
521 causing a fork per resolve. This also affected Coro::Socket.
522 - switch to a separate stack in $coro->call/eval to avoid
523 invalidating pointers.
524
525 4.03 Sat Oct 6 21:24:00 CEST 2007
526 - added Coro::throw method.
527 - minor code cleanups.
528
529 4.02 Sat Oct 6 02:36:47 CEST 2007
530 - fix a very minor per-coroutine memleak (a single codereference).
531 - fixed a bug where the currently in-use c context would be freed
532 prematurely (can happen only when programs change the stacksize
533 or use tracing).
534 - tracing can no longer keep a coro alive after it terminated.
535 - do static branch prediction in the common path for gcc. gives
536 about 2-5% speed improvement here.
537
538 4.01 Fri Oct 5 22:10:49 CEST 2007
539 - instead of recreating *a* standard output handle we simply
540 use STDOUT, which is faster and hopefully more robust.
541
542 4.0 Fri Oct 5 12:56:00 CEST 2007
543 - incompatibly changed Coro::Storable::freeze.
544 - major new feature: added Coro::Debug, for interactive coroutine
545 debugging, tracing and much more.
546 - major bug fix: unbelievable, but true: $_, $/ and many other
547 "saved" variables actually weren't being saved. This has been fixed,
548 of course, while increasing performance while losing all the save
549 flags.
550 - save flags are gone, and all the api functions dealing with them.
551 - added Coro::Semaphore::adjust.
552 - added Coro::Util::fork_eval.
553 - added Coro::Storable::{nfreeze,blocking_{freeze,nfreeze}}.
554 - added Coro::killall.
555 - reduce initial stack sizes to allow for "micro-coroutines".
556 - better async_pool resource management, moved parts of async_pool
557 handling to XS (major speed improvement).
558 - actually croak before modifying important data structures.
559 - refuse to transfer while compiling.
560 - possibly support eval EXPR better now.
561 - enable assembly per default on linux+bsd x86+amd64.
562 - all internal members were renamed _something for easier subclassing.
563 - many minor tweaks.
564
565 3.63 Wed May 16 14:10:06 CEST 2007
566 - implement handcoded assembly for x86/amd64 SVR ABI.
567
568 3.62 Fri Apr 27 21:36:06 CEST 2007
569 - upgrade libcoro (which might set unwind info correctly).
570 - change default on linux to setjmp/longjmp.
571
572 3.61 Thu Apr 19 12:36:18 CEST 2007
573 - Coro::Storable caused an endless loop when thawing invalid
574 pst's sometimes.
575 - use a Semaphore in Coro::Storable, as Storable doesn't
576 seem to be reentrant (although it is documented to
577 be threadsafe...).
578 - fix Coro::Signal to bring back the original unreliable
579 but stateful semantics.
580 - fixed a lot of typos in Coro.pm (patch submitted by David
581 Steinbrunner, which applied flawlessly).
582
583 3.6 Sat Apr 14 17:13:31 CEST 2007
584 - added some bugfixes to get eg/myhttpd working again.
585 - added Coro::Storable for often-cede'ing freeze/thaw.
586 - try to do a clean exit when a coroutine calls exit
587 (EXPERIMENTAL).
588 - got rid of indirect call through _coro_init.
589 - updated the partly antique examples in eg/ to
590 work again and be a bit less magic, too.
591 - fixed Coro::Signal semantics to work as documented again.
592
593 3.55 Sun Mar 25 01:20:47 CET 2007
594 - add SAVE_DEFFH to save the default filehandle and enable
595 it by default.
596 - finally move socket-operations from Coro::Socket to Coro::Handle
597 to be able to unblock foreign sockets.
598 - add Coro::State::save_also and guarded_save.
599 - add count accessor to Coro::Semaphore.
600 - add Coro::State::cctx_stacksize.
601 - just for the fun of it, do not rely on implicit context,
602 which can dramatically improve performance, but people
603 using windows-process-emulation perls do not care much about
604 performance.
605
606 3.51 Sun Mar 4 14:18:04 CET 2007
607 - fixed a problem when you weakened references to Coro::State's
608 (patch by Yuval Kogman).
609
610 3.501 Wed Feb 28 12:44:07 CET 2007
611 - rename some global symbols as macosx from hell redefines
612 them without asking.
613
614 3.5 Tue Feb 13 20:22:53 CET 2007
615 - do AnyEvent model detection earlier, avoiding problems
616 caused by first using AnyEvent and later Coro::Event.
617 - implement and document Coro::Event event objects.
618 - fix a potential problem in Coro::Event causing crashes.
619 - initialise PL_comppad when creating a new coroutine,
620 avoids crashes on early coro destruction.
621
622 3.41 Mon Jan 22 19:19:49 CET 2007
623 - readline on Coro::Handle did not support undefined $/,
624 nor did it deliver partial lines on EOF or error.
625 - implement malloc fallback for stack allocation because
626 stupid broken idiotic OSX has a stupid broken
627 idiotic fits-the-whole-os mmap "implementation" and
628 my dick feels longer if Coro is portable even to
629 obsolete platforms.
630
631 3.4 Fri Jan 19 21:52:54 CET 2007
632 - remove t/09_timer.t, as it isn't really testing much
633 but was rather flaky in practise.
634 - async_pool coro would keep arguments and callback alive until
635 it was reused.
636 - cancellation of a coroutine could cause spurious idle calls
637 in cede_notself.
638
639 3.3 Sat Jan 6 03:45:00 CET 2007
640 - implement $coro->on_destroy.
641 - Coro::Event blocking semantics have been changed,
642 documented and - hopefully - improved.
643 - fix nice adding, not subtracting, from priority.
644 - fix ->prio and api_is_ready (patch by Mark Hinds).
645 - fixed an assert ("... == prev__cctx->idle_te")
646 that could errronously trigger.
647 - fix various large and small memleaks.
648 - use a (hopefully) more stable cancel implementation
649 that immediately frees the coroutine data.
650 - cede/cede_notself return a status now.
651 - added Coro::guard function.
652 - added a global coroutine pool for jobs (on my machine,
653 I can create and execute 48k simple coros/s with async,
654 and 128k coros with async_pool).
655 - Coro::AIO now uses the coroutine priority as io priority.
656
657 3.2 Fri Dec 22 05:07:09 CET 2006
658 - improve portability to slightly older perls.
659 - use cleaner coroutine destruction.
660 - simplify configuration for users.
661 - optionally (unrecommended) prefer perl functions over
662 their coro replacements.
663
664 3.11 Tue Dec 5 13:11:24 CET 2006
665 - fixed some bogus assert's, but as perl.h disables assert even
666 without NDEBUG (thank you very much), not too many people should
667 notice (that did include myself). Andreas König noticed, though :)
668 - do not save/restore PL_sortcxix on >= 5.9.x, it doesn't seem to have
669 it. Also noticed by Andreas König :)
670 - save/restore tainted status.
671 - verified to pass the testsuite on my 5.9.5.
672
673 3.1 Mon Dec 4 23:03:40 CET 2006
674 - INCOMPATIBLE CHANGE: $/ is now per-coroutine (but slow).
675 - incompatible change: transfer flags are now per-state.
676 - give a better error message on deadlock.
677 - document Coro::nready.
678 - enhanced testsuite.
679
680 3.01 Sun Dec 3 23:47:42 CET 2006
681 - forgot to include Coro::Timer.
682
683 3.0 Sun Dec 3 22:57:25 CET 2006
684 - the "FINALLY COMPLETELY STABLE" release (coming soon:
685 the "FAMOUS LAST WORDS" release).
686 - implement a new stack sharing algorithm, which uses a stack
687 pool (size currently hardcoded).
688 - make stack sharing mandatory (it no longer uses a heuristic).
689 - eval/die no longer cause weird problems under heavy use.
690 - Coro::Event could cause livelocks if it was used but
691 no Coro::Event watchers were used.
692 - Coro::Event now uses asynccheck as prepare does not
693 check for changed watchers.
694 - Coro::Event allows multiple waiting coros and will wake up one
695 per event.
696 - Coro::Event should be cleaner and more efficient now.
697 - new utility function Coro::unblock_sub.
698 - document the sad fact that Event is no longer reentrant.
699 - putting a coroutine into the ready queue twice could under
700 some circumstances lead to stack corruption.
701 - minor incompatibility: subclassing Coro::State is supported
702 directly now without going through a _coro_state member.
703 - state/coro switching is much faster now.
704 - very minor optimisations and code/documentation cleanup.
705 - avoid problems due to compiler inlining.
706 - removed timers from Coro::Timer -> use AnyEvent instead.
707 - replaced Coro::idle coroutine by (cleaner) idle handler.
708 - updated to newest libcoro.
709 - implement enhanced support for valgrind.
710 - implement is_ready and return value for ready.
711 - removed Coro::Cont, it was a misnomer (it's generators),
712 and it was somewhat annoying to get it right. Will come back
713 if somebody asks for it :)
714 - many ->wait methods and Coro::Event could return
715 spuriously without the event having happened.
716
717 2.5 Tue Nov 7 12:22:33 CET 2006
718 - made Coro::Util, Coro::Select, Coro::Handle and Coro::Socket
719 use AnyEvent, moved them to Coro/.
720 - added Coro::LWP which contains all the uglyness required to
721 make LWP non-blocking.
722 - should work with perl 5.9.x now (Andreas König made me do it).
723 - fixed another bug in Coro::Select when the timeout was undef.
724 - reuse PL_start_env for all coros, saves some memory per coroutine.
725 - manage PL_top_env differently, hopefully to avoid panic: top_env.
726 - timeout argument was not properly used in Coro::Socket.
727 - allow limited forms of subclassing in Coro::Handle/Coro::Socket.
728 - emulate undocumented(!) functionality of IO::Socket required
729 by LWP(!!).
730 - updated eg/lwp to work with newer lwp's.
731 - remove "FATAL: uncaught exception" prefix. Coroutines that die
732 kill the whole process, just as exceptions in the main "coroutine"
733 did already.
734
735 2.1 Wed Nov 1 23:01:13 CET 2006
736 - fix a long-standing bug in Coro::Select where select with
737 zero timeout would instead change the current default filehandle.
738 - use a simpler and hopefully more robust way to clone padlists
739 (uses less memory and a perl function instead of our own).
740 - coro can now create a stack guard area on many architectures.
741 - Coro::AIO properly reexports additional functions from IO::AIO.
742 - updated libcoro with a workaround for OS X,
743 pach and testing by Michael Schwern.
744
745 2.0 Tue Oct 24 05:47:17 CEST 2006
746 - support additional aio requests in Coro::AIO.
747
748 1.9 (never properly released due to a glitch)
749
750 1.8 Thu Feb 2 00:59:06 CET 2006
751 - applied suggested patch by SAMV to avoid problems during stupid
752 mark & sweep gc run.
753 - applied patch by Scott Walters for 5.9.3 compatibility.
754
755 1.7 Tue Dec 27 01:41:58 CET 2005
756 - added Coro::AIO, a thin wrapper around IO::AIO.
757 - improved Makefile.PL explanations.
758
759 1.6 Mon Dec 12 21:30:05 CET 2005
760 - additionally save PM_curpm might fix as-of-yet
761 unseen problems with regex matches being attributed to the
762 wrong package.
763 - add t/10_bugs.t, which currently checks against imho broken
764 perls that use 0.26MB of stack space per Perl_magic_get
765 invocation (newer linuxes) as opposed to the 0.0002MB perl
766 normally uses.
767 - make stacksize configurable for the ultimate debian experience.
768
769 1.51 Mon Dec 12 18:48:36 CET 2005
770 - remove debugging warn() accidentally left in Coro::Select.
771
772 1.5 Tue Nov 29 13:32:44 CET 2005
773 - use Coro::Event inside Coro::Select to avoid spurious deadlocks.
774 - fix Coro::Select 'select'.
775 - strict'ify some modules.
776 - libcoro errornously restored the SIGUSR2 handler to SIGUSR1.
777 - use XSLoader in selected modules.
778 - remove some 5.6 compatibility cruft.
779
780 1.4 Tue Sep 6 00:11:05 CEST 2005
781 - libcoro did not take into account the trampoline on amd64,
782 when 'l'inux method was used.
783
784 1.31 Tue Aug 30 23:31:33 CEST 2005
785 - some portability fixes/workarounds.
786
787 1.3 Sat Aug 20 03:08:56 CEST 2005
788 - no code changes. module seems to work fine.
789 - improve Coro::State docs, remove reference to nonexisting
790 Coro::State::flush method.
791 - no longer autodetect windows, present it as an option instead.
792
793 1.2 Mon May 16 02:00:55 CEST 2005
794 - included libcoro.c earlier in State.xs, might improve portability.
795 - use a faster and possibly more stable Coro::Cont implementation.
796 - accept x86_64 in addition to amd64 for optimized linux-amd64 support.
797 - fix bugs Coro::SemaphoreSet that could cause locks never to be freed.
798 - fix bugs in CoroAPI.h and document it in Coro::MakeMaker.
799
800 1.11 Thu Mar 3 18:00:52 CET 2005
801 - change of contact address.
802
803 1.1 Tue Feb 22 20:51:16 CET 2005
804 - support [l]inux method on amd64.
805 - allow some context switches while compiling/eval'ing.
806
807 1.0 Tue Aug 10 03:47:27 CEST 2004
808 - Event 0.89 fixes the bug again.
809 - fix the remaining(??) memleak. I didn't free the cache-AV for
810 padlists, so one AV per created anon-sub leaked.
811
812 0.97 Fri May 14 15:23:32 CEST 2004
813 - remove stupid gcc extension that was an experiment only anyway.
814
815 0.96 Thu May 13 18:09:29 CEST 2004
816 - tell people if they have yet another broken Event variant.
817 - made Coro to work _better_ with threads (it seems that, as long
818 as you use Coros in one thread only everything will work fine.
819 Looking at the perl source the problem might be missing locking
820 between Coro and some perl internal routines. That's not easily
821 fixable).
822 - (hopefully) got rid of the static xnext inside transfer.
823
824 0.95 Sun Feb 15 03:20:28 CET 2004
825 - removed Coro::State::flush, implemented a new and much
826 faster caching mechanism by attaching magic to the CV.
827 - a memleak with (real) closures remains.
828 - dramatically reduced size of stacks to 65536 (linux/x86), after
829 observing that even myhttpd never had more than a kilobyte
830 of stack in use (stack is still only physically allocated in
831 pagesize increments for systems suporting mmap).
832 - fix for a "cygwin-64" architecture added, proposed by Stefan Traby.
833 - fix for threaded perl.
834
835 0.9 Sun Nov 23 04:32:39 CET 2003
836 - fix a few very hard to track down but (of course) stupid
837 memory leaks.
838 - stringify version number to avoid locale problems :(.
839 - perl 5.9.0 does not have SvPADBUSY, reported by Scott Walters,
840 hopefully ignoring it "just works".
841
842 0.8 Wed Nov 5 19:38:40 CET 2003
843 - port to perl5.005_03, but only 5.8.x+ is supported!
844 - honor LocalAddr even without LocalPort in Coro::Socket.
845
846 0.7 Tue May 27 03:12:38 CEST 2003
847 - the version jump indicates some level of testing, not gobs
848 of new features.
849 - uh... I found the prompt function in ExtUtils::MakeMaker.
850 Highly correct stuff, that is...
851 - fixed(?) a bug with die's in coroutines causing "panic: top_env".
852 the fix is not well understood by the author, so beware :(.
853
854 0.652 Thu May 8 02:54:46 CEST 2003
855 - Applied patch by Slaven Rezic to set default to "s" on FreeBSD,
856 cause version 4 doesn't have ucontext.
857 - Benjamin Reed reported that setjmp works fine on darwin,
858 so preselect it.
859
860 0.651 Sat Mar 29 15:00:23 CET 2003
861 - fix a bug in Coro::Handle where some bytes could get lost
862 on reading, reported by jason@nichego.net.
863
864 0.65 Sun Mar 23 00:08:26 CET 2003
865 - added a README.linux-glibc.
866 - new module Coro::Select.
867 - also save/restore PL_comppad, fixes segfaults with 5.8.1.
868 (I never claimed that I know what I am doing ;).
869 - set default to setjmp/longjmp on non-x86-linux.
870
871 0.6 Thu Nov 21 11:09:06 CET 2002
872 - made lazy context switching the default.
873 - fixed the bug where SemaphoreSet::guard
874 was the same as timed_guard and timed_guard was missing.
875 - fix a memleak in Coro::Timer.
876 - reclassified context sharing as not experimental.
877
878 0.534 Sun Apr 14 03:05:12 CEST 2002
879 - fixed backspace => tab in header parsing (myhttpd).
880 - added eg/readline, for elmex.
881 - Coro::Event now calls ->start on first call instead of
882 ->again, which created wrong timeouts for the first ->next.
883 - fixed a bug where Coro::Socket returned a closed socket instead
884 of nothing on ECONNREFUSED and similar error conditions.
885
886 0.533 Mon Feb 18 18:49:40 CET 2002
887 - adapt to finally working Event-0.85.
888 - fixed buggy event initialization (trapped under windows, but how
889 could it possibly have worked anywhere?)
890
891 0.532 Wed Jan 16 02:45:32 CET 2002
892 - removed the reference to pp_entersub, might work on
893 (some) win32 perls now (testsuite works under cygwin,
894 without Event, which freezes).
895
896 0.531 Mon Dec 10 22:18:44 CET 2001
897 - Fixed a bug in SemaphoreSet::timed_down.
898
899 0.53 Tue Nov 27 21:11:13 CET 2001
900 - some tests for Event.
901 - slightly different internal architecture to get refcnt into the object
902 and not the reference. might fix a few bugs, certainly did introduce
903 new ones.
904 - Coro::Timer (independent of Event).
905 - new timed_wait functions for Coro::Signal, Semaphore, SemaphoreSet.
906
907 0.52 Tue Nov 6 21:36:18 CET 2001
908 - ported to cygwin (trivial).
909 patch by Gerrit P. Haase <gp@familiehaase.de>.
910 - small setjmp code fix by Sullivan.DanielJ@epamail.epa.gov.
911
912 0.51 Thu Nov 1 20:39:01 CET 2001
913 - terminate/cancel now work properly (otherwise termination
914 could cause a "next coroutine is not and contains not..."
915 error.
916 - added Coro::Socket::shutdown.
917 - Coro::Event::loop no is the same as Event::loop.
918 - implemented terminate with args + join.
919
920 0.5 Fri Sep 28 16:15:35 CEST 2001
921 - fixed "print" on a Coro::Handle. The print method worked.
922 - small tweaks (seem to reduce memory consumption a lot)
923 in various modules.
924 - splendid use of "no warnings" scattered throughout.
925 - added Coro::Handle::rbuf, fixed Coro::Handle::fh.
926
927 0.49 Sun Sep 16 02:42:45 CEST 2001
928 - changed some method calls to function calls for speed
929 inside Coro::Handle.
930 - make Coro::Handle use an array instead of a hash for
931 speed reasons.
932 - IRIX mystery solved: it's SGI's NT, after all: "standard, huh?".
933 sjlj and ucontext should now work.
934 - IRIX-specific port for libcoro.
935 - swapped order of accept results to match IO::Socket.
936 - changed getsock/peername to sock/peername to match IO::Socket.
937 - fixed a bug that caused segfault when returning to main task
938 under some circumstances.
939 - other bugfixes.
940
941 0.45 Sun Sep 2 02:54:01 CEST 2001
942 - new method Coro::Handle::timeout.
943 - corrected speling of set...name to get...name in Coro::Socket.
944 - Coro::Socket::accept now returns a Coro::Socket, not a Coro::Handle.
945 - Coro::Handle now supports fileno and FILENO.
946 - added eg/myhttpd, a web server.
947 - Coro::Socket now accepts numeric ports as well as "port(number)"
948 syntax.
949 - moved some scheduling primitives into xs code. more to come.
950 - new simple priority system.
951 - implemented Coro::Event using XS, almost four times faster!
952 - small memory corruption problem fixed (boy that was difficult).
953
954 0.13 Wed Aug 8 16:53:07 CEST 2001
955 - new method Coro::Handle::readline.
956 - added eg/lwp and Coro::Handle::autoflush, to make LWP work.
957 (see eg/lwp on how to make LWP non-blocking).
958 - renamed Coro::Socket::new_inet to new.
959 - added Coro::Util, some utility functions.
960 - die/eval now works better (still get annoying (but true ;)
961 "Callback called exit" messages).
962 - Coro::Handle now supports timeout, and Coro::Socket Timeout.
963 - much better Coro::Socket support.
964
965 0.12 Fri Jul 27 04:19:01 CEST 2001
966 - do not use mmap if neither MAP_ANON nor MAP_ANONYMOUS is defined.
967 - very experimental stack sharing algorithm. not 100% safe but
968 should work well in practise ;)
969 - added Coro::RWLock.
970 - Coro::Specific now works.
971
972 0.11 Tue Jul 24 22:49:21 CEST 2001
973 - added specialized hack for newer and older linux versions (fast).
974 - renamed Coro::Event::IO to Coro::Handle.
975 - new module Coro::Socket.
976
977 0.1 Tue Jul 24 01:47:53 CEST 2001
978 - release candidate 3. A rather new internal structure :(
979 - the great renaming: Damian Conway gave me a suitable replacement
980 for yield.
981 - added Coro/libcoro, a portable coroutine implementation for C
982 (not even perl-dependent!!!), which can be used by Coro::State.
983 - renamed SAVE_DEFSV (on xs-level only) to avoid symbol clash in
984 perl-5.6.
985 - new function Coro::Event::idle.
986 - the idle process is now overriden
987 by default in Coro::Event.
988 - Coro::Channel now enforces the size.
989 - canceling events now works in all cases.
990 - Coro state now include $_ and $@.
991 - yet another bug workaround that I do not really understand :(
992 - new module Coro::Event::IO (very undocumented) to do
993 non-blocking i/o.
994 - performance tuning.
995
996 0.08 Thu Jul 19 06:13:25 CEST 2001
997 - release candidate 2 (new functionality).
998 - add Coro::State::flush function.
999 - transfer now supports a flags value (mostly for speed ATM).
1000 - might compile and work in the presence of threads now.
1001 - continuations have a saner syntax.
1002 - no more memleaks.
1003
1004 0.07 Tue Jul 17 17:40:18 CEST 2001
1005 - release candidate 1 ;)
1006 - slightly nicer code.
1007 - fixed a scheduling bug in Coro::Event.
1008
1009 0.06 Tue Jul 17 04:23:24 CEST 2001
1010 - ok, I found the showstopper - the same sub must not be
1011 re-entered in two different coroutines, otherwise => crash. I
1012 see no easy solution to this problem, except by walking the call
1013 chaing and saving/restoring the cv's, which is what I do now.
1014 - memory leaks still latent, especially at thread termination.
1015 - Coro::Event now works (haha).
1016
1017 0.05 Sun Jul 15 17:32:20 CEST 2001
1018 - fixed a few issues in Coro::Event.
1019 - I forgot to include Coro::Event in 0.04 :(:(:(
1020
1021 0.04 Sun Jul 15 05:24:59 CEST 2001
1022 - @_ is now properly localized.
1023 - Coro::State is now easier subclassable.
1024 - Coro::Cont now coroutine-aware.
1025 - Coro::Specific is a low-overhead module to create
1026 coroutine-specific vars.
1027 - Coro::Event provides a simple interface to Event.
1028
1029 0.03 Fri Jul 13 14:51:52 CEST 2001
1030 - transfer() now implemented in XS (beware).
1031 - new module Coro::Cont for really faked continuations.
1032 - big internal architecture changes: Coro::State is now
1033 really low-level and can thus be used to implement other
1034 interesting things, While "Coro::" implements a process-like
1035 model. Still crude and subject to change.
1036 - $_ and $@ are no longer being localized.
1037
1038 0.02 Tue Jul 10 01:38:17 CEST 2001
1039 - implemented "async" attribute.
1040 - $_ and $@ are now localized.
1041 - added Coro::Channel.
1042 - more testcases, still no docs.
1043
1044 0.01 Tue Jul 3 02:18:41 CEST 2001
1045 - original version; copied from Convert::Scalar.
1046