rename

Renames source file to dest file where dest must not already exist in the directory.

It is permitted for this operation to not be truly atomic, for example both source and dest can be visible temporarily in .listAll. However, the implementation of this method must ensure the content of dest appears as the entire source atomically. So once dest is visible for readers, the entire content of previous source is visible.

This method is used by IndexWriter to publish commits.