Another thing to look at (for marking methods as deprecated) is Attributes. I myself have never used them, but I think attributes might be an elegant solution to this problem. See Attribute::Handlers and perlsub.