Re: rtc: sysfs: move sysfs interface to Documentation/ABI

[Ozgur]

28.12.2017, 18:00, "Aishwarya Pant" <aishpant@xxxxxxxxx>:
> On Thu, Dec 28, 2017 at 05:23:33PM +0300, Ozgur wrote:
>> Â28.12.2017, 17:22, "Ozgur" <okaratas@xxxxxxxxxx>:
>> Â> 28.12.2017, 16:31, "Aishwarya Pant" <aishpant@xxxxxxxxx>:
>> Â>> ÂHi
>>
>> ÂÂHello,
>>
>> Â>> ÂIn Documentation/rtc.txt, there is a description of the sysfs
>> Â>> Âinterface which could be moved to Documentation/ABI.
>> Â>>
>> Â>> ÂWould such a change be useful?
>> Â>>
>> Â>> Â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.
>>
>> ÂÂDo I understand right? Are you want to make the rtc.txt part the same format as ABI folder?
>> ÂÂfor example create to RTC folder and add /dev/rtc what, date, kernelversion, contact right?
>
> Yes I mentioned just the sysfs interface. But both ioctl and sysfs interface
> should be there in Documentation/ABI. There could a new file called sysfs-rtc in
> Documentation/ABI/stable with both these interfaces.

Hello,

I think the ABI maintainer is API group but I think you have contact to linux documentation team. 
maybe, Greg provide a  give information:

>> ÂÂThis can be a good idea and I can help.
>
> Sure thanks. I can maybe send a patch with these changes.
>
> One question: who should be the primary contact for this ABI?

I add linux-api mailing lists. So, please send a your patch linux-kernel and linux-api mailing lists.

Ozgur

>> Â>> ÂAishwarya
>>
>> ÂOzgur