On Wed, Feb 02, 2005 at 04:49:46PM -0500, Alan Stern wrote: > On Wed, 2 Feb 2005, Matthew Dharm wrote: > > > > > Is there a place where we can keep all that useful descriptive text? I > > > > really don't want to throw it away, just to be bombarded by "what's this > > > > parameter for" questions... > > > > > > It can go into a comment, but that wouldn't help very much... > > > > It would be better than nothing. > > > > > I don't know whether it's regarded as good form to have such a long text > > > as the contents of a module parameter description. The only other spot > > > seems to be in Documentation/kernel-parameters.txt, which has brief > > > descriptions of many (but far from all) available parameters. There's > > > also the disadvantage that it's not accessible to people who haven't > > > installed the kernel source. > > > > My main goal is to put it someplace that Google can find it. If we can at > > least meet that threshold, then we'll save ourselves a lot of trouble. > > Then the ideal solution would be to put it on a well-known web page. The > obvious candidate is www.linux-usb.org, maybe as part of the FAQ. It > already has a discussion of max_sectors; this wouldn't be very different.
Sounds like a plan.
> > Alternatively, we leave the configuration option in place, and simply have
> > that option set the default value of the module parameter. Then, enhance
> > the help text to mention the parameter.
>
> That would work, and it would represent the minimum change from the
> current setup. But having a config option just to set a default value
> feels to me like overkill.
Yeah, it is overkill-ish. But it could also be used as a "slow transition
path". In a rev or two, we can remove the option entirely and leave it to
sysfs once the FAQ is updated and ready to go.
Or is that just too much work for a stupid little option?
I've clearly been spending too much time at my day job supporting lusers.
Let's do this: Ask Greg KH for his opinion on handling users.
Matt
--
Matthew Dharm Home: [EMAIL PROTECTED]
Maintainer, Linux USB Mass Storage Driver
G: Money isn't everything, A.J.
AJ: Who convinced you of that?
G: The Chief, at my last salary review.
-- Mike and Greg
User Friendly, 11/3/1998
pgpbGEyZu8H42.pgp
Description: PGP signature
