From 0dd4a0a8d154fb8f938d8e914759d28b4a152a5c Mon Sep 17 00:00:00 2001 From: theGhostJW Date: Thu, 6 Feb 2025 11:39:54 +1100 Subject: [PATCH] Update cabal-package-description-file.rst make the documentation around the ``manual`` flag a little clearer --- doc/cabal-package-description-file.rst | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/doc/cabal-package-description-file.rst b/doc/cabal-package-description-file.rst index 86aab056c0d..52675e09501 100644 --- a/doc/cabal-package-description-file.rst +++ b/doc/cabal-package-description-file.rst @@ -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: