more docs for GHC_PACKAGE_PATH

Document GHC_PACKAGE_PATH, and changes to the ghc-pkg command line interface.

Fix links to library doc for Haddock 0.7.

Update documentation for ghc-pkg list and ghc-pkg latest.

Document changes to the package system.

A nice side effect of the relaxed restrictions is that the
-ignore-package flag is no longer required when compiling a package
(unless the package is "base", and even in that case we might be able
to get away with -hide-package base).  For now, I've removed
references that talk about using -ignore-package when compiling a
package, and simplified the documentation for -ignore-package.

Fix the names of a few fields.

Add the -hide-all-packages flag.

Fix InstalledPackageInfo link

Update documentation of ghc-pkg command

Fix documentation for ghc-pkg list.

xrefs to Cabal docs

Update packages documentation (phew)

A few updates to the local Emacs variables in these files.  For some
reason, I can't get Emacs' PSGML mode to work with the new XML files
(although I thought I had it working before... strange).

Correct DocBook XML now

Started to convert the users guide to DocBook XML. Not yet finished, there are
still *tons* of misplaced indexterms, but some sensible documentation can
already be generated.

xmlize sgml docbooks

Clarify words about the -package flag

Add note about -all_load instead of --whole-archive on MacOS X.

Rename --list-packages-local to --list-local-packages, because it
seems that having one long option which is a prefix of another doesn't
work too well with GetOpt.

Doc the -L ghc-pkg option.

Update ghc-pkg documentation w.r.t. multiple config files, and add
documentation for 'auto' packages.

fix markup slightly

Add a note about the profiling versions of the interface files in a package.

Add notes on how to build a .a file to the docs, as requested by Koen
Claessen.

Various hacking on the User's Guide to knock it into shape for the release.

Committers: please take a look at the 5.04 release notes and feel free
to tweak or embelish the description for your favourite new feature.

Documentation for Darwin/MacOS X-Specific options/packacke.conf entries
(-framework, -framework-path; framework_dirs, extra_frameworks)

Doc --force.

document the environment variable expansion done in input package specifications

Replace all instances of '--' with '––' since '--' gets
interpreted by JadeTeX to mean a single dash.

document --update-package option

Document -i option

document new --auto-ghci-libs option.

Fill in details for 5.02.

Document -package-conf and ghc-pkg --config-file

mark up wibbles (don't people try to format the documentation before
checking in changes?)

Say that building packages as DLLs is now no longer supported, but may still
work.

Clarify the situation with GHCi object files, and add instructions for
building one from a .a file.

fix and elaborate the documentation for <literal>extra_libraries</literal>

- document new <command>ghc-pkg</command> tool
- document <literal>source_dirs</literal> field

More documentation rewriting...  I'm particularly proud of the "flag
reference" section, please check it out.