better docs, tidied up API. still needs tests.