> Actually, how about: > > * If the folio has buffers, the uptodate buffers are set dirty, to > * preserve dirty-state coherency between the folio and the buffers. > * Buffers added to a dirty folio are created dirty. This looks good to me :) > > I considered deleting the sentence entirely as it's not actually related > to what the function does; it's just a note about how the buffer cache > behaves. That said, information about how buffer heds work is scant > enough that I don't want to delete it.