Merge pull request #594 from boriel/bugfix/print_failing_in_48k

Bugfix/print failing in 48k

Author: boriel

docs/end.md

@@ -0,0 +1,19 @@
+# END
+
+
+##Syntax
+```
+END [<value>]
+```
+
+Terminates execution and returns to the Operating System (i.e. to the Sinclair
+BASIC interpreter). An optional value can be used (defaults to 0 if not specified)
+that will be returned to the OS.
+
+```basic
+PRINT "HELLO WORLD"
+END 32: REM The value 32 will be returned to the OS
+```
+
+End is also a keyword used to close [scopes](scope.md) in [FUNCTION](function.md) and [SUB](sub.md)
+and compound sentences in [IF](if.md), [WHILE](while.md).

docs/gosub.md

@@ -0,0 +1,57 @@
+#GO SUB
+
+
+##Syntax
+```
+GO SUB <label>
+GOSUB <label>
+```
+Continues the execution at the given label or line number.
+The current execution point is pushed (stored) onto the stack,
+to be recovered later.
+
+When a [RETURN](return.md) is found and executed, the previous
+execution point is popped out (recovered) from the stack and
+continues just after the GO SUB. This is a way to create simple
+subroutines.
+
+This sentence exists just for compatibility with legacy BASIC
+dialects. You should use [SUB](sub.md) or [FUNCTION](function.md) instead.
+
+GO SUB cannot be used within neither subroutines nor functions.
+You can't GOSUB into a function or sub. So GOSUB is limited to
+global [scope](scope.md)
+
+> **WARNING**: Using GO SUB continuously without returning with
+> RETURN will eventually fill the stack (stack overflow) and crash
+> your program.
+
+### Example with GO SUB
+
+```
+10 LET number = 10
+20 GOSUB 1000 : REM calls the subroutine
+30 LET number = 20
+40 GOSUB 1000 : REM calls the subroutine again
+100  END : REM the program must end here to avoid entering the subroutine without using GOSUB
+1000 REM Subroutine that prints number + 1
+1010 PRINT "number + 1 is "; number + 1
+1020 RETURN : REM return to the caller
+```
+
+This will output:
+
+```
+number + 1 is 11
+number + 1 is 21
+```
+
+
+##Remarks
+* This statement is Sinclair BASIC compatible.
+* GO SUB cannot be used within subrutines nor functions.
+
+##See also
+* [RETURN](return.md)
+* [FUNCTION](function.md)
+* [SUB](sub.md)

docs/goto.md

@@ -0,0 +1,34 @@
+#GO TO
+
+
+##Syntax
+```
+GO TO <label>
+GOTO <label>
+```
+Continues (jumps) the execution at the given label or line number.
+
+This sentence exists just for compatibility with legacy BASIC
+dialects. You should use [DO...LOOP](do.md), [FOR](for.md), [SUB](sub.md)
+or [FUNCTION](function.md) instead.
+
+You can't GOTO into a function or sub.
+
+### Example with GO TO
+
+```
+10 GOTO 30
+20 END
+30 PRINT "This is executed before END"
+40 GOTO 20
+```
+
+This will `This is executed before END` and then jump into
+line 20, finishing the program.
+
+
+##Remarks
+* This statement is Sinclair BASIC compatible.
+
+##See also
+* [GO SUB](gosub.md)

docs/return.md

@@ -1,4 +1,4 @@
-#RESTORE
+#RETURN
 
 
 ##Syntax