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.

> 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.

I'll be glad to work up whichever solution you think is best.

Alan Stern



-------------------------------------------------------
This SF.Net email is sponsored by: IntelliVIEW -- Interactive Reporting
Tool for open source databases. Create drag-&-drop reports. Save time
by over 75%! Publish reports on the web. Export to DOC, XLS, RTF, etc.
Download a FREE copy at http://www.intelliview.com/go/osdn_nl
_______________________________________________
linux-usb-devel@lists.sourceforge.net
To unsubscribe, use the last form field at:
https://lists.sourceforge.net/lists/listinfo/linux-usb-devel

Reply via email to