more doco
fixup bat tests