On Wed, Feb 17, 2016 at 10:57:21AM -0500, Tejun Heo wrote:
> On Fri, Feb 12, 2016 at 12:35:02AM +0000, Mark Brown wrote:

> > If it's something that gets included in a generated document then people
> > will tell you pretty quickly if it gets out of sync these days, 0day
> > notices and there's people sending fixes quite frequently.

> Haven't generated docs turned out to be mostly pointless?  I think it
> makes a lot more sense to write comments so that they're more
> accessible in-line.

I personally find very little value in them but there are definitely
people who care about them judging by the patches I get when they go out
of sync.