From 8d4836e69dbd30dfcab4609a6673f59b6f24b0e6 Mon Sep 17 00:00:00 2001 From: Mike Pilgrem Date: Mon, 20 Jan 2025 20:48:30 +0000 Subject: [PATCH] Re #6679 Document current setup-depends behaviour, re missing Cabal --- doc/commands/build_command.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/doc/commands/build_command.md b/doc/commands/build_command.md index 9856bc2bf7..446dab1793 100644 --- a/doc/commands/build_command.md +++ b/doc/commands/build_command.md @@ -210,6 +210,12 @@ part of Stack's [user's guide](../tutorial/building_your_project.md#adding-dependencies) for information about how these dependencies get specified. +If a package description specifies a custom build type, it must also specify a +custom setup. That should list the dependencies needed to compile `Setup.hs`. +Stack further customises the setup, using the `Cabal` package. If that package +is not listed, Stack will not add the package as a dependency but warn that +build errors are likely. + In addition to specifying targets, you can also control what gets built, or retained, with the flags and options listed below. You can also affect what gets built by specifying Cabal (the library) options for the configure step