JAX4TH 0.dpANS-2.3.10 Archive Distribution Document & Release Notes Fourth Public FREEWARE Distribution 92-02-22. The JAX4TH system including jax4th.words 19161 ----rwed Today 19:39:17 jax4th.make 168 -s-arwed Today 19:39:16 jax4th.lnk 43 -s-arwed Today 19:39:16 jax4th.i 14366 ----rwed Today 19:39:15 jax4th.doc 32831 ---arwed Today 19:39:14 jax4th.a 191456 ----rwed Today 19:39:10 jax4th 37032 --p-rwed Today 19:39:05 defimage.with 92 ---arwed Today 19:39:04 defimage.make 94 -s-arwed Today 19:39:04 defimage.lnk 52 -s-arwed Today 19:39:04 defimage.jx4 131280 ----rwed Today 19:39:03 defimage.a 1827 ----rwed Today 19:38:59 is Copyright 1991,1992 by Jack J. Woehr. Portions of the glossary JAX4TH.WORDS are Copyright 1991 by the ANS ASC X3/X3J14 Technical Committee. Distribution ------------ The JAX4TH kernel and source code included in this archive may be freely redistributed as long as this documentation file and any other files contained in the distribution archive for the given revision of JAX4TH accompany such redistribution. By "freely redistributed", we mean, "given away for free, for the cost of magnetic media, or for reasonable online time charge from a public-access computer bulletin board system, or via USENET or publicly- accessible anonymous FTP site." JAX4TH MAY NOT BE DISTRIBUTED BY/VIA ANY MEDIUM OF REDISTRIBUTION WHICH ITSELF CLAIMS COPYRIGHT ON THE CONTENTS OF SUCH A DISTRIBUTION. THE AUTHOR *WILL* PROTECT HIS COPYRIGHT. Lack of Warranty and Conditions of Usage of this Free Software ----------------------------------------------------------------------------- This freely-distributed experimental software development system "IS PROVIDED 'AS IS' WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANT- ABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU." Shoot the lawyers :-). Files in this distribution -------------------------- DEFIMAGE.A C.A.P.E. source code for the default local image of JAX4TH. DEFIMAGE.JX4 The default local image to be loaded by JAX4TH in the case of the latter's being invoked from a command line interface without an image file argument. In later versions, double-clicking .JX4.info will invoke JAX4TH on the given image. DEFIMAGE.LNK Link commands for linking DEFIMAGE.JX4. DEFIMAGE.MAKE Amiga script file to make DEFIMAGE.JX4. DEFIMAGE.WITH A "with" file for the linking process. DISTRIB.TXT This description of the current distribution and restrictions (if any) on re-distribution by the user. JAX4TH Relocatable re-entrant dpANS-2-compliant Forth kernel suitable for PURE bit protection under AmigaDOS. JAX4TH.A C.A.P.E. source code for the re-entrant kernel JAX4TH. JAX4TH.BUGS Some bugs from the known bug list. JAX4TH.I Includes, macros for JAX4TH.A and DEFIMAGE.A. JAX4TH.DOC An informational file which assumes 1) that the reader has systems programmer familiarity with the Commodore Amiga 500/1000/200, and 2) that the reader is familiar with Forth, and with the particulars of the draft proposed ANS Forth promulgated by the ANS X3/X3J14 Technical Committee for an American National Standard Forth. JAX4TH.LNK Linker command file for JAX4TH. JAX4TH.MAKE Amiga script file to make JAX4TH. JAX4TH.WORDS This is a listing with stack diagrams of the words in the FORTH-WORDLIST and a listing with stack diagrams and explanations of the words in the IMPLEMENTOR-WORDLIST. Quickstart Instructions ----------------------- 1) Make a logical device (e.g., via AmigaDOS ASSIGN) name JX4: 2) Copy JAX4TH and DEFIMAGE.JX4 to JX4: 3) Optionally, at the AmigaDOS prompt type RESIDENT JX4:JAX4TH to make JAX4TH resident 4) From a NEWCON: (NewShell) window, type JAX4TH to launch an instance of JAX4TH. You can launch as many instances from as many NewShell windows as you like. Type INSTANCES in JAX4TH and it will return on the stack the number of instances of JAX4TH currently running. 5) BYE exits the current instance of JAX4TH and decrements INSTANCES but does not clean up any resources allocated by the programmer: open files, allocations via the MEMORY wordlist words, resources allocated via direct CALLs to the Amiga operating system, etc. must be cleaned up by the program. Revision History ---------------- 0.dpANS-2.3.10 - Fixed some minor bugs. 0.dpANS-2.3.08 - Added SAVE-IMAGE and AUTOSTART to effect saving custom images for later reload and autostart. 0.dpANS-2.3.06 - Added command-line loading of custom image file. Minor bug fixes. 0.dpANS-2.3.04 - S" now complies with the description in the FILE wordlist, i.e., it works interpretively at not just as a compilation tool. 0.dpANS-2.3.03 - J fixed, wouldn't work inside branch constructs. 0.dpANS-2.3.02 - I fixed, wouldn't work inside branch constructs. - M* was accidentally non-findable, now findable. 0.dpANS-2.3.01 - CALL to Amiga OS now supported, see JAX4TH.DOC and JAX4TH.WORDS. 91-09-07. 0.dpANS-2.2.28 - First public release 91-09-01. BUGS ------ See JAX4TH.BUGS THANX ----- - To Steven Sarns, President of Vesta Technology, for his support of X3J14 and my attendance thereto. - To Steven R. Wheeler for moral support, clever suggestions, and debugging assistance. - To all the members of X3J14 and to chair E. Rather, to vice-chair Andy Kobziar, and to TSC chair G. Bailey. - To Wil Baden, Forth Algorithmist Emeritus. - To Peter Appelman, a friend. - To the members of the Forth Interest Group, who taught me Forth and gave me a new career. - To Darren & BJ of AMIGA PRO/AM on GEnie, who in 1989 asked me the $64,000 question, "A Forth load library? Why? Why not just write a PURE RESIDENT-able Forth?" - To Wes Howe and to Innovatronics for C.A.P.E. - and lastest and mostest, To my wife and children, who accept that Dad stays up late a lot in the basement. << END of DISTRIB.TXT >>