LISP Evaluator for FreeBASIC. An embedded LISP interpreter written entirely in FreeBASIC for use with FreeBASIC applications.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
examples
inc
lib
src
tests
.gitignore
changelog.txt
dist-win32.lst
license.txt
lisp.dsp
mk.bat
mkdist.bat
notes.txt
readme.txt

readme.txt

	LISP Evaluator for FreeBASIC 
	Copyright (c) 2007-2017 Jeffery R. Marshall.

	An embedded LISP interpreter written entirely in FreeBASIC for use 
	with FreeBASIC applications.


0. INTRODUCTION

	My main motivation for writing this is I like the idea of LISP as a
	script or macro language that can be embedded in my programs.  My
	experience with LISP was with AutoLISP.  This version of LISP is
	also a single namespace variety.  It certainly does not follow any
	standard.  None-the-less it is very LISP-like.

	Using this library is probably not a good way to learn LISP.  Use a 
	real LISP compiler or interpreter for that.  But if you do know some
	LISP programming, this version will be similar enough to be useful.


1. LICENSE

	See the 'license.txt' file in the same folder as this readme.txt


2. COMPILING

	To compile the library, use the following commands:

		cd src
		make

	To compile the examples, use following:

		cd examples
		make

	To run the test suite, from main directory

		example\runlisp tests\tests.lsp


3. INSTALLING

	There is no install script.  To use, either copy the library and
	include files to an appropriate directory, or include the paths
	to ./lib and ./inc as search paths.

	To use the library as-is, only the following files are needed

	./inc/lisp.bi
	./inc/lisp_err.bi
	./lib/liblisp.a

	To use the library as well as extend the built-in functions, all
	of the include files from ./src are also needed.


4. INTRINSIC FUNCTIONS

	Following is a list of the built-in functions available from the library.
	
	(~ <number>)
	(* <number> number...)
	(+ <number> number...)
	(- <number> number...)
	(/ <number> number...)
	(/= <atom> atom...)
	(< <atom> atom...)
	(<= <atom> atom...)
	(= <atom> atom...)
	(> <atom> atom...)
	(>= <atom> atom...)
	(1+ <number>)
	(1- <number>)
	(abs <number>)
	(and <expr>...)
	(append <expr>...)
	(apply function [list])
	(atom <expr>)
	(car <list>)
	(car <cons>)
	(cdr <list>)
	(cdr <cons>)
	(cond (<expr1> expr2)...)
	(cons <expr1> expr2)
	(consp <expr>)
	(defun <sym> (arglist) <expr>...)
	(elt <list> <index>)
	(eq <expr1> <expr2>)
	(eql <expr1> <expr2>)
	(equal <expr1> <expr2>)
	(equalp <expr1> <expr2>)
	(eval <expr>)
	(garbage-collect)
	(gc)
	(if <expr> <then-expr> else-expr...)
	(integerp <expr>)
	(lambda expr...)
	(last <list>)
	(length <list>)
	(list expr...)
	(listp <expr>)
	(load <filename>)
	(mapcar <function> <list1...listn>)
	(not <expr>)
	(nth <index> <list>)
	(null <expr>)
	(numberp <expr>)
	(or <expr>...)
	(princ <expr>...)
	(progn <expr>... )
	(quote <expr>)
	(set <expr1> <expr2>)
	(setf <sym1> <expr1> [<sym2> <expr2>]...)
	(setq <sym1> <expr1> [<sym2> <expr2>]...)
	(stringp <expr>)
	(unless <expr> else-expr...)
	(when <expr> then-expr...)
	(while <expr> expr...)
	(zerop <expr>)


5. EXAMPLE USAGE IN FREEBASIC

	#include "lisp.bi"
	using LISP

	DIM lsp AS LispModule, expr AS STRING

	expr = "(lisp expression)"
	lsp.eval( expr )


6. EXAMPLE PROGRAMS

	The directory ./examples have a few example example programs. To
	compile all of the example programs, use:

	cd examples
	make

	Each example also has its own instructions for comiling and usage
	in the .bas source file.


7. OBTAINING THE ORIGINAL SOURCE

	https://github.com/jayrm/fb-lisp
		
	and sometimes http://www.coderjeff.ca


8. ACKNOWLEDGEMENTS

	Sandro Sigala - That a C version of a simple LISP evaluator existed and
	was available under an Open Source license saved huge amounts time.  
	Thanks to Sandro for slisp-1.2.
	

EOF