nice api on all methods; refs #3