Document deprecated functions
Document how to mark functions as deprecated (eg. @deprecated comment, E_DEPRECATED define). Add a list of functions deprecated by version? Reasons why and what should be used instead. Strategy for removing deprecated functions?