Skip to content

Commit 944a61c

Browse files
athasulysses4ever
authored andcommitted
Clarify role of ~/.cabal when determining config file.
This is purely a documentation change that makes the behaviour more explicit. 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 d643706 commit 944a61c

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)