2018-01-02 08:54:46

by Aishwarya Pant

[permalink] [raw]
Subject: Documentation: OMAPDSS: move sysfs documentation to ABI

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.

Aishwarya


2018-01-02 10:17:24

by Tomi Valkeinen

[permalink] [raw]
Subject: Re: Documentation: OMAPDSS: move sysfs documentation to ABI

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

2018-01-02 10:56:31

by Aishwarya Pant

[permalink] [raw]
Subject: Re: Documentation: OMAPDSS: move sysfs documentation to ABI

On Tue, Jan 02, 2018 at 12:16:18PM +0200, Tomi Valkeinen wrote:
> 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.

All right, I will drop this then.

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