How to build the mandelbrot-demo program

1. Needed

	- source files (found in mandelbrot-demo.tar.gz):
		apfel.f
		pchar.asm

	- compiler, assembler, loader, punch program (found in tape-images.new.tar.gz):
	 	SLST-FRTN.img
		SLST-LDR-APM.img
		OBJECT-PAL-AP.img
		SLST-DAP-16.img
		
	- fortran library, 3 files (found in tape-images.new.tar.gz):
		LIBRARY-FORT_LIB_1.img
		LIBRARY-FOR_LIB_2S.img
		LIBRARY-FORT_LIB_3.img


1. Prepare source files.
	- You have to change the source files to <CR><LF> line termination (MS-DOS style)
	- Then you have to set the 8th bit on all data - yes, you can't it read anymore...
	  There are also some tricks with an & in the emulator...

	- Remove my header from the SLST files. In library files no problem.

	- If you use the Emulator: go to step 2.
	- If you use the original machine: punch out the source tapes :-)
	
2. Build pchar routine
	PCHAR is a little assembler routine allowing simplest unformatted io.
	
	- Boot SLST-DAP-16.img
	- MSTCLR
	- A reg: Set bits:
		-1 Two-pass assembly
		-3 Input from high-speed paper tape
		-11 NO object output
		-12 Listing on teletype
	- P reg: '1000
	
	
	Real machine:
	
		- Mount the source tape into the high speed reader, turn on ASR
		- press START and wait.....
		- Assembly should stop at the end of text on the tape. Tape should not
		  run out.
		- Reposition tape to the beginning.
		- Press start again. 
		- After completion the assembler says "AC". With or without errors!!
		
		Now you have a listing. Let's build the object file:
		
		- Mount the source tape into the high speed reader, turn on ASR punch
		- A-reg bits 1-3-7-16 (no listing, object to asr, no listing)
		- P-REG 1000
		- Reposition tape to the beginning.
		- Press start again. 
		- After completion the assembler says "AC". With or without errors!!

		 Now you have the pchar object. Need it later.
		 
	Emulator:
		- Same register settings as on real machine.
		- Press START, emulator will ask for "ptr" file.
		- enter "pchar.par" or whatever you have chosen for the converted file.
		- The assembler will stop.
		- Press START again.
		- Will say EOF and ask for more paper. give source file again.
		- Should print listing and say "AC"
		
		Make the object:
		- A-reg 1-3-8-16, P-reg '1000
		- Same procedure but answer the questions "ptp" with your new
		  object's filename, "pchar.obj" for example.
		- Notice: look closely if you're asked for PTP or PTR. If you enter your
		  source file name at PTP it will be erased instantly!!
		- Leave emulator program. Important to really close.
		
		Now you have the pchar object. Need it later.
	  
		NOTICE: Sometimes the emulator asks for a file 
		        and does not echo your keystrokes.
                 	BUT IT WORKS!!!!	


3. Build mail object file
	- That's easier than using the two-pass assembler....!
	- Boot SLST-FRTN.img
	- MSTRCLR
	- A-reg settings:
	 	-'000310: Listing on ASR, suppress verbosity by setting sense switch 2
		-'000302: Object output to ASR
	- Operation: 
	 	-Start at '1000 like with the assembler. But only one pass.
	 	-Will type "end of job"....
	- Now you should have two different object tapes or files.
	- Leave emulator!!!!	

4. Putting all together
	- Boot SLST-LDR-APM.img
	- MSTRCLR
	- Change contents of memory address '15000 to '17777 or '37777
	- MSTRCLR
	- A-reg '17000, P-reg '16000
	- OBJECT-PAL-AP.img needed. Mount tape now if using real hardware
	- Press START TWICE
	- if using emulator, enter "OBJECT-PAL-AP.img" at the PTR prompt
	- LDR-APM now loads PAL-AP. Should say LC when ready. If it says CK you
	  have a checksum error on the tape. If tape runs out you have a problem
	
	Now load apfel.obj:
	- MSTRCLR
	- P-reg '16000 A-reg '1000
	- now the usual sequence "tape and start" for real machine, and "start and tape"
	  for emulator. using apfel.obj
	- Will say MR. Means that you have unresolved symbols. 
	- If you like to you can set P-reg to '16002' and start. You'll get a memory map.
	
	- Go on loading with pchar.obj. Loading continues if START is pressed
	- Now process the library files the same way. The order is important. 1,2,3
	- If you have managed this you will get LC (loading complete).
	
	Now the application is ready to run. But wait! Don't you want to generate a
	self loading system tape (SLST) with PAL-AP? Sure! So you can always restore the 
	actual state without doing all the patching stuff.
	
	- Punch on ASR on.
	- P-reg '17000', A-reg set only bit 1.
	- Press START. Computer will halt.
	- Enter '100 to A-reg and press START. Will halt again.
	- Enter '6700 to A-reg and press START. Will begin to punch
	  self loading tape. (or ask for file etc... ASRPTP)
	
	Now you have the SLST and can easily load the program by booting the tape.

5. Start the program	
	- When the program is loaded start the computer at '1000. That's all.
	- When program is ready PA will be printed and CP halts. If you press START
	  it will start a new run.
	  
6. Good luck. I hope I have described enough...