[ViewVC] Annotation of: cvs/libev/Changes

Revision history for libev, a high-performance and full-featured event loop.

TODO: ev_walk
TODO: child wactehr execution order w.r.t. childsigcb reg. priorities
TODO: remain
        - Denis F. Latypoff corrected many typos in example code snippets.
        - honor autoconf detection of EV_USE_CLOCK_SYSCALL, also double-
          check that the syscall number is available before trying to
          use it (reported by ry@tinyclouds).

3.6  Tue Apr 28 02:49:30 CEST 2009
        - multiple timers becoming ready within an event loop iteration
          will be invoked in the "correct" order now.
        - do not leave the event loop early just because we have no active
          watchers, fixing a problem when embedding a kqueue loop
          that has active kernel events but no registered watchers
          (reported by blacksand blacksand).
        - correctly zero the idx values for arrays, so destroying and
          reinitialising the default loop actually works (patch by
          Malek Hadj-Ali).
        - implement ev_suspend and ev_resume.
        - new EV_CUSTOM revents flag for use by applications.
        - add documentation section about priorites.
        - add a glossary to the dcoumentation.
        - extend the ev_fork description slightly.
        - optimize a jump out of call_pending.

3.53 Sun Feb 15 02:38:20 CET 2009
        - fix a bug in event pipe creation on win32 that would cause a
          failed assertion on event loop creation (patch by Malek Hadj-Ali).
        - probe for CLOCK_REALTIME support at runtime as well and fall
          back to gettimeofday if there is an error, to support older
          operating systems with newer header files/libraries.
        - prefer gettimeofday over clock_gettime with USE_CLOCK_SYSCALL
          (default most everywhere), otherwise not.

3.52 Wed Jan  7 21:43:02 CET 2009
        - fix compilation of select backend in fd_set mode when NFDBITS is
          missing (to get it to compile on QNX, reported by Rodrigo Campos).
        - better select-nfds handling when select backend is in fd_set mode.
        - diagnose fd_set overruns when select backend is in fd_set mode.
        - due to a thinko, instead of disabling everything but
          select on the borked OS X platform, everything but select was
          allowed (reported by Emanuele Giaquinta).
        - actually verify that local and remote port are matching in
          libev's socketpair emulation, which makes denial-of-service
          attacks harder (but not impossible - it's windows). Make sure
          it even works under vista, which thinks that getpeer/sockname
          should return fantasy port numbers.
        - include "libev" in all assertion messages for potentially
          clearer diagnostics.
        - event_get_version (libevent compatibility) returned
          a useless string instead of the expected version string
          (patch by W.C.A. Wijngaards).

3.51 Wed Dec 24 23:00:11 CET 2008
        - fix a bug where an inotify watcher was added twice, causing
          freezes on hash collisions (reported and analysed by Graham Leggett).
        - new config symbol, EV_USE_CLOCK_SYSCALL, to make libev use
          a direct syscall - slower, but no dependency on librt et al.
        - assume negative return values != -1 signals success of port_getn
          (http://cvs.epicsol.org/cgi/viewcvs.cgi/epic5/source/newio.c?rev=1.52)
          (no known failure reports, but it doesn't hurt).
        - fork detection in ev_embed now stops and restarts the watcher
          automatically.
        - EXPERIMENTAL: default the method to operator () in ev++.h,
          to make it nicer to use functors (requested by Benedek László).
        - fixed const object callbacks in ev++.h.
        - replaced loop_ref argument of watcher.set (loop) by a direct
          ev_loop * in ev++.h, to avoid clashes with functor patch.
        - do not try to watch the empty string via inotify.
        - inotify watchers could be leaked under certain circumstances.
        - OS X 10.5 is actually even more broken than earlier versions,
          so fall back to select on that piece of garbage.
        - fixed some weirdness in the ev_embed documentation.

3.49 Wed Nov 19 11:26:53 CET 2008
        - ev_stat watchers will now use inotify as a mere hint on
          kernels <2.6.25, or if the filesystem is not in the
          "known to be good" list.
        - better mingw32 compatibility (it's not as borked as native win32)
          (analysed by Roger Pack).
        - include stdio.h in the example program, as too many people are
          confused by the weird C language otherwise. I guess the next thing
          I get told is that the "..." ellipses in the examples don't compile
          with their C compiler.

3.48 Thu Oct 30 09:02:37 CET 2008
        - further optimise away the EPOLL_CTL_ADD/MOD combo in the epoll
          backend by assuming the kernel event mask hasn't changed if
          ADD fails with EEXIST.
        - work around spurious event notification bugs in epoll by using
          a 32-bit generation counter. recreate kernel state if we receive
          spurious notifications or unwanted events. this is very costly,
          but I didn't come up with this horrible design.
        - use memset to initialise most arrays now and do away with the
          init functions.
        - expand time-out strategies into a "Be smart about timeouts" section.
        - drop the "struct" from all ev_watcher declarations in the
          documentation and did other clarifications (yeah, it was a mistake
          to have a struct AND a function called ev_loop).
        - fix a bug where ev_default would not initialise the default
          loop again after it was destroyed with ev_default_destroy.
        - rename syserr to ev_syserr to avoid name clashes when embedding,
          do similar changes for event.c.

3.45 Tue Oct 21 21:59:26 CEST 2008
        - disable inotify usage on linux <2.6.25, as it is broken
          (reported by Yoann Vandoorselaere).
        - ev_stat errornously would try to add inotify watchers
          even when inotify wasn't available (this should only
          have a performance impact).
        - ev_once now passes both timeout and io to the callback if both
          occur concurrently, instead of giving timeouts precedence.
        - disable EV_USE_INOTIFY when sys/inotify.h is too old.

3.44 Mon Sep 29 05:18:39 CEST 2008
        - embed watchers now automatically invoke ev_loop_fork on the
          embedded loop when the parent loop forks.
        - new function: ev_now_update (loop).
        - verify_watcher was not marked static.
        - improve the "associating..." manpage section.
        - documentation tweaks here and there.

3.43 Sun Jul  6 05:34:41 CEST 2008
        - include more include files on windows to get struct _stati64
          (reported by Chris Hulbert, but doesn't quite fix his issue).
        - add missing #include <io.h> in ev.c on windows (reported by
          Matt Tolton).

3.42 Tue Jun 17 12:12:07 CEST 2008
        - work around yet another windows bug: FD_SET actually adds fd's
          multiple times to the fd_*SET*, despite official MSN docs claiming
          otherwise. Reported and well-analysed by Matt Tolton.
        - define NFDBITS to 0 when EV_SELECT_IS_WINSOCKET to make it compile
          (reported any analysed by Chris Hulbert).
        - fix a bug in ev_ebadf (this function is only used to catch
          programming errors in the libev user). reported by Matt Tolton.
        - fix a bug in fd_intern on win32 (could lead to compile errors
          under some circumstances, but would work correctly if it compiles).
          reported by Matt Tolton.
        - (try to) work around missing lstat on windows.
        - pass in the write fd set as except fd set under windows. windows
          is so uncontrollably lame that it requires this. this means that
          switching off oobinline is not supported (but tcp/ip doesn't
          have oob, so that would be stupid anyways.
        - use posix module symbol to auto-detect monotonic clock presence
          and some other default values.

3.41 Fri May 23 18:42:54 CEST 2008
        - work around an obscure bug in winsocket select: if you
          provide only empty fd sets then select returns WSAEINVAL. how sucky.
        - improve timer scheduling stability and reduce use of time_epsilon.
        - use 1-based 2-heap for EV_MINIMAL, simplifies code, reduces
          codesize and makes for better cache-efficiency.
        - use 3-based 4-heap for !EV_MINIMAL. this makes better use
          of cpu cache lines and gives better growth behaviour than
          2-based heaps.
        - cache timestamp within heap for !EV_MINIMAL, to avoid random
          memory accesses.
        - document/add EV_USE_4HEAP and EV_HEAP_CACHE_AT.
        - fix a potential aliasing issue in ev_timer_again.
        - add/document ev_periodic_at, retract direct access to ->at.
        - improve ev_stat docs.
        - add portability requirements section.
        - fix manpage headers etc.
        - normalise WSA error codes to lower range on windows.
        - add consistency check code that can be called automatically
          or on demand to check for internal structures (ev_loop_verify).

3.31 Wed Apr 16 20:45:04 CEST 2008
        - added last minute fix for ev_poll.c by Brandon Black.

3.3  Wed Apr 16 19:04:10 CEST 2008
        - event_base_loopexit should return 0 on success
          (W.C.A. Wijngaards).
        - added linux eventfd support.
        - try to autodetect epoll and inotify support
          by libc header version if not using autoconf.
        - new symbols: EV_DEFAULT_UC and EV_DEFAULT_UC_.
        - declare functions defined in ev.h as inline if
          C99 or gcc are available.
        - enable inlining with gcc versions 2 and 3.
        - work around broken poll implementations potentially
          not clearing revents field in ev_poll (Brandon Black)
          (no such systems are known at this time).
        - work around a bug in realloc on openbsd and darwin,
          also makes the errornous valgrind complaints
          go away (noted by various people).
        - fix ev_async_pending, add c++ wrapper for ev_async
          (based on patch sent by Johannes Deisenhofer.
        - add sensible set method to ev::embed.
        - made integer constants type int in ev.h.

3.2  Wed Apr  2 17:11:19 CEST 2008
        - fix a 64 bit overflow issue in the select backend,
          by using fd_mask instead of int for the mask.
        - rename internal sighandler to avoid clash with very old perls.
        - entering ev_loop will not clear the ONESHOT or NONBLOCKING
          flags of any outer loops anymore.
        - add ev_async_pending.

3.1  Thu Mar 13 13:45:22 CET 2008
        - implement ev_async watchers.
        - only initialise signal pipe on demand.
        - make use of sig_atomic_t configurable.
        - improved documentation.

3.0  Mon Jan 28 13:14:47 CET 2008
        - API/ABI bump to version 3.0.
        - ev++.h includes "ev.h" by default now, not <ev.h>.
        - slightly improved documentation.
        - speed up signal detection after a fork.
        - only optionally return trace status changed in ev_child
          watchers.
        - experimental (and undocumented) loop wrappers for ev++.h.

2.01 Tue Dec 25 08:04:41 CET 2007
        - separate Changes file.
        - fix ev_path_set => ev_stat_set typo.
        - remove event_compat.h from the libev tarball.
        - change how include files are found.
        - doc updates.
        - update licenses, explicitly allow for GPL relicensing.

2.0  Sat Dec 22 17:47:03 CET 2007
        - new ev_sleep, ev_set_(io|timeout)_collect_interval.
        - removed epoll from embeddable fd set.
        - fix embed watchers.
        - renamed ev_embed.loop to other.
        - added exported Symbol tables.
        - undefine member wrapper macros at the end of ev.c.
        - respect EV_H in ev++.h.

1.86 Tue Dec 18 02:36:57 CET 2007
        - fix memleak on loop destroy (not relevant for perl).

1.85 Fri Dec 14 20:32:40 CET 2007
        - fix some aliasing issues w.r.t. timers and periodics
          (not relevant for perl).

(for historic versions refer to EV/Changes, found in the Perl interface)

0.1  Wed Oct 31 21:31:48 CET 2007
        - original version; hacked together in <24h.

Revision:	1.115
Committed:	Mon Jun 29 04:41:34 2009 UTC (14 years, 10 months ago) by root
Branch:	MAIN
Changes since 1.114:	+7 -0 lines
Log Message:	* empty log message *
#	User	Rev	Content
1	root	1.14	Revision history for libev, a high-performance and full-featured event loop.
2	root	1.1
3	root	1.114	TODO: ev_walk
4	root	1.115	TODO: child wactehr execution order w.r.t. childsigcb reg. priorities
5			TODO: remain
6			- Denis F. Latypoff corrected many typos in example code snippets.
7			- honor autoconf detection of EV_USE_CLOCK_SYSCALL, also double-
8			check that the syscall number is available before trying to
9			use it (reported by ry@tinyclouds).
10
11	root	1.113	3.6 Tue Apr 28 02:49:30 CEST 2009
12	root	1.107	- multiple timers becoming ready within an event loop iteration
13			will be invoked in the "correct" order now.
14	root	1.105	- do not leave the event loop early just because we have no active
15			watchers, fixing a problem when embedding a kqueue loop
16			that has active kernel events but no registered watchers
17			(reported by blacksand blacksand).
18	root	1.102	- correctly zero the idx values for arrays, so destroying and
19			reinitialising the default loop actually works (patch by
20			Malek Hadj-Ali).
21	root	1.108	- implement ev_suspend and ev_resume.
22	root	1.106	- new EV_CUSTOM revents flag for use by applications.
23	root	1.109	- add documentation section about priorites.
24			- add a glossary to the dcoumentation.
25	root	1.111	- extend the ev_fork description slightly.
26	root	1.112	- optimize a jump out of call_pending.
27	root	1.102
28	root	1.101	3.53 Sun Feb 15 02:38:20 CET 2009
29			- fix a bug in event pipe creation on win32 that would cause a
30			failed assertion on event loop creation (patch by Malek Hadj-Ali).
31	root	1.100	- probe for CLOCK_REALTIME support at runtime as well and fall
32			back to gettimeofday if there is an error, to support older
33			operating systems with newer header files/libraries.
34			- prefer gettimeofday over clock_gettime with USE_CLOCK_SYSCALL
35			(default most everywhere), otherwise not.
36
37	root	1.99	3.52 Wed Jan 7 21:43:02 CET 2009
38	root	1.97	- fix compilation of select backend in fd_set mode when NFDBITS is
39			missing (to get it to compile on QNX, reported by Rodrigo Campos).
40			- better select-nfds handling when select backend is in fd_set mode.
41			- diagnose fd_set overruns when select backend is in fd_set mode.
42			- due to a thinko, instead of disabling everything but
43			select on the borked OS X platform, everything but select was
44			allowed (reported by Emanuele Giaquinta).
45	root	1.95	- actually verify that local and remote port are matching in
46			libev's socketpair emulation, which makes denial-of-service
47			attacks harder (but not impossible - it's windows). Make sure
48	root	1.96	it even works under vista, which thinks that getpeer/sockname
49			should return fantasy port numbers.
50	root	1.100	- include "libev" in all assertion messages for potentially
51	root	1.97	clearer diagnostics.
52	root	1.98	- event_get_version (libevent compatibility) returned
53			a useless string instead of the expected version string
54			(patch by W.C.A. Wijngaards).
55	root	1.95
56	root	1.94	3.51 Wed Dec 24 23:00:11 CET 2008
57	root	1.91	- fix a bug where an inotify watcher was added twice, causing
58	root	1.92	freezes on hash collisions (reported and analysed by Graham Leggett).
59	root	1.87	- new config symbol, EV_USE_CLOCK_SYSCALL, to make libev use
60			a direct syscall - slower, but no dependency on librt et al.
61	root	1.88	- assume negative return values != -1 signals success of port_getn
62			(http://cvs.epicsol.org/cgi/viewcvs.cgi/epic5/source/newio.c?rev=1.52)
63			(no known failure reports, but it doesn't hurt).
64	root	1.93	- fork detection in ev_embed now stops and restarts the watcher
65			automatically.
66	root	1.89	- EXPERIMENTAL: default the method to operator () in ev++.h,
67			to make it nicer to use functors (requested by Benedek László).
68			- fixed const object callbacks in ev++.h.
69	root	1.90	- replaced loop_ref argument of watcher.set (loop) by a direct
70			ev_loop * in ev++.h, to avoid clashes with functor patch.
71	root	1.91	- do not try to watch the empty string via inotify.
72	root	1.92	- inotify watchers could be leaked under certain circumstances.
73			- OS X 10.5 is actually even more broken than earlier versions,
74			so fall back to select on that piece of garbage.
75	root	1.93	- fixed some weirdness in the ev_embed documentation.
76	root	1.87
77	root	1.86	3.49 Wed Nov 19 11:26:53 CET 2008
78	root	1.83	- ev_stat watchers will now use inotify as a mere hint on
79			kernels <2.6.25, or if the filesystem is not in the
80			"known to be good" list.
81	root	1.84	- better mingw32 compatibility (it's not as borked as native win32)
82			(analysed by Roger Pack).
83	root	1.85	- include stdio.h in the example program, as too many people are
84			confused by the weird C language otherwise. I guess the next thing
85			I get told is that the "..." ellipses in the examples don't compile
86			with their C compiler.
87	root	1.83
88	root	1.80	3.48 Thu Oct 30 09:02:37 CET 2008
89	root	1.71	- further optimise away the EPOLL_CTL_ADD/MOD combo in the epoll
90			backend by assuming the kernel event mask hasn't changed if
91			ADD fails with EEXIST.
92	root	1.75	- work around spurious event notification bugs in epoll by using
93	root	1.77	a 32-bit generation counter. recreate kernel state if we receive
94	root	1.78	spurious notifications or unwanted events. this is very costly,
95			but I didn't come up with this horrible design.
96	root	1.71	- use memset to initialise most arrays now and do away with the
97			init functions.
98	root	1.72	- expand time-out strategies into a "Be smart about timeouts" section.
99			- drop the "struct" from all ev_watcher declarations in the
100	root	1.73	documentation and did other clarifications (yeah, it was a mistake
101			to have a struct AND a function called ev_loop).
102	root	1.74	- fix a bug where ev_default would not initialise the default
103			loop again after it was destroyed with ev_default_destroy.
104	root	1.79	- rename syserr to ev_syserr to avoid name clashes when embedding,
105			do similar changes for event.c.
106	root	1.71
107	root	1.69	3.45 Tue Oct 21 21:59:26 CEST 2008
108	root	1.67	- disable inotify usage on linux <2.6.25, as it is broken
109			(reported by Yoann Vandoorselaere).
110			- ev_stat errornously would try to add inotify watchers
111	root	1.68	even when inotify wasn't available (this should only
112	root	1.67	have a performance impact).
113	root	1.65	- ev_once now passes both timeout and io to the callback if both
114			occur concurrently, instead of giving timeouts precedence.
115	root	1.66	- disable EV_USE_INOTIFY when sys/inotify.h is too old.
116	root	1.65
117	root	1.62	3.44 Mon Sep 29 05:18:39 CEST 2008
118			- embed watchers now automatically invoke ev_loop_fork on the
119			embedded loop when the parent loop forks.
120	root	1.58	- new function: ev_now_update (loop).
121	root	1.57	- verify_watcher was not marked static.
122	root	1.59	- improve the "associating..." manpage section.
123	root	1.60	- documentation tweaks here and there.
124	root	1.57
125	root	1.56	3.43 Sun Jul 6 05:34:41 CEST 2008
126	root	1.54	- include more include files on windows to get struct _stati64
127	root	1.56	(reported by Chris Hulbert, but doesn't quite fix his issue).
128	root	1.53	- add missing #include <io.h> in ev.c on windows (reported by
129			Matt Tolton).
130
131	root	1.52	3.42 Tue Jun 17 12:12:07 CEST 2008
132	root	1.50	- work around yet another windows bug: FD_SET actually adds fd's
133			multiple times to the fd_SET, despite official MSN docs claiming
134	root	1.51	otherwise. Reported and well-analysed by Matt Tolton.
135			- define NFDBITS to 0 when EV_SELECT_IS_WINSOCKET to make it compile
136	root	1.48	(reported any analysed by Chris Hulbert).
137	root	1.49	- fix a bug in ev_ebadf (this function is only used to catch
138			programming errors in the libev user). reported by Matt Tolton.
139			- fix a bug in fd_intern on win32 (could lead to compile errors
140			under some circumstances, but would work correctly if it compiles).
141			reported by Matt Tolton.
142	root	1.50	- (try to) work around missing lstat on windows.
143	root	1.45	- pass in the write fd set as except fd set under windows. windows
144	root	1.46	is so uncontrollably lame that it requires this. this means that
145			switching off oobinline is not supported (but tcp/ip doesn't
146			have oob, so that would be stupid anyways.
147	root	1.47	- use posix module symbol to auto-detect monotonic clock presence
148			and some other default values.
149	root	1.45
150	root	1.44	3.41 Fri May 23 18:42:54 CEST 2008
151	root	1.46	- work around an obscure bug in winsocket select: if you
152	root	1.40	provide only empty fd sets then select returns WSAEINVAL. how sucky.
153	root	1.41	- improve timer scheduling stability and reduce use of time_epsilon.
154	root	1.36	- use 1-based 2-heap for EV_MINIMAL, simplifies code, reduces
155			codesize and makes for better cache-efficiency.
156			- use 3-based 4-heap for !EV_MINIMAL. this makes better use
157			of cpu cache lines and gives better growth behaviour than
158			2-based heaps.
159	root	1.38	- cache timestamp within heap for !EV_MINIMAL, to avoid random
160			memory accesses.
161			- document/add EV_USE_4HEAP and EV_HEAP_CACHE_AT.
162	root	1.33	- fix a potential aliasing issue in ev_timer_again.
163	root	1.35	- add/document ev_periodic_at, retract direct access to ->at.
164			- improve ev_stat docs.
165			- add portability requirements section.
166	root	1.39	- fix manpage headers etc.
167	root	1.40	- normalise WSA error codes to lower range on windows.
168	root	1.43	- add consistency check code that can be called automatically
169			or on demand to check for internal structures (ev_loop_verify).
170	root	1.31
171	root	1.30	3.31 Wed Apr 16 20:45:04 CEST 2008
172			- added last minute fix for ev_poll.c by Brandon Black.
173	root	1.29
174	root	1.28	3.3 Wed Apr 16 19:04:10 CEST 2008
175	root	1.23	- event_base_loopexit should return 0 on success
176			(W.C.A. Wijngaards).
177	root	1.20	- added linux eventfd support.
178			- try to autodetect epoll and inotify support
179			by libc header version if not using autoconf.
180	root	1.21	- new symbols: EV_DEFAULT_UC and EV_DEFAULT_UC_.
181			- declare functions defined in ev.h as inline if
182			C99 or gcc are available.
183			- enable inlining with gcc versions 2 and 3.
184	root	1.25	- work around broken poll implementations potentially
185			not clearing revents field in ev_poll (Brandon Black)
186			(no such systems are known at this time).
187	root	1.23	- work around a bug in realloc on openbsd and darwin,
188			also makes the errornous valgrind complaints
189			go away (noted by various people).
190	root	1.26	- fix ev_async_pending, add c++ wrapper for ev_async
191			(based on patch sent by Johannes Deisenhofer.
192			- add sensible set method to ev::embed.
193	root	1.27	- made integer constants type int in ev.h.
194	root	1.20
195	root	1.19	3.2 Wed Apr 2 17:11:19 CEST 2008
196	root	1.15	- fix a 64 bit overflow issue in the select backend,
197			by using fd_mask instead of int for the mask.
198	root	1.16	- rename internal sighandler to avoid clash with very old perls.
199	root	1.18	- entering ev_loop will not clear the ONESHOT or NONBLOCKING
200			flags of any outer loops anymore.
201	root	1.17	- add ev_async_pending.
202	root	1.15
203	root	1.14	3.1 Thu Mar 13 13:45:22 CET 2008
204	root	1.12	- implement ev_async watchers.
205	root	1.10	- only initialise signal pipe on demand.
206			- make use of sig_atomic_t configurable.
207	root	1.14	- improved documentation.
208	root	1.10
209	root	1.9	3.0 Mon Jan 28 13:14:47 CET 2008
210	root	1.6	- API/ABI bump to version 3.0.
211	root	1.4	- ev++.h includes "ev.h" by default now, not <ev.h>.
212			- slightly improved documentation.
213	root	1.5	- speed up signal detection after a fork.
214	root	1.6	- only optionally return trace status changed in ev_child
215			watchers.
216	root	1.8	- experimental (and undocumented) loop wrappers for ev++.h.
217	root	1.4
218	root	1.2	2.01 Tue Dec 25 08:04:41 CET 2007
219	root	1.3	- separate Changes file.
220	root	1.2	- fix ev_path_set => ev_stat_set typo.
221			- remove event_compat.h from the libev tarball.
222			- change how include files are found.
223			- doc updates.
224			- update licenses, explicitly allow for GPL relicensing.
225
226			2.0 Sat Dec 22 17:47:03 CET 2007
227			- new ev_sleep, ev_set_(io\|timeout)_collect_interval.
228			- removed epoll from embeddable fd set.
229			- fix embed watchers.
230			- renamed ev_embed.loop to other.
231			- added exported Symbol tables.
232			- undefine member wrapper macros at the end of ev.c.
233			- respect EV_H in ev++.h.
234
235			1.86 Tue Dec 18 02:36:57 CET 2007
236			- fix memleak on loop destroy (not relevant for perl).
237
238			1.85 Fri Dec 14 20:32:40 CET 2007
239			- fix some aliasing issues w.r.t. timers and periodics
240			(not relevant for perl).
241
242			(for historic versions refer to EV/Changes, found in the Perl interface)
243
244	root	1.1	0.1 Wed Oct 31 21:31:48 CET 2007
245			- original version; hacked together in <24h.
246