On Tue, Aug 9, 2016 at 10:22 AM, Christoph Hellwig <hch@xxxxxxxxxxxxx> wrote: > On Tue, Aug 09, 2016 at 11:19:50AM +0300, Jani Nikula wrote: >> On Tue, 09 Aug 2016, Christoph Hellwig <hch@xxxxxxxxxxxxx> wrote: >> > The ugly format is a major regression over a proper simple text >> > file. What's the point? >> >> Major regression? Please be reasonable. >> >> I think the changes are rather small, and it's a fair compromise between >> a simple text file and one that can be used to generate pretty >> documentation [1]. > > It's a lot less pretty to read - it look like a cat threw up to be > specific. The point of the Document is to read it quickly in the kernel > tree. If you want fancy websites write a separate document. > >> [1] http://static.lwn.net/kerneldoc/dev-tools/sparse.html > > And I wouldn't exactly call that pretty. There is no value add > over a simple text file here, and it requires a browser to not look > ugly instead of a text editor, which is a giant usablity regression. The point is to make the docs more discoverable by being able to cross-link them. Old hats like us don't need that, but it definitely has value in bringing new folks on board. And yes I want that, at least for everything that's at least half-relevant to drm/gpu/i915 topics. And given that we just started on a large-scale effort to roll out rcu in our driver (besides all the other bits we're using) that's pretty much everything. -Daniel -- Daniel Vetter Software Engineer, Intel Corporation +41 (0) 79 365 57 48 - http://blog.ffwll.ch -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
