minor change in API and addition of coverage docblocks