Re: Bad escriptions in Kconfig

On Mon, 31 Dec 2007, Douglas Gilbert wrote:
Matthew Wilcox wrote:
On Mon, Dec 31, 2007 at 10:16:43AM -0500, Douglas Gilbert wrote:
Bodo Eggert wrote:

(Kicking netdev from CC)

---
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?
Heard of google :-)

For explanations of SCSI (and other storage) terminology
reference could be made to SAM-3 or SAM-4 drafts (because
the real standards cost money) at www.t10.org .

Perhaps many other subsections in the kernel could have
similar references.

I think that's an appalling idea. Someone's trying to configure their
kernel, not research hundreds of new ideas on the internet. Here's a
better description:

help
The SCSI target code allows your computer to appear as a SCSI
device. This is useful in a SAN or NAS environment where you
want other computers to be able to treat this computer as a disc.

To compile this driver as a module, choose M here: the module
will be called scsi_tgt.

Appalling or not, it is more accurate to define a SCSI target
properly than equate it to a direct access logical unit (i.e.
a disk).

Yes, but calling the current text a "help text" would be even less accurate.
Can you create a helpfull text without being incorrect?
--
Field experience is something you don't get until just after you need it.
--
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/

Relevant Pages

  • Re: Bad escriptions in Kconfig
    ... If you want to use SCSI target mode drivers enable this option. ... kernel, not research hundreds of new ideas on the internet. ...
    (Linux-Kernel)
  • Re: Bad escriptions in Kconfig
    ... If you want to use SCSI target mode drivers enable this option. ... What TF is a SCSI target mode, what is a target mode driver? ... FC or SAS target driver ...
    (Linux-Kernel)