Add user-defined flavour example for turning off dynamic linking (#535)
authorAlp Mestanogullari <alpmestan@gmail.com>
Thu, 22 Mar 2018 00:38:11 +0000 (01:38 +0100)
committerAndrey Mokhov <andrey.mokhov@gmail.com>
Thu, 22 Mar 2018 00:38:11 +0000 (01:38 +0100)
See #534 and https://ghc.haskell.org/trac/ghc/ticket/10536

doc/user-settings.md

index 1a89dd4..05e4efc 100644 (file)
@@ -149,6 +149,16 @@ Note that `rtsWays` is computed from `libraryWays` by default, therefore the abo
 change will lead to the removal of `threadedProfiling` way from `rtsWays`. To
 change this behaviour, you can override the default `rtsWays` setting.
 
+Similarly, if we want to completely turn off dynamic linking,
+we can define a custom `Flavour` to this effect:
+``` haskell
+noDynamicFlavour :: Flavour
+noDynamicFlavour = defaultFlavour
+  { name = "no-dynamic"
+  , libraryWays = remove [dynamic] defaultLibraryWays
+  }
+```
+
 ## Verbose command lines
 
 By default Hadrian does not print full command lines during the build process