remove controversial & undocumented deprecation
Merge pull request #508 from huitseeker/undocumented-deprecate

remove controversial & undocumented deprecation