[Haskell-cafe] Poor libraries documentation

Derek Elkins derek.a.elkins at gmail.com
Wed Jan 30 11:40:46 EST 2008


On Wed, 2008-01-30 at 13:15 +0000, Jules Bean wrote:
> Neil Mitchell wrote:
> > For a start, its probably a good idea to mention that cos is an
> > abbreviation of cosine (most people will know, but its handy to state
> > it). Secondly, and much more importantly, it should state whether
> > these measurements are in degrees or radians. It should also state
> > things like acos is the inverse of cos - its been a while since I last
> > used trig and I had to look it up!!!
> 
> I imagine the laziness here was because these all match their names in 
> the traditional libc, accessable via manpages.

And, uh, well, the Report... except, entertainingly, the Report doesn't
actually define most of these except by reference.

> You may not consider that an excuse :)

Ultimately, as others have said, it would be nice to have reference
documentation all in one place and one format.



More information about the Haskell-Cafe mailing list