fix atari target syslib

compiler/res/prog8lib/atari/syslib.p8

@@ -7,10 +7,14 @@ atari {
         &uword  RESET_VEC       = $FFFC     ; 6502 reset vector, determined by the kernal if banked in
         &uword  IRQ_VEC         = $FFFE     ; 6502 interrupt vector, determined by the kernal if banked in
 
-; ---- kernal routines ----
+}
-; TODO
 
 
+sys {
+    ; ------- lowlevel system routines --------
+
+    const ubyte target = 8         ;  compilation target specifier.  64 = C64, 128 = C128,  16 = CommanderX16, 8 = atari800XL
+
     asmsub  init_system()  {
         ; Initializes the machine to a sane starting state.
         ; Called automatically by the loader program logic.
@@ -32,15 +36,6 @@ asmsub  init_system_phase2()  {
         }}
     }
 
-}
-
-
-sys {
-    ; ------- lowlevel system routines --------
-
-    const ubyte target = 8         ;  compilation target specifier.  64 = C64, 128 = C128,  16 = CommanderX16, 8 = atari800XL
-
-
     asmsub  reset_system()  {
         ; Soft-reset the system back to initial power-on Basic prompt.
         ; TODO

compiler/res/prog8lib/atari/textio.p8

@@ -118,7 +118,6 @@ romsub $F2Fd = waitkey()
 asmsub chrout(ubyte char @ A) {
 	%asm {{
 		sta  _tmp_outchar+1
-		pha
 		txa
 		pha
 		tya
@@ -130,7 +129,6 @@ _tmp_outchar
 		tay
 		pla
 		tax
-		pla
 		rts
 	}}
 }

docs/source/building.rst

@@ -255,28 +255,32 @@ Troubleshooting
 Compiler doesn't run, complains about "UnsupportedClassVersionError"
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 You need to install and use JDK version 11 or newer to run the prog8 compiler. Check this with "java -version".
+See :ref:`requirements`.
 
-The computer resets unexpectedly (at the end of the program)
+The computer just resets (at the end of the program)
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-If you are using the default 'zeropage' compiler option, and your program exits, it is not possible
+In the default compiler configuration, it is not safely possible to return back to the BASIC prompt when
-to return back to the BASIC prompt. The only reliable course of action is to reboot the system.
+your program exits. The only reliable thing to do is to reboot the system.
-(this is due to the fact that in the default mode, prog8 can overwrite important BASIC and Kernal
+This is due to the fact that in this mode, prog8 will overwrite important BASIC and Kernal variables in zero page memory.
-variables in memory).
+To avoid the reset from happening, use an empty ``repeat`` loop at the end of your program to keep it from exiting.
-To avoid a sudden system reset, use an empty ``repeat`` loop at the end of your program to keep it from exiting.
 Alternatively, if you want your program to exit cleanly back to the BASIC prompt,
 you have to use ``%zeropage basicsafe``, see :ref:`directives`.
+The reason this is not the default is that it is very beneficial to have more zeropage space available to the program,
+and programs that have to reaturn cleanly to the BASIC prompt are considered to be the exception.
+
 
 Odd text and screen colors at start
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 Prog8 will reset the screen mode and colors to a uniform well-known state. If you don't like the
-default text and screen colors, you can simply change them to whatever you want using the
+default text and screen colors, you can simply change them yourself to whatever you want at the
-appropriate routines in the ``textio`` module.
+start of your program. It depends on the computer system how you do this but there are some
+routines in the textio module to help you with this.
 Alternatively you can choose to disable this re-initialization altogether
 using ``%option no_sysinit``, see :ref:`directives`.
 
 Floats error
 ^^^^^^^^^^^^
-Getting an assembler error about undefined symbols such as ``not defined 'floats'``?
+Are you getting an assembler error about undefined symbols such as ``not defined 'floats'``?
 This happens when your program uses floating point values, and you forgot to import ``floats`` library.
 If you use floating points, the compiler needs routines from that library.
 Fix it by adding an ``%import floats``.

docs/source/todo.rst

@@ -1,10 +1,6 @@
 TODO
 ====
 
-- instead of resetting the computer at program exit, reinit screen and print message >PROGRAM EXIT CODE 123;RESET COMPUTER.< + sei + endless loop.
-  change troubleshooting and other references in the docs.
-
-
 For 9.0 major changes
 ^^^^^^^^^^^^^^^^^^^^^
 - DONE: added 'cbm' block in the syslib module that now contains all CBM compatible kernal routines and variables

examples/test.p8

@@ -1,15 +1,28 @@
 %import textio
-%zeropage basicsafe
-%option no_sysinit
 
 main {
-
     sub start() {
         str name1 = "name1"
         str name2 = "name2"
-        uword[] @split names = [name1, name2, "name3"]
+        uword[] names = [name1, name2, "name3"]
         cx16.r0++
+        uword ww
+        for ww in names {
+            txt.print(ww)
+            txt.spc()
+        }
+        txt.nl()
+
         names = [1111,2222,3333]
+        for ww in names {
+            txt.print_uw(ww)
+            txt.spc()
+        }
+        txt.nl()
+        txt.print("end.")
+        %asm {{
+            lda  #$3e
+        }}
     }
 }