Help messages, api cleanup

adjusted help mesages
cleaned up the interanl api (why return a partial when you can return
the endpoint?)