installation refinements
[lambda.git] / how_to_get_the_programming_languages_running_on_your_computer.mdwn
index 1afe9b6..0937db1 100644 (file)
@@ -29,7 +29,7 @@ Furthermore, Mac users will be in one of two subgroups:
 
     There are also other package management systems available for the Mac, notably Homebrew and Fink. I only know a little bit about them.
 
-    There are instructions about how to get Xcode on the [Installing MacPorts](https://www.macports.org/install.php) page.
+    There are instructions about how to get Xcode on the [Installing MacPorts](http://www.macports.org/install.php) page.
     Some versions of [Xcode](http://developer.apple.com/xcode.html) are available for free on the Mac App Store.
     Other versions are available through Apple's Developer website (some of these are free, but do require you to
     register with Apple as an "Apple Developer", which involves clicking to accept a legal agreement with Apple).
@@ -123,7 +123,7 @@ If for some reason you have problems with Racket, other implementations you coul
 try are
 [Chicken](http://www.call-cc.org),
 [Gauche](http://practical-scheme.net/gauche),
-or [Chibi](https://code.google.com/p/chibi-scheme). The later in that list you go, the more likely it
+or [Chibi](http://code.google.com/p/chibi-scheme). The later in that list you go, the more likely it
 is that you'll have to compile the software yourself. (Thus Mac users will need Xcode.)
 
 Racket stands to Scheme in something like the relation Firefox stands to HTML. It's one program (or platform) among others for working with the Scheme language; and many of those programs (or web browsers) permit different extensions, have small variations, and so on.
@@ -206,7 +206,7 @@ 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).
 
-*   *Another instruction page focuses on [OPAM](http://ocaml.org/docs/install.html), also [this](https://opam.ocaml.org).*
+*   *Another instruction page focuses on [OPAM](http://ocaml.org/docs/install.html), also [this](http://opam.ocaml.org).*
 
 *   *[More details about installing OCaml on Macs, if needed](http://cocan.org/getting_started_with_ocaml_on_mac_os_x)*
 
@@ -287,7 +287,7 @@ The current version of OCaml is 4.02.1 (released October 2014).
     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:
-    <https://godirepo.camlcity.org/svn/lib-findlib/trunk/INSTALL>.
+    <http://godirepo.camlcity.org/svn/lib-findlib/trunk/INSTALL>.
 
     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
@@ -314,33 +314,36 @@ other.
 
     There is a (slow, bare-bones) version of Haskell available for online use at <http://tryhaskell.org/>.
 
-Like Scheme, Haskell has a couple of different implementations. The dominant one, and the one we recommend you install, is called GHC, short for "Glasgow Haskell Compiler". To install this on your machine, there are a couple of different strategies. It's helpful to understand some lingo as you begin this process:
+Like Scheme, Haskell has a couple of different implementations. The dominant one, and the one we recommend you install, is called [GHC](http://wiki.haskell.org/GHC), short for "Glasgow Haskell Compiler". To install this on your machine, there are a couple of different strategies. It's helpful to understand some lingo as you begin this process:
 
-*   As mentioned, **[GHC](https://wiki.haskell.org/GHC)** is the main Haskell engine or compiler you'll be installing. The current version is 7.8.4, from December 2014.
+*   As mentioned, **GHC** is the main Haskell engine or compiler you'll be installing. The current version is 7.8.4, from December 2014.
 *   **gcc** and **llvm/clang** and **Xcode** and **MinGW** are names for other compilers on different systems. Oftentimes these will be used during the installation process to get GHC up and running. Some of the strategies described below will help you install these if they're not already on your machine.
 *   **alex** and **happy** and **haddock** are names of various Haskell helper programs that GHC uses to get up and running.
-*   **cabal** is a "package manager" for Haskell. It allows you to install libraries or extensions that other people have built. (Usually those are published at the [Hackage](http://hackage.haskell.org) web site. Some of these are experimental and may not always work; others are quite fundamental and are almost de facto parts of what people expect in a Haskell system.
-*   **[Haskell Platform](https://www.haskell.org/platform)** is a standard bundle that includes a fixed version of GHC, plus fixed versions of some of the most popular libraries or extensions. This is updated once or twice a year. The current version is 2014.2.0.0, from August 2014. It includes GHC version 7.8.3.
+*   **[Cabal](http://www.haskell.org/cabal)** is a "package manager" for Haskell. It allows you to install libraries or extensions that other people have built. (Usually those are published at the [Hackage](http://hackage.haskell.org) web site.) Some of these are experimental and may not always work; others are quite fundamental and are almost de facto parts of what people expect in a Haskell system.
+*   **[Haskell Platform](http://www.haskell.org/platform)** is a standard bundle that includes a fixed version of GHC, plus fixed versions of some of the most popular libraries or extensions. This is updated once or twice a year. The current version is 2014.2.0.0, from August 2014. It includes GHC version 7.8.3.
 
-The easiest way to get up and running with Haskell/GHC is to install the Haskell Platform. Here's how to do that on Ubuntu or Debian Linux:
+The easiest way to get up and running with Haskell/GHC is to install the Haskell Platform. Here's how to do that on Windows:
 
-*   In a Terminal, type `sudo apk-get install haskell-platform`.
+*   Go to <http://www.haskell.org/platform/windows.html> and follow the instructions. It looks like this process will automatically install the MinGW compiler needed to get this build of Haskell running on Windows.
 
 On a Mac without MacPorts:
 
-*   \<Instructions>
-*   <https://github.com/pittsburgh-haskell/haskell-installation>
+*   Go to <http://www.haskell.org/platform/mac.html> and follow the instructions. This requires Mac OS X 10.6 / Snow Leopard or later; but there is a link to an earlier version of Haskell Platform, that's built for Mac OS X 10.5 / Leopard. These instructions also require that you have (parts of) Apple's Xcode tools installed. (These are mentioned above.) There are some very brief comments about different options for how to get that on the Haskell Platform page.
+
+*   [Here is more info](http://github.com/pittsburgh-haskell/haskell-installation) about installing Haskell on Macs.
 
 On a Mac with MacPorts:
 
-*   \<Instructions>
+*   In a Terminal, type `sudo port install haskell-platform`.
 
-On Windows:
+On Ubuntu or Debian Linux:
+
+*   In a Terminal, type `sudo apk-get install haskell-platform`.
 
-*   \<Instructions>
 
+---
 
+*   It's useful to know about the general [Haskell wiki](http://wiki.haskell.org) (not restricted to just GHC). They have a [Getting Started](http://wiki.haskell.org/Haskell_in_5_steps) page, which also recommends that you install the Haskell Platform.
 
-*   Getting started: <https://wiki.haskell.org/Haskell_in_5_steps>
-*   <new-www.haskell.org/downloads>
+*   <http://new-www.haskell.org/downloads>