explain autoIndex

I had to read the code to figure if `autoIndex` did what I hoped it did, so I updated the documentation to explain more clearly.

It might be good if `autoIndex` was enabled by default.
I think the cases where you want that behaviour outnumber the cases where you don't.