Add the user manual.

  * The user manual is now the authoratitive documentation, rather than the
    rather short README.
  * It is only provided in html at the moment due to it being in several
    pieces and docutils not being able to link the pieces dynamically
    depending on the output type.
  * Thanks to Robey Pointer for the colour scheme.
  * Register the user manual with doc base rather than the README.

Other changes

  * Add dependency on bzrtools.
  * Bump required version of bzr for the testsuite failures that are fixed in
    0.18.
  * Actually call dh_install, and use it for the docs so that they can go in
    a subdir.
  * Add nocheck and notest DEBBUILDOPTS support to avoid running the testsuite
    during the build. My laptop is pleased.