Jax4th for the Commodore Amiga Copyright 1991, 1993, 1994 Jack J. Woehr
jax@well.sf.ca.us jax@cygnus.com SYSOP RCFB (303) 278-0364
-----------------------------------------------------------------------
This is free software and can be modified and redistributed under
certain conditions described in the file COPYING.TXT. The
Disclaimer of Warranty and License for this free software are also
contained in the file COPYING.TXT.
This is Jax's free ANS Forth for the Commodore Amiga. For more information
on ANS Forth, contact the X3J14 Technical Committee via email at
ansforth-request@minerva.com
or contact the
American National Standards Institute
11 W. 42nd Street
New York NY 10036
The source and documentation were prepared using Amiga MicroEmacs.
Listing of archive: 'JX4A0317.LZH'
Original Packed Ratio Date Time Type CRC Name
-------- ------ --- -------- -------- ----- ---- ------------
15230 6277 59% 05-17-94 13:22:26 -lh1- 38BF COPYING.TXT
1827 853 54% 05-17-94 13:22:14 -lh1- 58F4 DEFIMAGE.A
131280 2953 98% 05-17-94 13:22:24 -lh1- 50CB DEFIMAGE.JX4
52 43 18% 05-17-94 13:22:12 -lh1- B73C DEFIMAGE.LNK
94 74 22% 05-17-94 13:22:12 -lh1- DD3A DEFIMAGE.MAKE
92 62 33% 05-17-94 13:22:12 -lh1- 3BA8 DEFIMAGE.WITH
37188 18371 51% 05-17-94 13:22:16 -lh1- 1E16 JAX4TH
193700 60208 69% 05-17-94 13:22:10 -lh1- 88D9 JAX4TH.A
14329 5648 61% 05-17-94 13:22:00 -lh1- 90A1 JAX4TH.I
43 37 14% 05-17-94 13:21:58 -lh1- 3AE9 JAX4TH.LNK
168 113 33% 05-17-94 13:21:58 -lh1- 30C8 JAX4TH.MAKE
65 51 22% 05-17-94 13:22:00 -lh1- AE5D JAX4TH.WITH
26 24 8% 05-17-94 13:21:58 -lh1- B96C MAKEALL
5237 1936 64% 05-17-94 13:22:32 -lh1- 9734 demo/DEMO.F
436 318 28% 05-17-94 13:22:30 -lh1- 5D7F doc/JAX4TH.BUGS
33704 14149 59% 05-17-94 13:22:28 -lh1- 2DDD doc/JAX4TH.DOC
2462 1094 56% 05-17-94 13:22:28 -lh1- 7B80 doc/JAX4TH.INTERNALS
19267 7664 61% 05-17-94 13:22:30 -lh1- 3327 doc/JAX4TH.WORDS
6684 3202 53% 05-17-94 13:43:06 -lh1- EEA1 READ_1ST.TXT
-------- ------ ---
461884 123077 74% 19 file(s)
Operation successful
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 <name>.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.WITH
A "with" file for the linking process.
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.
Also ...
COPYING.TXT
The GNU Public License.
READ_1ST.TXT
This file.
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. DO NOT "RUN" JAX4TH.
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.
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 >>
Release notes:
0.dpANS-6.3.16 - dpANS-6 compliance. Fixed bug which prevented control
structures from spanning lines in INCLUDED files.
0.dpANS-2.3.11 - fixed bug in system calls to Amiga OS.
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.
BUG REPORTS AND SUGGESTED IMPROVEMENTS TO:
Jax
PO Box 51
Golden, CO 80402-0051
jax@cygnus.com <<== preferred
jax@well.sf.ca.us
72203.1320@compuserve.com
|