smallbasic · chrisws · Aug 22, 2023 · Jul 31, 2023 · Aug 1, 2023 · Aug 1, 2023
diff --git a/_build/pages/language_support.markdown b/_build/pages/language_support.markdown
@@ -2,8 +2,7 @@
 
 > Using your favorite text editor
 
-The SDL and FLTK versions of SmallBASIC come with an integrated editor. If you are more familiar with Visual Studio Code, Atom or Geany,
-you will find on the following pages instructions on how to setup syntax highlighting, code snippets and program execution directly from these editors.
+The SDL and FLTK versions of SmallBASIC come with an integrated editor. If you are more familiar with Visual Studio Code, Atom, Sublime Text, KDE Kate or Geany, you will find on the following pages instructions on how to setup syntax highlighting, code snippets and program execution directly from these editors.
 
 ::: contentsPanel ::
 ::: contentsHeader ::
@@ -13,4 +12,6 @@ Contents
 #. [Visual Studio Code](/pages/language_support_vscode.html)
 #. [Atom](/pages/language_support_atom.html)
 #. [Geany](/pages/language_support_geany.html)
+#. [Sublime Text](/pages/language_support_sublimetext.html)
+#. [KDE Kate](/pages/language_support_kdekate.html)
 :::
diff --git a/_build/pages/language_support_kdekate.markdown b/_build/pages/language_support_kdekate.markdown
@@ -0,0 +1,16 @@
+# SmallBASIC in KDE Kate
+
+_"The KDE Advanced Text Editor, or Kate, is a source code editor developed by the KDE free software community.
+It has been a part of KDE Software Compilation since version 2.2, which was first released in 2001. Intended 
+for software developers, it features syntax highlighting, code folding, customizable layouts, regular expression
+support, and extensibility" 
+([wikipedia](https://en.wikipedia.org/wiki/Kate_(text_editor)))_
+
+![Example](https://github.com/Joe7M/smallbasic.kate.syntaxcoloring/blob/main/screenshot.png)
+
+## Setup Syntax Highlighting and Coloring
+
+The file for syntax highlighting can be downloaded from [Github](https://github.com/Joe7M/smallbasic.kate.syntaxcoloring/)
+
+Copy the file "smallbasic.xml" into the folder "~/.local/share/org.kde.syntax-highlighting/syntax/".
+Most probably this folder does not exist. Please create it. Restart Kate and chose "SmallBASIC" for highlighting.
diff --git a/_build/pages/language_support_sublimetext.markdown b/_build/pages/language_support_sublimetext.markdown
@@ -0,0 +1,54 @@
+# SmallBASIC in Sublime Text
+
+_"Sublime Text is a shareware text and source code editor available for Windows, macOS, and Linux. 
+It natively supports many programming languages and markup languages. Users can customize it with
+themes and expand its functionality with plugins, typically community-built and maintained under 
+free-software licenses. [...] The editor utilizes minimal interface and contains features for programmers
+including configurable syntax highlighting, code folding, search-and-replace supporting
+regular-expressions, terminal output window, and more. It is proprietary software, but a free 
+evaluation version is available." 
+([wikipedia](https://en.wikipedia.org/wiki/Sublime_Text))_
+
+![Example](https://github.com/Joe7M/smallbasic.sublimetext.syntaxcoloring/blob/main/screenshot.png)
+
+## Installation
+
+The files for syntax highlighting can be downloaded from [Github](https://github.com/Joe7M/smallbasic.sublimetext.syntaxcoloring/).
+
+Copy the files in the folder "package" to the User directory in the Sublime Text package folder.
+The Sublime Text package folder can be open within Sublime Text under Preferences -> Browse Packages.
+
+## Script execution
+
+Please edit the file `SmallBASIC.sublime-build` to configure script execution.
+
+### Linux 
+
+The default file launches sbasicg (SDL-version) in Linux. sbasicg must be in the search path.
+
+```
+{
+	"cmd": ["cmd", "/c", "sbasicg", "-r", "$file"],
+	"selector": "source.SmallBASIC"
+}
+```
+
+Replace sbasicg by sbasic if you want to launch the console version. You can also include the full path.
+
+```
+{
+	"cmd": ["cmd", "/c", "sbasic", "$file"],
+	"selector": "source.SmallBASIC"
+}
+```
+
+### Windows
+
+Replace sbasicg by sbasicg.exe. You can include the full path if sbasicg.exe is not in the search path.
+
+```
+{
+	"cmd": ["cmd", "/c", "sbasicg.exe", "-r" "$file"],
+	"selector": "source.SmallBASIC"
+}
+```
diff --git a/_build/pages/language_support_vscode.markdown b/_build/pages/language_support_vscode.markdown
@@ -1,7 +1,5 @@
 # SmallBASIC in Visual Studio Code
 
-> Using Visual Studio Code
-
 _"Visual Studio Code is a source-code editor made by Microsoft for Windows, Linux and macOS.
 Features include support for debugging, syntax highlighting, intelligent code completion, snippets,
 code refactoring, and embedded Git. Users can change the theme, keyboard shortcuts, preferences,

diff --git a/_build/reference/1421-language-step.markdown b/_build/reference/1421-language-step.markdown
@@ -1,8 +1,10 @@
 # STEP
 
-> FOR t = 1 TO 10 STEP 2
+> FOR i = a TO b STEP s
 
-Specifies the loop counter increment in a FOR loop
+Specifies the loop counter increment `s` in a FOR loop. The variable `i` will be increased in every loop by amount `s`. `s` can be a positive or negative number.
+
+See FOR for more information.
 
 ### Example 1: Positive step
 

diff --git a/_build/reference/1523-system-sbver.markdown b/_build/reference/1523-system-sbver.markdown
@@ -2,6 +2,12 @@
 
 > SBVER
 
-Version and build information
+Shows version and build information.
+
+### Example
+
+```
+print SBVER    ' Output: 12.26 Console Unix_64 Tue, 06 Jun 2023
+```
 
 
diff --git a/_build/reference/1734-system-self.markdown b/_build/reference/1734-system-self.markdown
@@ -8,7 +8,7 @@ The SELF variable works with MAP variables. You can assign a reference to a FUNC
 
 Note: 'MAP' is the name given to the dictionary/hashmap variable variant.
 
-Example:
+### Example 1: SELF and MAP variable
 
 ```
 SUB hello
@@ -20,8 +20,9 @@ a.foo = @hello
 a.foo()
 ```
 
-```
+### Example 2: Simple Class
 
+```
 func SimpleClass(i)
 
   sub Increment(i)

diff --git a/_build/reference/1800-math-statstd.markdown b/_build/reference/1800-math-statstd.markdown
@@ -1,12 +1,40 @@
 # STATSTD
 
-> STATSTD (...)
+> f = STATSTD (var1 [, var2, ... , varN)
 
-(Corrected sample) standard deviation.
+(Corrected sample) standard deviation. `var1` to `varN` can be single numbers or arrays.
 
 see: [Wikipedia - Standard Deviation](https://en.wikipedia.org/wiki/Standard_deviation)
 
+### Example 1: Using an array
+
+```
+A = [2,2,4,4,14]
+print statstd(A)        ' Output: 5.09901951359278
+```
+
+### Example 2: Using two arrays
+
+```
+A = [2,2,3,4,14]
+B = [7,9,7]
+print statstd(A, B)     ' Output: 4.14039335605413 
+```
+
+### Example 3: Using an array and a number
+
 ```
-a = [2, 4, 4, 4, 5, 5, 7, 9]
-print statstd(a)
+A = [2,2,3,4,14]
+B = 5
+print statstd(A, B)     ' Output: 4.56070170039655
 ```
+
+### Example 4: Using numbers
+
+```
+A = 3
+B = 5
+C = 4
+print statstd(A, B, C)  ' Output: 1
+```
+
diff --git a/_build/reference/1801-math-statmedian.markdown b/_build/reference/1801-math-statmedian.markdown
@@ -1,11 +1,13 @@
 # STATMEDIAN
 
-> STATMEDIAN (...)
+> f = STATMEDIAN (var1 [, var2, ... ,varN])
 
-The median of a finite list of numbers is the "middle" number, when those numbers are listed in order from smallest to greatest.
+The median of a finite list of numbers is the "middle" number, when those numbers are listed in order from smallest to greatest. `var1` to `varN` can be single numbers or arrays.
 
 see: [Wikipedia - Median](https://en.wikipedia.org/wiki/Median)
 
+### Example
+
 ```
 a = [1, 3, 3, 6, 7, 8, 9]
 print statmedian(a)   ' output: 6

diff --git a/_build/reference/536-console-sound.markdown b/_build/reference/536-console-sound.markdown
@@ -1,13 +1,22 @@
 # SOUND
 
-> SOUND freq, dur_ms [, vol] [BG]
+> SOUND freq, dur [, vol] [BG]
 
-Plays a sound.
+Plays a sound with the frequency `freg` in Hz for a duration `dur` in milliseconds. The optional parameter `vol` controls the volume of the sound. Volume is in the range from 0 to 100, where 100 is maximum volume. If the optional parameter `BG` is given, the sound will play in the background: SmallBASIC will not wait with program execution until the sound has finished.
 
+### Example1 : Play sound
+
+```
+Sound 1000, 800, 50             ' 1000 Hz, 800 ms, 50% volume
+```
+
+### Example 2: Play sound in background
+
+```
+Sound 1000, 800, 50 BG          ' 1000 Hz, 800 ms, 50% volume
+print "This line will be printed immediately"
+pause
+```
 
-* freq The frequency
-* dur_ms The duration in milliseconds
-* vol The volume in 1/100 units
-* BG Play it in background