more api doc fixes. refs #15