Add a separate configure script and build system for building the
documentation.  The configure and Makefile code is stolen from
fptools.  This is left as a separate build system so that the main
Cabal setup doesn't require a Unix build environment or DocBook XML
tools.

Document new behaviour of -s option

fix 3 bugs in --use-package, and document it.

Fix documentation regarding the module attributes.

Update the documentation w.r.t. home modules and the not-home attribute.

Describe numeric character references.

SGML is dead, long live DocBook XML!

Note: The BuildRequires tags in the spec files are still incomplete
and the documentation about the DocBook tools needs to be updated,
too. Stay tuned...

Re-added indices + minor fixes

XMLification

Mainly DocBook fixes

Document new features in HtmlHelp

- update copyright
- add version to abstract

Added the new-born haddock.js to the build process and the documentation.

Fix URL

Add -optP-P to example ghc command line.

Add instructions for using GHC to pre-process source for feeding to Haddock.

Add -k/--package docs

Support for generating a single unified index for several packages.

  --use-index=URL  turns off normal index generation, causes Index
 		   links to point to URL.

  --gen-index      generates an combined index from the specified
                   interfaces.

Currently doesn't work exactly right, because the interfaces don't
contain the iface_reexported info.  I'll need to fix that up.

- Suppress warnings about unknown imported modules by default.
- Add a -v/--verbose flag to re-enable these warnings.

The general idea is to suppress the "Warning: unknown module: Prelude"
warnings which most Haddock users will see every time, and which
aren't terribly useful.

Allow installing of docs.

* Made -D a short option for --dump-interface.
* Made -m a short option for --ms-help.
* Made -n a short option for --no-implicit-prelude.
* Made -c a short option for --css.
* Removed DocBook options from executable (they didn't do anything),
  but mark them as reserved in the docs. Note that the short option
  for DocBook output is now -S (from SGML) instead of -d. The latter
  is now a short option for --debug.
* The order of the Options in the documentation now matches the order
  printed by Haddock itself.

Note: Although changing the names of options is often a bad idea, I'd
really like to make the options for the programs in fptools more
consistent and compatible to the ones used in common GNU programs.

Made option handling a bit more consistent with other tools, in
particular: Every program in fptools should output
   * version info on stdout and terminate successfully when -V or --version
   * usage info on stdout and terminate successfully when -? or --help
   * usage info on stderr and terminate unsuccessfully when an unknown option
is given.

Markup fix

Add documentation for anchors.

- update the acknowledgements

- remove the paragraph that described how to use explicit layout with
  doc comments; it isn't relevant any more.

Mention alternative commenting styles.

Document all the new options since 0.3

oops, fix markup bugs

Document recent changes to markup syntax

- Remove the note about function argument docs not being implemented

- Note that qualified identifiers can be used to point to entities
  that aren't in scope.

Fix one of the record examples

fix typos

Document changes since 0.1

typo

Fix some typos.

Yet more keyboard bashing - this is pretty much complete now.

More keyboard bashing