updated api docs and fixed instanceof check, refs #816