Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1754885AbdL1SaY (ORCPT ); Thu, 28 Dec 2017 13:30:24 -0500 Received: from forward5o.cmail.yandex.net ([37.9.109.249]:45929 "EHLO forward5o.cmail.yandex.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1754330AbdL1SaS (ORCPT ); Thu, 28 Dec 2017 13:30:18 -0500 Authentication-Results: mxback8j.mail.yandex.net; dkim=pass header.i=@yandex.com.tr From: Ozgur Envelope-From: okaratas@yandex.com.tr 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> X-Mailer: Yamail [ http://yandex.ru ] 5.0 Date: Thu, 28 Dec 2017 21:30:14 +0300 Content-Transfer-Encoding: 8bit Content-Type: text/plain; charset=utf-8 Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 1846 Lines: 51 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