Use Data::Dump::Sexp instead of pretty_print

[app-scheme79asm.git] / README

App-Scheme79asm version 0.005
=============================

SIMPLE is a LISP processor defined in the 1979
B<Design of LISP-Based Processors> paper by Steele and Sussman.

The SIMPLE processor expects input in a particular tagged-pointer
format. This module takes a string containing a sequence of
S-expressions. Each S-expression is a list of one of three types:

(tag value), for example (symbol 2), represents a value to be
put in memory (for example a number, or a symbol, or a variable
reference). The value must be a number.

(tag list), where list is of one of these three types,
represents a tagged pointer. In this case, list is (recursively)
laid out in memory as per these rules, and a pointer to that location
(and tagged tag) is put somewhere in memory.

(tag list1 list2), where list1 and list2 are of one of these
three types (not necessarily the same type). In this case, list1
and list2 are (recursively) laid out in memory such that list1
is at position X and list2 is at position X+1, and a pointer of
type tag and value X is put somewhere in memory.

After this process the very last pointer placed in memory is moved to
the special location 5 (which is where SIMPLE expects to find the
expression to be evaluated).

In normal use a single S-expression will be supplied, representing an
entire program.

INSTALLATION

To install this module type the following:

   perl Makefile.PL
   make
   make test
   make install

DEPENDENCIES

This module requires these other modules and libraries:

* Data::Dump::Sexp
* Data::SExpression
* List::MoreUtils

COPYRIGHT AND LICENCE

Copyright (C) 2018 by Marius Gavrilescu

This library is free software; you can redistribute it and/or modify
it under the same terms as Perl itself, either Perl version 5.24.3 or,
at your option, any later version of Perl 5 you may have available.