API documentation

First big effort to document the API
removed unused method 'daystack'