added deprecation warning at compile time
replaced '$i' with more meaningful variable names
documenting deprecation syntax more clearly
Merge pull request #13 from Financial-Times/deprecation-warnings

Deprecation warnings