Home » Archimedes archive » Zipped Apps » FORTH » !FORTH/User

!FORTH/User

This website contains an archive of files for the Acorn Electron, BBC Micro, Acorn Archimedes, Commodore 16 and Commodore 64 computers, which Dominic Ford has rescued from his private collection of floppy disks and cassettes.

Some of these files were originally commercial releases in the 1980s and 1990s, but they are now widely available online. I assume that copyright over them is no longer being asserted. If you own the copyright and would like files to be removed, please contact me.

Tape/disk: Home » Archimedes archive » Zipped Apps » FORTH
Filename: !FORTH/User
Read OK:
File size: 0513 bytes
Load address: 0000
Exec address: 0000
File contents
The file will become the user guide to the FORTH system.

   For the time being just some notes so that you can use it  more easily.

   !FORTH is a normal aplication and can be double clicked to start as usual. !FORTH will install itself on the Iconbar, when on
the Iconbar it is fully active, i.e. it will execute programs dragged onto it. Clicking on the !FORTH icon on the Iconbar will open the main (at present only) !FORTH window.

   !FORTH is a character based program, it emulates a 80 by 25 screen. This window can be resized and moved as normal, other windows can be moved on top of it, screen output behaving properly. (i.e. not overwriting the top window, but see the Bug list). The !FORTH system emulates some of the VDU commands, specifically, those affecting the printer, and clearing the screen.

   !FORTH has only been tested in the following modes: 12, 15, 16. It is usable with a monochrone monitor, and works best in mode 16 (of those I have tested). 

   !FORTH can be multi-tasked, this can be shown by running Prog2 in one !FORTH window while other windows run !CLOCK, !USAGE, etc. Two or more !FORTH tasks can be run at the same time duble click on the !FORTH icon again to get two or more !FORTH icons on the iconbar. Then open the forth windows and run the Prog2 in them.
00000000  54 68 65 20 66 69 6c 65  20 77 69 6c 6c 20 62 65  |The file will be|
00000010  63 6f 6d 65 20 74 68 65  20 75 73 65 72 20 67 75  |come the user gu|
00000020  69 64 65 20 74 6f 20 74  68 65 20 46 4f 52 54 48  |ide to the FORTH|
00000030  20 73 79 73 74 65 6d 2e  0a 0a 20 20 20 46 6f 72  | system...   For|
00000040  20 74 68 65 20 74 69 6d  65 20 62 65 69 6e 67 20  | the time being |
00000050  6a 75 73 74 20 73 6f 6d  65 20 6e 6f 74 65 73 20  |just some notes |
00000060  73 6f 20 74 68 61 74 20  79 6f 75 20 63 61 6e 20  |so that you can |
00000070  75 73 65 20 69 74 20 20  6d 6f 72 65 20 65 61 73  |use it  more eas|
00000080  69 6c 79 2e 0a 0a 20 20  20 21 46 4f 52 54 48 20  |ily...   !FORTH |
00000090  69 73 20 61 20 6e 6f 72  6d 61 6c 20 61 70 6c 69  |is a normal apli|
000000a0  63 61 74 69 6f 6e 20 61  6e 64 20 63 61 6e 20 62  |cation and can b|
000000b0  65 20 64 6f 75 62 6c 65  20 63 6c 69 63 6b 65 64  |e double clicked|
000000c0  20 74 6f 20 73 74 61 72  74 20 61 73 20 75 73 75  | to start as usu|
000000d0  61 6c 2e 20 21 46 4f 52  54 48 20 77 69 6c 6c 20  |al. !FORTH will |
000000e0  69 6e 73 74 61 6c 6c 20  69 74 73 65 6c 66 20 6f  |install itself o|
000000f0  6e 20 74 68 65 20 49 63  6f 6e 62 61 72 2c 20 77  |n the Iconbar, w|
00000100  68 65 6e 20 6f 6e 0a 74  68 65 20 49 63 6f 6e 62  |hen on.the Iconb|
00000110  61 72 20 69 74 20 69 73  20 66 75 6c 6c 79 20 61  |ar it is fully a|
00000120  63 74 69 76 65 2c 20 69  2e 65 2e 20 69 74 20 77  |ctive, i.e. it w|
00000130  69 6c 6c 20 65 78 65 63  75 74 65 20 70 72 6f 67  |ill execute prog|
00000140  72 61 6d 73 20 64 72 61  67 67 65 64 20 6f 6e 74  |rams dragged ont|
00000150  6f 20 69 74 2e 20 43 6c  69 63 6b 69 6e 67 20 6f  |o it. Clicking o|
00000160  6e 20 74 68 65 20 21 46  4f 52 54 48 20 69 63 6f  |n the !FORTH ico|
00000170  6e 20 6f 6e 20 74 68 65  20 49 63 6f 6e 62 61 72  |n on the Iconbar|
00000180  20 77 69 6c 6c 20 6f 70  65 6e 20 74 68 65 20 6d  | will open the m|
00000190  61 69 6e 20 28 61 74 20  70 72 65 73 65 6e 74 20  |ain (at present |
000001a0  6f 6e 6c 79 29 20 21 46  4f 52 54 48 20 77 69 6e  |only) !FORTH win|
000001b0  64 6f 77 2e 0a 0a 20 20  20 21 46 4f 52 54 48 20  |dow...   !FORTH |
000001c0  69 73 20 61 20 63 68 61  72 61 63 74 65 72 20 62  |is a character b|
000001d0  61 73 65 64 20 70 72 6f  67 72 61 6d 2c 20 69 74  |ased program, it|
000001e0  20 65 6d 75 6c 61 74 65  73 20 61 20 38 30 20 62  | emulates a 80 b|
000001f0  79 20 32 35 20 73 63 72  65 65 6e 2e 20 54 68 69  |y 25 screen. Thi|
00000200  73 20 77 69 6e 64 6f 77  20 63 61 6e 20 62 65 20  |s window can be |
00000210  72 65 73 69 7a 65 64 20  61 6e 64 20 6d 6f 76 65  |resized and move|
00000220  64 20 61 73 20 6e 6f 72  6d 61 6c 2c 20 6f 74 68  |d as normal, oth|
00000230  65 72 20 77 69 6e 64 6f  77 73 20 63 61 6e 20 62  |er windows can b|
00000240  65 20 6d 6f 76 65 64 20  6f 6e 20 74 6f 70 20 6f  |e moved on top o|
00000250  66 20 69 74 2c 20 73 63  72 65 65 6e 20 6f 75 74  |f it, screen out|
00000260  70 75 74 20 62 65 68 61  76 69 6e 67 20 70 72 6f  |put behaving pro|
00000270  70 65 72 6c 79 2e 20 28  69 2e 65 2e 20 6e 6f 74  |perly. (i.e. not|
00000280  20 6f 76 65 72 77 72 69  74 69 6e 67 20 74 68 65  | overwriting the|
00000290  20 74 6f 70 20 77 69 6e  64 6f 77 2c 20 62 75 74  | top window, but|
000002a0  20 73 65 65 20 74 68 65  20 42 75 67 20 6c 69 73  | see the Bug lis|
000002b0  74 29 2e 20 54 68 65 20  21 46 4f 52 54 48 20 73  |t). The !FORTH s|
000002c0  79 73 74 65 6d 20 65 6d  75 6c 61 74 65 73 20 73  |ystem emulates s|
000002d0  6f 6d 65 20 6f 66 20 74  68 65 20 56 44 55 20 63  |ome of the VDU c|
000002e0  6f 6d 6d 61 6e 64 73 2c  20 73 70 65 63 69 66 69  |ommands, specifi|
000002f0  63 61 6c 6c 79 2c 20 74  68 6f 73 65 20 61 66 66  |cally, those aff|
00000300  65 63 74 69 6e 67 20 74  68 65 20 70 72 69 6e 74  |ecting the print|
00000310  65 72 2c 20 61 6e 64 20  63 6c 65 61 72 69 6e 67  |er, and clearing|
00000320  20 74 68 65 20 73 63 72  65 65 6e 2e 0a 0a 20 20  | the screen...  |
00000330  20 21 46 4f 52 54 48 20  68 61 73 20 6f 6e 6c 79  | !FORTH has only|
00000340  20 62 65 65 6e 20 74 65  73 74 65 64 20 69 6e 20  | been tested in |
00000350  74 68 65 20 66 6f 6c 6c  6f 77 69 6e 67 20 6d 6f  |the following mo|
00000360  64 65 73 3a 20 31 32 2c  20 31 35 2c 20 31 36 2e  |des: 12, 15, 16.|
00000370  20 49 74 20 69 73 20 75  73 61 62 6c 65 20 77 69  | It is usable wi|
00000380  74 68 20 61 20 6d 6f 6e  6f 63 68 72 6f 6e 65 20  |th a monochrone |
00000390  6d 6f 6e 69 74 6f 72 2c  20 61 6e 64 20 77 6f 72  |monitor, and wor|
000003a0  6b 73 20 62 65 73 74 20  69 6e 20 6d 6f 64 65 20  |ks best in mode |
000003b0  31 36 20 28 6f 66 20 74  68 6f 73 65 20 49 20 68  |16 (of those I h|
000003c0  61 76 65 20 74 65 73 74  65 64 29 2e 20 0a 0a 20  |ave tested). .. |
000003d0  20 20 21 46 4f 52 54 48  20 63 61 6e 20 62 65 20  |  !FORTH can be |
000003e0  6d 75 6c 74 69 2d 74 61  73 6b 65 64 2c 20 74 68  |multi-tasked, th|
000003f0  69 73 20 63 61 6e 20 62  65 20 73 68 6f 77 6e 20  |is can be shown |
00000400  62 79 20 72 75 6e 6e 69  6e 67 20 50 72 6f 67 32  |by running Prog2|
00000410  20 69 6e 20 6f 6e 65 20  21 46 4f 52 54 48 20 77  | in one !FORTH w|
00000420  69 6e 64 6f 77 20 77 68  69 6c 65 20 6f 74 68 65  |indow while othe|
00000430  72 20 77 69 6e 64 6f 77  73 20 72 75 6e 20 21 43  |r windows run !C|
00000440  4c 4f 43 4b 2c 20 21 55  53 41 47 45 2c 20 65 74  |LOCK, !USAGE, et|
00000450  63 2e 20 54 77 6f 20 6f  72 20 6d 6f 72 65 20 21  |c. Two or more !|
00000460  46 4f 52 54 48 20 74 61  73 6b 73 20 63 61 6e 20  |FORTH tasks can |
00000470  62 65 20 72 75 6e 20 61  74 20 74 68 65 20 73 61  |be run at the sa|
00000480  6d 65 20 74 69 6d 65 20  64 75 62 6c 65 20 63 6c  |me time duble cl|
00000490  69 63 6b 20 6f 6e 20 74  68 65 20 21 46 4f 52 54  |ick on the !FORT|
000004a0  48 20 69 63 6f 6e 20 61  67 61 69 6e 20 74 6f 20  |H icon again to |
000004b0  67 65 74 20 74 77 6f 20  6f 72 20 6d 6f 72 65 20  |get two or more |
000004c0  21 46 4f 52 54 48 20 69  63 6f 6e 73 20 6f 6e 20  |!FORTH icons on |
000004d0  74 68 65 20 69 63 6f 6e  62 61 72 2e 20 54 68 65  |the iconbar. The|
000004e0  6e 20 6f 70 65 6e 20 74  68 65 20 66 6f 72 74 68  |n open the forth|
000004f0  20 77 69 6e 64 6f 77 73  20 61 6e 64 20 72 75 6e  | windows and run|
00000500  20 74 68 65 20 50 72 6f  67 32 20 69 6e 20 74 68  | the Prog2 in th|
00000510  65 6d 2e                                          |em.|
00000513