I understand that there are historical reasons for these APIs, but again, this can be fixed with proper documentation (perhaps a page describing all of the APIs and their benefits and drawbacks). 5) Addition of new APIs in new OS versions. I know Apple wants to sell new OS versions, ...