X-Git-Url: http://git.megacz.com/?a=blobdiff_plain;f=ghc%2Fdocs%2Fusers_guide%2Fusing.xml;h=8cbcd35fca6cb6f6dcf01dbb8865bcaa9dc42ea1;hb=c6b2930d3f7d91217a634bd592d184e383598e67;hp=6dc0ac00e8a723c722aacd674af8348db234713d;hpb=c30b7a08bf1571f316ce804f26f0ef52d28e08da;p=ghc-hetmet.git diff --git a/ghc/docs/users_guide/using.xml b/ghc/docs/users_guide/using.xml index 6dc0ac0..8cbcd35 100644 --- a/ghc/docs/users_guide/using.xml +++ b/ghc/docs/users_guide/using.xml @@ -153,19 +153,19 @@ module X where - - .lhs - lhs suffix - + .hs - A “literate Haskell” module. + A Haskell module. - .hs + + .lhs + lhs suffix + - A not-so-literate Haskell module. + A “literate Haskell” module. @@ -368,7 +368,7 @@ ghc ––make Main.hs file. - You don't have to write aMakefile. + You don't have to write a Makefile. Makefilesavoiding @@ -551,9 +551,9 @@ ghc -c Foo.hs - suffix - - + suffix + + Causes all files following this option on the command line to be processed as if they had the suffix @@ -746,6 +746,19 @@ ghc -c Foo.hs it). + + + + + + + Prints a one-line summary of timing statistics for the + GHC run. This option is equivalent to + +RTS -tstderr, see . + + + @@ -1478,38 +1491,47 @@ f "2" = 2 &phases; -Using Concurrent Haskell + Using Concurrent Haskell + Concurrent Haskellusing - Concurrent Haskell—use + GHC supports Concurrent Haskell by default, without requiring a + special option or libraries compiled in a certain way. To get access to + the support libraries for Concurrent Haskell, just import + Control.Concurrent. More information on Concurrent Haskell is provided in the documentation for that module. - -GHC supports Concurrent Haskell by default, without requiring a -special option or libraries compiled in a certain way. To get access -to the support libraries for Concurrent Haskell, just import -Control.Concurrent (details are in the accompanying -library documentation). + The following RTS option(s) affect the behaviour of Concurrent + Haskell programs:RTS options, concurrent - -RTS options are provided for modifying the behaviour of the threaded -runtime system. See . - - - -Concurrent Haskell is described in more detail in the documentation -for the Control.Concurrent module. - - - + + + + + RTS option + Sets the context switch interval to s + seconds. A context switch will occur at the next heap block + allocation after the timer expires (a heap block allocation occurs + every 4k of allocation). With or + , context switches will occur as often as + possible (at every heap block allocation). By default, context + switches occur every 20ms. Note that GHC's internal timer ticks + every 20ms, and the context switch timer is always a multiple of + this timer, so 20ms is the maximum granularity available for timed + context switches. + + + + Using parallel Haskell -parallel Haskell—use - - - -[You won't be able to execute parallel Haskell programs unless PVM3 +Parallel Haskellusing +[NOTE: GHC does not support Parallel Haskell by default, you need to + obtain a special version of GHC from the GPH site. Also, +you won't be able to execute parallel Haskell programs unless PVM3 (parallel Virtual Machine, version 3) is installed at your site.] @@ -1518,7 +1540,7 @@ To compile a Haskell program for parallel execution under PVM, use the option,-parallel option both when compiling and linking. You will probably want to import -parallel into your Haskell modules. +Control.Parallel into your Haskell modules. @@ -1650,7 +1672,7 @@ results—only with “how parallel” it was! We want pretty pictu parallelism profiles (à la hbcpp) can be generated with the --qP RTS option (concurrent, parallel) RTS option. The +-qP RTS option RTS option. The per-processor profiling info is dumped into files named <full-path><program>.gr. These are then munged into a PostScript picture, which you can then display. For example, to run your program @@ -1695,20 +1717,18 @@ what's happening overall is: tail -f /tmp/pvml.nnn. -RTS options for Concurrent/parallel Haskell +<title>RTS options for Parallel Haskell -RTS options, concurrent RTS options, parallel -Concurrent Haskell—RTS options parallel Haskell—RTS options Besides the usual runtime system (RTS) options (), there are a few options particularly -for concurrent/parallel execution. +for parallel execution. @@ -1725,17 +1745,16 @@ the default is 2. -: +: --C<us> RTS option Sets +-C<s> RTS option Sets the context switch interval to <s> seconds. A context switch will occur at the next heap block allocation after the timer expires (a heap block allocation occurs every 4k of allocation). With or , context switches will occur as often as possible (at every heap block -allocation). By default, context switches occur every 20ms -milliseconds. Note that GHC's internal timer ticks every 20ms, and +allocation). By default, context switches occur every 20ms. Note that GHC's internal timer ticks every 20ms, and the context switch timer is always a multiple of this timer, so 20ms is the maximum granularity available for timed context switches. @@ -1764,7 +1783,7 @@ check (with ). -qt<num> RTS option -(paraLLEL ONLY) Limit the thread pool size, i.e. the number of concurrent +(paraLLEL ONLY) Limit the thread pool size, i.e. the number of threads per processor to <num>. The default is 32. Each thread requires slightly over 1K words in the heap for thread state and stack objects. (For 32-bit machines, this