Re: [Q]: Linux and real device drivers

JF (krapht@hbe.ca)
Mon, 27 Sep 1999 16:53:42 -0500

> [Much complaining about Microsoft Windows deleted]
>
> > Maybe. But they sure as hell wrote a lot of Documentation.
>
> Have you ever *read* Microsoft's documentation? I consider it all crap.
> It is incomplete, incorrect, hard to read, wordy, typically out-of-date, and
> often expensive. However, everyone seems to understand that crap has no place
> in the kernel, and that extends to kernel docs as well.

I agree 100%.

Here is a sample of documentation from Microsoft (no joke!) :

> Here is the ContainedControls class definition in the VBrun library..
>
> Member of VBRUN
>
> A collection that allows access to the controls contained within the
> control that were added to the control by the developer who uses the
> control.

Now THAT is helpful!

The best documentation is probably the code itself.

--
Jean-Francois Brousseau
krapht@hbe.ca


-
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@vger.rutgers.edu
Please read the FAQ at http://www.tux.org/lkml/