Matthew Wilcox <willy@xxxxxxxxxxxxx> writes: > The rust code is alredy coming though ... > > rust/kernel/buffer.rs:/// A pre-allocated buffer that implements [`core::fmt::Write`]. > > so now we have three formats. Markdown and RST are _very_ similar, but > not identical [1]. Oh, and even better we now have three distinct tools -- > kerneldoc, rustdoc and sphinx. Have the rust people reached out to you > about integrating the various docs? I have talked with them a bit, yes, but without any clear conclusions at this point. The Rust world has its own way of doing things with regard to documentation, and I don't want to tell them they can't use it in the kernel context. So I think there's going to be a certain amount of groping around for the best solution. We did come to the mutual agreement that teaching kernel-doc to parse Rust code as well was not an ideal solution. Probably there will be some sort of tool to translate between rustdoc and our sphinx setup. Beyond that, we'll see how it goes. jon
