Difference between revisions of "GHC"

From HaskellWiki
Jump to navigation Jump to search
(Remove building guide link, direct people to the GHC wiki instead)
(22 intermediate revisions by 12 users not shown)
Line 1: Line 1:
The '''Glasgow Haskell Compiler''' is a state-of-the-art, open source, compiler and interactive environment for the functional language Haskell.
+
The '''Glasgow Haskell Compiler''' is a state-of-the-art, open source compiler and interactive environment for the functional language Haskell.
   
 
* [http://www.haskell.org/ghc/ The GHC Home Page]
 
* [http://www.haskell.org/ghc/ The GHC Home Page]
Line 9: Line 9:
 
These documents relate to the ''latest released'' version of GHC.
 
These documents relate to the ''latest released'' version of GHC.
 
For ''earlier released'' versions click the relevant version on the
 
For ''earlier released'' versions click the relevant version on the
[http://www.haskell.org/ghc/download.html downloads page].
+
[http://www.haskell.org/ghc/download downloads page].
 
For the the ''current HEAD snapshot'' look at
 
For the the ''current HEAD snapshot'' look at
 
[http://www.haskell.org/ghc/download.html#snapshots development snapshots].
 
[http://www.haskell.org/ghc/download.html#snapshots development snapshots].
Line 15: Line 15:
   
 
; [http://www.haskell.org/ghc/docs/latest/html/users_guide/index.html The User's Guide]: The User's Guide has all you need to know about using GHC: command line options, language extensions, GHCi, etc.
 
; [http://www.haskell.org/ghc/docs/latest/html/users_guide/index.html The User's Guide]: The User's Guide has all you need to know about using GHC: command line options, language extensions, GHCi, etc.
: Download: | [http://www.haskell.org/ghc/docs/latest/users_guide.html.tar.gz HTML.tar.gz] | [http://www.haskell.org/ghc/docs/latest/users_guide.pdf PDF] | [http://www.haskell.org/ghc/docs/latest/users_guide.ps.gz A4 Postscript (gzipped)] |
+
: Download: | [http://www.haskell.org/ghc/docs/latest/users_guide.html.tar.bz2 HTML.tar.bz2] | [http://www.haskell.org/ghc/docs/latest/users_guide.pdf PDF] | [http://www.haskell.org/ghc/docs/latest/users_guide.ps PS] |
 
 
 
; [http://www.haskell.org/ghc/docs/latest/html/libraries/index.html Standard Libraries]: Documentation for the libraries that come with GHC.
 
; [http://www.haskell.org/ghc/docs/latest/html/libraries/index.html Standard Libraries]: Documentation for the libraries that come with GHC.
: Download: | [http://www.haskell.org/ghc/docs/latest/libraries.html.tar.gz HTML.tar.gz] |
+
: Download: | [http://www.haskell.org/ghc/docs/latest/libraries.html.tar.bz2 HTML.tar.bz2]
 
 
; [http://www.haskell.org/ghc/docs/latest/html/Cabal/index.html Cabal]: An infrastructure for building and distributing Haskell software.
+
; [http://www.haskell.org/cabal/users-guide/ Cabal]: An infrastructure for building and distributing Haskell software.
: Download: | [http://www.haskell.org/ghc/docs/latest/Cabal.html.tar.gz HTML.tar.gz] | [http://www.haskell.org/ghc/docs/latest/Cabal.pdf PDF] | [http://www.haskell.org/ghc/docs/latest/Cabal.ps.gz A4 Postscript (gzipped)] |
 
   
 
== Collaborative documentation ==
 
== Collaborative documentation ==
Line 33: Line 32:
 
** [[How_to_write_a_Haskell_program|How to write a Haskell program]]
 
** [[How_to_write_a_Haskell_program|How to write a Haskell program]]
 
** [[/FAQ|GHC FAQ]]
 
** [[/FAQ|GHC FAQ]]
  +
** [[/Error messages|Error messages]]
  +
** [[Upgrading_packages|Guidelines for upgrading your GHC]]
 
** [[/GHCi|Using GHCi]]
 
** [[/GHCi|Using GHCi]]
 
** [[/GHCi debugger| The GHCi debugger]]
 
** [[/GHCi debugger| The GHCi debugger]]
 
** [[Cabal|Using Cabal]] (including with DLLs)
 
** [[Cabal|Using Cabal]] (including with DLLs)
 
** The [[Performance|Haskell Performance Resource]], for advice on improving the performance of your code
 
** The [[Performance|Haskell Performance Resource]], for advice on improving the performance of your code
  +
** [[Mutually recursive modules]]
  +
** [[/Memory_Management| Memory management and garbage collection]]
  +
** [[/Memory Footprint|Memory footprint on the heap of common data-structures]]
  +
  +
* Platform related matters
 
** [[GHC under WINE|Running GHC under Wine]]
 
** [[GHC under WINE|Running GHC under Wine]]
  +
** [[Mac OS X]]
  +
** [[Windows]]
  +
*** [http://haskell.forkio.com/dotnet Using GHC with .NET]
  +
*** [http://haskell.forkio.com/gmpwindows Dynamically linking GMP on Windows]
   
 
* GHC extensions
 
* GHC extensions
Line 44: Line 54:
 
** [[/Concurrency|Concurrent programming in GHC]]
 
** [[/Concurrency|Concurrent programming in GHC]]
 
** [[Template Haskell]] is a (GHC) extension to Haskell that adds compile-time metaprogramming facilities.
 
** [[Template Haskell]] is a (GHC) extension to Haskell that adds compile-time metaprogramming facilities.
  +
** [[Quasiquotation]] allows the ability for user-definable parsers to provide new concrete syntax for any datatype.
 
** [http://www.cse.unsw.edu.au/~dons/hs-plugins Dynamically loaded Haskell modules]: Don Stewart's <tt>hs-plugins</tt> library
 
** [http://www.cse.unsw.edu.au/~dons/hs-plugins Dynamically loaded Haskell modules]: Don Stewart's <tt>hs-plugins</tt> library
 
** [[/Using the FFI|Using the Foreign Function Interface]]
 
** [[/Using the FFI|Using the Foreign Function Interface]]
Line 49: Line 60:
 
** [[/Using rules|Using RULES in GHC]]
 
** [[/Using rules|Using RULES in GHC]]
 
** [[GHC/Data Parallel Haskell|Data Parallel Haskell: using nested data parallelism in GHC]]
 
** [[GHC/Data Parallel Haskell|Data Parallel Haskell: using nested data parallelism in GHC]]
  +
** [[Roles]] are GHC's way of discerning the difference between compile-time type equality (created by type synonyms and type families) and runtime type equality (created by newtypes).
   
 
* [[Correctness of short cut fusion]]
 
* [[Correctness of short cut fusion]]
Line 55: Line 67:
   
 
See the [http://hackage.haskell.org/trac/ghc GHC Developer Wiki]. The latest snapshot of the documentation for the next version can be found [http://haskell.org/ghc/dist/current/docs/ here].
 
See the [http://hackage.haskell.org/trac/ghc GHC Developer Wiki]. The latest snapshot of the documentation for the next version can be found [http://haskell.org/ghc/dist/current/docs/ here].
  +
  +
* [[/SIMD|SIMD CPU operations]]
   
 
[[Category:Implementations]]
 
[[Category:Implementations]]

Revision as of 18:58, 8 April 2014

The Glasgow Haskell Compiler is a state-of-the-art, open source compiler and interactive environment for the functional language Haskell.

Documentation

The documentation below relates to using GHC. For documentation about GHC's internals and building GHC, head over to the GHC Developer Wiki.

These documents relate to the latest released version of GHC. For earlier released versions click the relevant version on the downloads page. For the the current HEAD snapshot look at development snapshots.


The User's Guide
The User's Guide has all you need to know about using GHC: command line options, language extensions, GHCi, etc.
Download: | HTML.tar.bz2 | PDF | PS |
Standard Libraries
Documentation for the libraries that come with GHC.
Download: | HTML.tar.bz2
Cabal
An infrastructure for building and distributing Haskell software.

Collaborative documentation

GHC is a big system. We try to document the core functionality (above), but you can help by writing documentation yourself. This section collects documentation written in a collaborative way, by users and developers together. Please help by adding new sections, and by clarifying and improving existing ones.

Development of GHC

See the GHC Developer Wiki. The latest snapshot of the documentation for the next version can be found here.