added -varshigh compiler option to move BSS section.

Documented BSS a bit in the manual.

codeCore/src/prog8/code/core/CompilationOptions.kt

@@ -19,6 +19,7 @@ class CompilationOptions(val output: OutputType,
                          var asmQuiet: Boolean = false,
                          var asmListfile: Boolean = false,
                          var experimentalCodegen: Boolean = false,
+                         var varsHigh: Boolean = false,
                          var evalStackBaseAddress: UInt? = null,
                          var outputDir: Path = Path(""),
                          var symbolDefs: Map<String, String> = emptyMap()

codeCore/src/prog8/code/core/IMachineDefinition.kt

@@ -16,6 +16,8 @@ interface IMachineDefinition {
     var ESTACK_LO: UInt
     var ESTACK_HI: UInt
     val PROGRAM_LOAD_ADDRESS : UInt
+    val BSSHIGHRAM_START: UInt
+    val BSSHIGHRAM_END: UInt
 
     val cpu: CpuType
     var zeropage: Zeropage

codeCore/src/prog8/code/target/atari/AtariMachineDefinition.kt

@@ -17,6 +17,9 @@ class AtariMachineDefinition: IMachineDefinition {
     override var ESTACK_LO = 0x1b00u     //  $1b00-$1b7f inclusive      // TODO
     override var ESTACK_HI = 0x1b80u     //  $1b80-$1bff inclusive      // TODO
 
+    override val BSSHIGHRAM_START = 0u    // TODO
+    override val BSSHIGHRAM_END = 0u      // TODO
+
     override lateinit var zeropage: Zeropage
     override lateinit var golden: GoldenRam
 

codeCore/src/prog8/code/target/c128/C128MachineDefinition.kt

@@ -17,6 +17,10 @@ class C128MachineDefinition: IMachineDefinition {
     // the 2*128 byte evaluation stack (1 page, on which bytes, words, and even floats are stored during calculations)
     override var ESTACK_LO = 0x1b00u     //  $1b00-$1b7f inclusive
     override var ESTACK_HI = 0x1b80u     //  $1b80-$1bff inclusive
+
+    override val BSSHIGHRAM_START = 0u    // TODO
+    override val BSSHIGHRAM_END = 0u      // TODO
+
     override lateinit var zeropage: Zeropage
     override lateinit var golden: GoldenRam
 

codeCore/src/prog8/code/target/c64/C64MachineDefinition.kt

@@ -18,6 +18,10 @@ class C64MachineDefinition: IMachineDefinition {
     // the 2*128 byte evaluation stack (1 page, on which bytes, words, and even floats are stored during calculations)
     override var ESTACK_LO = 0xcf00u     //  $cf00-$cf7f inclusive
     override var ESTACK_HI = 0xcf80u     //  $cf80-$cfff inclusive
+
+    override val BSSHIGHRAM_START = 0xc000u
+    override val BSSHIGHRAM_END = ESTACK_LO
+
     override lateinit var zeropage: Zeropage
     override lateinit var golden: GoldenRam
 

codeCore/src/prog8/code/target/cx16/CX16MachineDefinition.kt

@@ -17,6 +17,10 @@ class CX16MachineDefinition: IMachineDefinition {
     // the 2*128 byte evaluation stack (1 page, on which bytes, words, and even floats are stored during calculations)
     override var ESTACK_LO = 0x0700u        //  $0700-$077f inclusive
     override var ESTACK_HI = 0x0780u        //  $0780-$07ff inclusive
+
+    override val BSSHIGHRAM_START = 0xa000u     // hiram bank 1, 8Kb, assumed to be active
+    override val BSSHIGHRAM_END = 0xc000u       // rom starts here.
+
     override lateinit var zeropage: Zeropage
     override lateinit var golden: GoldenRam
 

codeCore/src/prog8/code/target/virtual/VirtualMachineDefinition.kt

@@ -17,6 +17,8 @@ class VirtualMachineDefinition: IMachineDefinition {
 
     override var ESTACK_LO = 0u                 // not actually used
     override var ESTACK_HI = 0u                 // not actually used
+    override val BSSHIGHRAM_START = 0u          // not actually used
+    override val BSSHIGHRAM_END = 0u            // not actually used
     override lateinit var zeropage: Zeropage    // not actually used
     override lateinit var golden: GoldenRam     // not actually used