Hi Brad,


> -----Original Message-----
> From: Brad Hards [mailto:[EMAIL PROTECTED]]
> Sent: Wednesday, March 22, 2000 1:23 PM
> To: Dunlap, Randy
> Cc: '[EMAIL PROTECTED]'
> Subject: Re: [linux-usb] USB usability concerns for 2.4
> 
> 
> "Dunlap, Randy" wrote:
> > Maybe these are distribution issues and not developer issues.
> > If so, please tell me.  In either case, I think that if we 
> don't address
> > them (or some of them), we (the linux-usb mailing list & project)
> > will be getting a lot of email from newbie USB users about
> > "this device doesn't work" and "the driver module didn't load" etc.
> Maybe two mailing lists - usb-devel and usb-help?

I'm (slowly) working on putting some linux-usb stuff
at sourceforge.net, so I'll plan to set up 2 mailing
lists there, or at least a developer mailing list there.
Maybe leave [EMAIL PROTECTED] for user help.

> > Examples:
> > . /etc/fstab entry to mount /proc/bus/usb automatically
> How about the following after /proc:
> usbdevfs       /proc/bus/usb         usbdevfs          
> defaults   0   0 
> 
> It won't work under every circumstance, but it will work most of the
> time.

Good.

> > I'm also a little concerned about the Linux USB Guide that
> > Brad Hards has produced.  It's a fine and useful document, but
> > its size could keep newbie users from reading/using it.
> Probably, although the web version is in nice chunks.

Now that I look at the html version, it is.  To me, it's not
so obvious from looking at http://linuxusbguide.sourceforge.net/
that there is an html version.  It's your web page, but I think
that it would be clearer if you formatted it more like:

          This project is about the Linux USB Guide.
              It is available in these formats:
                    HTML <with link>
                    DVI  <with link>
                    PostScript <with link>


> > Would it make sense to have a separate mini-howto for USB
> > that only addresses user/usability/setup/config issues and not
> > developer issues?
> Cutting out whole sections and dividing it up is trivial. The 
> hard part
> is about reducing the detail in an individual entry. For example, the
> next version has a long section about mouse install, since between
> Xfree3.x, Xfree4.x and gpm, there are a lot of combinations. That is
> ugly, but I don't know how to make a setup that can work in 
> every case.

Yep, agreed.  I'm not trying to reduce the amount of detail,
I just don't want to overload the user with pages of
developer stuff that they won't be interested in.

> I am tempted to dump the user mode programming stuff (some of it to
> perhaps become part of libusb), since it is fairly 
> independent of Linux.
> I could also dump the kernel info, since Deti did a much 
> better job than
> anything I could do, even given his stuff to work from. For an
> indication of what this would look like, refer to
> http://LinuxUSBGuide.sourceforge.net - version 1.0.4 got 
> dropped in the
> bitbucket, and 1.0.5 is essentially a user only version. It 
> is still 46
> pages though, and would likely be around 60 pages when complete with
> just the drivers in the current kernel. 
> 
> Would the intro to USB be better dumped as well? 

It was the 80+ page version that I had problems with.
I would prefer to see the user and developer guides kept
separate, like you have already addressed.  I didn't realize
that you had done this.

Regarding the USB intro -- this is background info IMO and
I think that some people would like to see this.  Personally
I would move it toward the end of the user guide.

> I can also use the same source documents to make two (or 
> more) different
> versions - how would you like it divided up?
> 
> Comments?

Are you willing to address the "free use" issue for
Linux distributions?

> 
> Brad

Thanks,
Randy


---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to