in reply to
It looks like a well-written and very useful module.
Another very minor nitpick which you may even want to ignore depending on your preferences:
I noticed you took out the "our" vars created by h2xs, something that is important for compatibility with 5.005. I would also suggest removing the warnings pragma as well for the sake of backwards compatibility. I generally leave it commented so that if my module is still seeing general use several years from now I'll remember to put it back in.
I like your examples :-) Good examples are something I often find lacking in PODs.