[project @ 2002-04-02 10:34:56 by simonmar]

Add my build.mk file as a sample, and point to it in the comments at
the top of config.mk.

diff --git a/mk/build.mk.sample b/mk/build.mk.sample
new file mode 100644 (file)
index 0000000..3f55836
--- /dev/null
+++ b/mk/build.mk.sample
@@ -0,0 +1,64 @@
+# -----------------------------------------------------------------------------
+# A Sample build.mk
+#
+# Uncomment one of the following BuildFlavour settings to get the desired
+# overall build type, and then tweak the options in the relevant section
+# below.
+
+BuildFlavour = devel
+#BuildFlavour = perf
+
+# -------- Misc. settings -----------------------------------------------------
+
+# Not necessary to set this, but useful if you have other projects checked-out
+# in your source tree.
+ProjectsToBuild = glafp-utils ghc libraries hslibs
+
+# Which warnings we like to use
+MyWarningOpts   = -W -fno-warn-unused-matches -fwarn-unused-imports
+
+# -------- 1. A Development build --------------------------------------------
+
+ifeq "$(BuildFlavour)" "devel"
+
+GhcCompilerWays =
+
+FptoolsHcOpts = -H32m $(MyWarningOpts)
+GhcHcOpts     = -Rghc-timing -DDEBUG
+GhcLibHcOpts  = -dcore-lint -O -H32m  $(MyWarningOpts) -keep-hc-files 
+GhcLibWays    =
+
+# Debugging RTS
+GhcRtsHcOpts = -optc-DDEBUG
+GhcRtsCcOpts = -g
+SRC_HC_OPTS  += -lbfd -liberty
+
+# profiled RTS
+#GhcRtsCcOpts =  -pg -g
+
+# Optimised/profiled RTS
+#GhcRtsCcOpts = -O2 -pg
+
+#GhcRtsWithFrontPanel = YES
+#SRC_HC_OPTS += `gtk-config --libs`
+
+SplitObjs = NO
+
+NoFibWays =
+SRC_RUNTEST_OPTS += +RTS -H10m -RTS
+STRIP=:
+
+endif
+
+# -------- 1. A Performance/Distribution build--------------------------------
+
+ifeq "$(BuildFlavour)" "perf"
+
+FptoolsHcOpts = -H32m -O $(MyWarningOpts)
+GhcHcOpts     = -Rghc-timing
+GhcLibHcOpts  = -H32m -O $(MyWarningOpts)
+
+GhcLibWays    = p
+
+#GhcRtsCcOpts = -O2 -fomit-frame-pointer -mpreferred-stack-boundary=2 -march=pentiumpro
+endif

diff --git a/mk/config.mk.in b/mk/config.mk.in
index a81ff84..535790e 100644 (file)
--- a/mk/config.mk.in
+++ b/mk/config.mk.in
@@ -17,9 +17,11 @@
 #        so if you edit config.mk your changes will be spammed.
 #
 #      - Settings in this file may be overriden by giving replacement
-#        definitions in build.mk.  If you don't have a build.mk file
-#        then you get defaults for everything.  The defaults should
-#        provide a reasonable vanilla build.
+#        definitions in build.mk.  See build.mk.sample for a good
+#        starting point for a build.mk file.
+#
+#        If you don't have a build.mk file then you get defaults for everything.
+#        The defaults should provide a reasonable vanilla build.
 #
 # This is one of only two files that configure generates (the other is config.h)
 #