clarify the current state of the DiskFile API

Change-Id: Ia3d62c53d14c9a5efdb9a39b08817320cf331085