From 0846d4d7b2a2dc2ef1b93e3dba855730e0ffe134 Mon Sep 17 00:00:00 2001
From: Robert Vollmert <rob@vllmrt.net>
Date: Tue, 27 Aug 2019 19:25:34 +0200
Subject: [PATCH] stack.yaml: Document use of obscure ghc options.

---
 stack.yaml | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/stack.yaml b/stack.yaml
index df74319d2..20707fa41 100644
--- a/stack.yaml
+++ b/stack.yaml
@@ -1,5 +1,12 @@
+# stack is used for circleci and appveyor CI builds
 resolver: lts-14.3
 ghc-options:
-  postgrest: -O2 -Werror -Wall -fwarn-identities -fno-spec-constr -optP-Wno-nonportable-include-path
+  # -fno-spec-constr may help keep compile time memory use in check,
+  #   see https://gitlab.haskell.org/ghc/ghc/issues/16017#note_219304
+  # -optP-Wno-nonportable-include-path
+  #   prevents build failures on case-insensitive filesystems (macos),
+  #   see https://github.com/commercialhaskell/stack/issues/3918
+  postgrest: -O2 -Werror -Wall -fwarn-identities
+             -fno-spec-constr -optP-Wno-nonportable-include-path
 nix:
   packages: [pcre, pkgconfig, postgresql, zlib]