> In my book, a bug is a discrepancy between documentation (and other
> reasonable expectations . . .) and implementation.
Quite right too.
> I note that the
> GHC libraries have been (sensibly) reorganised, so that to use the
> Socket library, you must now use -syslib net, and to use the FiniteMap
> library you must use -syslib data. Could you please update
> ghc/docs/users_guide/libmisc.vsgml to fit?
We're currently in the process of revamping the documentation (actually
Reuben is doing most of the work), and the library documentation in
particular will be completely reorganised to match the new structure.
Things are in transition right now, so I'm afraid the current documentation
isn't much use.
> Also it might be nice if
> major incompatible changes like this were warned about on the
> mailing list . . .
Good point. Here's a belated "heads up":
GHC's libraries have been reorganised as part of the
multi-compiler library effort.
ghc/lib/std still contains GHC's prelude. All the other
ghc/lib/<dir>s have been removed.
hslibs now contains a reorganised library collection, split
into several top-level "categories":
hslibs/lang Language-related extension support
/net Networking libraries
/data Data structures (inc. edison)
/text Text-processing utilites
/concurrent Concurrency support
/util Miscellaneous utilities (regexps
etc.)
/num Numerical libraries (currently
empty)
/posix POSIX library
GHC's existing libraries have been distributed amongst the
new hierarchy. To gain access to the new libraries, use
'-syslib <category>', eg. '-syslib lang' gets you the lang
libraries. The compiler knows about dependencies between
library categories, so you don't need to add '-syslib lang'
when specifying '-syslib net', for instance.
Most of the stuff that used to be in '-syslib exts' is now in
'-syslib lang'. You still get this by default when you specify
'-fglasgow-exts'.
Cheers,
Simon
