X-Git-Url: http://git.megacz.com/?a=blobdiff_plain;ds=sidebyside;f=docs%2Finstalling.vsgml;h=99b3b9f21530a8d07e6e3174e2e05b4d74e5f3e9;hb=3b5c5b4df499fe80e9c60fb84d960842fc30f43a;hp=54c374abe3f7d2f4953b52002919fc9bd10f975e;hpb=33638a09854e586c236f2444e407150817375870;p=ghc-hetmet.git diff --git a/docs/installing.vsgml b/docs/installing.vsgml index 54c374a..99b3b9f 100644 --- a/docs/installing.vsgml +++ b/docs/installing.vsgml @@ -2,7 +2,7 @@
Building and Installing the Glasgow Functional Programming Tools Suite -Version 4.00 +Version 4.04 <author>The GHC Team, Department of Computing Science, University of Glasgow, @@ -677,33 +677,15 @@ be less than 32 characters long. <tag>GNU C (@gcc@):</tag> <nidx>pre-supposed: GCC (GNU C compiler)</nidx> <nidx>GCC (GNU C compiler), pre-supposed</nidx> -Version 2.7.2.x is known to work. + +Versions 2.7.2.x, 2.8.1 and egcs 1.1.2 are known to work. Use other +versions at your own risk! If your GCC dies with ``internal error'' on some GHC source file, please let us know, so we can report it and get things improved. (Exception: on @iX86@ boxes---you may need to fiddle with GHC's @-monly-N-regs@ option; see the User's Guide) -<nidx/EGCS/ EGCS (the Enhanced GNU Compiler Suite) may or may not -work, we haven't tested it fully yet. - -<tag>PVM version 3:</tag> -<nidx>pre-supposed: PVM3 (Parallel Virtual Machine)</nidx> -<nidx>PVM3 (Parallel Virtual Machine), pre-supposed</nidx> - -PVM is the Parallel Virtual Machine on which Parallel Haskell programs -run. (You only need this if you plan to run Parallel Haskell. -Concurent Haskell, which runs concurrent threads on a uniprocessor -doesn't need it.) Underneath PVM, you can have (for example) a -network of workstations (slow) or a multiprocessor box (faster). - -The current version of PVM is 3.3.11; we use 3.3.7. It is readily -available on the net; I think I got it from @research.att.com@, in -@netlib@. - -A PVM installation is slightly quirky, but easy to do. Just follow -the @Readme@ instructions. - <tag>@xargs@ on Solaris2:</tag> <nidx>xargs, presupposed (Solaris only)</nidx> <nidx>Solaris: alternative xargs</nidx> @@ -725,34 +707,13 @@ library. <nidx>pre-supposed: Autoconf</nidx> <nidx>Autoconf, pre-supposed</nidx> -GNU Autoconf is used to build the @configure@ script from -@configure.in@ in a source distribution. If you modify -@configure.in@, you'll need @autoconf@ to regenerate @configure@. - -<tag>@bash@ (Parallel Haskell only):</tag> -<nidx>bash, presupposed (Parallel Haskell only)</nidx> -Sadly, the @gr2ps@ script, used to convert ``parallelism profiles'' -to PostScript, is written in Bash (GNU's Bourne Again shell). -This bug will be fixed (someday). - -<tag>Flex:</tag> -<nidx>pre-supposed: flex</nidx> -<nidx>flex, pre-supposed</nidx> - -This is a quite-a-bit-better-than-Lex lexer. Used to build GHC's -lexer, and a couple of utilities in @glafp-utils@. On our machines, -the version in @/bin@ doesn't work; you need the GNU version. Find -out by saying @flex --version@ (our current version is 2.5.4, but -maybe earlier ones will work). If it doesn't know about the -@--version@ flag, it ain't the right @flex@. +GNU Autoconf is needed if you intend to build from the CVS sources, it +is <em/not/ needed if you just intend to build a standard source +distribution. -<tag>Yacc:</tag> -<nidx>pre-supposed: non-worthless Yacc</nidx> -<nidx>Yacc, pre-supposed</nidx> - -If you mess with the Haskell parser, you'll need a Yacc that can cope. -The unbundled @/usr/lang/yacc@ is OK; the GNU @bison@ is OK; Berkeley -yacc, @byacc@, is not OK. +Autoconf builds the @configure@ script from @configure.in@ and +@aclocal.m4@. If you modify either of these files, you'll need +Autoconf to rebuild @configure@. <tag>@sed@</tag> <nidx>pre-supposed: sed</nidx> @@ -763,7 +724,6 @@ build-configuration stuff needs it. GNU sed version 2.0.4 is no good! It has a bug in it that is tickled by the build-configuration. 2.0.5 is ok. Others are probably ok too (assuming we don't create too elaborate configure scripts..) - </descrip> One @fptools@ project is worth a quick note at this point, because it @@ -771,6 +731,35 @@ is useful for all the others: @glafp-utils@ contains several utilities which aren't particularly Glasgow-ish, but Occasionally Indispensable. Like @lndir@ for creating symbolic link trees. +<sect1> Tools for building parallel GHC (GPH) +<label id="pre-supposed-gph-tools"> +<p> + +<descrip> +<tag>PVM version 3:</tag> +<nidx>pre-supposed: PVM3 (Parallel Virtual Machine)</nidx> +<nidx>PVM3 (Parallel Virtual Machine), pre-supposed</nidx> + +PVM is the Parallel Virtual Machine on which Parallel Haskell programs +run. (You only need this if you plan to run Parallel Haskell. +Concurent Haskell, which runs concurrent threads on a uniprocessor +doesn't need it.) Underneath PVM, you can have (for example) a +network of workstations (slow) or a multiprocessor box (faster). + +The current version of PVM is 3.3.11; we use 3.3.7. It is readily +available on the net; I think I got it from @research.att.com@, in +@netlib@. + +A PVM installation is slightly quirky, but easy to do. Just follow +the @Readme@ instructions. + +<tag>@bash@:</tag> +<nidx>bash, presupposed (Parallel Haskell only)</nidx> +Sadly, the @gr2ps@ script, used to convert ``parallelism profiles'' +to PostScript, is written in Bash (GNU's Bourne Again shell). +This bug will be fixed (someday). +</descrip> + <sect1> Tools for building the Documentation <label id="pre-supposed-doc-tools"> <p> @@ -800,6 +789,20 @@ documentation. We recomment teTeX, which includes just about everything you need. </descrip> +<sect1> Other useful tools +<label id="pre-supposed-other-tools"> +<p> + +<descrip> +<tag>Flex:</tag> +<nidx>pre-supposed: flex</nidx> +<nidx>flex, pre-supposed</nidx> + +This is a quite-a-bit-better-than-Lex lexer. Used to build a couple +of utilities in @glafp-utils@. Depending on your operating system, +the supplied @lex@ may or may not work; you should get the GNU +version. +</descrip> <sect>Building from source <label id="sec:building-from-source">