- This magic is called when an object is destroyed as the result of
- the variable going out of scope (but not when the variable is
- undefined).
+ This magic is called when a variable is destroyed as the result of
+ going out of scope (but not when it is undefined). It behaves
+ roughly like Perl object destructors (i.e. "DESTROY" methods),
+ except that exceptions thrown from inside a *free* callback will
+ always be propagated to the surrounding code.