Revert "Enable new warning for fragile/incorrect CPP #if usage"
[ghc.git] / mk / build.mk.sample
1 # -----------------------------------------------------------------------------
2 # A Sample build.mk
3 #
4 # Uncomment one of the following BuildFlavour settings to get the desired
5 # overall build type.
6
7 # -------- Build profiles -----------------------------------------------------
8 # Uncomment one of these to select a build profile below:
9
10 # Full build with max optimisation and everything enabled (very slow build)
11 #BuildFlavour = perf
12
13 # As above but build GHC using the LLVM backend
14 #BuildFlavour = perf-llvm
15
16 # Perf build configured for a cross-compiler
17 #BuildFlavour = perf-cross
18
19 # Fast build with optimised libraries, no profiling (RECOMMENDED):
20 #BuildFlavour = quick
21
22 # Fast build with optimised libraries, no profiling, with LLVM:
23 #BuildFlavour = quick-llvm
24
25 # Fast build configured for a cross compiler
26 #BuildFlavour  = quick-cross
27
28 # Even faster build.  NOT RECOMMENDED: the libraries will be
29 # completely unoptimised, so any code built with this compiler
30 # (including stage2) will run very slowly, and many GHC tests
31 # will fail with this profile (see Trac #12141):
32 #BuildFlavour = quickest
33
34 # Profile the stage2 compiler:
35 #BuildFlavour = prof
36
37 # Profile the stage2 compiler (LLVM backend):
38 #BuildFlavour = prof-llvm
39
40 # A development build, working on the stage 1 compiler:
41 #BuildFlavour = devel1
42
43 # A development build, working on the stage 2 compiler:
44 #BuildFlavour = devel2
45
46 # A build with max optimisation that still builds the stage2 compiler
47 # quickly. Compiled code will be the same as with "perf". Programs
48 # will compile more slowly.
49 #BuildFlavour = bench
50
51 # As above but build GHC using the LLVM backend
52 #BuildFlavour = bench-llvm
53
54 # Bench build configured for a cross-compiler
55 #BuildFlavour = bench-cross
56
57 # Use the same settings as validate.
58 #BuildFlavour = validate
59
60 ifneq "$(BuildFlavour)" ""
61 include mk/flavours/$(BuildFlavour).mk
62 endif
63
64 # -------- Miscellaneous variables --------------------------------------------
65
66 # Set to V = 0 to get prettier build output.
67 # Please use V=1 (the default) when reporting GHC bugs.
68 #V=0
69
70 # Should all enabled warnings (see mk/warnings.mk) be turned into errors while
71 # building stage 2?
72 #WERROR=-Werror
73
74 # After stage 1 and the libraries have been built, you can uncomment this line:
75 #stage=2
76
77 # Then stage 1 will not be touched by the build system, until
78 # you comment the line again.  This is a useful trick for when you're
79 # working on stage 2 and want to freeze stage 1 and the libraries for
80 # a while.
81
82 # Enable these if you would like DWARF debugging symbols for your libraries.
83 # This is necessary, for instance, to get DWARF stack traces out of programs
84 # built by the produced compiler. You must also pass --enable-dwarf-unwind to
85 # `configure` to enable the runtime system's builtin unwinding support.
86 #GhcLibHcOpts += -g3
87 #GhcRtsHcOpts += -g3
88
89 # Build the "extra" packages (see ./packages). This enables more tests. See:
90 # https://ghc.haskell.org/trac/ghc/wiki/Building/RunningTests/Running#AdditionalPackages
91 #BUILD_EXTRA_PKGS=YES
92
93 # Uncomment the following line to enable building DPH
94 #BUILD_DPH=YES
95
96 # Uncomment the following to force `integer-gmp` to use the in-tree GMP 6.1.2
97 # (other sometimes useful configure-options: `--with-gmp-{includes,libraries}`)
98 #libraries/integer-gmp_CONFIGURE_OPTS += --configure-option=--with-intree-gmp
99
100 # Enable pretty hyperlinked sources
101 #HADDOCK_DOCS = YES
102 #EXTRA_HADDOCK_OPTS += --hyperlinked-source
103
104 # Don't strip debug and other unneeded symbols from libraries and executables.
105 STRIP_CMD = :