LOADING INSTRUCTIONS FOR NOOBS
Z88 Boggle for Cambridge Computer Z88 emulator(s)
=================================================

Adapted from a similar document by John Connolly for the 2020 CSSCGC
which also contained a Z88 entry by Jamie Bradbury. These instructions
are pretty much idiot-proof for even the noobiest of Z88 noobs.

For the record, I am using the "raw" Java version of OZvm v1.2, i.e. one that's
been compiled as a .jar file. This should be usable on any OS that has Java
installed. Navigate to it in a command prompt / terminal window (delete as
appropriate) and run it with:
java -jar z88.jar

--------------------------------------------------------------------------------

To install and run 'Z88 Boggle' from its raw text file using the OZvm v1.2:

1.	Click on an empty slot from 1 to 3 at the bottom of the emulator window. If
	no slots are available, you will have to remove one of the installed cards.
2.	The 'Create Card' window should open. Change the card type to anything but
	'RAM' ('EPROM' should do the trick), and then click on 'Load Files...'.
3.	Navigate to the folder where the BASIC listing is stored (that's
	'boggle.txt') and select the file. Make sure the box for 'Create File
	Area' is ticked.
4.	Select 'Yes', and the card should now appear installed in the Z88.
5.	Perform a hard reset of the Z88. (It's under the 'Z88' menu.)
6.	Use the cursor keys within the Z88 to navigate to the FlashStore
	application. Press ENTER to open it. Once loaded, move the flashing cursor
	to the card which you have just installed and press ENTER to inspect its
	contents.
7.	Once inside the card, 'boggle.txt' should be present in the directory.
	Select it and press ENTER (making sure your cursor is in the directory
	view).
8.	You will be asked if you want to copy 'boggle.txt' to the Z88's internal 
	RAM (as 'RAM.0/boggle.txt'). Press ENTER to confirm.
9.	Now that the listing is in the Z88's RAM disk, press ESC until you return 
	to the application menu. Now, select BBC BASIC.
10.	Once inside BBC BASIC, type the following:
	*CLI .*BOGGLE.TXT
	The listing will copy itself from the RAM disc into BBC BASIC.
11.	Eventually, the program will finish loading (for reference, the final line 
	number is 650, a DATA statement).
12.	Make a snapshot at this point to save going through the whole process 
	again. Select 'Save Z88 snapshot' from the 'File' menu and choose your
	filename. (NOTE that I've done all this already! 'Z88 Boggle.z88' should be
	right there waiting for you in the 'Jim's Additional Material' folder.)
13. To play the game, type 'RUN' and hit ENTER. Just like a Spectrum, or a ZX81,
	or even... gasp!... a BBC Micro!

These steps assume you are using a freshly installed version of OZvm
v1.2 for Windows. This guide has not been tested on other versions of
OZvm or different operating systems. No liability can be accepted for
damage to your computer or yourself as a result of following these
instructions (though I can't imagine how one would incur such damages).
