Some javadocs for the PageCache and PageCursor.retry -> shouldRetry rename.
Fix a bug in the StandardPageCache

Concurrent PagedFile.flush calls could cause a BufferUnderflowException to be thrown,
because the position and limit of the underlying buffer of the page being flush, was
not accessed in a thread-safe way.