documented custom indexing