& 		HLISP INSTALLATION AND RELEASE NOTES    F Installation of HLISP is relatively straightforward.  The executeable B image file is named LISP.EXE, and may reside anywhere appropriate.B It is most easily invoked by defining a global symbol (usually in  your LOGIN.COM) such as:   	$ LISP :== $dev:[dir]LISP  F When HLISP is invoked in this manner, it will prompt for input at the 6 terminal.  Input is EVAL'd, and the result is PRINTed.  B Indirect command files are also supported on both the DCL command E line, and during interactive use.  Command files may be nested up to 4 three levels, and have a default file type of "LSP".  F HLISP also has an interactive help facility using a VMS standard help G library.  The filename for the library is LISP.HLB, and it is accessed G by HLISP using the logical name LISPHELP.  To make this facility work, : the following logical name assignment should be performed:    	$ ASSIGN dev:[dir]LISP LISPHELP  G Note that the device and directory default to SYS$HELP if they are not < specified in the ASSIGN.  To invoke the HLISP help facility < interactively from within LISP, evaluate the following form:   	(HELP)1  N LISP will prompt for additional inputs while in the help mode, just as the VMSE HELP command does.  An alternate form permits an initial topic to be S
 specified:   	(HELP <topic>)  O where <topic> is the name (or the first few characters of the name) of a topic  in the help library.  K Further documentation on HLISP is contained in the HLISP Reference Manual, . included in the delivery in the file LISP.MEM.  K Please note that this LISP is intended to be most compatible with Standard H LISP as defined by the paper "Standard LISP Report", by J. Marti, et al.O It is not yet, nor will it likely ever be a fully compatable implementation of OA this particular definition, however it is the preferred baseline.H This LISP presently implements about three fourhts of this standard, butL contains many extensions to make the things I am presently working on easier8 to do.  Copies of this paper are available upon request.  K PLEASE, give me some feedback on what you like and dislike. I'm afraid I amN able to do only limited verification, so I would especially appreciate hearingL about any problems.  Also any items on your wish list may get added to mine!  A Below are the release notes for all official releases, in reverse G chronological order.  The trouble report logs are also included in each  release as a seperate file.    				Release Notes    				  Version 6   0 *** The following new functions have been added:( 	ASPAWN	spawn an asynchronous subprocessB 	ATTACH	attach the user's terminal to another process (like DCL's)A 	HASHSTR	return an integer in a given range, hashed from a string  				Release Notes    				  Version 5  1 *** This release is largely a bug fixing release.   % *** The function SQRT has been added.S  G *** The pretty printer has been modified to be slightly more efficient.   				Release Notes   				  Version 4N  H *** A list structure editor has been added.  Together with some support M routines, it is now possible to edit a list, a function definition (assuming  M that it is not a compiled or builtin routine), or a variables value.  The newC/ functions defined for this new capability are:  	EDD	edit a function definition  	EDL	edit a list% 	EDP	edit a variable's property value 	EDV	edit a variable's value> 	EDLAUX	auxiliary function used by all of the editor functions 	EDLNXTCMD auxiliary functionC 	EDLNXTVAL auxiliary function - These functions are builtin but not compiled. L Also, with the addition of these functions, the E function has been deleted.  0 *** The following new functions have been added:B 	COPY	returns a copy of its argument (no cyclic structures please) 	FLAG1	flags a single idC 	GETP	get the property list of an id (CDR of an id no longer works) D 	LAST	return a list containing the last element of its argument listD 	OUTF	redirect output temporarily, evaluate arguments (not compiled)) 	REMFLAG1 removes a flag from a single id L In addition, in an effort to migrate more toward the standard, the following functions have also been added:g- 	CONSTANTP return T if argument is a constantr4 	DIVIDE	return quotient and remainder as dotted pair( 	EXPT	return arbitrary power of a number! 	FLAG	add a flag to a list of idsi/ 	FLAGP	test for the presence of a flag on an idt% 	MAX2	return the larger of two valuesl& 	MIN2	return the smaller of two values1 	MINUSP	return T if argument is a negative number , 	ONEP	return T if argument equals 1 (or 1.0)# 	PLUS2	return the sum of two valuese) 	REMFLAG	remove a flag from a list of idsu 	fM *** The pretty printer routines were made smarter.  Improvements were made intH the formatting of LISP code (primarily LAMBDA LET LOOP PROG), and in theN way quoted items are output.  This also resulted in a new auxilliary function I (PPAUX2) being defined to assist the other pretty printing routines, and SM extending the PRLENGTH function to permit it to compute the print-lengths of $I expressions using the short hand format for quoted items.  PPPL was also fN improved to not produce to PNAME property, which is non-portable.  All of the M pretty printer routines that the user is likely to invoke interactively have eN been modified to invoke TERPRI before they terminate.  This required adding a H new routine PPINT (PPI with no TERPRI call) for use internal to PPAUX...  M *** In previous versions there was a problem interrupting garbage collection tO by using a control-C.  As a result, garbage collection messages were defaulted eN on so the user would beware.  This has now been changed now so that control-C O is disabled during garbage collection, and garbage collection messages are now  N defaulted off.  Note that when garbage collection is in progress, a control-C N will be ignored so you may need to try again if LISP fails to respond to your 
 control-C.  J *** The implementation of function definition storage and lookup has been F changed.  The functions GETD, PUTD, and REMD must be used to access a N function's definition, since the definition is no longer kept on the property ? list of the id.  This change was made primarily for efficiency.oK Also, the property list may no longer be accessed using CDR.  The function n( GETP has been provided for this purpose.  H *** The reference manual has been improved by adding more detail to the C descriptions.  The help library has also been updated and improved.r  I *** Various minor fixes to make function conform more closely to the LISP 1 Standard LISP Report and to improve shortcomings.i  C *** The functions CSET and CSETQ have been deleted, since they are 	F non-standard and add nothing to the implementation, with the possible  exception of confusion.   L *** SETQ was extended to permit multiple assignments in a single invocation.  O *** The name of the HLISP help library file has been changed from LISPHELP.HLB d to LISP.HLB. r 				Release Notese   				  Version 3i  M *** One of the most significant new features of this release of HLISP is the sN addition of a reference manual.  The manual is still in preliminary form, but   anything is better than nothing.  7 *** Additional MAP composite functions have been added:i/ 	MAP	apply a function to CDR segments of a listu0 	MAPC	apply a function to CAR segments of a listE 	MAPCAN	build a concatenated list of results from applying a functions' 			to successive CAR elements of a listvE 	MAPCON	build a concatenated list of results from applying a functionE' 			to successive CDR segments of a listaE 	MAPLIST	build a constructed list of results from applying a functiono' 			to successive CDR segments of a listh  J *** Vectors have been added, according to the definitions in the Standard $ LISP Report.  The new functions are: 	MKVECT	create a vectors+ 	UPBV	determine the upper bound of a vector  	GETV	get a vector element 	PUTV	store a vector elementJ Each vector element is initialized to NIL, and may reference an arbitrary I S-expression.  The vector itself is allocated dynamically as new virtual  M address space, however S-expressions referenced by it must be allocated from a the LISP heap.  J *** The ability to expand the LISP heap has been provided via the function GROWMEM.  N *** The builtin LISP condition handler was made a little smarter so that when L the user overflows the LISP call stack, the resulting access violation error@ message also includes an indication of the cause of the problem.M The error checking routines used internally by many of the builtin primitives M have been made smarter, e.g., the expression (SET !*GC T) will no longer givehN an access violation if !*GC has no APVAL, but return the normal error message.> [This expression should more probably have been (SETQ !*GC T).  L *** The garbage collector now prints messages at the beginning and ending ofF the collection process by default.  This was found desirable because aI control-C during garbage collection tends to leave the system in a rather, worthless state.  K *** The SSPAWN function was modified to return the completion status of thenG process.  This status is an integer, which is a standard VMS completiondF status.  The function GETMSG was added to convert this number into the$ corresponding system message string.  K *** The message produced by STATUS was made slightly more self explanitory, M and the TERPRI call before the message was made conditional on there actually % being something in the output buffer.*  N *** MSG was converted from an FSUBR to an LSUBR so that it formats the output 5 based on the result of the argument after evaluation.a  N *** The function QUIT was added as the standard synonym for EXIT (to exit from LISP to the operating system).  N *** The function PAIRP was added as the standard synonym for CONSP (to detect  dotted pairs).  I *** The function OBLIST replaces the old function SYMLIST to display the y ob-list.  I *** Various minor fixes to make function conform more closely to the LISPi Standard Report. t 				Release Notesk   				  Version 2e  N *** READ now supports list syntax using square brackets (aka "super brackets")E in addition to parentheses.  A right bracket may be used to terminate J parenthesized lists early, to any depth.  The outermost list is implicitlyM enclosed in brackets. (Note that these extensions are not supported in LINT.)d  M *** PP.LSP now is much smarter about maximizing the amount of text on a line. J PPUAX (the internal smarts used by all of the pretty printer functions) is9 also smarter about some of the forms it is working with. m There are also new functions:n 	PPI		Pretty print indentedv= 	PPPL		Pretty print property list in DEFPROP comapatible formd% 	E		Spawn an edit command line to DCLaE Note that the E function will probably need to have the command line c; modified to properly invoke your favorite flavor of editor.mH PP is now also much faster than in the past due to bringing many of its ? computational chores into the interpreter as normal primitives.e? PP is now also builtin, though it is still implemented in LISP.   0 *** The following new functions have been added:- 	APPEND1		append an atom to the end of a listl 	DOWNCASE	convert to lower casei 	EXIT		exit from LISP to VMS= 	LET		define & initialize local variables for a list of formsa+ 	LOCSTR		locate a substring within a stringM% 	LOOP		convenient PROG-like iteration 4 	OCML		invoke indirect command file programmatically 	POP		pop element from stack/ 	POSN		return current position on output bufferl0 	PRLENGTH	return print length of an s-expression 	PUSH		push element onto stack: 	REVERSE		return a copy of the input list in reverse order 	UPCASE		convert to upper case* See the help file for further information.  G *** When LISP is initializing, it now checks to see if the logical name N LISP_INIT is defined.  If it is, its value must be the name of a LISP command H file (default type is .LSP).  This command file is then executed before @ control is started at the terminal.  E.g., the DCL command line: 	$ASSIGN PP LISP_INIT M will cause LISP to load the PP command file before prompting at the terminal.r  M *** Minor extensions were made to the definitions of the following functions:I3 	DEFPROP		now handles multiple property-value pairsa  L *** All of the internal calls to builtin LISP functions such as CONS, READ, O RATOM, PRIN1, TERPRI, etc., have been made non-traced so that it is now easier aO to debug macros and such by tracing these primitives without having all of the t/ internal calls cluttering up the trace listing.i   				Release Notesm   				  Version 1p  K This release of LISP is now the "official" version 1, dated August 5, 1983.oM This version and all subsequent versions will have a builtin symbol defining oA the current version.  This symbol is VERSION.  It may be PRINTed.*  L This release has many new features and bug fixes.  The previous version was K considered to be an alpha test version.  This version is considered to be aaM beta test version.  The trouble report log for the alpha test (pre-version 1)oJ version is included in the distribution, as it will be for all subsequent ' releases, for anyone who is interested.   N This version contains a couple of incompatabilities with the previous version.O The DR form for defining readmacros has been changed to DRM, for compatability  L with other implementations.  The trouble report log mentions the other, the N special symbol returned by READCH for an end-of-line has changed.  Other than A these two items, all other changes are believed to be extensions.m  N This version also contains an updated version of PP, and several other tools, = as well as an updated version of SIR, and some example rules.s1 Several other LISP goodies are also in the works.tO A new version of LINT has also been added, with a more convenient command line.n