Simon Peyton-Jones wrote:
| Indeed. I had to browse the source after finding that the Haddock docs are | essentially useless. I do have to say, one nice side effect of using darcs | is that one can simply point one's browser at the source repository to peruse | the code. I've bookmarked http://cvs.haskell.org/darcs :-)
Good idea. Could you help us improve the documentation by sending darcs patches with Haddock docs in them? Not necessarily comprehensive: at least recording the bits you discovered, and wished had been in the docs in the first place.
The real issue here is that we're generating Haddock docs for the libraries as they appear to a Unix user, and hence leaving out all the Windows-specific stuff. The main thing we need to do is include the Win32 package in the docs, and there may be a few other minor things. Cheers, Simon