[commit: hadrian] master: Add user-defined flavour example for turning off dynamic linking (#535) (2fcfde2)

[git at git.haskell.org]

Repository : ssh://git@git.haskell.org/hadrian

On branch  : master
Link       : http://git.haskell.org/hadrian.git/commitdiff/2fcfde2a455b2d0c5f6a0f6003dcc8af669aea80

>---------------------------------------------------------------

commit 2fcfde2a455b2d0c5f6a0f6003dcc8af669aea80
Author: Alp Mestanogullari <alpmestan at gmail.com>
Date:   Thu Mar 22 01:38:11 2018 +0100

    Add user-defined flavour example for turning off dynamic linking (#535)
    
    See #534 and https://ghc.haskell.org/trac/ghc/ticket/10536


>---------------------------------------------------------------

2fcfde2a455b2d0c5f6a0f6003dcc8af669aea80
 doc/user-settings.md | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/doc/user-settings.md b/doc/user-settings.md
index 1a89dd4..05e4efc 100644
--- a/doc/user-settings.md
+++ b/doc/user-settings.md
@@ -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