From: Vincent Pit Date: Sun, 28 Sep 2014 15:34:50 +0000 (+0200) Subject: Be more precise about the hook timing with regards to END blocks X-Git-Tag: v0.06~2 X-Git-Url: http://git.vpit.fr/?a=commitdiff_plain;h=95f8377579dd625843dcace2463165ae5a8c8282;p=perl%2Fmodules%2FThread-Cleanup.git Be more precise about the hook timing with regards to END blocks --- diff --git a/lib/Thread/Cleanup.pm b/lib/Thread/Cleanup.pm index 1a51b89..c09372c 100644 --- a/lib/Thread/Cleanup.pm +++ b/lib/Thread/Cleanup.pm @@ -49,22 +49,26 @@ The hook will also be called when pseudo-forks (i.e. processes spawn on Windows register { ... }; ®ister($coderef); -Specify that the given block or code reference C<$coderef> will have to be called (in void context, without arguments) every time a thread finishes its job. -More precisely, +Specify that the given block or code reference C<$coderef> will have to be called (in void context, without arguments) every time a thread or a pseudo-fork terminates. +More precisely : =over 4 =item * -it will always be called before the joining for joined threads ; +For joined threads, it will be called when C succeeds, after any C block local to the spawn thread ; =item * -it will be called for detached threads if and only if they terminate before the main thread, and the hook will then fire at C time ; +For detached threads, it will be called if and only if the thread terminates before the main thread, and the hook will then fire at global C time ; =item * -it won't trigger for the destruction of the main thread. +For pseudo-forks, it will be called when C succeeds, after any C block local to the spawn process but before any global C block ; + +=item * + +It will never trigger for the destruction of the main thread. =back