docs: Improve ->read_folio documentation
authorMatthew Wilcox (Oracle) <willy@infradead.org>
Fri, 29 Apr 2022 12:45:43 +0000 (08:45 -0400)
committerMatthew Wilcox (Oracle) <willy@infradead.org>
Wed, 29 Jun 2022 12:51:06 +0000 (08:51 -0400)
commit90c02eb9a76c16427d644927a0de86600ad5ef85
tree48868035aea279e803f14d3a004eac50809b92cc
parent290e1a320437011fc4f26456ab45eaebf9e44f5e
docs: Improve ->read_folio documentation

Add information on the use of 'file', whether ->read_folio should be
synchronous, and steer new callers towards calling read_mapping_folio()
instead of calling ->read_folio directly.

Signed-off-by: Matthew Wilcox (Oracle) <willy@infradead.org>
Documentation/filesystems/vfs.rst