[0-2024-0]

.gitignore

@@ -1,2 +1 @@
-
-/.vscode
+book

LICENSE.txt

@@ -1,5 +1,4 @@
 Attribution-ShareAlike 4.0 International
-
 =======================================================================
 
 Creative Commons Corporation ("Creative Commons") is not a law firm and

README.md

@@ -1 +1,6 @@
-# Specification
+# Specification
+
+- Read the License
+  - [as Text](./LICENSE.txt)
+  - [as Markup](./docs/0-2024-0/LICENSE.md)
+- [Read the Specification](./docs/0-2024-0/index.md)

SUMMARY.md

@@ -0,0 +1,18 @@
+# Summary
+
+- [Welcome](./0-2024-0/ENTRY.md)
+- [Introduction](./0-2024-0/introduction)
+- [Convention](./0-2024-0/convention.md)
+- **Build-ins**
+  - '[On-Hand](./0-2024-0/built-in_on-hand.md)'
+  - _Types_
+    - [Basic](./0-2024-0/built-in_type.md)
+    - [Data Structure](./0-2024-0/built-in_datastruct.md)
+    - [Flow Control](./0-2024-0/built-in_flow-constrol.md)
+    - [Operation](./0-2024-0/built-in_operation.md)
+  - _Syntax Sugar_
+    - [A Pinch](./0-2024-0/built-in_syntactic-sugar.md)
+    - [Another Pinch](./0-2024-0/built-in_more-sugar.md)
+- [Tips and Tricks](./0-2024-0/tips-and-tricks.md)
+- [Appendice](./0-2024-0/appendice.md)
+  - [A](./0-2024-0/appendix-a.md)

book.toml

@@ -0,0 +1,17 @@
+[book]
+authors      = ["Sara Tasche"]
+language     = "en"
+multilingual = true
+src          = "docs"
+title        = "minimaLang - Specification"
+
+
+[output.html]
+smart-punctuation   = true
+git-repository-url  = "https://github.com/minimaLang/"
+git-repository-icon = "fa-github"
+# edit-url-template = ""
+
+[output.html.print]
+enable     = true
+page-break = true

docs/0-2024-0/ENTRY.md

@@ -0,0 +1,4 @@
+# Welcome
+
+- [Introduction](./0-2024-0/introduction)
+- [Convention](./0-2024-0/convention.md)

docs/0-2024-0/appendice.md

@@ -0,0 +1,3 @@
+# Appendice
+
+- [A](appendix-a.md)

docs/md/appendix-a.md → docs/0-2024-0/appendix-a.md

@@ -1,3 +1 @@
 # Appendix A
-
-( ... )

docs/0-2024-0/built-in_datastruct.md

@@ -0,0 +1,89 @@
+# Data Structure
+
+- [Mark](#mark)
+- [Pair](#pair)
+- [Sequence](#sequence)
+  - [of Value](#of-value)
+  - [of Expression](#of-expression)
+
+## Mark
+
+| Symbol     | Syntax         | Name
+| ---------- | -------------- | ----
+| `"` .. `"` | _Sym> <> <Sym_ | Mark
+
+## Pair
+
+| Symbol    | Count | Syntax                        | Name
+| --------- | :---: | ----------------------------- | ----
+| `(` ..`)` |   2   | _Sym> <1:Key> <2:Value> <Sym_ | Pair
+
+A pair consists of _key_ and _value_. \
+The _key_ must be of type _[Constant](built-in_type#constant)_.
+
+```minimaL
+( 'A 31 ; 'B 21 ) : C
+C 'A N :
+C 'B M :
+```
+
+- `N` answers `32`
+- `M` answers `21`
+
+## Sequence
+
+| Token
+| ----------
+| `[` .. `]`
+
+- [Value](#of-value)
+- [Expression](#of-expression)
+
+### of Value
+
+| Type  | Token
+| ----- | --------
+| Begin | `(`
+| Infix | _Values_
+| End   | `)`
+
+- _Valid_
+  1. `[ 1 2 3 ]`
+  2. `( [ 1 2 3 ] [ A B C ] )`
+  3. `( [ 1 A 5 ] )`
+- _Invalid_
+  1. `( 1 2 3 )`
+  2. `( )`
+  3. `[ ]`
+
+```minimaL
+1 A :
+2 B :
+3 C :
+[ A B C ] + O :
+```
+
+`O` _answers_ `6`
+
+```minimaL
+D 1 :
+E 2 :
+F 3 :
+G 2 :
+[ D E ] < + / >
+```
+
+### of Expression
+
+| Token        | Name
+| ------------ | ---------------------
+| `{`          | Expression-List-Begin
+| _Expression_ | Expression
+| `}`          | Expression-List-End
+
+```minimaL
+{
+  1 A :
+  2 B :
+}
+```

docs/md/flow-control.md → docs/0-2024-0/built-in_flow-control.md

@@ -7,14 +7,14 @@
 
 ## Loop
 
-A _Loop_ is a combination of a _Branch_ and a _Comparsion_.
+A _Loop_ is a combination of a _Branch_ (Jump) and a _Comparsion_.
 
 ```minimaL
-A 200 :
-B  10 :
+200 : A
+10  : B
 .. Loop1
   A B - : C
-  C 0 ?0 : Loop1 ..
+  C 0 ?0 : Loop1 !
 ```
 
 In other programming language is this equvialent to
@@ -30,31 +30,37 @@ In other programming language is this equvialent to
 
 ## Branch
 
-| Name      | Token      |
-| :-------- | :--------: |
-| Condition | `?0`, `?1` |
-| Branch    | `:`        |
+| Name      | Token       |
+| --------- | ----------- |
+| Condition | `?0`, `?1`  |
+| Branch    | _label_ `!` |
 
 | Syntax      |
-| :---------: |
+| ----------- |
 | _Condition_ |
 | _Value_     |
 | _Branch_    |
 | _Label_     |
 
 The jump target is a [Label](#label).
 
-- _Valid_
-  1. `20 21 - 0 = ?0 : Jump ..`
-  2. `5 5 - 0 = : A ?0 : Jump ..`
+- _Example_
+  1. `20 21 - 0  ?0 : Jump !`
 - _Invalid_
-  1. `20 21 - 0 = ?0 Jump ..`
-  2. `20 21 - 0 = :`
+  1. `20 21 - 0  ?0   Jump !`
+  2. `20 10 -    ?0 : Jump !`
+  3. `20 21 - 0     : Jump !`
+  4. `20 21 - 0 ?0  : Jump`
+
+1. Colon missing (`:`)
+2. No comparative value
+3. Condition missing
+4. Branch-Symbol missing (`!`)
 
 ## Label
 
 | Token |
-| :---: |
+| ----- |
 | `..`  |
 
 See [Branch](#branch), [Loop](#loop)
@@ -73,12 +79,13 @@ A _Label_ can be used to ...
 
 ### Define
 
-| Syntax            |
-| :---------------: |
-| _Token_ LabelName |
+| Token | Syntax     | Name      |
+| ----- | ---------- | --------- |
+| `..`  | `..` label | Set-Label |
+| `..`  | label `..` | Get-Label |
 
 ### Jump
 
-| Syntax            |
-| :---------------: |
-| LabelName _Token_ |
+| Token | Syntax     | Name    |
+| ----- | ---------- | ------- |
+| `!`   | label `!`  | Jump-To |

docs/0-2024-0/built-in_more-sugar.md

@@ -0,0 +1,19 @@
+# More Sugar
+
+- [Familiarize with used syntax convention](syntax-convention.md)
+
+## Value-List
+
+| Token      | Syntax   | Name       |
+| :--------: | :------: | :--------: |
+| `{` .. `}` | _.._ _?_ | Value-List |
+
+```minimaL
+{ 0 1 2 3 } 2 ** { A B C D } :
+```
+
+- Answers
+  1. [_A_] 0
+  2. [_B_] 2
+  3. [_C_] 4
+  4. [_D_] 9

docs/0-2024-0/built-in_on-hand.md

@@ -0,0 +1,5 @@
+# On-Hand
+
+Please read _[Syntax Convention](convention.md)_
+
+## Overview