Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id ; Tue, 11 Dec 2001 08:59:54 -0500 Received: (majordomo@vger.kernel.org) by vger.kernel.org id ; Tue, 11 Dec 2001 08:59:34 -0500 Received: from garrincha.netbank.com.br ([200.203.199.88]:28424 "HELO netbank.com.br") by vger.kernel.org with SMTP id ; Tue, 11 Dec 2001 08:59:22 -0500 Date: Tue, 11 Dec 2001 11:59:06 -0200 (BRST) From: Rik van Riel X-X-Sender: To: Andrea Arcangeli Cc: Andrew Morton , Marcelo Tosatti , lkml Subject: Re: 2.4.16 & OOM killer screw up (fwd) In-Reply-To: <20011211144223.E4801@athlon.random> Message-ID: X-spambait: aardvark@kernelnewbies.org X-spammeplease: aardvark@nl.linux.org 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 On Tue, 11 Dec 2001, Andrea Arcangeli wrote: > > The VM code lacks comments, and nobody except yourself understands > > what it is supposed to be doing. That's a bug, don't you think? > > Lack of documentation is not a bug, period. Also it's not true that > I'm the only one who understands it. Without documentation, you can only know what the code does, never what it is supposed to do or why it does it. This makes fixing problems a lot harder, especially since people will never agree on what a piece of code is supposed to do. regards, Rik -- Shortwave goes a long way: irc.starchat.net #swl http://www.surriel.com/ http://distro.conectiva.com/ - 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/