/
README.dpmi
122 lines (102 loc) · 4.84 KB
/
README.dpmi
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
CIFORTH CUSTOMIZATION FOR DPMI ("windows"). 4.0.x for x is 3 and up.
COPYRIGHT (c) 2000-2003 Albert van der Horst , THE NETHERLANDS
LICENSE
This program is free software; you can redistribute it and/or
modify it under the terms of version 2 of the GNU General
Public License as published by the Free Software Foundation.
NOTE
DPMI is deprecated, there will be no version 5 releases. New version 4
releases may only appear in the unlikely event of defects that have no
work around.
DESCRIPTION
Forth is a tool for evolutionary programming. This is the binary
distribution of wina 4.0.3, a stable release of a 32 bits windows
Forth that interfaces through the DOS Protected Mode Interface. This
means that internally it is much like a MS-DOS Forth, using INT 21 for
Operating System Functions, but with the advantage of protected-mode's
possibility to have 32 bits. Without notice this description also
applies to versions 4.0.x . DPMI is deprecated, there will be no
version 5 releases.
This wina is a Windows native version of ciforth (common Intel Forth),
an interpret environment and compiler for Forth. It is (large and by)
compliant with the ISO Forth standard; the CORE wordset is fully
implemented. The small, classic, indirect threaded kernel contains the
essential, i.a. file access and exceptions. Its power is multiplied by
an extensive source library, that add i.a. a decompiler and integrated
386 assembler. It is fully self contained; if you want to understand a
compiler in all details, this is your best, if not only, choice.
ciforth sports a very high documentation to binary proportion.
Unpack in the directory where you want to use it by :
pkunzip wina4d0d4.zip
Now you can use wina interactively by :
wina
You can compile a program `monkey.frt' to an executable `monkey.exe':
wina -c monkey.frt
The Forth word defined latest in `monkey.frt' is the entry point.
The library contains facilities to access arguments passed to
a program.
RELEASE CONTENT
Don't panic! ciforth is just two files.
The rest is documentation (examples and source).
COPYING Copyright notice
READWINA.TXT This file
WINA.ASM Source
WINA.COM Forth interpreter compiler
WINA.TEX Doc source
WINA.HTM Usable reference documentation
WINA.PDF Documentation in Portable Data Format
WINA.PS Documentation in PostScript
FORTH.LAB Source library
TOBLK.FRT Example : transform text into Forth blocks.
FROMBLK.FRT Example : transform Forth blocks into text.
The latest version can be fetched from
http://home.hccnet.nl/a.w.m.van.der.horst/ciforth.html
This contains also the generic system that is recommended over
`WINA.ASM' if you want to make extensive change.
DOCUMENTATION I
The documentation is in industry standard PostScript.
However on the poor windows platforms you may have a hard
time using it. The best option is a print shop.
Alternatively,
you can order a printed manual by sending a request to
albert@spenarnc.xs4all.nl
Include a valid e-mail address, and preferably a phone number.
Shipping costs (especially oversee) may vary.
If you have access to a Linux system you may
print the manual (>150 pages) by :
lpr ci86.wina.ps
or view it:
gv ci86.wina.ps
DOCUMENTATION II
The documentation is also supplied in the proprietary .pdf
format.
The ubiquitous Acrobat reader can be used to view it.
This documentation is generated by a sophisticated system that
uses the free tool ``pdftex''.
Probably it could not be integrated with proprietary tools from Adobe.
Hopefully Adobe plays nice, such that I can keep generating pdf
documentation in the future.
DOCUMENTATION III
Viewing the file ``WINA.HTML'' with a html viewer,
gives a reference extract but with more cross links.
This is only intended to be used while using the system, it
contains no information about installation or tutorial material.
INSTALLATION
After unpacking wina is ready to use, because the library sits in
the current directory as configured.
Installation to a system wide directory is easy :
WINA -i C:\TOOLS\WINA.EXE C:\TOOLS\WINA.LAB
If C:\TOOLS is in the PATH , wina now is usable from anywhere.
On a XP system it is recommended to do :
wina -i C:\WINDOWS\system32\wina.exe c:\WINDOWS\system32\wina.lab c:\WINDOWS\system32\cmd.exe
The executable contains its own configuration information.
All this is explained in detail in the documentation.
If commands like DIR don't work (typically file not found errors),
the third parameter, which is the command interpreter, is wrong.
It has to agree with the variable ComSpec that can be inspected
with the SET command.
A simple manual installation is superior to an automatic installation
that would never work across all the targeted platforms.
This Forth worked on windows version I never used or even heard of!
And of course even the simplest manual installation weeds out the wimps.
(Forth is not for wimps.)