Re: [PATCH 00/13] Convert vfs.txt to vfs.rst

From: Tobin C. Harding
Date: Sun Mar 17 2019 - 23:34:58 EST


On Sun, Mar 17, 2019 at 06:46:40PM -0700, Randy Dunlap wrote:
> On 3/12/19 9:09 PM, Tobin C. Harding wrote:
> > Hi,
> >
> > This set converts the VFS overview documentation to RST format. I think
> > I'm slowly getting better at structuring these conversions to ease
> > review, if you disagree or you notice any way to further improve please
> > say so.
>
> Hi Tobin,
>
> What does this patch set apply to? Maybe Jon's git tree?

I did this on top of Jon's tree before rc-1 came out (so during the
merge window last week). I can rebase and fire off another version if
its easier for you Jon.

> I applied it to 5.1-rc1 with some forceful (minor) editing and ran
> 'make htmldocs' successfully, so
>
> Tested-by: Randy Dunlap <rdunlap@xxxxxxxxxxxxx>

Thanks Randy.

> although there is at least one new field in struct file_operations: iopoll.

I purposely kept the conversion separate from the update. Most of this
file explicitly states the kernel version each struct documented is for
(and at least two of them are 2.6.22).

One reason for the separation is that this set should be reviewable by
'docs' folk without having to be too closely looked at by anyone from
filesystems but the update will most likely benefit from at least a
cursory look over by someone from filesystems.

I have started the update to v5.20 but its slow going because I don't
know the VFS. I'm learning as I go, I should have something together
soon.

thanks,
Tobin.