This module generalises the mechanism of the wantarray
function, allowing a function to determine in some detail
how its return value is going to be immediately used.

Author: Robin Houston,

Thanks to Damian Conway for encouragement and good suggestions.