@cindex Web site
The primary distribution site for this software is
+
@example
-@uref{http://birchwood-abbey.net/~matt/Scheme/}
+@uref{http://birchwood-abbey.net/~puck/Scheme/}
@end example
@cindex bugs, reporting
If Scheme does not seem to be available through your launcher, you
should still be able to run it with a shell (terminal) command line.
Simply enter the command
+
@example
mit-scheme-pucked --edit
@end example
+
@noindent
and Scheme will load and print something like this:
The version information shown above can be printed again by
evaluating this expression.
@findex identify-world
+
@example
(identify-world)
@end example
+
@cindex release number
@cindex microcode, version
@cindex runtime system, version
MIT/GNU Scheme Pucked, and a new command name,
@code{mit-scheme-pucked}, so that it can be installed alongside the
stable release. While it comes with an assortment of plugins and a
-strange name, the core of the system is largely unchanged. Note that
-the core is the @emph{bleeding edge core}. The head of the project's
-development branch on Savannah is merged in frequently. Thus it
-includes changes proposed for the next stable release.
+strange name, the core of the system is largely unchanged.
@unnumbered Proposed Changes
+The core of MIT/GNU Scheme Pucked is the @emph{bleeding edge core}.
+The head of the MIT/GNU Scheme project's development branch on
+Savannah is merged in frequently. Thus it includes changes proposed
+for the next stable release of MIT/GNU Scheme.
+
@itemize @bullet
@item
Most of the bindings that we would fluid bind with @code{fluid-let},
used instead. @footnote{Parameters will be more easily implemented in
SMPing (Symmetrically Multi-Processing) worlds.} For example, rather
than fluid binding @code{*parser-radix*} with @code{fluid-let}
+
@example
(fluid-let ((*parser-radix* 16))
...)
@end example
+
@noindent
you should parameterize @code{param:parser-radix}
+
@example
(parameterize ((param:parser-radix 16))
...)
should be apparent to the casual user.
If your code does not hack Edwin and you previously said
+
@example
mit-scheme --load my-code
@end example
+
@noindent
you should be able to say
+
@example
mit-scheme-pucked --load my-code
@end example
+
@noindent
and be no worse off.
@code{(gdbm-available?)} should be replaced with
@code{(plugin-available? "gdbm")}.
-@item
-The @code{(runtime postgresql)} package was removed but has not yet
-been replaced with a corresponding plugin. If you were using it, let
-Puck know.
-
@item
The @code{(runtime crypto)} and @code{(runtime blowfish)} packages are
provided but deprecated. Their bindings are unassigned until
The installation process includes HTML documentation by default. In
the right place these files are available in your web browser, whether
online or offline, using a file URL like the following Ubuntu locator.
+
@example
@url{file:///usr/share/doc/mit-scheme-pucked/html/index.html}
@end example
+
HTML documentation for installed plugins is found in the same location.
@item
MIT/GNU Scheme Pucked and its plugins are now available as packages
for recent versions of Ubuntu on Intel@registeredsymbol{}64 and IA-32
architecture machines. If
-@uref{http://birchwood-abbey.net/~matt/Scheme/} has links to packages
+@uref{http://birchwood-abbey.net/~puck/Scheme/} has links to packages
for your Ubuntu, you can use your Ubuntu package manager to add,
remove and update Scheme and its plugins. @xref{Ubuntu Installation}.
You should begin by installing the GPG key used to sign the packages.
It is available from this web page:
+
@example
@url{https://savannah.gnu.org/users/mhb}
@end example
+
Click the ``Download GPG Key'' link on that page and save the
@file{mhb-key.gpg} file. You might install it with this command:
+
@example
sudo apt-key add ~/Downloads/mhb-key.gpg
@end example
Next add the repository to your list of package sources.
-On Ubuntu 16.10 (Yakkety Yak) you would use this command:
+On Ubuntu 17.04 (Zesty Zapus) you would use this command:
+
@example
sudo add-apt-repository \
-s "deb http://birchwood-abbey.net/ubuntu/ birchwood yakkety"
@end example
+
or by editing files in @file{/etc/apt/}.
Finally, use your package manager to update its list of available
Scheme and Edwin and makes Scheme a graphical X11 application like the
original MIT/GNU Scheme. You could do this with Apt by entering the
following commands.
+
@example
sudo apt-get update
sudo apt-get install mit-scheme-pucked-x11-screen
You can also download the package files and install them by hand. Links to
the available package files are listed on the project home page.
+
@example
-@uref{http://birchwood-abbey.net/~matt/Scheme/}
+@uref{http://birchwood-abbey.net/~puck/Scheme/}
@end example
+
You will need to know your Ubuntu version (e.g. 16.10) and Debian
machine architecture (e.g. amd64), then click on the corresponding
link. You will need to do this for your chosen plugin, all of the
checksums for the package files and is signed. If you saved the GPG
key in @file{~/Downloads/mhb-key.gpg}, you can add it to your keyring
like this:
+
@example
gpg --import ~/Downloads/mhb-key.gpg
@end example
+
Then verify the signature on the @file{.changes} file like this:
+
@example
gpg --verify ~/Downloads/mit-scheme-pucked_9.2.7-1_amd64.changes
@end example
+
Finally compare the checksum in the @file{.changes} file with one
computed from your downloaded file.
+
@example
grep mit-scheme-pucked_9.2.7-1_amd64.deb \
mit-scheme-pucked_9.2.7-1_amd64.changes
something like @file{mit-scheme-pucked-9.2.7-i386.tar.gz}.
Compile the Scheme interpreter using the following steps:
+
@enumerate
@item
Unpack the archive to create your build directory, e.g.@:
@file{mit-scheme-pucked-9.2.7}. For example,
+
@example
tar xzf mit-scheme-pucked-9.2.7-i386.tar.gz
@end example
+
will create a new directory @file{mit-scheme-pucked-9.2.7}.
+
@item
Move into the @file{src} subdirectory of the new directory:
+
@example
cd mit-scheme-pucked-9.2.7/src
@end example
+
@item
@anchor{Build Configuration}
Configure the software:
+
@example
./configure
@end example
installed somewhere else, for example @file{/opt}, pass the
@option{--prefix} option to the configure script, as in the
command line below.
+
@example
./configure --prefix=/opt
@end example
Installation is per the GNU custom, not unlike the core
installation. For the Gtk+ plugin:
+
@example
tar xzf mit-scheme-pucked-gtk-0.5-i386.tar.gz
cd mit-scheme-pucked-gtk-0.5
You can put a writable directory at the front of your host Scheme's
library path by setting the @code{MITSCHEME_LIBRARY_PATH} environment
variable
+
@example
export MITSCHEME_LIBRARY_PATH=~/pucked:/opt/lib/mit-scheme-pucked
@end example
+
@noindent
or including the @code{--library} option on the command line.
+
@example
mit-scheme-pucked --library ~/pucked:/opt/lib/mit-scheme-pucked
@end example
projects / mit-scheme.git / commitdiff