On Mon, Feb 06, 2017 at 09:02:32PM +0000, Anthony Youngman wrote: > > > On 06/02/17 19:23, Shaohua Li wrote: > > I'm starting document of the raid5-cache feature. Please note this is a > > kernel doc instead of a mdadm manual, so I don't add the details about > > how to use the feature in mdadm side. Please let me know what else we > > should put into the document. Of course, comments are welcome! > > > > Signed-off-by: Shaohua Li <shli@xxxxxx> > > --- > > Documentation/md/raid5-cache.txt | 109 +++++++++++++++++++++++++++++++++++++++ > > 1 file changed, 109 insertions(+) > > create mode 100644 Documentation/md/raid5-cache.txt > > Note that the kernel documentation is moving over to a new format - .rst. > They're using a new system called Sphinx. There was an article on lwn about > it. I've lost the reference to lwn, but if you look at > https://www.kernel.org/doc/html/latest/ you will see that it is a match to > Documentation/index.rst. > > So of course, converting all the md stuff has made its way onto my "to do" > list, but I don't want to start until I've got a converted kernel running on > my system. I'm currently running 4.4.6 and I think it came out with > something like 4.6. Problem is, running gentoo, my system is well out of > date because I need a helper system to get me to upgrade and going from KDE4 > to KDE5 is likely to give me grief :-) > > You're probably working with an up-to-date kernel, but it's up to you - do > you want to create a .rst file, or submit it as .txt and let me convert it > and go through the grief of working out how to do it :-). Conversion is > probably rather more than just converting the one file, it'll need > converting the directory structure too, I expect. Any problems, Jon Corbet's > probably our go-to guy. Yep, I saw some directories are converted to .rst, but most not yet. I'll commit this as-is if nobody objects, being lazy to learn/install the rst stuffes :). It would be great you can help convert the md directory to new format, but I don't think it's in a hurry. Thanks, Shaohua -- To unsubscribe from this list: send the line "unsubscribe linux-raid" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
