From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from forward5o.cmail.yandex.net ([37.9.109.249]:48205 "EHLO forward5o.cmail.yandex.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1754019AbdL1SlR (ORCPT ); Thu, 28 Dec 2017 13:41:17 -0500 From: Ozgur To: Aishwarya Pant Cc: Alessandro Zummo , Alexandre Belloni , "linux-rtc@vger.kernel.org" , "linux-kernel@vger.kernel.org" , Julia Lawall , Jonathan Corbet , linux-api@vger.kernel.org In-Reply-To: <20171228150027.GA11300@mordor.localdomain> References: <20171228133132.GA3927@mordor.localdomain> <434381514470951@web50o.yandex.ru> <480511514471013@web35j.yandex.ru> <20171228150027.GA11300@mordor.localdomain> Subject: Re: rtc: sysfs: move sysfs interface to Documentation/ABI MIME-Version: 1.0 Message-Id: <4310831514485814@web18g.yandex.ru> Date: Thu, 28 Dec 2017 21:30:14 +0300 Content-Type: text/plain; charset=utf-8 Sender: linux-rtc-owner@vger.kernel.org List-ID: 28.12.2017, 18:00, "Aishwarya Pant" : > On Thu, Dec 28, 2017 at 05:23:33PM +0300, Ozgur wrote: >>  28.12.2017, 17:22, "Ozgur" : >>  > 28.12.2017, 16:31, "Aishwarya Pant" : >>  >>  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