Skip to content

Commit 0dc2991

Browse files
committed
Clarify role of ~/.cabal when determining config file.
This is purely a documentation change that makes the behaviour more explicit. In helps. The actual behaviour is unchanged, although the need for a five step checklist to find the config file suggests that perhaps things have gotten a bit out of hand.
1 parent 55aba14 commit 0dc2991

File tree

1 file changed

+3
-1
lines changed

1 file changed

+3
-1
lines changed

doc/config.rst

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -82,7 +82,9 @@ The configuration file location is determined as follows:
8282
1. If option ``--config-file`` is given, use it;
8383
2. otherwise, if ``$CABAL_CONFIG`` is set use it;
8484
3. otherwise, if ``$CABAL_DIR`` is set use ``$CABAL_DIR/config``;
85-
4. otherwise use ``config`` in ``$XDG_CONFIG_HOME/cabal``, which
85+
4. otherwise, if ``~/.cabal`` exists, and is a directory, use
86+
``~/.cabal/config``;
87+
5. otherwise use ``config`` in ``$XDG_CONFIG_HOME/cabal``, which
8688
defaults to ``~/.config/cabal`` on Unix.
8789

8890
If the configuration file does not exist, and it was not given

0 commit comments

Comments
 (0)