stack.yaml: various optional features

diff --git a/stack.yaml b/stack.yaml
index ecc68bde9048c7c5ac1e05a50f838a51e68941e4..d652a8c5a8cd9c778b15cef57fff55f17d3485ac 100644 (file)
--- a/stack.yaml
+++ b/stack.yaml
@@ -1,5 +1,37 @@
+# For more information, see: https://github.com/commercialhaskell/stack/blob/release/doc/yaml_configuration.md
+
+# Override default flag values for local packages and extra-deps
 flags: {}
+
+# Local packages, usually specified by relative directory name
 packages:
+
+# Local packages, usually specified by relative directory name
 - '.'
+
+# Packages to be pulled from upstream that are not in the resolver (e.g., acme-missiles-0.3)
 extra-deps: []
+
+# Specifies the GHC version and set of packages available (e.g., lts-3.5, nightly-2015-09-21, ghc-7.10.2)
 resolver: lts-5.2
+
+rebuild-ghc-options: true
+ghc-options:
+    # All packages
+    "*": -Wall # -fwarn-incomplete-uni-patterns -fwarn-incomplete-record-updates -fwarn-monomorphism-restriction -fwarn-auto-orphans -fwarn-implicit-prelude -fwarn-missing-local-sigs -fwarn-missing-exported-sigs -fwarn-missing-import-lists -fwarn-identities
+    some-package: -DSOME_CPP_FLAG
+
+# Control whether we use the GHC we find on the path
+# system-ghc: true
+
+# Require a specific version of stack, using version ranges
+# require-stack-version: -any # Default
+# require-stack-version: >= 1.0.0
+
+# Override the architecture used by stack, especially useful on Windows
+# arch: i386
+# arch: x86_64
+
+# Extra directories used by stack for building
+# extra-include-dirs: [/path/to/dir]
+# extra-lib-dirs: [/path/to/dir]