wiki:Attic/BeginnersNotes

Version 11 (modified by guest, 8 years ago) (diff)

--

Notes From a Beginning GHC Hacker

General notes (some just for Windows)

  1. The Building Guide is very good, read the appropriate parts.
  2. Optimize your set up for build speed. Having to wait 10 minutes to compile because you added an export to a critical module is no fun.
    1. Use MSYS, not cygwin. MSYS is much faster.
    2. Do not use -O to compile GHC while you are making heavy changes. Once things compile smoothly and you want to test it, compile with optimization (on my machine, adding -O triples the compile time for a fresh 'make').
  3. If you do a 'make tags' then you can go right to the definition of a function (from any module) using alt-. in emacs.
  4. If you need to add or delete modules, use 'make boot' to fix up the dependencies.

Notes on the type system (and its interactions)

The compiler is, of course, found in the fptools/compiler directory. Important subdirectories for hacking on the type system include:

The critical parts dealing with types are in the 'types' and 'typecheck' directories:

types

  • TypeRep?.lhs
    • The representation of types, the Type datatype, is defined here and exported concretely
    • A few crucial type constructors (like ->) are defined here in order to avoid excessive module loops
  • TyCon?.lhs
    • The representation of type constructors, TyCon?, is defined here and exported abstractly
    • Construction and manipulation functions for type constructors are here
  • Type.lhs
    • Contains the bulk of the type system, imports the concrete representation from TypeRep?, and re-exports Type abstractly