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
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
|
<html>
<head>
<title>kForth Installation</title>
</head>
<body bgcolor=white>
<h2><img src="kforth.gif"></a> Installation</h2>
<p>
kForth is provided under the terms of the
<a href="http://www.gnu.org/copyleft/gpl.html">GNU General Public License</a>.
New releases of this software will be posted at the
<a href="http://www.ccreweb.org">CCRE website</a>,
as they become available. Online documentation is also available
at the website. Difficulties with installation should be reported to:
<a href="mailto:krishna.myneni@ccreweb.org">krishna.myneni@ccreweb.org</a>
<br><br>
<p>
kForth is distributed as a compressed tar (Unix Tape Archive)
file ( <a href="ftp://ccreweb.org/software/kforth/linux/kflnx10.tar.gz">
kflnx10.tar.gz</a> for the Linux version and
<a href="ftp://ccreweb.org/software/kforth/windows/kfwin10.tar.gz">
kfwin10.tar.gz</a> for the Windows version).
This file contains the source code files and a Makefile for building
the executable. Windows users may also simply download the
file <a href="ftp://ccreweb.org/software/kforth/windows/kfwin10.zip">
kfwin10.zip</a> if they only want to execute
kForth.<br><br>
<a name="Installation under Linux"></a><h3>Installation under Linux</h3>
<p>
<ol>
<li>As root user, create a directory for kforth under
<code>/usr/local/src</code>, <i>e.g.</i><br><br>
<center><b>mkdir /usr/local/src/kforth</b></center>
<br><br>
and move the archive file <code>kflnx10.tar.gz</code> into
this directory,<br><br>
<center><b>mv kflnx10.tar.gz /usr/local/src/kforth</b></center>
<br><br>
<li>Change to the kforth source directory,<br><br>
<center><b>cd /usr/local/src/kforth</b></center><br><br>
and extract the source files using the command<br><br>
<center><b>tar -zxvf kflnx10.tar.gz</b></center>
<br><br>
<li>Along with the extracted source files, there will also be a
<code>Makefile</code> in the directory. Type <br><br>
<center><b>make</b></center><br><br>
to generate the executable. The GNU assembler, C, and C++ compilers
must be installed on your system. In addition, the <code>readline</code>
and <code>ncurses</code> libraries must be present on your system.
<br><br>
<li>The executable, named <b>kforth</b> will be generated. Move the
executable to the directory <code>/usr/local/bin</code> in order to
put it in a path available to users,
<br><br>
<center><b>mv kforth /usr/local/bin</b></center><br><br>
<li>Sample source code files are included in the archive. These
files have extension <code>.4th</code>. Users may copy the
example programs to their own directories.
<br><br>
<li>You may specify a default directory in which kforth
will search for .4th files not found in the current
directory. The environment variable <code>KFORTH_DIR</code> must
be set to this directory. For example, under the BASH
shell, if you want the default directory to be
<code>/usr/local/src/kforth</code>, add the following lines to your
<tt>.bash_profile</tt> file:<br><br>
<pre>
KFORTH_DIR=/usr/local/src/kforth
export KFORTH_DIR
</pre><br><br>
<li>The file <tt>kforth.xpm</tt> may be used to create a desktop icon
for kForth under X Windows. For example, if you are using
the KDE environment, copy <tt>kforth.xpm</tt> to the <tt>/usr/share/icons</tt>
directory.
<br>
</ol>
<hr>
<br><br>
<a name="Installation under Windows"></a><h3>Installation under Windows</h3>
<p>
The <a href="http://cygwin.com">Cygwin development tools</a> must be
installed on your Windows system to rebuild the executable starting
from the source code. If you do not wish to build kForth from scratch,
simply download the distribution file
<a href="ftp://ccreweb.org/software/kforth/windows/kfwin10.zip">
kfwin10.zip</a> and unzip the contents into the desired directory.
The zip file contains the executable <tt>kforth.exe</tt>, the required
dynamic link libraries <tt>cygwin1.dll</tt>, <tt>cygncurses5.dll</tt>,
<tt>cygreadline4.dll</tt>, and sample kForth programs.<br><br>
<p>
Follow these steps to build kForth from scratch on your
Windows system:<br><br>
<ol>
<li> Start the Cygwin BASH shell.<br><br>
<li> Create a directory for the kForth source files, typically
in the <code>/usr/local/src</code> directory, <i>e.g.</i><br><br>
<center><b>mkdir /usr/local/src/kforth</b>
</center><br><br>
<li> Move the kForth archive file <code>kfwin10.tar.gz</code>
into this directory:<br><br>
<center><b>mv kfwin10.tar.gz /usr/local/src/kforth</b>
</center><br><br>
<li> Change to the <code>/usr/local/src/kforth</code> directory
and extract the files:<br><br>
<pre>
cd /usr/local/src/kforth
tar -zxvf kfwin10.tar.gz
</pre><br><br>
After this step, the directory should contain all of the kforth
source files, the <code>Makefile</code>, and a <code>README</code>
file containing these instructions.<br><br>
<li> Build the kForth executable. There are several options for
building kForth, but the simplest is to type:<br><br>
<center><b>make</b></center><br><br>
All of the source files will be compiled/assembled and the
executable file, named <code>kforth.exe</code>, will be generated.
<br><br>
<li> Move the executable to the desired directory.<br><br>
<li> Sample source code files, with the extension <code>.4th</code>,
are included in the archive file. These files are inteded to
serve as <a href="kforth4.html">programming examples</a> for kForth.<br><br>
<li> If you will be running kForth from the Cygwin BASH shell,
you may specify a default directory in which kForth
will search for .4th files not found in the current
directory. The environment variable KFORTH_DIR must be set
to this directory. For example, under the BASH
shell, if you want the default directory to be
<code>/usr/local/src/kforth</code>, add the following
lines to your <code>.bash_profile</code> file:<br><br>
<pre>
KFORTH_DIR=/usr/local/src/kforth
export KFORTH_DIR
</pre><br><br>
<li> The file <code>kforth.ico</code> may be used to create a
desktop icon for kforth under Windows.<br><br>
</ol>
<br><hr>
<a href="kforth1.html"><img src="left.gif"></a>
<a href="kforth2.html"><img src="right.gif"></a> <br><br>
Copyright © 1998--2001 Creative Consulting for Research and Education<br>
</body>
</html>
|
