better doco for obsoletes