From: Vincent Pit <vince@profvince.com>
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/?p=perl%2Fmodules%2FThread-Cleanup.git;a=commitdiff_plain;h=95f8377579dd625843dcace2463165ae5a8c8282

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 { ... };
     &register($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<join> succeeds, after any C<END> 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<END> 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<END> time ;
 
 =item *
 
-it won't trigger for the destruction of the main thread.
+For pseudo-forks, it will be called when C<waitpid> succeeds, after any C<END> block local to the spawn process but before any global C<END> block ;
+
+=item *
+
+It will never trigger for the destruction of the main thread.
 
 =back