Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1946237AbWKJKCw (ORCPT ); Fri, 10 Nov 2006 05:02:52 -0500 Received: (majordomo@vger.kernel.org) by vger.kernel.org id S1946239AbWKJKCw (ORCPT ); Fri, 10 Nov 2006 05:02:52 -0500 Received: from mtagate2.de.ibm.com ([195.212.29.151]:65331 "EHLO mtagate2.de.ibm.com") by vger.kernel.org with ESMTP id S1946237AbWKJKCv (ORCPT ); Fri, 10 Nov 2006 05:02:51 -0500 In-Reply-To: <20061110065336.GA13646@kroah.com> Subject: Re: How to document dimension units for virtual files? To: Greg KH Cc: Ingo Oeser , linux-kernel@vger.kernel.org, mschwid2@de.ibm.com, pavel@ucw.cz, Randy Dunlap X-Mailer: Lotus Notes Build V70_M4_01112005 Beta 3NP January 11, 2005 Message-ID: From: Michael Holzheu Date: Fri, 10 Nov 2006 11:03:48 +0100 X-MIMETrack: Serialize by Router on D12ML061/12/M/IBM(Release 6.5.5HF607 | June 26, 2006) at 10/11/2006 11:05:52 MIME-Version: 1.0 Content-type: text/plain; charset=US-ASCII Sender: linux-kernel-owner@vger.kernel.org X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 1481 Lines: 42 Greg, Greg KH wrote on 11/10/2006 07:53:36 AM: > On Wed, Nov 08, 2006 at 07:27:56PM +0100, Michael Holzheu wrote: > > If you want to export data to userspace via a virtual filesystem > > like sysfs, the following rules are recommended: > > Um, does this mean you expect us to change all of the currently existing > sysfs file names? And people get mad at me when I just move sysfs > symlinks around... No, of course we should not change existing kernel interfaces. > Look at the hwmon drivers, and the documentation in > Documentation/hwmon/sysfs-interface for a description of how we have > been documenting this already. Yes, it is an option to document units in seperate files. But I personally think, that this is only the second best solution. Especially since normally documentation is not read. > > In short, I don't really think we need to encode the units in the file > name, somehow we have done pretty well without it so far :) Why not trying to make things better than they used to be? At least for our s390_hypfs I would like to use the suggested naming scheme. It is new and therefore not burdened with other naming conventions. Ok? So, no "Documentation/filesystems/ExportData" patch? Michael - To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/