fixed spelling mistakes
refactored methods into the same order as documented in the header. Documented private methods in private interface.
updated warning about deprecated methods