Removing bad, misleading, hopelessly out of date API documentation

and leave pointers to more up to date documentation.