Document .cabal/config

[goldfirere]

I just learned, via haskell-cafe, that I could say jobs: 4 in my ~/.cabal/config file to make my life better. I wish this had been in the documentation! (It's not at https://www.haskell.org/cabal/users-guide/ or anywhere underneath, that I could find.) Are there other options lurking undocumented in that file (such as ghc-options)?

Thanks!

[erikd]

cabal version 1.22 has a cabal user-config sub-command. The help output is here:

Display and update the user's global cabal configuration.

Usage: cabal user-config diff
   or: cabal user-config update

When upgrading cabal, the set of configuration keys and their default values
may change. This command provides means to merge the existing config in
~/.cabal/config (i.e. all bindings that are actually defined and not commented
out) and the default config of the new version.

diff: Shows a pseudo-diff of the user's ~/.cabal/config file and the default
configuration that would be created by cabal if the config file did not exist.
update: Applies the pseudo-diff to the configuration that would be created by
default, and write the result back to ~/.cabal/config.

which does a lot of what you want (although docs would also be nice).