X-Git-Url: http://git.megacz.com/?a=blobdiff_plain;f=ghc%2Fdocs%2Fusers_guide%2Fusing.xml;h=761d6cff6a7f8eb5733f68afd9eb35928b1e31e9;hb=8e26abeefde8ee20acfe269aff9349164774d2a9;hp=141dd4a6710a35811ea13d92d746e070eb49748d;hpb=d2976cf4c60e5c54902adc7b19b46614684bdc28;p=ghc-hetmet.git
diff --git a/ghc/docs/users_guide/using.xml b/ghc/docs/users_guide/using.xml
index 141dd4a..761d6cf 100644
--- a/ghc/docs/users_guide/using.xml
+++ b/ghc/docs/users_guide/using.xml
@@ -1478,38 +1478,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 +1527,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 +1659,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 +1704,18 @@ what's happening overall is: tail -f /tmp/pvml.nnn.
-RTS options for Concurrent/parallel Haskell
+RTS options for Parallel Haskell
-RTS options, concurrentRTS options, parallel
-Concurrent Haskell—RTS optionsparallel Haskell—RTS options
Besides the usual runtime system (RTS) options
(), there are a few options particularly
-for concurrent/parallel execution.
+for parallel execution.
@@ -1763,7 +1770,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