Messages in this thread | | | From | (Axel Boldt) | Subject | Updating Configure.help | Date | Mon, 11 Mar 1996 16:31:17 -0700 |
| |
Hi everyone,
you've probably all noticed the file Documentation/Configure.help which contains the help texts for the kernel config options used by the various configure scripts. Whenever you add a new config option, please take a minute to add an entry to Configure.help as well. A couple of things to keep in mind:
* The lines should be shorter than 70 characters, because menuconf likes it that way.
* Keep it simple, explain your acronyms, and give a "safe" value for those people who don't know what they are doing. Generally, the audience I have in mind consists of intelligent but ignorant new users who recompile the kernel for the first time.
* Don't be afraid to repeat things that have already been said in other help texts: the texts are not meant to be read in sequence.
* Technical information or stuff that's too long for a help text should go into a README in the Documentation directory.
* Please include pointers to all relevant HOWTOs or kernel source READMEs.
I'll continue spell-checking the file every once in a while, check the URLs, and fill in config options that slipped through, but obviously, I'd prefer it if every developer could take care of the texts for their own options. Thanks everyone.
==============================
And now for the off-topic part: the GNU-Linux debate. "Why can't we all just get a lawn?" I.e. let's all go out and buy a "Linux: the choice of a GNU generation" t-shirt. Then, whenever someone asks us about it, we can tell them not only the story about the Finnish student and his virtual beers, but also the one about the MIT hacker and his dream. Changing the name of the baby goes a little bit too far for my taste, mostly because the current name is so much sexier than the proposed alternatives.
Cheers, Axel
| |