Add relocatable version doc bits. Remove tom_rtest target.

tom_rtest is going to be covered by something in acorn_mos_disassembly,
which will also serve as an example for general tube_relocation.py use.

Author: Tom Seddon

Makefile

@@ -51,6 +51,7 @@ build:
 	$(_V)$(PYTHON) submodules/beeb/bin/tube_relocation.py create -o $(DEST)/rbasiced.relocation.dat $(DEST)/rbasiced.rom $(DEST)/rbasiced2.rom 
 
 	$(_V)$(SHELLCMD) stat --size-budget=16384 $(DEST)/basiced_.rom $(DEST)/basiced.rom $(DEST)/hibasiced.rom $(DEST)/elkbasiced.rom $(DEST)/elkhibasiced.rom $(DEST)/rbasiced.rom
+	$(_V)$(SHELLCMD) stat $(DEST)/rbasiced.relocation.dat
 
 	$(_V)$(SHELLCMD) sha1 "--ignore=$(VER)" $(DEST)/basiced.rom
 
@@ -93,19 +94,3 @@ clean:
 
 ##########################################################################
 ##########################################################################
-
-# Test the relocating version. For me, on my Windows laptop. Build DFS
-# 2.45 for MOS 3.50r with relocation tables for BASIC, EDIT, and BASIC
-# Editor.
-
-.PHONY:tom_rtest
-tom_rtest: _MOS320=../mos320
-tom_rtest: _DEST=$(DEST)/rbasiced
-tom_rtest: build
-	$(_V)cd $(_MOS320) && make
-	$(_V)$(SHELLCMD) mkdir "$(_DEST)"
-	$(_V)$(SHELLCMD) copy-file "$(_MOS320)/orig/350/basic.4r32.rom" "$(_DEST)/"
-	$(_V)$(SHELLCMD) copy-file "$(_MOS320)/orig/350/edit.1.50r.rom" "$(_DEST)/"
-	$(_V)$(SHELLCMD) copy-file "$(_MOS320)/orig/350/dfs.2.45.rom" "$(_DEST)/"
-	$(_V)$(SHELLCMD) copy-file "$(DEST)/rbasiced.rom" "$(_DEST)/"
-	$(_V)$(PYTHON) submodules/beeb/bin/tube_relocation.py --verbose set-multi --bitmap-rom "$(_DEST)/dfs.2.45.rom" 9 --begin 0xaf00 --end 0xb800 --rom "$(_DEST)/basic.4r32.rom" "$(_MOS320)/build/basic.4r32.relocation.dat" --rom "$(_DEST)/edit.1.50r.rom" "$(_MOS320)/build/edit.1.50r.relocation.dat" --rom "$(_DEST)/rbasiced.rom" "$(DEST)/rbasiced.relocation.dat" --set-multi

docs/build.md

@@ -12,6 +12,10 @@ Prerequisites (Windows):
 
 To build, type `make`.
 
-The ROM images are written to a folder called `.build`: `basiced.rom`
-and `hibasiced.rom`.  The Electron ROM images are called
-`elkbasiced.rom` and `elkhibasiced.rom`.
+The ROM images are written to a folder called `.build`:
+
+- `basiced.rom` - The BASIC Editor, BBC version
+- `hibasiced.rom` - The HIBASIC Editor, BBC version
+- `elkbasiced.com` - The BASIC Editor, Electron version
+- `elkhibasiced.com` - The HIBASIC Editor, Electron version
+- `rbasiced.rom` `rbasiced.relocation.dat` - The BASIC Editor, relocatable MOS 3.50 version

docs/doc.md

@@ -221,3 +221,23 @@ FUNC + various letters and punctuation characters:
 Note that these shortcuts prevent you from using FUNC + the letter keys to
 obtain the keyword firmkeys that you would normally get in BASIC on the
 Electron.
+
+# The BASIC Editor (relocatable) (MOS 3.50 only) (DIY required)
+
+The BASIC Editor (relocatable) is an ordinary-looking sideways ROM
+containing The BASIC Editor. But, in conjunction with its relocation
+bitmap (supplied), and a bit of elbow grease (this part is up to you,
+sorry!), it can also act as The HIBASIC Editor when used with a 6502
+second processor. Both ROMs in 1 ROM bank!
+
+These files can be used with my `tube_relocation` Python 3.x script:
+https://github.com/tom-seddon/beeb/tree/master/bin#tube_relocation -
+the script will insert the relocation bitmap into a spare region in
+some other ROM, and update the ROM image updated to refer to it.
+
+You should be able to make this work with standard MOS 3.50, but my
+refreshed MOS 3.50 versions will give you more options (and noticeably
+improve the relocation speed):
+https://github.com/tom-seddon/acorn_mos_disassembly/blob/master/docs/refresh.md
+
+Setting this up is currently a DIY job.