[PATCH 0/5] Improve buffer head documentation

From: Matthew Wilcox (Oracle)
Date: Thu Jan 04 2024 - 11:37:21 EST


Having started improving the kernel-doc for __folio_mark_dirty(), I
then started noticing other improvements that could be made, and this
is as far as I got before deciding I'd made enough for now. Tested with
make htmldocs.

Matthew Wilcox (Oracle) (5):
doc: Improve the description of __folio_mark_dirty
buffer: Add kernel-doc for block_dirty_folio()
buffer: Add kernel-doc for try_to_free_buffers()
buffer: Fix __bread() kernel-doc
doc: Split buffer.rst out of api-summary.rst

Documentation/filesystems/api-summary.rst | 3 -
Documentation/filesystems/index.rst | 1 +
fs/buffer.c | 98 +++++++++++++----------
include/linux/buffer_head.h | 17 ++--
mm/page-writeback.c | 14 ++--
5 files changed, 74 insertions(+), 59 deletions(-)

--
2.43.0