OCaml installation refinements
[lambda.git] / how_to_get_the_programming_languages_running_on_your_computer.mdwn
index eb84656..bea78cf 100644 (file)
@@ -234,10 +234,8 @@ This will make it easier to install additional add-ons further down the road.
 However, if you're not able to get that working, don't worry about it much.
 
 The current version of OCaml is 4.02.1 (released October 2014).
+<!-- 3.12.1 July 2011; 4.00.1 Oct 2012; 4.01.0 Sept 2013; 4.02.0 Aug 2014; 4.02.1 Oct 2014 -->
 
-*   *Another instruction page focuses on [OPAM](http://ocaml.org/docs/install.html), also [this](https://opam.ocaml.org).*
-
-*   *[More details about installing OCaml on Macs, if needed](http://cocan.org/getting_started_with_ocaml_on_mac_os_x)*
 
 *   In your web browser:
 
@@ -252,8 +250,8 @@ The current version of OCaml is 4.02.1 (released October 2014).
     even if you don't know what MinGW or Cygwin are.
     Some features of this require Cygwin, but it looks like
     it should mostly work even for users without Cygwin.
-    At the time of this writing, only an installer for the previous
-    version of OCaml (3.11.0, from January 2010) is available.
+    At the time of this writing, only an installer for an earlier
+    version of OCaml (4.01.0, from September 2013) is available.
 
     To install the Findlib add-on, you must have the
     Cygwin system installed. We assume few of you do,
@@ -263,6 +261,13 @@ The current version of OCaml is 4.02.1 (released October 2014).
 
 *   **To install on Mac without MacPorts**
 
+    *Instructions coming*
+
+*   *Another instruction page focuses on [OPAM](http://ocaml.org/docs/install.html), also [this](https://opam.ocaml.org).*
+
+*   *[More details about installing OCaml on Macs, if needed](http://mirror.ocamlcore.org/wiki.cocan.org/getting_started_with_ocaml_on_mac_os_x)*
+
+    <!--
     To install OCaml 3.12 (just released this summer), go to
     <http://caml.inria.fr/download.en.html>
     and download and install the "Binary distribution for Mac OS X"
@@ -283,14 +288,14 @@ The current version of OCaml is 4.02.1 (released October 2014).
 
     This will build an installer package which you should be able to
     double-click and install.
+    -->
 
 *   **To install on Mac with MacPorts**
 
-    You can install the previous version of OCaml (3.11.2,
-    from January 2010), together with the Findlib add-on, by opening a Terminal
-    and typing:
+    You can install the current version of OCaml (4.02.1, from October 2014),
+    together with the Findlib add-on and OPAM package manager, by opening a Terminal and typing:
 
-        sudo port install ocaml caml-findlib
+        sudo port install ocaml caml-findlib opam
 
     As with Scheme, it's helpful to also have rlwrap installed, and to start OCaml as `rlwrap ocaml`. This gives
     you a nice history of the commands you've already typed, which you can scroll up and down in with your
@@ -301,9 +306,9 @@ The current version of OCaml is 4.02.1 (released October 2014).
     Use your packaging system, for example, open a Terminal and
     type:
 
-        sudo apt-get install ocaml ocaml-findlib
+        sudo apt-get install ocaml ocaml-findlib opam
 
-    That will install a version of OCaml and the Findlib add-on.
+    That will install a version of OCaml and the Findlib add-on and OPAM package manager.
 
     If for some reason you can't get OCaml through your
     packaging system, you can go to
@@ -312,7 +317,7 @@ The current version of OCaml is 4.02.1 (released October 2014).
 
     If you can't get findlib through your packaging system, you'll
     need to download it from
-    <http://download.camlcity.org/download/findlib-1.2.6.tar.gz>.
+    <http://download.camlcity.org/download/findlib-1.5.5.tar.gz>.
     and use gcc to compile it yourself. If you don't know how to
     do that, you probably don't want to attempt this.
     Here are the INSTALL notes:
@@ -368,7 +373,7 @@ On **Ubuntu or Debian Linux**:
 *   In a Terminal, type `sudo apt-get install haskell-platform`.
 
 
-If any of the instructions above don't work, then you can try alternative instructions for [Windows](http://new-www.haskell.org/downloads/windows) or [Mac](http://new-www.haskell.org/downloads/osx) or [Ubuntu](http://new-www.haskell.org/downloads/linux). After installing the software, you should open a terminal and type `cabal update && cabal install alex happy`. If typing `which ghci` in a Terminal doesn't give you any reply, you may need to type `echo 'export PATH=/usr/local/bin:$PATH' >> ~/.bashrc`, then exit and restart your Terminal session.
+If any of the instructions above don't work, then you can try alternative instructions for [Mac](http://new-www.haskell.org/downloads/osx) or [Windows](http://new-www.haskell.org/downloads/windows) or [Ubuntu](http://new-www.haskell.org/downloads/linux). After installing the software, open a Terminal and type `cabal update && cabal install alex happy`. <!-- If typing `which ghci` in a Terminal doesn't give you any reply, you may need to type `echo 'export PATH=/usr/local/bin:$PATH' >> ~/.bashrc`, then exit and restart your Terminal session. --> Note that this method doesn't install all the extensions that are part of the Haskell Platform, but only the core pieces of GHC. You can use Cabal to download and manage any extra extensions you turn out to need, down the road.
 
 It's useful to know about the general [Haskell wiki](https://wiki.haskell.org) (not restricted to just GHC). They have a [Getting Started](https://wiki.haskell.org/Haskell_in_5_steps) page, which also recommends that you install the Haskell Platform.