documented index failures. fixes #643