apichange: remove: hy_goal_package_obsoletes().

Lot less general than hy_goal_package_all_obsoletes().
rename: hy_goal_package_all_obsoletes() -> hy_goal_list_obsoleted_by_package().

doc: document the overall API changes in this area.