File: README

package info (click to toggle)
kforth 20010227-2
  • links: PTS
  • area: main
  • in suites: woody
  • size: 508 kB
  • ctags: 652
  • sloc: asm: 2,026; cpp: 1,795; ansic: 575; makefile: 64
file content (97 lines) | stat: -rw-r--r-- 2,883 bytes parent folder | download
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
README file for kforth for Linux

Copyright (c) 1999--2000 Creative Consulting for Research and Education
Last Revised: 8-8-2000

GENERAL
-------

kforth for Linux is provided under the terms of the GNU
General Public License. The license terms for this software 
are explained at our website:

http://ourworld.compuserve.com/homepages/krishnamyneni/ccre/ccre.htm

New releases of this software will be posted at the website, as they
become available. Online documentation is also available at the website.
Further information may be obtained by sending e-mail to:

krishnamyneni@compuserve.com

INSTALLATION 
------------

kforth is distributed as a compressed tar (Unix Tape Archive) file
with the name:

	kflnx10.tar.gz

This file contains the source code files and a Makefile for building
the executable. The GNU C/C++ development files are required to be
installed on your system. In addition, the 'readline' and 'ncurses'
libraries must be available.

Follow these steps to install kforth on your system:

1. Log in as the root user (superuser).

2. Create a directory for the kforth source files, typically
   in the /usr/local/src directory, e.g.

	mkdir /usr/local/src/kforth

3. Move the kforth archive file (kflnx10.tar.gz) into this directory:

	mv kflnx10.tar.gz /usr/local/src/kforth

4. Change to the /usr/local/src/kforth directory and extract the
   files:

	cd /usr/local/src/kforth
	tar -zxvf kflnx10.tar.gz

   After this step, the directory should contain all of the kforth
   source files, the Makefile, and this README file.

5. Build the kforth executable. There are several options for
   building kforth, but the simplest is to type:

	make

   All of the source files will be compiled/assembled and the
   executable file, named "kforth", will be generated. 


6. Move the executable to a directory in the path for users:
	
	mv kforth /usr/local/bin

   Any user should then be able to execute kforth.

7. Sample source code files, with the extension ".4th", are
   included in the archive file. These files are inteded to
   serve as programming examples for kforth. Users may copy
   the .4th files into their directories.

8. 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 
   /usr/local/src/kforth, add the following lines to your
   .bash_profile file:

	KFORTH_DIR=/usr/local/src/kforth
	export KFORTH_DIR

9. The file kforth.xpm may be used to create a desktop icon
   for kforth under X Windows. For example, if you are using
   the KDE environment, copy kforth.xpm to the /usr/share/icons
   directory.

Contact CCRE via email at krishnamyneni@compuserve.com if you 
have problems installing the software on your system.