From mboxrd@z Thu Jan 1 00:00:00 1970 From: Andrew Morton Date: Thu, 06 Jan 2011 21:16:59 +0000 Subject: Re: [RESEND #2] [PATCH v2] LEDS: Add output invertion option to Message-Id: <20110106131659.cedf8500.akpm@linux-foundation.org> List-Id: References: <201012091441.51846.jkrzyszt@tis.icnet.pl> <20110106130440.cfd77c8e.akpm@linux-foundation.org> <20110106130856.22b92a8b.randy.dunlap@oracle.com> In-Reply-To: <20110106130856.22b92a8b.randy.dunlap@oracle.com> MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit To: Randy Dunlap Cc: Janusz Krzysztofik , Richard Purdie , "linux-fbdev@vger.kernel.org" , linux-kernel@vger.kernel.org, "linux-omap@vger.kernel.org" , Paul Mundt On Thu, 6 Jan 2011 13:08:56 -0800 Randy Dunlap wrote: > On Thu, 6 Jan 2011 13:04:40 -0800 Andrew Morton wrote: > > > On Thu, 9 Dec 2010 14:41:50 +0100 > > Janusz Krzysztofik wrote: > > > > > +static DEVICE_ATTR(invert, 0644, bl_trig_invert_show, bl_trig_invert_store); > > > > This new sysfs file should be documented. Where would be an > > appropriate place for that? Documentation/leds-class.txt doesn't > > mention a sysfs API at all. > > -- > > in Documentation/ABI/, where all sysfs interface info lives. > Spose so. Documentation/ABI/stable/sysfs-class-backlight does have some stuff in it. Personally I tend to regard Documentation/ABI/ as fairly useless incomprehensible stuff, maintained to keep Greg happy ;) It'd be better to have a nice little well-maintained document for a subsystem such as this which actually explains its operation in a useful-to-humans way. Rather than just mechanically filling out forms. But a Documentation/ABI update is a heck of a lot better than nothing.