documentation updates from ross paterson
  - more accurate specification of package names
  - hs-source-dir -> hs-source-dirs in examples
  - setup clean removes a bit more
  - rearrange description of fields

  Version.hs: allow more spaces in version constraints

  Install.hs: add the exe extension when installing executables (reported by Brian Smith)
 
  test directory: add explicit dependencies on base

  Misc:
  Prefix error messages and warnings with the program name, and send them
  to stderr.  (Also moved some stuff from Distribution.Simple.Utils to
  Distribution.Simple.Build to avoid circular dependencies.)

  refactoring only: split Compiler type from Distribution.Setup,
  to reduce dependencies.

  Exclude DefaultSetup.lhs from the GHC build

  add JHC to the Compiler type

  refactored argument processing

  setup sdist --snapshot: append YYYYMMDD to the version for the bundle

  improved error messages (from Brian Smith):
  
  * attach source locations to messages when available
  
  * change some remaining error's do die.

  refactor defaultMainWorker

  split Distribution.Extension between Language.Haskell.Extension (just
  the type, which will also be useful when haskell-src-exts is merged)
  and Distribution.Compiler (mappings to compiler options).

  add Language.Haskell.Extension

  Simon marlow:  update defaults for prefix/libdir/bindir

Krasimir:
  added hs-source-dirs (ross added docs)

  Add other-files field to PackageDescription. This is a list files
  which belong to the package but aren't compiled. These files are
  copied and packaged from sdist command.

Ross:
  fixes to buildHugs and sdist after hs-source-dirs changes.
  
  Also simplified smartCopySources a bit.

  document sdist and new other-files field.

Krasimir says:
  Small fixes in the parser/printer. When there is a package description with
  executables only then the old implementation of pretty printer was written
  to print empty "exposed-modules" field while there isn`t any library. After
  that the parser will generate PackageDescription with (Just emptyLibrary)
  instead of Nothing. Now exposed-modules field is printed only if
  library /= Nothing

Ross says:
  In smartCopySources, don't try to strip the prefix if it was ".",
  because joinFileName "." x == x
  (fixes bug reported by Iavor Diatchki)

  Improve sdist a bit: copy files named in main-is, license-file and c-sources.
  Also supply a default Setup.hs if none is present.
  
  This will get it working for only the simplest of packages.  It omits
  header files, configure stuff and files named in the buildinfo file.
  To do it properly, we'd need a field in the package description listing
  extra files to copy into a source distribution.

  Clean up parsing & pretty-printing.
  
  Most list fields now have consistent syntax:
  
    - commas are optional
    - each element of the list is either
  	- a sequence of one or more non-space non-comma characters
  	- a quoted string in Haskell 98 lexical syntax
  
  The build-depends field still requires commas, because the elements
  can contain whitespace.
  
  I merged fieldGet/fieldShow in StanzaField into a single field for
  simplicity.

  add flags arguments to post-hooks, and have defaultUserHooks use postConf
  instead of preConf.

  changes to package description fields, as discussed on the libraries list:
  
  * allow both License and License-File, which now correspond to different
    fields of Package Description.
  
  * add Synopsis.
  
  * rename Hidden-Modules as Other-Modules.

** libraries/Cabal/Distribution ParseUtils.hs 
** minor local refactoring of unionBuildInfo
** build-package -> buildable

Authors: Malcolm Wallace, Ross Paterson, Krasimir Angelov

  move createIfNotExists and removeFileRecursive functions from
  Distribution.Simple.Utils to System.Directory. The functions are renamed
  to createDirectoryIfMissing and removeDirectoryRecursive.

  avoid a few GHC warnings

  get IOError stuff from System.IO.Error instead of System.IO

  Minor tweaks to build with nhc98.

  OPTIONS pragma stuff for nhc98 and compat w/ ghc

  Use a custom monad ParseResult for parse results instead of Either PError,
  removing the need for Distribution.Compat.Error and the dependency on mtl.
  

Two of the bugs were passing the wrong accessor function to the pretty
printer.

The third bug was that the pretty printer rendered "foo\\bar" as
"foo\bar", but actually in order to get the slash into the string, the
user would have to have used the quote syntax.  I think we decided
that the quote syntax meant a haskell string, so they should input it
as "foo\\bar", of course internally represented as "foo\bar', but when
printed, it should show two slashes again.

** add a newline to the end of the installed package description
** When pretty-printing free-format text fields, align the lines vertically
  (so that following lines will be seen as continuations) and replace empty
  lines with "." (so they'll be correctly re-parsed, instead of looking
  like a stanza separator).

** revert to getting main module from the right place
** make singleStanza ignore comment lines too

** haddock fixes

** Add the following fields to PackageDescription:
  
  	buildPackage   :: Bool,         -- ^ package is buildable here
  	ccOptions      :: [String],     -- ^ options for C compiler
  	ldOptions      :: [String],     -- ^ options for linker
  	frameworks     :: [String],
  
  When these are system dependent (as they often are), they will need to be
  overridden, but the mechanism is left to the Cabal user.
  
  Not that I've treated these as basic fields, so they apply to the library
  (if any) and all executables in the package.  The overriding is easier
  that way.

** Make the build prefix settable with the --builddir option to configure
  (in Simple), save this in the LocalBuildInfo, and use it in subsequent
  phases.
  
  This is useful for the Hugs build, where we want to place the built
  libraries so that we can easily use them inplace.

** Some rearrangement, centring on changes to the definition of
  PPSuffixHandler:
  
  * removed the special treatment of literate source: a separate
    preprocessor can be used for these if required.
  
  * handlers can use package and local build info to construct the
    appropriate preprocessor.
  
  Also, the supplied suffix handlers list now only has entries for suffixes
  that need preprocessing (i.e. not .hs or .lhs).  Dummy entries for the
  suffixes handled by the compiler are added internally.

**  Add a function getOptionsFromSource to fetch LANGUAGE and OPTIONS pragmas
  from the initial part of a Haskell source module (as proposed by SimonM
  on the libraries list).
  
  Also export the auxiliary function stripComments, which does what it says,
  optionally preserving pragmas.

- Rename Compat.* modules to Distribution.Compat.*
- Add {-# OPTIONS -cpp #-} to a few modules
- Distribution.Compat.ReadP: use real ReadP in GHC 6.3+
- new module: Distribution.Extension, contains Extension type
  formerly from Distribution.Misc.
- new module: Distribution.License, contains License type
  formerly from Distribution.Misc.
- remove Distribution.Misc
- new module: Distribution.ParseUtils, containing various parsing utilities
  formerly from Distribution.Package, that are re-used in 
  Distribution.InstalledPackageInfo.
- new module: Distribution.PackageDescription contains everything related
  to PackageDescription, which was formerly in Distribution.Package.
- Distribution.Package now contains only PackageId-related stuff.
- Distribution.InstalledPackageInfo: update for use in GHC, add
  parsing/pretty-printing.
- Compat.H98 is now Distribution.Compat.Error (it contained only stuff
  related to the Error monad, which isn't H98 anyway).
- remove imports of H98 libs (use hierarchical ones instead)
- configure now detects the GHC version (but doesn't do anything with it... yet)