Work at SourceForge, help us to make it a better place! We have an immediate need for a Support Technician in our San Francisco or Denver office.

Close

[70dc01]: getting-sbcl.lisp Maximize Restore History

Download this file

getting-sbcl.lisp    131 lines (124 with data), 5.3 kB

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
(in-package :sbcl-page)
(define-page :getting-sbcl "Getting Started" "getting" getting-sbcl)
(defun getting-sbcl ()
(list
(<p>
"SBCL is available in source and binary form for "
(<a href= ,(page-link :ports)> "a number of different architectures")
". This page describes how to get SBCL installed and how to start
using it. For more complete installation instructions, please see the "
(<a href= "http://sbcl.git.sourceforge.net/git/gitweb.cgi?p=sbcl/sbcl.git;a=blob_plain;f=INSTALL;hb=HEAD"> "INSTALL")
" document that comes with SBCL.")
(<h2> "Installing a binary")
(<p>
"SBCL is available in binary form for many architectures. To
obtain the latest binary release for your system, visit the "
(<a href= ,(page-link :ports)> "platform support")
" page and click on the green square which indicates your
platform. When the binary is downloaded, unpack the tarball:"
(<pre>
(format nil "bzip2 -cd sbcl-~A-x86-linux-binary.tar.bz2 | tar xvf -"
(car *most-recent-release*)))
"replacing "
(<code> (format nil "sbcl-~A-x86-linux-binary.tar.bz2"
(car *most-recent-release*)))
" with the name of the tarball you downloaded. Then enter the
directory which was unpacked, and run the installation script to
install SBCL in your "
(<code> "/usr/local")
" directory:"
(<pre>
(format nil "cd sbcl-~A-x86-linux~%sh install.sh"
(car *most-recent-release*))))
(<h2> "Running SBCL")
(<p>
"Make sure that "
(<code> "/usr/local/bin")
" is in your "
(<code> "PATH")
". Then run SBCL by invoking \"sbcl\", which should
produce a banner like this:"
(<pre>
(format nil "This is SBCL ~A, an implementation of ANSI Common Lisp.
More information about SBCL is available at <http://www.sbcl.org/>.
SBCL is free software, provided as is, with absolutely no warranty.
It is mostly in the public domain; some portions are provided under
BSD-style licenses. See the CREDITS and COPYING files in the
distribution for more information.
*" (car *most-recent-release*)))
"To quit SBCL, type "
(<code> "(quit)")
".")
(<h2> "Installing to a different prefix")
(<p>
"You can install SBCL to a different directory prefix by setting
the "
(<code> "INSTALL_ROOT")
" environment variable before running
the installation script:"
(<pre>
"INSTALL_ROOT=/my/sbcl/prefix sh install.sh")
"To start SBCL, you need to set the SBCL_HOME environment
variable to point at a subdirectory of the place you installed SBCL:"
(<pre>
"export SBCL_HOME=/my/sbcl/prefix/lib/sbcl # for bash / zsh
setenv SBCL_HOME /my/sbcl/prefix/lib/sbcl # for csh / tcsh")
"Make sure that "
(<code> "/my/sbcl/prefix/bin")
" is in your "
(<code> "PATH")
" and invoke SBCL as described above.")
(<h2> "Using SBCL with Emacs")
(<p>
"If you are going to use SBCL to develop Common Lisp, you
will want a development environment which is more human friendly than
the basic SBCL read-eval-print-loop. Such an environment is provided
by "
(<a href= "http://www.common-lisp.net/project/slime/"> "SLIME")
", the Superior Lisp Interaction Mode for Emacs. SLIME
provides many features, including an enhanced REPL with symbol
completion and command-line history and interactive support for
compiling and debugging code.")
(<h2> "Compiling SBCL from Source")
(<p> "SBCL can be compiled from source code using another
ANSI-compliant Common Lisp implementation. As of SBCL 0.8.13, the
following compilers are known to work:"
(<p>
(<li> "SBCL itself")
(<li> "CMU Common Lisp, tested with 18e and 19a")
(<li> "OpenMCL 0.14.1")
(<li> "CLISP 2.33.2"))
"To compile SBCL, first unpack the source tarball and enter the
directory it makes. Then make sure that your system's "
(<code> "make")
" is a GNU make or set the GNUMAKE environment variable
appropriately:"
(<pre>
"export GNUMAKE=gnumake # for bash / zsh
setenv GNUMAKE gnumake # for csh / tcsh")
"Then you will need to invoke the build shell script with the
appropriate argument for the host Common Lisp you are using:"
(<table class= "build-command-table">
(<tr>
(<th> "SBCL")
(<td> (<code> "sh make.sh")))
(<tr>
(<th> "CMUCL")
(<td> (<code> "sh make.sh \"lisp -batch\"")))
(<tr>
(<th> "OpenMCL")
(<td> (<code> "sh make.sh \"openmcl --batch\"")))
(<tr>
(<th> "CLISP")
(<td> (<code> "sh make.sh \"clisp\""))))
(<strong> "Important:")
" It is highly recommended that you run
the make.sh script in either a very fast terminal such as xterm (the
GNOME terminal and the OS X terminal are too slow) or that you run it
in a detached GNU screen session (use C-a d to detach the session and
screen -r to resume it). The SBCL compile produces lots of output and
your system's terminal program "
(<emph> "will")
" likely slow down the compile in a drastic manner.")
(<p> "To install the SBCL binary you have built, see the
installation instructions above.")))