Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1753533AbdL1PAg (ORCPT ); Thu, 28 Dec 2017 10:00:36 -0500 Received: from mail-pf0-f193.google.com ([209.85.192.193]:42542 "EHLO mail-pf0-f193.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1753293AbdL1PAe (ORCPT ); Thu, 28 Dec 2017 10:00:34 -0500 X-Google-Smtp-Source: ACJfBosf+8czJ6qrb0laohlHXgOYDgIOhpXQFjAKQN+WZddHqLAU6fkoAxzuCyAq1i+0pVAvIEOt/g== Date: Thu, 28 Dec 2017 20:30:27 +0530 From: Aishwarya Pant To: Ozgur Cc: Alessandro Zummo , Alexandre Belloni , "linux-rtc@vger.kernel.org" , "linux-kernel@vger.kernel.org" , Julia Lawall , Jonathan Corbet Subject: Re: rtc: sysfs: move sysfs interface to Documentation/ABI Message-ID: <20171228150027.GA11300@mordor.localdomain> References: <20171228133132.GA3927@mordor.localdomain> <434381514470951@web50o.yandex.ru> <480511514471013@web35j.yandex.ru> MIME-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: <480511514471013@web35j.yandex.ru> User-Agent: Mutt/1.9.2 (2017-12-15) Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 1435 Lines: 43 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. > > 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? > > >> ?Aishwarya > > Ozgur