Date: Wed, 3 Nov 2004 19:45:31 -0200
From: Marcelo Tosatti <marcelo.tosatti@cyclades.com>
To: Jim Nelson <james4765@verizon.net>
Cc: linux-kernel@vger.kernel.org, akpm@osdl.org
Subject: Re: [PATCH 5/5] documentation: Remove drivers/char/README.cycladesZ
Message-ID: <20041103214530.GD4716@logos.cnet>
References: <20041103152246.24869.2759.68945@localhost.localdomain> <20041103152314.24869.56459.88722@localhost.localdomain> <20041103133103.GB4109@logos.cnet> <41891AF3.9050800@verizon.net> <20041103150947.GA4695@logos.cnet> <418955D2.7000700@verizon.net>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <418955D2.7000700@verizon.net>
User-Agent: Mutt/1.5.5.1i
Sender: linux-kernel-owner@vger.kernel.org
Content-Length: 1687
Lines: 41

On Wed, Nov 03, 2004 at 05:04:02PM -0500, Jim Nelson wrote:
> Marcelo Tosatti wrote:
> >On Wed, Nov 03, 2004 at 12:52:51PM -0500, Jim Nelson wrote:
> >
> >>You're right.  I'll send a patch to put README.cycladesZ in 
> >>Documentation/serial right now.
> >
> >
> >Also please only remove other README's if they are really obsolete. 
> >Whats your criteria for choosing what is obsolete?
> >
> 
> I erred on README.cycladesZ, I'll admit.  My apologies.  I normally contact 
> the maintainer *before* making a call like that.  Well, I'm kinda new to 
> this, and making mistakes is part of the process.

Sure, no problem. :)

> My unofficial "guidelines" for what needs to be looked at more closely 
> include: references to 2.0, 2.1, 2.2, 2.3, or 2.5 kernels, references to 
> external modules, dates of 2002 or earlier, or just a "wait a minute, I 
> don't think that's right". Not the prettiest technique, I know.

I think what your intention is good, we dont want obsolete files
which are not pertinent to v2.6 around - but you need to be careful. 

Old documents are not necessarily obsolete.

I would suggest sending all the patches to the respective maintainers,
removing only the ones which are _obviously_ obsolete (like the CyclomY 
which talks about upgrading from 2.0 to 2.2).

README.ecpa and README.scc, which you remove on your patches,
look valid and useful documentation to me. 

> >Move the rest to Documentation/serial, fine.
-
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/