Not sure what you're saying here. That documentation is accurate, I re-read your suggestions and it makes no sense to say "file" as you aren't adding a file (conceptually). You are adding an index entry… by a relative path.