From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1759475AbYBRKhd (ORCPT ); Mon, 18 Feb 2008 05:37:33 -0500 Received: (majordomo@vger.kernel.org) by vger.kernel.org id S1756750AbYBRKh0 (ORCPT ); Mon, 18 Feb 2008 05:37:26 -0500 Received: from E23SMTP05.au.ibm.com ([202.81.18.174]:59862 "EHLO e23smtp05.au.ibm.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751783AbYBRKhZ (ORCPT ); Mon, 18 Feb 2008 05:37:25 -0500 Message-ID: <47B95EDB.1020400@linux.vnet.ibm.com> Date: Mon, 18 Feb 2008 16:02:59 +0530 From: Balbir Singh Reply-To: balbir@linux.vnet.ibm.com Organization: IBM User-Agent: Thunderbird 2.0.0.9 (X11/20071115) MIME-Version: 1.0 To: Paul Menage CC: Li Zefan , balbir@in.ibm.com, pj@sgi.com, Pavel Emelianov , KAMEZAWA Hiroyuki , vatsa@linux.vnet.ibm.com, akpm@linux-foundation.org, containers@lists.linux-foundation.org, linux-kernel@vger.kernel.org Subject: Re: [RFC][PATCH 1/7] CGroup API: Add cgroup.api control file References: <20080215204418.535025000@menage.corp.google.com> <20080215204820.734926000@menage.corp.google.com> <47B6B5CA.7040201@linux.vnet.ibm.com> <6599ad830802160944v6d529570k1ade6df273ca3d0d@mail.gmail.com> <47B953A8.9030206@cn.fujitsu.com> In-Reply-To: <47B953A8.9030206@cn.fujitsu.com> Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Li Zefan wrote: > Paul Menage wrote: >> On Feb 16, 2008 2:07 AM, Balbir Singh wrote: >>> Paul Menage wrote: >>> >>> Hi, Paul, >>> >>> Do we need to use a cgroup.api file? Why not keep up to date documentation and >>> get users to use that. I fear that, cgroup.api will not be kept up-to-date, >>> leading to confusion. >> The cgroup.api file isn't meant to give complete documentation for a >> control file, simply a brief indication of its usage. >> > > But we don't have /proc/proc.api or /sys/sysfs.api ... > Yes, doing that would make the size of the kernel go out of control. >> The aim is that most bits of the information reported in cgroup.api >> are auto-generated, so there shouldn't be problems with it getting >> out-of-date. >> >> Is it just the space used by the documentation string that you're >> objecting to? The other function of the file is to declare a type for >> each variable. >> I like the documentation aspect, it is the space that I object to. -- Warm Regards, Balbir Singh Linux Technology Center IBM, ISTL