how_to_get_the_programming_languages_running_on_your_computer.mdwn

   1 Identifying your system
   2 =======================
   3
   4 We'll assume you're using either Mac OS X, or Windows, or Linux.
   5
   6 If you're using Mac OS X, you'll be in one of two subgroups:
   7
   8 * You'll have Apple's Xcode and the independent MacPorts system
   9 installed.
  10 Xcode is available at
  11 <http://developer.apple.com/technologies/tools/xcode.html>
  12 You have to register as an Apple Developer to download it. This
  13 is free but requires you to accept a legal agreement with Apple.
  14 The latest version of Xcode to work with Leopard is 3.14; more
  15 recent versions require Snow Leopard.
  16
  17 The MacPorts system is available at
  18 <http://www.macports.org/>
  19 This automates the building of Unix-type software on your Mac; it
  20 makes it a lot easier to check for dependencies, use more-recent
  21 versions of things, and so on.
  22
  23 * Or you won't have those installed. (Most Mac users will be in this group.)
  24 Then you'll need pre-packaged (and usually pretty GUI) installers for
  25 everything. These are great when they're available and kept up-to-date;
  26 however those conditions aren't always met.
  27
  28 IN EITHER CASE, take note of what version of the Mac OS you're running:
  29 "Tiger" 10.4, or "Leopard" 10.5, or "Snow Leopard" 10.6.
  30
  31
  32 If you're using Windows, you'll be in one of two subgroups:
  33
  34 * You'll have the Cygwin system installed:
  35 <http://www.cygwin.com/>
  36 This puts a Unix-like layer on top of your Windows system,
  37 and makes it easier for you to use the same software everybody
  38 else will be using, without its needing as much special-for-Windows
  39 treatment. However, many of you won't have this installed.
  40
  41 * You won't have Cygwin installed. You might in theory have
  42 a different group of compilers installed (Microsoft ...), but
  43 we'll assume that the overwhelming majority of users in this group
  44 don't have access to a compiler and need pre-packaged installers
  45 for everything.
  46
  47 If you're using Linux, you could be using any one of numerous packaging
  48 systems.
  49
  50 We'll give examples using the packaging system shared by Debian and Ubuntu,
  51 and we'll assume that those of you using different packaging systems will know
  52 how to make the relevant substitutions. You may also want to take note of the
  53 output of the "uname -srm" command. On my machine this tells me "Linux
  54 2.6.35-ARCH x86_64". That tells me I'm running the x86_64 (as opposed to the
  55 i686 or i386 or whatever) version of Linux, and that I'm running kernel
  56 version 2.6.35.
  57
  58
  59
  60 PLEASE REPORT PROBLEMS (AND SOLUTIONS!)
  61 =======================================
  62
  63 We haven't tested these instructions ourselves, and they're not explicit step-by-step instructions in any case. If you encounter troubles, please email to let us know so that we can amend the instructions to help others. If you figure out how to fix the problem youself (and please do), please also write with suggestions how we can change these instructions to make the process easier and more straightforward for others.
  64
  65
  66 Getting Scheme
  67 ==============
  68
  69 Scheme is one of the two major dialects of Lisp. It's more clean and minimalistic than the other dialect, and is what's mostly used in academic circles.
  70
  71 Scheme itself has umpteen different "implementations", which share a large common base, but differ slightly in what commands you use to print, inteact with the filesystem, tell the compiler to include one source file inside another, and so on. One major implementation used to be called PLT Scheme, and this is what we recommend you use. (If you're already using or comfortable with another Scheme implementation, though, there's no compelling reason to switch.)
  72
  73 We say this "used to be called" PLT Scheme, because they just changed their name to "Racket." Not "Racket Scheme," just "Racket." Since the name change is so recent, you're likely to run across both sets of names.
  74
  75 PLT Scheme had three salient components: the command-line version "mzscheme", a GUI extension "MrEd", and a teaching-friendly editor/front-end "DrScheme".
  76 In Racket these have been renamed "racket", "gracket", and "DrRacket", respectively.
  77
  78 * Windows: Go to: <http://racket-lang.org/download/>. Download and install the "Windows x86" version.
  79
  80 * Mac/without MacPorts: Go to: <http://racket-lang.org/download/>. Download and install the option for your system, most likely "Macintosh
  81 OS X (Intel)"
  82
  83 * Mac/with MacPorts: You can install a command-line version of
  84 PLT Scheme (dating from early 2009) by opening a Terminal
  85 and typing:
  86
  87      sudo port install mzscheme
  88
  89 If you want the GUI components, I think you'll need to use the
  90 "Mac/without MacPorts" installation options above.
  91
  92 Linux users:
  93
  94 Use your packaging system, for example, open a Terminal and
  95 type:
  96
  97      sudo apt-get install plt-scheme
  98
  99 It's very likely that your packaging system has some version of
 100 PLT Scheme available, so look for it. However, if you can't find it you
 101 can also install a pre-packaged binary from the Racket website: <http://racket-lang.org/download/>
 102 Choose the option for your version of Linux (Ubuntu, Debian, and two
 103 varieties of Fedora are available)
 104
 105
 106 Getting OCaml
 107 =============
 108
 109 Caml is one of the two major dialects of ML. The other dialect is SML and has several implementations. Caml has only one active implementation, OCaml, developed by the INRIA academic group in France.
 110
 111 It's helpful if in addition to OCaml you also install the Findlib add-on.
 112 This will make it easier to install additional add-ons further down the road.
 113 However, if you're not able to get that working, don't worry about it much.
 114
 115
 116 * Windows: Go to:<http://caml.inria.fr/download.en.html>.
 117 You can probably download and install the
 118 "Self installer for the port based on the MinGW toolchain"
 119 even if you don't know what MinGW or Cygwin are.
 120 Some features of this require Cygwin, but it looks like
 121 it should mostly work even for users without Cygwin.
 122 At the time of this writing, only an installer for the previous
 123 version of OCaml (3.11.0, from January 2010) is available.
 124
 125 To install the Findlib add-on, you must have the
 126 Cygwin system installed. We assume few of you do,
 127 so we're not going to try to explain how to do this.
 128 If you want to figure it out yourself, go to the
 129 Findlib website: <http://projects.camlcity.org/projects/findlib.html>.
 130
 131 * Mac/without MacPorts:
 132 To install OCaml 3.12 (just released the summer), go to:
 133 <http://caml.inria.fr/download.en.html>
 134 and download and install the "Binary distribution for Mac OS X"
 135
 136 To install the Findlib add-on, you'll need the Xcode development tools
 137 to compile it yourself. Once you get that far, it's probably easiest
 138 for you to install MacPorts and just install things using the MacPorts
 139 instructions. (Use the MacPorts version of OCaml, instead of installing
 140 the package from the caml.inria.fr website, as described above)
 141 However, if you do have Xcode, and want to do without MacPorts, then
 142 what you need to do is download Findlib from:
 143 <http://download.camlcity.org/download/findlib-1.2.6.tar.gz>
 144 Unpack the download, open a Terminal and go into the folder you just
 145 unpacked, and type:
 146
 147     ./configure
 148     make package-macosx
 149
 150 This will build an installer package which you should be able to
 151 double-click and install.
 152
 153 * Mac/with MacPorts: you can install the previous version of OCaml (3.11.2,
 154 from January 2010), together with the Findlib add-on, by opening a Terminal
 155 and typing:
 156
 157     sudo port install ocaml caml-findlib
 158
 159 * Linux: Use your packaging system, for example, open a Terminal and
 160 type:
 161
 162     sudo apt-get install ocaml ocaml-findlib
 163
 164 That will install a version of OCaml (probably 3.11.2, from January 2010)
 165 and the Findlib add-on.
 166
 167 If for some reason you can't get OCaml through your
 168 packaging system, you can go to:
 169 <http://caml.inria.fr/download.en.html>
 170 Pre-packaged binary installers are available for several Linux systems.
 171
 172 If you can't get findlib through your packaging system, you'll
 173 need to download it from:
 174 <http://download.camlcity.org/download/findlib-1.2.6.tar.gz>
 175 and use gcc to compile it yourself. If you don't know how to
 176 do that, you probably don't want to attempt this.
 177 Here are the INSTALL notes:
 178 <https://godirepo.camlcity.org/svn/lib-findlib/trunk/INSTALL>
 179