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

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite for Android: free password hash cracker in your pocket

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Date:   Mon, 18 Mar 2019 14:34:30 +1100
From:   "Tobin C. Harding" <me@...in.cc>
To:     Randy Dunlap <rdunlap@...radead.org>
Cc:     "Tobin C. Harding" <tobin@...nel.org>,
        Jonathan Corbet <corbet@....net>, linux-doc@...r.kernel.org,
        linux-fsdevel@...r.kernel.org, linux-kernel@...r.kernel.org
Subject: Re: [PATCH 00/13] Convert vfs.txt to vfs.rst

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@...radead.org>

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.