Skip to content

Commit

Permalink
Update cabal-package-description-file.rst
Browse files Browse the repository at this point in the history
make the documentation around the ``manual`` flag a little clearer
  • Loading branch information
theGhostJW authored Feb 6, 2025
1 parent 595d023 commit 0dd4a0a
Showing 1 changed file with 6 additions and 4 deletions.
10 changes: 6 additions & 4 deletions doc/cabal-package-description-file.rst
Original file line number Diff line number Diff line change
Expand Up @@ -2462,10 +2462,12 @@ Configuration Flags
:default: ``False``
:since: 1.6

By default, Cabal will first try to satisfy dependencies with the
default flag value and then, if that is not possible, with the
negated value. However, if the flag is manual, then the default
value (which can be overridden by commandline flags) will be used.
Cabal normally tries to resolve dependencies using the flag's ``default``
value first. If that fails, it automatically retries with the negated
default value. However, if the ``manual`` flag is set to ``True``, Cabal
will not retry with the negated value, and dependency resolution will fail
if the default value doesn't work. Note that the default value can still
be overridden using command-line flags.

.. _conditional-blocks:

Expand Down

0 comments on commit 0dd4a0a

Please sign in to comment.