Re: [PATCH 5/5] documentation: Remove drivers/char/README.cycladesZ

From: Jim Nelson
Date: Thu Nov 04 2004 - 10:42:52 EST


Marcelo Tosatti wrote:

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.


README.ecpa has been unchanged since at least 2.4.18, and the maintainer is no longer maintaining it in-kernel for 2.6. Digi has a maintained version on their website. The document details the user-space programs needed for firmware loading, and the version at Digi's website is maintained.

README.scc is fundamentally unchanged since at least 2.2.20. That's my reason for removing it. The file it points to was also last updated in the 2.2 kernel series - I need to get a more complete LXR setup here at home to pin it down more accurately. It's for an AX.25 network adapter, and has no need to be in drivers/char.


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@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/