rev. readme, fix index funcs