On Wed, 17 Feb 2016 12:04:29 -0500 Tejun Heo <tj@xxxxxxxxxx> wrote: > idk, istr this coming up some months ago and there really weren't good > arguments for furthering out-of-line generated docs. I'm sure there > are people building and checking for errors but that doesn't indicate > the actual usefulness or that we shouldn't move away from it. This might come as a real surprise to the subsystems that are putting a lot of work into said docs. *You* might not find them useful but, for example, the DRM folks have told me that they credit better docs with an increase in the quality of the code submissions they are getting. Much of that work is inline, but in the code is not always the best place for everything. There's a set of us working to improve the generation system, making it so that even ordinary kernel developers can manage to get it to work. Sorry if you don't this stuff useful, but I hope you'll not mind if others keep the documentation in good form? In the case that started this discussion, it's the out-of-line generation that raises the alarm when things do go out of sync, helping to keep the docs current. jon -- To unsubscribe from this list: send the line "unsubscribe linux-block" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
