updated the API doc, and extended the API a bit
implemented some more test stuff