DOC: markdown cleanup

Author: chrisws

_build/reference/538-console-cat.markdown

@@ -5,9 +5,6 @@
 Returns a console code. 0 = reset, 1 = bold, -1 bold-off, 2 = underline, -2 = underline-off, 3 = reverse, -3 = reverse-off.
 
 
-> ? cat(1);"Bold";cat(0)
-
-
 ~~~
 
 ' Note: tested and works with SB 0.12.2 on Linux 64-bit.

_build/reference/539-console-inkey.markdown

@@ -4,7 +4,7 @@
 
 Returns the last key-code in keyboard buffer, or an empty string if there are no keys. Special key-codes like the function-keys are returned as 2-byte string.
 
-
+```
 k=INKEY
 IF LEN(k)
   IF LEN(k)=2
@@ -15,7 +15,7 @@ IF LEN(k)
 ELSE
   ? "keyboard buffer is empty"
 FI
-
+```
 
 ~~~
 
@@ -205,10 +205,16 @@ Def CTRL_SHIFT(c) = CTRL_SHIFT_CHR + Lcase(c)  ' Ctrl+Shift+a, etc
 ~~~
 
 When the first character in the two character code is 27, the second character is a code for the given special key. You would need to inspect the SB source to work out the equivalent SmallBASIC key constants, but I'll have a look at generating a constants.bas file that you can include in your programs.
+
 As reported by Shian (thanks Shian!), there are a few problems with INKEY. I'll fix these in the next update. There is supposed to be a different first character code for SHIFT/ALT etc states.
+
 Also, INKEY needs to read from the system event queue to get the next keystroke. It currently does a pause for key, but I think it should actually block in the call to read the queue, that way when you type a key there would be no delay. Either way this doesn't work well for shooter type games, but there is a better way. Have a look at:
+
 https://github.com/smallbasic/SmallBASIC/blob/master/samples/distro-exam...
+
 This uses the DEFINEKEY command to register keystroke handlers for game keys. When you hit the game key, the registered FUNC will get called more or less immediately, somewhere inside the game main looI think this should work well in the space shooter (which is awesome by the way).
+
 Code for quick lookup of a key code:
+
 http://smallbasic.sourceforge.net/?q=node/1583
 

_build/reference/546-data-read.markdown

@@ -4,16 +4,18 @@
 
 Assigns values in DATA items to specified variables.
 
+var - Any variable.
 
-* var - Any variable.
 Unless a RESTORE command is executed, SmallBASIC moves to the next DATA item with each READ assignment. If SmallBASIC runs out of DATA items to READ, an run-time error occurs.
-> FOR c=1 TO 6
-    READ x
-    PRINT x
+
+```
+FOR c=1 TO 6
+   READ x
+   PRINT x
 NEXT
 ...
 DATA "a,b,c", 2
 DATA 3, 4
 DATA "fifth", 6
-
+```
 

_build/reference/548-data-search.markdown

@@ -4,8 +4,8 @@
 
 Scans an array for the key. If key is not found the SEARCH command returns (in ridx) the value. (LBOUND(A)-1). In default-base arrays that means -1. The cmpfunc (if its specified) it takes 2 vars to compare. It must return 0 if x = y; non-zero if x <> y.
 
-
-> FUNC cmp(x,y)
+```
+FUNC cmp(x,y)
   cmp=!(x=y)
 END
 ...
@@ -16,7 +16,7 @@ NEXT
 SEARCH A, 4, r USE cmp(x,y)
 PRINT r:REM prints 1
 PRINT A(r): REM prints 4
-
+```
 
 ~~~
 

_build/reference/549-data-sort.markdown

@@ -4,8 +4,8 @@
 
 Sorts an array. The cmpfunc if specified, takes 2 vars to compare and must return: -1 if x < y, +1 if x > y, 0 if x = y.
 
-
-> FUNC qscmp(x,y)
+```
+FUNC qscmp(x,y)
 IF x=y
     qscmp=0
 ELIF x>y
@@ -20,5 +20,5 @@ FOR i=0 TO 5
     A(i)=RND
 NEXT
 SORT A USE qscmp(x,y)
-
+```
 

_build/reference/559-data-isnumber.markdown

@@ -4,12 +4,13 @@
 
 Returns true if x is a number (or it can be converted to a number).
 
-
-> ? ISNUMBER(12)          :REM true
+```
+? ISNUMBER(12)          :REM true
 ? ISNUMBER("12")        :REM true
 ? ISNUMBER("12E+2")     :REM true
 ? ISNUMBER("abc")       :REM false
 ? ISNUMBER("1+2")       :REM false
 ? ISNUMBER("int(2.4)")  :REM false
+```
 
 

_build/reference/560-data-isstring.markdown

@@ -4,11 +4,11 @@
 
 Returns true if x is a string (and cannot be converted to a number).
 
-
-> ? ISSTRING(12)      :REM false
+```
+? ISSTRING(12)      :REM false
 ? ISSTRING("12")    :REM false
 ? ISSTRING("12E+2") :REM false
 ? ISSTRING("abc")   :REM true
 ? ISSTRING("1+2")   :REM true
-
+```
 

_build/reference/569-data-data.markdown

@@ -4,9 +4,10 @@
 
 Stores one or more constants, of any type, for subsequent access via READ command.
 
-
 DATA commands are non executable statements that supply a stream of data constants for use by READ commands. All the items supplied by all the DATA commands in a program make up one continuous "string" of information that is accessed in order by your program's READ commands.
-> RESTORE MyDataBlock
+
+```
+RESTORE MyDataBlock
 FOR I=1 TO 3
     READ v
     PRINT v
@@ -15,5 +16,5 @@ END
 ...
 LABEL MyDataBlock
 DATA 1,2,3
-
+```
 

_build/reference/570-data-dim.markdown

@@ -4,8 +4,9 @@
 
 Reserves storage space for an array.
 
+The array will have (upper-lower)+1 elements. If `lower` is not specified, and `OPTION BASE` hasn't used, elements start at 0.
 
-The array will have (upper-lower)+1 elements. If @lower@ is not specified, and @OPTION BASE@ hasn't used, elements start at 0.
+```
 REM One dimension array of 7 elements, starting from 0
 DIM A(6)
 ...
@@ -19,7 +20,7 @@ REM Allocating zero-length arrays:
 DIM z()
 ...
 IF LEN(Z)=0 THE APPEND Z, "The first element"
-
+```
 
 ~~~
 

_build/reference/571-data-erase.markdown

@@ -4,12 +4,12 @@
 
 Deallocates the memory used by the specified arrays or variables. After that these variables turned to simple integers with zero value.
 
-
-> DIM x(100)
+```
+DIM x(100)
 ...
 PRINT FRE(0)
 ERASE x
 PRINT FRE(0)
 PRINT x(1):REM ERROR
-
+```