forked from epatel/xAce
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathREADME
146 lines (111 loc) · 4.85 KB
/
README
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
/\
__ __ / \ ___ ___
\ \/ / / /\ \ / __/ _ \
> < / ____ \ (_| __/
/_/\_\/_/ \_\___\___|
The Jupiter ACE is the real *outsider* micro from the 80's.
Instead of having BASIC as the programming language it had FORTH.
It was designed by two guys who had worked at Sinclair Research Ltd
and were responsible for the famous Sinclair ZX81 and ZX Spectrum.
They are Steven Vickers and Richard Altwasser.
For a FAQ (2010) see
http://www.robsons.org.uk/archive/users.aol.com/autismuk/ace/faq.htm
I made it for the fun of it. As a base I used Russell Marks
ZX81 emulator xz81. Which he based on Ian Collier xz80, a
ZX Spectrum emulator for X. The xz81 can be found (2010) at
http://www.zx81.nl/dload/emulators/unix/z81-0.2.tar.gz
----------------------------------------------------------------------
9 May 2010
The project has been revived at github by http://github.com/LawrenceWoodman
I have updated a couple of broken references.
I can recommend downloading a copy of "Thinking Forth"
http://thinking-forth.sourceforge.net/
-Edward
----------------------------------------------------------------------
15 Feb 1999
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or (at
your option) any later version.
This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
Files:
README - This file
CHANGELOG.md - Lists the changes between versions
COPYING - The GNU GENERAL PUBLIC LICENSE
forth.txt - Crash course in Forth
boldcomp.email.txt - Email from Boldfield Computing shedding light on
the legal position of distributing the rom with
the emulator
.gitignore - Tells Git which files to ignore
CMakeLists.txt - CMake file for creating system dependent
Makefiles
ace.rom - The Jupiter Ace rom image
src/ - Contains the source code for xAce
tests/ - Contains testing routines
Requirements:
xAce will run on a variety of Unix platforms and has been tested
most thoroughly on Linux.
To compile it you will need to have the following development
libraries installed:
libx11 (Often packaged as libx11-dev)
libxext (Often packaged as libxext-dev)
In addition the build process uses 'CMake', which you will have to have
installed on your system.
Compilation and Installation:
From the root directory of the repository, i.e. The directory this file
is in. Run 'cmake' to create the Makefiles:
cmake .
Now run 'make' from the same directory:
make
The binary executable will now be in src/, to install it to a sensible
location such as '/usr/local/bin' run the following as root:
make install
For the moment xAce must be run from a terminal window and from the
same directory in which the rom image is to be found. So from the
current directory run:
xace
The ROM?
The distribution includes a copy of the Jupiter ACE ROM image.
Please see boldcomp.email.txt file included for more information.
Version:
v0.5 See CHANGELOG.md for details of changes.
Loading/Saving External Files:
To attach a tape press 'F3' and enter the name of the tape
file that you wish to use. From this point any loading or
saving is done to this file.
It is important to note that when you save, the rest of the
file is truncated.
Spooling:
To spool text into xAce from an external file, press 'F11'
and enter the name of the file that you want xAce to read.
Alternatively you can use the -s command line switch e.g.
./xace -s spool.file
or to spool more quickly, use -S e.g.
./xace -S spool.file
The host keyboard response is turned off during spooling to avoid
corruption.
Software for the Jupiter Ace:
The Jupiter Ace Resource Site (http://www.jupiter-ace.co.uk) is
the best source for Ace software. Here you will find that most
of the .TAP files should work.
Useful Links:
The xAce project page (http://lawrencewoodman.github.com/xAce/)
The Jupiter Ace Resource Site (http://www.jupiter-ace.co.uk)
Others:
Paul Robson (old email removed) has made a DOS version and is also
the maintainer of the FAQ mentioned earlier.
Credits:
Steven Vickers and Richard Altwasser
Russell Marks
Ian Collier (old email removed)
Paul Robson (old email removed)
Michael Josefsson (old email removed)
Ronald Kneusel (old email removed)
Contact:
e-mail: See github (old email removed)
Share and enjoy!
-Edward
"An idiot with a computer is a faster, better idiot" - Rich Julius