C<clear>
-This magic is invoked when the variable is reset, such as when an array is emptied.
+This magic is invoked when a container variable is reset, i.e. when an array or a hash is emptied.
Please note that this is different from undefining the variable, even though the magic is called when the clearing is a result of the undefine (e.g. for an array, but actually a bug prevent it to work before perl 5.9.5 - see the L<history|/PERL MAGIC HISTORY>).
=item *