Added README file to the disk

build.sh

@@ -9,9 +9,18 @@ python="python"
 rm -fr work
 mkdir work
 
+# Get the current date for the build filename
+CURRENTDATE=`date +%Y-%m-%d`
+
 # First, we build the NTSC version
 cd work
 
+# Create an empty file for the build number
+touch empty.txt
+
+# Create the readme file for flicker-free ships
+$beebasm -i ../src/elite-flicker-free-readme.asm
+
 # Extract the files from the original disk image
 $c1541 -attach "../original-disks/elite[firebird_1986](ntsc)(v060186)(!).g64" \
        -extract
@@ -33,7 +42,9 @@ $c1541 \
     -write gma3 \
     -write gma4.encrypted gma4 \
     -write gma5.encrypted gma5 \
-    -write gma6.encrypted gma6
+    -write gma6.encrypted gma6 \
+    -write readme64.txt "readme,s" \
+    -write empty.txt "build ${CURRENTDATE},s"
 
 # Report checksums
 cd ..
@@ -64,7 +75,9 @@ $c1541 \
     -write gma3 \
     -write gma4.encrypted gma4 \
     -write gma5.encrypted gma5 \
-    -write gma6.encrypted gma6
+    -write gma6.encrypted gma6 \
+    -write readme64.txt "readme,s" \
+    -write empty.txt "build ${CURRENTDATE},s"
 
 # Report checksums
 cd ..

src/elite-flicker-free-plus4.asm

@@ -1,6 +1,6 @@
 \ ******************************************************************************
 \
-\ BBC MASTER ELITE GAME SOURCE (FLICKER-FREE ROUTINES)
+\ FLICKER-FREE COMMODORE PLUS/4 ELITE
 \
 \ BBC Master Elite was written by Ian Bell and David Braben and is copyright
 \ Acornsoft 1986

src/elite-flicker-free-readme.asm

@@ -0,0 +1,107 @@
+\ ******************************************************************************
+\
+\ COMMODORE 64 FLICKER-FREE ELITE README
+\
+\ BBC Master Elite was written by Ian Bell and David Braben and is copyright
+\ Acornsoft 1986
+\
+\ The code on this site has been reconstructed from a disassembly of the version
+\ released on Ian Bell's personal website at http://www.elitehomepage.org/
+\
+\ The commentary is copyright Mark Moxon, and any misunderstandings or mistakes
+\ in the documentation are entirely my fault
+\
+\ The terminology and notations used in this commentary are explained at
+\ https://www.bbcelite.com/about_site/terminology_used_in_this_commentary.html
+\
+\ The deep dive articles referred to in this commentary can be found at
+\ https://www.bbcelite.com/deep_dives
+\
+\ ******************************************************************************
+
+MACRO CAP x
+ EQUB x + 128
+ENDMACRO
+
+.readmeC64
+
+ EQUB 13
+ EQUS "---------------------------------------"
+ EQUB 13
+ CAP 'F'
+ EQUS "LICKER-FREE "
+ CAP 'C'
+ EQUS "OMMODORE 64 "
+ CAP 'E'
+ EQUS "LITE"
+ EQUB 13
+ EQUB 13
+ CAP 'C'
+ EQUS "ONTAINS THE FLICKER-FREE SHIP DRAWING "
+ EQUB 13
+ EQUS "ROUTINES FROM THE "
+ CAP 'B'
+ CAP 'B'
+ CAP 'C'
+ EQUS " "
+ CAP 'M'
+ EQUS "ASTER VERSION,"
+ EQUB 13
+ EQUS "BACKPORTED BY "
+ CAP 'M'
+ EQUS "ARK "
+ CAP 'M'
+ EQUS "OXON"
+ EQUB 13
+ EQUB 13
+ CAP 'C'
+ EQUS "ONTAINS FLICKER-FREE PLANET DRAWING "
+ EQUB 13
+ EQUS "ROUTINES BY "
+ CAP 'M'
+ EQUS "ARK "
+ CAP 'M'
+ EQUS "OXON"
+ EQUB 13
+ EQUB 13
+ CAP 'B'
+ EQUS "ASED ON THE "
+ CAP 'F'
+ EQUS "IREBIRD RELEASE OF "
+ CAP 'E'
+ EQUS "LITE"
+ EQUB 13
+ CAP 'B'
+ EQUS "Y "
+ CAP 'I'
+ EQUS "AN "
+ CAP 'B'
+ EQUS "ELL AND "
+ CAP 'D'
+ EQUS "AVID "
+ CAP 'B'
+ EQUS "RABEN"
+ EQUB 13
+ CAP 'C'
+ EQUS "OPYRIGHT (C) "
+ CAP 'D'
+ EQUS "."
+ CAP 'B'
+ EQUS "RABEN AND "
+ CAP 'I'
+ EQUS "."
+ CAP 'B'
+ EQUS "ELL 1985"
+ EQUB 13
+ EQUB 13
+ CAP 'S'
+ EQUS "EE WWW.BBCELITE.COM FOR DETAILS"
+ EQUB 13
+ EQUB 13
+ CAP 'B'
+ EQUS "UILD: ", TIME$("%F %T")
+ EQUB 13
+ EQUS "---------------------------------------"
+ EQUB 13
+
+SAVE "README64.txt", readmeC64, P%

src/elite-flicker-free.asm

@@ -1,6 +1,6 @@
 \ ******************************************************************************
 \
-\ BBC MASTER ELITE GAME SOURCE (FLICKER-FREE ROUTINES)
+\ FLICKER-FREE COMMODORE 64 ELITE
 \
 \ BBC Master Elite was written by Ian Bell and David Braben and is copyright
 \ Acornsoft 1986