Darren New wrote:

> It's fine for the details. But try to document (say) the BSD interface 
> to TCP by documenting only the listen(), accept(), bind(), and connect() 
> calls. Without understanding what an IP address is, or a socket, or how 
> DNS works, etc you're still not going to win.
> 
> Or take something like a big windowing system, or a 3D graphics system, 
> or a physics library, and try to document *just* the routines without 
> documenting the architecture of the system.  You'll spend three days 
> trying to find out where to start reading the documentation.

Ah yes... This is how I tried to learn OpenGL. (By reading function 
descriptions, that is.) It's not very easy...

-- 
http://blog.orphi.me.uk/
http://www.zazzle.com/MathematicalOrchid*

Post a reply to this message