Return-Path: <linux-kernel-owner+willy=40w.ods.org@vger.kernel.org>
Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand
	id <S261847AbSJ2PEW>; Tue, 29 Oct 2002 10:04:22 -0500
Received: (majordomo@vger.kernel.org) by vger.kernel.org
	id <S261850AbSJ2PEW>; Tue, 29 Oct 2002 10:04:22 -0500
Received: from e35.co.us.ibm.com ([32.97.110.133]:47550 "EHLO
	e35.co.us.ibm.com") by vger.kernel.org with ESMTP
	id <S261847AbSJ2PEV>; Tue, 29 Oct 2002 10:04:21 -0500
Subject: Re: [Lse-tech] Re: [PATCH] Updated sys_epoll now with man pages
From: Paul Larson <plars@linuxtestproject.org>
To: "Randy.Dunlap" <rddunlap@osdl.org>
Cc: Andrew Morton <akpm@digeo.com>, Hanna Linder <hannal@us.ibm.com>,
       Linus Torvalds <torvalds@transmeta.com>,
       Davide Libenzi <davidel@xmailserver.org>,
       Jamie Lokier <lk@tantalophile.demon.co.uk>,
       Linux Kernel Mailing List <linux-kernel@vger.kernel.org>,
       lse-tech <lse-tech@lists.sourceforge.net>, ahu@ds9a.nl
In-Reply-To: <Pine.LNX.4.33L2.0210282121560.13581-100000@dragon.pdx.osdl.net>
References: <Pine.LNX.4.33L2.0210282121560.13581-100000@dragon.pdx.osdl.net>
Content-Type: text/plain
Content-Transfer-Encoding: 7bit
X-Mailer: Ximian Evolution 1.0.5 
Date: 29 Oct 2002 08:59:47 -0600
Message-Id: <1035903591.5646.284.camel@plars>
Mime-Version: 1.0
Sender: linux-kernel-owner@vger.kernel.org
X-Mailing-List: linux-kernel@vger.kernel.org
Content-Length: 966
Lines: 21

On Mon, 2002-10-28 at 23:28, Randy.Dunlap wrote:
> I expect this to be unpopular, but I've been saying lately that
> when new kernel APIs or syscalls or whatsoever are added to
> Linux, there should be sufficient docs along with the patch(es)
> explaining the patch and some intended uses of it, perhaps even
> with examples.  Ingo does this sometimes.  Some people don't
> bother to even come close.
It would be great to see more people doing that, also releasing docs
about intentions beforehand (rfc's and such) would be nice to see too. 
As far as example programs go, cc'ing the Linux Test Project at
ltp-list@lists.sourceforge.net would be a really nice thing too and make
you very popular! :)

Thanks,
Paul Larson

-
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/