-
Notifications
You must be signed in to change notification settings - Fork 0
/
INSTALL.txt
executable file
·119 lines (82 loc) · 4.56 KB
/
INSTALL.txt
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
(Suomenkieliset asennusohjeet tiedostossa INSTALL_fi.txt.)
INSTALLATION INSTRUCTIONS
I. Getting and installing Java
Titokone is a TTK-91 machine language simulator written in Java. To
run Titokone, you need a Java virtual machine (minimum version 1.4.2)
installed. You can download an implementation of the Java virtual
machine at http://java.sun.com. Follow their installation instructions.
It may be slightly difficult to find what you want at Sun's Java
pages. To install just the virtual machine, look for "JRE", to install
the development environment as well for making your own Java programs
or for creating new translations for Titokone, look for "SDK". At the
time of writing this, J2SE version 1.4.2, both SDK and JRE (the 2 is
the platform number, version number is different) could be downloaded
from http://java.sun.com/j2se/1.4.2/download.html.
Note that on the University of Helsinki, CS department, Java SDK 1.4.2
or newer has been installed already, so you only need to install Java
if you want to use Titokone at eg. your home machine.
II. Getting Titokone
You can get Titokone via the Tietokoneen toiminta (Computer Organization)
course homepage, currently at http://www.cs.helsinki.fi/teemu.kerola/tito/.
You can choose between downloading the JAR package containing Titokone
(titokone.jar) directly or downloading a ZIP file which contains the
JAR file itself along with some instructions and helper programs.
III. Installing Titokone
1) Quick installation (Windows, Linux, etc)
For those who know how to manage JAR packages directly, fetching
titokone.jar is sufficient. (JAR is a package format; if you have an
up-to-date version of WinZip, you should be able to open them; in Linux,
use the command 'jar' - see below.) No installation is required; you can
run the jar file directly. For example, in Windows you must execute the
command
java.exe -jar titokone.jar
in the directory where you stored the titokone.jar package.
In Linux, you must execute the command
java -jar titokone.jar
to run the program. You must have Java installed and on your execution
path.
2) Almost-as-quick installation in Windows
Download titokone.zip and unpack it to the target directory of your
choosing. (The package creates a subdirectory called 'titokone'.) To
run Titokone, go to the subdirectory and double-click on the titokone
BAT (MS-DOS Batch) file. You can tell titokone.bat apart from the
titokone.jar file by its icon; titokone.jar usually looks like
something yellow in a screw bench, titokone.bat resembles a cog wheel
inside a window frame. Titokone.sh, a script which starts the program
in Linux, is probably an unknown filetype in Windows.
If BAT files have stopped working in Windows MEGAMILLIONSUPER (we have
tested them up to Windows XP), you can probably still somehow run the
command 'java.exe -jar C:\my\path\to\titokone\titokone.jar' via the
Start menu. Replace C:\my\path\to\titokone with the actual path to the
file.
3) Almost-as-quick installation in Linux
Download titokone.zip and unpack it (eg. gunzip titokone.zip) to the
target directory of your choosing. (The package creates a subdirectory
called 'titokone'.) To run Titokone, open a terminal, change to the
directory the zip file opened, and then the 'titokone' subdirectory,
and run
java -jar titokone.jar
If typing is tiresome, the zip contains a titokone.sh startup script
for your convenience. You can rename the file to something shorter,
like tk. Then you just need to run ./tk (or ./titokone.sh if you have
not renamed it). The script does not change directories, so you must
either keep it in the same directory as titokone.jar or edit it.
4) Opening the jar (mostly interesting for developers only)
If you wish, you can open the jar by running the following command:
in Windows: It is probably easiest to open the file using WinZip or
something similar.
in Linux: jar -xvf titokone.jar
The jar package contains the source code and class files, among other
things. If you modify the files, eg. to add a new language file (see the
included manual on how to do this), you should note that the class files
are a part of a Java package (three packages, to be exact).
To start the modified program, change to the package root directory (where
the 'fi' subdirectory is located) and run the command:
in Windows: java.exe fi.hu.cs.titokone.Titokone
in Linux: java fi.hu.cs.titokone.Titokone
Javadoc of the classes is included in javadoc/. To compile files
(needed for eg. adding new language support), you need Java SDK, JRE
is not sufficient.
See also: README.txt.
Enjoy!
May 2004, the Titokone developers.