Why isn't the default configuration:

doc-index-file: $datadir/doc/$compiler/index.html
install-dirs global
  docdir: $datadir/doc/$compiler/$pkgid
  bindir: $datadir/bin-$compiler

Currentlly, trying to use multiple compilers with the default settings causes conflicts in both the documentation and binary directories. If this would break too much stuff, how about covering the "best practice" for multiple compilers configuration in the cabal documentation?