linux-kernel - Re: Bad escriptions in Kconfig

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [day] [month] [year] [list]

Message-ID: <alpine.LSU.0.999.0712311931080.5775@be1.lrz>
Date:	Mon, 31 Dec 2007 19:35:58 +0100 (CET)
From:	Bodo Eggert <7eggert@....de>
To:	Douglas Gilbert <dougg@...que.net>
cc:	Matthew Wilcox <matthew@....cx>, Bodo Eggert <7eggert@....de>,
	linux-kernel@...r.kernel.org, linux-scsi@...r.kernel.org
Subject: 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@...r.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/