This patch fixes a bug where a sublibrary overwrites a library
directory.  This leads to overwriting `*.haddock` files, which results
in missing entries in various indexes (e.g. the html index,
quicksearch).

(cherry picked from commit 1840bca)

# Conflicts:
#	cabal-install/src/Distribution/Client/CmdHaddockProject.hs

This patch makes `haddock-project` use `--local` option by default.
Since its the default, it is removed. Also `--gen-index`,
`--gen-contents`, `--hyperlinked-source` and `--quickjump` are removed
since they are always turned on.

Added a haddock-project test.

(cherry picked from commit 1b89c1b)

# Conflicts:
#	Cabal/src/Distribution/Simple/Haddock.hs
#	Cabal/src/Distribution/Simple/Setup/Haddock.hs
#	cabal-install/src/Distribution/Client/CmdHaddockProject.hs
#	cabal-testsuite/PackageTests/Backpack/Includes2/setup-external.cabal.out
#	cabal-testsuite/PackageTests/Backpack/Includes2/setup-external.out
#	cabal-testsuite/PackageTests/Backpack/Includes2/setup-per-component.out
#	cabal-testsuite/PackageTests/Backpack/Includes3/setup-external-explicit.out
#	cabal-testsuite/PackageTests/Backpack/Includes3/setup-external-ok.cabal.out
#	cabal-testsuite/PackageTests/Backpack/Includes3/setup-external-ok.out
#	cabal-testsuite/PackageTests/Backpack/Reexport1/setup.cabal.out
#	cabal-testsuite/PackageTests/Backpack/Reexport1/setup.out
#	cabal-testsuite/PackageTests/Haddock/setup.cabal.out
#	cabal-testsuite/PackageTests/Haddock/setup.out
#	cabal-testsuite/PackageTests/HaddockArgs/quickjump.out
#	cabal-testsuite/PackageTests/HaddockNewline/setup.cabal.out
#	cabal-testsuite/PackageTests/HaddockNewline/setup.out
#	cabal-testsuite/PackageTests/InternalLibraries/Haddock/haddock.cabal.out
#	cabal-testsuite/PackageTests/InternalLibraries/Haddock/haddock.out
#	cabal-testsuite/PackageTests/NewHaddock/DisableDoc/cabal.out
#	cabal-testsuite/PackageTests/NewHaddock/HaddockOutput/HaddockOutputCmd/cabal.out
#	cabal-testsuite/PackageTests/NewHaddock/HaddockOutput/HaddockOutputConfig/cabal.out
#	cabal-testsuite/PackageTests/NewHaddock/ImplyDependencies/cabal.out

`haddock-project` command need to build the project so that haddocks of
the dependencies are available in the store.

Fixes #8958.

(cherry picked from commit 2c597e8)

# Conflicts:
#	cabal-install/src/Distribution/Client/CmdHaddockProject.hs