2001-07-05 10:37:10

by Matthias Andree

[permalink] [raw]
Subject: Linux 2.4.6 Configure.help incomplete :-(

There are still a lot of help texts missing from Configure.help,
CONFIG_AIC7XXXX_BUILD_FIRMWARE to name just one example.

I'm pretty annoyed by RELEASE versions that don't have all options
documented. If a module doesn't come with proper documentation for all
its options, drop it.

How is a non-hacker supposed to configure the kernel if he doesn't even
have the faintest clue about the options?

Linux is the system with the worst official documentation anyhow,
compared to the "monolithic" BSD variants.

I appreciate efforts by ESR to get the documentation complete, but
evidently, the "good" way not enough.

A complex system without proper documentation is worth _nothing_.

--
Matthias Andree


2001-07-19 20:08:57

by Pavel Machek

[permalink] [raw]
Subject: Re: Linux 2.4.6 Configure.help incomplete :-(

Hi!

> There are still a lot of help texts missing from Configure.help,
> CONFIG_AIC7XXXX_BUILD_FIRMWARE to name just one example.
>
> I'm pretty annoyed by RELEASE versions that don't have all options
> documented. If a module doesn't come with proper documentation for all
> its options, drop it.

Ugh?

Configure.help is *very* minor thing, and it should not interfere with
kernel development. It will not corrupt your data. Will not make your
kernel unstable. Etc.

> How is a non-hacker supposed to configure the kernel if he doesn't even
> have the faintest clue about the options?

How many non-hackers have you seen confused by that particular option?

Pavel
--
Philips Velo 1: 1"x4"x8", 300gram, 60, 12MB, 40bogomips, linux, mutt,
details at http://atrey.karlin.mff.cuni.cz/~pavel/velo/index.html.