Merge branch 'stable'

commercialhaskell · Dec 16, 2023 · 18e6200 · 18e6200
2 parents ebd88b8 + f18a4e6
commit 18e6200
Showing 1 changed file with 9 additions and 0 deletions.
diff --git a/doc/build_command.md b/doc/build_command.md
@@ -464,6 +464,15 @@ Pass Stack's `--fast` flag to add `-O0` to the flags and options passed to GHC.
 The effect of `--fast` can be overriden with Stack's
 [`--ghc-options`](#-ghc-options-option) command line options.
 
+!!! note
+
+    With one exception, GHC's `-O` flag is always passed to GHC first (being
+    Cabal's default behaviour). The exception is if Cabal's
+    `--disable-optimization` flag or `--enable-optimization[=n]`, `-O[n]`
+    options are used during the configure step of the Cabal build process; see
+    Stack's [`configure-options`](yaml_configuration.md#configure-options) YAML
+    configuration option.
+
 ### `--ghc-options` option
 
 `stack build --ghc-options <ghc_options>` passes the specified command line