Building and Installing the Glasgow Functional Programming Tools Suite

The GHC Team, Department of Computing Science, University of Glasgow, Glasgow, Scotland, G12 8QQ. Email: glasgow-haskell-{users,bugs}@dcs.gla.ac.uk

1. Getting the Glasgow fptools suite

2. Things to check before you start typing

3. What machines the Glasgow tools run on

• 3.1 What platforms the Haskell compiler (GHC) runs on
• 3.2 What machines the other tools run on

4. Installing from binary distributions

• 4.1 Bundle structure
• 4.2 What bundles there are
• 4.3 Testing that GHC seems to be working

5. Installing pre-supposed utilities

6. Building from source

• 6.1 Your source tree
• 6.2 Build trees
• 6.3 Getting the build you want
• 6.4 The story so far
• 6.5 Making things
• 6.6 Standard Targets

7. The Makefile architecture

• 7.1 A small project
• 7.2 A larger project
• 7.3 Boilerplate architecture
• 7.4 The main mk/boilerplate.mk file
• 7.5 Pattern rules and options
• 7.6 The main mk/target.mk file
• 7.7 Recursion
• 7.8 Way management
• 7.9 When the canned rule isn't right

8. Booting/porting from C (.hc) files

9. Known pitfalls in building Glasgow Haskell