Subject: Re: Documentation: OMAPDSS: move sysfs documentation to ABI
To: Aishwarya Pant <aishpant@gmail.com>,
        Jonathan Corbet <corbet@lwn.net>, <linux-omap@vger.kernel.org>,
        <linux-fbdev@vger.kernel.org>, <linux-doc@vger.kernel.org>,
        <linux-kernel@vger.kernel.org>
CC: Julia Lawall <Julia.Lawall@lip6.fr>,
        Greg KH <gregkh@linuxfoundation.org>
References: <20180102085436.GA32637@mordor.localdomain>
From: Tomi Valkeinen <tomi.valkeinen@ti.com>
Message-ID: <3b9a14dd-ad04-e4ce-bc8f-dff7fa2a90cd@ti.com>
Date: Tue, 2 Jan 2018 12:16:18 +0200
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101
 Thunderbird/52.5.0
MIME-Version: 1.0
In-Reply-To: <20180102085436.GA32637@mordor.localdomain>
Content-Type: text/plain; charset="utf-8"
Content-Language: en-US
Content-Transfer-Encoding: 7bit
Sender: linux-kernel-owner@vger.kernel.org

Hi,

On 02/01/18 10:54, Aishwarya Pant wrote:
> Hi
> 
> In Documentation/arm/OMAP/DSS, there is a description of the DSS and FB sysfs
> interfaces which could be moved to Documentation/ABI.
> 
> Would such a change be useful? I can see that the sysfs interface is still in
> testing.
> 
> The ABI documentation format looks like the following:
> 
> What:          (the full sysfs path of the attribute)
> Date:          (date of creation)
> KernelVersion: (kernel version it first showed up in)
> Contact:       (primary contact)
> Description:   (long description on usage)
> 
> I am doing this in an exercise to move sysfs ABI interfaces (which are
> documented) to their right place i.e. in Documentation/ABI along with the rest.

The Documentation/arm/OMAP/DSS document is for omapfb driver, which is
deprecated by the omapdrm driver. I haven't maintained omapfb for some
time now, but I guess it still works ok. I hope we can drop omapfb at
some point in the future.

There probably are still omapfb users out there, so the ABI is valid,
but I'd say it's quite at the bottom of the priority list.

 Tomi

-- 
Texas Instruments Finland Oy, Porkkalankatu 22, 00180 Helsinki.
Y-tunnus/Business ID: 0615521-4. Kotipaikka/Domicile: Helsinki