From d619525e70b4591eec62a598bf2cbf1c4f3c837e Mon Sep 17 00:00:00 2001 From: simonmar Date: Fri, 7 Apr 2000 13:26:33 +0000 Subject: [PATCH] [project @ 2000-04-07 13:26:33 by simonmar] Small updates, and link to the Concurrent section in the Hslibs docs. --- ghc/docs/users_guide/glasgow_exts.sgml | 7 ++- ghc/docs/users_guide/installing.sgml | 31 +++++------ ghc/docs/users_guide/intro.sgml | 12 +---- ghc/docs/users_guide/parallel.sgml | 17 +++--- ghc/docs/users_guide/using.sgml | 93 ++++++++++++++++++-------------- 5 files changed, 78 insertions(+), 82 deletions(-) diff --git a/ghc/docs/users_guide/glasgow_exts.sgml b/ghc/docs/users_guide/glasgow_exts.sgml index 35bbb8d..4748af3 100644 --- a/ghc/docs/users_guide/glasgow_exts.sgml +++ b/ghc/docs/users_guide/glasgow_exts.sgml @@ -2212,10 +2212,9 @@ stuff is hairy with a capital H! This section documents GHC's implementation of multi-paramter type classes. There's lots of background in the paper Type classes: exploring the design space (Simon Peyton -Jones, Mark Jones, Erik Meijer). +URL="http://research.microsoft.com/~simonpj/multi.ps.gz" >Type +classes: exploring the design space (Simon Peyton Jones, Mark +Jones, Erik Meijer). diff --git a/ghc/docs/users_guide/installing.sgml b/ghc/docs/users_guide/installing.sgml index 730901c..8a28e3c 100644 --- a/ghc/docs/users_guide/installing.sgml +++ b/ghc/docs/users_guide/installing.sgml @@ -163,14 +163,6 @@ for the installation. Again, there is a sub-directory for each -info/ - - -contains Emacs info documentation files (one -sub-directory per project). - - - html/ @@ -323,21 +315,26 @@ documentation. The values for these variables can be set through invocation of the -configureconfigure script that comes with the distribution, -but doing an optical diff to see if the values match your expectations -is always a Good Idea. - -Instead of running configure, it is perfectly OK to copy -Makefile.in to Makefile and set all these variables -directly yourself. But do it right! +configureconfigure +script that comes with the distribution, but doing an optical diff to +see if the values match your expectations is always a Good Idea. + + +Instead of running configure, it is +perfectly OK to copy Makefile.in to +Makefile and set all these variables directly +yourself. But do it right! + -Run make install. This should work with ordinary Unix -make—no need for fancy stuff like GNU make. +Run make install. This +should work with ordinary Unix +make—no need for fancy stuff like GNU +make. diff --git a/ghc/docs/users_guide/intro.sgml b/ghc/docs/users_guide/intro.sgml index fb8e9e7..30f9214 100644 --- a/ghc/docs/users_guide/intro.sgml +++ b/ghc/docs/users_guide/intro.sgml @@ -251,15 +251,6 @@ URL="http://www.haskell.org/ghc/" Glasgow FP group page - - - - - - comp.lang.functional FAQ @@ -360,8 +351,7 @@ subscribe haskell My Name <m.y.self@fp.rules.ok.org> Some Haskell-related discussion takes place in the Usenet newsgroup -comp.lang.functional. (But note: news is basically dead at Glasgow. -That's one reason Glaswegians aren't too active in c.f.l.) +comp.lang.functional. diff --git a/ghc/docs/users_guide/parallel.sgml b/ghc/docs/users_guide/parallel.sgml index 4970b09..242b87a 100644 --- a/ghc/docs/users_guide/parallel.sgml +++ b/ghc/docs/users_guide/parallel.sgml @@ -28,14 +28,16 @@ a single Unix process on a single processor. You will find at least one paper about Concurrent Haskell hanging off -of Simon Peyton Jones's Web page. +of Simon Peyton +Jones's Web page. -Parallel Haskell is about speed—spawning threads onto multiple -processors so that your program will run faster. The `threads' -are always advisory—if the runtime system thinks it can -get the job done more quickly by sequential execution, then fine. +Parallel Haskell is about speed—spawning +threads onto multiple processors so that your program will run faster. +The `threads' are always advisory—if the +runtime system thinks it can get the job done more quickly by +sequential execution, then fine. @@ -55,10 +57,7 @@ Again, check Simon's Web page for publications about Parallel Haskell Some details about Parallel Haskell follow. For more information -about concurrent Haskell, see the Concurrent section in the GHC/Hugs Extension Libraries documentation. +about concurrent Haskell, see . diff --git a/ghc/docs/users_guide/using.sgml b/ghc/docs/users_guide/using.sgml index 844a0f8..4358ac8 100644 --- a/ghc/docs/users_guide/using.sgml +++ b/ghc/docs/users_guide/using.sgml @@ -935,9 +935,19 @@ Haskell libraries. option -Turn on recompilation checking. This will stop compilation early, -leaving an existing .o file in place, if it can -be determined that the module does not need to be recompiled. +(On by default) Turn on recompilation checking. This will stop +compilation early, leaving an existing .o file in +place, if it can be determined that the module does not need to be +recompiled. + + + + + + option + + +Turn off recompilation checking. @@ -1348,9 +1358,9 @@ safely (see ). No -type option specified: +-O* not specified --O* not specified This is taken to mean: “Please compile quickly; I'm not over-bothered about compiled-code quality.” So, for example: ghc -c Foo.hs @@ -1358,22 +1368,22 @@ about compiled-code quality.” So, for example: ghc -c Foo.hs or : - - -O option -O1 option -optimise normally -Means: “Generate good-quality code without taking too long about it.” -Thus, for example: ghc -c -O Main.lhs +optimisenormally + + +Means: “Generate good-quality code without taking too long about +it.” Thus, for example: ghc -c -O Main.lhs : +-O2 option +optimiseaggressively --O2 option -optimise aggressively Means: “Apply every non-dangerous optimisation, even if it means significantly longer compile times.” @@ -1392,12 +1402,9 @@ better code than . : - - -O2-for-C option gcc, invoking with -O2 - - + Says to run GCC with , which may be worth a few percent in execution speed. Don't forget , lest you use the native-code @@ -1407,35 +1414,33 @@ generator and bypass GCC altogether! : - - -Onot option optimising, reset - - + -This option will make GHC “forget” any ish options it has seen so -far. Sometimes useful; for example: make all EXTRA_HC_OPTS=-Onot. +This option will make GHC “forget” any +ish options it has seen so far. Sometimes useful; +for example: make all +EXTRA_HC_OPTS=-Onot. : - - -Ofile <file> option optimising, customised - - + -For those who need absolute control over exactly -what options are used (e.g., compiler writers, sometimes :-), a list -of options can be put in a file and then slurped in with . +For those who need absolute control over +exactly what options are used (e.g., compiler +writers, sometimes :-), a list of options can be put in a file and +then slurped in with . -In that file, comments are of the #-to-end-of-line variety; blank -lines and most whitespace is ignored. +In that file, comments are of the +#-to-end-of-line variety; blank lines and most +whitespace is ignored. @@ -2223,17 +2228,20 @@ options the driver passes through to the linker. GHC (as of version 4.00) 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 -(i.e. Concurrent and friends), use the option. +(i.e. Concurrent and friends), use the + option. Three RTS options are provided for modifying the behaviour of the -threaded runtime system. See the descriptions of , , -and in . +threaded runtime system. See the descriptions of +, , and + in . -Concurrent Haskell is described in more detail in . +Concurrent Haskell is described in more detail in . @@ -2252,16 +2260,19 @@ Concurrent Haskell is described in more detail in .) +To run your parallel program, once PVM is going, just invoke it +“as normal”. The main extra RTS option is +, to say how many PVM +“processors” your program to run on. (For more details of +all relevant RTS options, please see .) -- 1.7.10.4