| I'm trying to come to grips with GHC, and one thing that I | think would help would be a nice guide to the Core and STG | syntaxes. There is an old guide to Core syntax in the user | guide (section 4.17.3) but that section remains unchanged | from at least version 0.29 of the compiler, and is looking | rather out of date. Indeed that would be nice. The best there is is Andrew Tolmach's external-core representation, which is described rather thoroughly in http://www.haskell.org/ghc/docs/papers/core.ps.gz The various -ddump outputs are not well documented, and change reguarly anyway. It's easier to agree that documentation would be useful than to generate such documentation. Let me make a constructive suggestion, though. Often people learn stuff about GHC. There's an easy way for them to record what they learned, by putting it in Manuel's GHC commentary: http://www.cse.unsw.edu.au/~chak/haskell/ghc/comm/ Notes in the commentary don't need to be complete or consistent -- but if you simply jot down (in HTML) the things you wish you had known to start with, your jottings can easily be incorporated and help the next person. So send us your jottings! (For those with access to the CVS repository, it's in fptools/ghc/docs/comm/ Simon