"D. Tweed" wrote:
> Documentation is a vague term: certainly it'd be undesirable for a
> specification to the libraries to just a literate copy of the code
> itself. But if you're thinking in terms of an open source project where
> people fix bugs in the libraries then libraries that contain some
> explanation would be useful (as an additional item to the library spec).
Couldn't agree more. Every module should be commented, and every exported
symbol (and lots of the internal ones) should also be commented. But I don't
think you need anything more than comment characters for this.
