some haddock fixes
updates to the manual (from ross):
  make copyright, maintainer and synopsis optional again.
  document required fields, plus a few assorted tweaks.

As described in message to libraries@, except that because of the way
the parser is structured, I can't check for an altogether missing
license.  Instead I warn if they say AllRightsReserved.

krasimir: {un}register.bat
ross: small doc fixes, and {un}register.bat docs
      added verbosity to defaultUserHooks

  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.

  display some messages when verbosity > 0
  extraLibs and extraLibDirs were ignored when building for GHC

  Rename package description fields as in InstalledPackageInfo:
  
  	options-ghc -> ghc-options
  	options-hugs -> hugs-options
  	options-nhc -> nhc-options
  	extra-libs -> extra-libraries

  document syntax changes.
  
  Perhaps executable should be a token instead of freeform?

  installHugs: treat Main the same as other modules

  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.

Fixed bug for ghc < 6.3 where call to ghc-pkg during configure step
was unconditional.  Now only call ghc-pkg to get versioned
dependencies if >= 6.3. revived buildDepToDep as setDepByVersion,
which sets the exact version number if supplied by the package
description in any case where we can't query the HC-pkg system.

minor fix to withHooks test for hugs

  Configure dependencies properly, by querying hc-pkg for the package list.

  We should pass the full package id (including version) to ghc now that
  we know it, not just the package name.

  buildHugs: use ppCpp (calling cpphs) instead of invoking cpp directly.

  Also removed the unused exeDependencies.

  Add --user flag to configure

  Doc setup configure --user/--global

  Minor doc tweaks

  Hugs only: use binary handles for copyFile

Found the following issues:
** install --user for hugs doesn't work at all

** install for hugs doesn't know the trick of checking in the library
   directory for other-modules while building an executable

** copyFile for hugs doesn't work on binaries?  I get an error about
   encodings during copy step when cross-installing GHC libraries with
   Hugs build.  This may mask other problems since its hard to test
   cross-installing.