From: Bodo Eggert <7eggert@gmx.de>
To: linux-kernel@vger.kernel.org
Cc: linux-scsi@vger.kernel.org, netdev@vger.kernel.org
Subject: Bad escriptions in Kconfig
Date: Mon, 31 Dec 2007 13:26:32 +0100 (CET) [thread overview]
Message-ID: <alpine.LSU.0.999.0712311313050.3761@be1.lrz> (raw)
In some of the Kconfig files, the options are not adequately decribed. I
collected a few of the bad descriptions I found:
---
Lowlevel video output switch controls (VIDEO_OUTPUT_CONTROL) [M/n/y/?] (NEW) ?
This framework adds support for low-level control of the video
output switch.
---
- What is THE video output switch and why would I need low level control?
- Frameworks should be auto-selected like libraries, shouldn't they?
- WTF is this a module?
-------------
---
Auxiliary Display support (AUXDISPLAY) [N/y/?] (NEW) ?
Say Y here to get to see options for auxiliary display drivers.
This option alone does not add any kernel code.
---
- If I knw what an axilary display was, I would not read this help text!
- After digging some time, I discovered that all Auxdisplays are parallel
port devices.
Rename to "Parallel port display device support"?
-------------
---
Transformation user configuration interface (XFRM_USER) [N/m/y/?] (NEW)
Support for Transformation(XFRM) user configuration interface
like IPsec used by native Linux tools.
If unsure, say Y.
---
- I'm not sure if these words combine to a sentence.
- I can't tell if IPSEC is the only user or if I'd break other parts by not
saying 'Y'. OTOH, I don't want to bloat my kernel ...
- What's a native linux tool?
-------------
---
SCSI target support (SCSI_TGT) [N/m/y/?] (NEW) ?
If you want to use SCSI target mode drivers enable this option.
If you choose M, the module will be called scsi_tgt.
---
What TF is a SCSI target mode, what is a target mode driver?
--
I'm a member of DNA (National Assocciation of Dyslexics).
-- Storm in <5Z4Z7.52353$4x4.6445347@news2-win.server.ntlworld.com>
next reply other threads:[~2007-12-31 12:26 UTC|newest]
Thread overview: 5+ messages / expand[flat|nested] mbox.gz Atom feed top
2007-12-31 12:26 Bodo Eggert [this message]
2007-12-31 15:16 ` Douglas Gilbert
2007-12-31 15:47 ` Matthew Wilcox
2007-12-31 16:34 ` Douglas Gilbert
2007-12-31 18:35 ` Bodo Eggert
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=alpine.LSU.0.999.0712311313050.3761@be1.lrz \
--to=7eggert@gmx.de \
--cc=linux-kernel@vger.kernel.org \
--cc=linux-scsi@vger.kernel.org \
--cc=netdev@vger.kernel.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox
all inboxes | Powered by JetHome®