Re: [PATCH v4 0/9] docs: Convert VFS doc to RST
From: Jonathan Corbet <corbet@lwn.net>
Date: 2019-05-29 22:30:58
Also in:
linux-fsdevel, lkml
On Wed, 15 May 2019 10:29:04 +1000 "Tobin C. Harding" [off-list ref] wrote:
Here is an updated version of the VFS doc conversion. This series in no way represents a final point for the VFS documentation rather it is a small step towards getting VFS docs updated. This series does not update the content of vfs.txt, only does formatting.
I've finally gotten to this, sorry for taking so long. Applying it to docs-next turned out to be a bit of a chore; there have been intervening changes to vfs.txt that we didn't want to lose. But I did it. Unfortunately, there's still a remaining issue. You did a lot of list conversions like this:
- struct file_system_type *fs_type: describes the filesystem, partly initialized +``struct file_system_type *fs_type``: describes the filesystem, partly initialized by the specific filesystem code
but that does not render the way you would like, trust me. You really
want to use the list format, something like:
``struct file_system_type *fs_type``
describes the filesystem, partly initialized by the specific
filesystem code
There are, unfortunately, a lot of these to fix... I bet it could be done
with an elisp function, but I don't have time to beat my head against that
wall right now.
Any chance you would have time to send me a followup patch fixing these
up? I'll keep my branch with this set for now so there's no need to
rebase those.
Thanks,
jon