Implement a way to mark a public API as deprecated

[jcouball]

Have the ability for the developer to indicate deprecated methods.

Calling deprecated methods (by default) should output a STDERR warning message saying that the deprecated method was called and what line of code called it.

The user of the gem should have the ability to suppress the warning messages or to raise an error when a deprecated method is called.