From dd83b70a3457846200b0316ee44fc2b63329a981 Mon Sep 17 00:00:00 2001
From: wxwisiasdf <39974089+wxwisiasdf@users.noreply.github.com>
Date: Wed, 6 Dec 2023 20:09:01 +0000
Subject: [PATCH 1/3] document the else_if/if stuff

---
 docs/extensions.md | 80 ++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 80 insertions(+)

diff --git a/docs/extensions.md b/docs/extensions.md
index 66d415a5a..ab79c4de8 100644
--- a/docs/extensions.md
+++ b/docs/extensions.md
@@ -35,6 +35,86 @@ You should add an entry for `name_of_condition` to your csv file, since it will
 
 To use a scripted trigger simply add `test = name_of_condition` in a trigger wherever you want to evaluate your scripted trigger and it will work as if you had copied its content into that location. I advise you not to use scripted triggers from within other scripted triggers while defining them. You can safely refer to scripted triggers earlier in the same file, but doing so across files will put you at the mercy of the file loading order.
 
+### If/Else
+
+If and Else statments are now provided to avoid code duplication and make your life easier. A `else` with a limit is equivalent to an `else_if` with a limit, and a `else_if` without a limit is equal to a `else` without a limit. In other words, `else` and `else_if` are essentially synonyms, provided for code clarity.
+
+For example:
+```
+if = { #run if limit is true
+  limit = { ... }
+  ...
+} else_if = { #run only if the limit above is false, and this limit is true
+  limit = { ... }
+  ...
+} else = { #only if both cases are not fullfilled AND the limit is true
+  limit = { ... }
+  ...
+}
+```
+
+No limit specified equals to an `always = yes`.
+
+Additionally, the order of execution for `if` and `else`/`else_if` statments allows for nested code:
+
+```
+if = {
+  limit = { a = yes }
+  money = 1
+  if = {
+    limit = { b = yes }
+	money = 50
+  } else {
+    money = 100
+  }
+}
+```
+This is equivalent to:
+```
+if = {
+  limit = { a = yes b = yes }
+  money = 1
+  money = 50
+} else_if {
+  limit = { a = yes }
+  money = 1
+  money = 100
+}
+```
+
+Additionally, negation of statments are implicit, in other words:
+```
+if = {
+  limit = { test == yes }
+} else {
+  limit = { test != yes }
+}
+```
+
+Is implicitly assumed for every `else` after a `if`, this means that an explicit negation (rewriting everything inside a big NOT statment) is not required for `else` statments, as they now logically are tied to all stamtents beforehand being false, and the statment of it's own limit being true.
+
+An issue which might exist due to the volatility of the syntax could be:
+```
+else_if = {
+  limit = { ... }
+} if = {
+  limit = { ... }
+}
+```
+
+The behaviour of this statment is that, since there is no preceding `if` before the `else_if`, the `else_if` will be able to run as if it was chained with an `if` that evaluated to false, in the case of it's limit evaluating to true, then it will run its own effect. However, the other `if` statment will run regardless of the previous expression.
+
+As the lexicographical order of the statments are sequential, this is, every `else_if` and `else` must be preceded by an `if` statment, otherwise they will be chained to the nearest *preceding* `if` statment before them for their lexicographical evaluation, otherwise they will act as an `if` in itself if none is present.
+
+```
+else_if = {
+  limit = { ... }
+} else_if = {
+  limit = { ... }
+}
+```
+These `else_if` statments are chained together, if the first runs, the second will not, and viceversa. If no preceding `if` exists before them, the first `else_if` takes the role of the `if` statment.
+
 ### Abbreviated `.gui` syntax
  
 `size = { x = 5 y = 10 }` can be written as `size = { 5 10 }`, as can most places expecting an x and y pair.

From e276d4903da7b6b7bb34c22760ab6f5b54c489d7 Mon Sep 17 00:00:00 2001
From: wxwisiasdf <39974089+wxwisiasdf@users.noreply.github.com>
Date: Wed, 6 Dec 2023 20:11:54 +0000
Subject: [PATCH 2/3] fix error

---
 docs/extensions.md | 35 +++++++++++++++++++----------------
 1 file changed, 19 insertions(+), 16 deletions(-)

diff --git a/docs/extensions.md b/docs/extensions.md
index ab79c4de8..f48682951 100644
--- a/docs/extensions.md
+++ b/docs/extensions.md
@@ -59,35 +59,38 @@ Additionally, the order of execution for `if` and `else`/`else_if` statments all
 
 ```
 if = {
-  limit = { a = yes }
-  money = 1
-  if = {
-    limit = { b = yes }
-	money = 50
-  } else {
-    money = 100
-  }
+	limit = { a = yes }
+		money = 1
+	if = {
+		limit = { b = yes }
+		money = 50
+	} else {
+		money = 100
+	}
 }
 ```
 This is equivalent to:
 ```
 if = {
-  limit = { a = yes b = yes }
-  money = 1
-  money = 50
+	limit = { a = yes b = yes }
+	money = 1
+	money = 50
+} else_if {
+	limit = { a = yes b = no }
+	money = 1
 } else_if {
-  limit = { a = yes }
-  money = 1
-  money = 100
+	limit = { a = yes }
+	money = 1
+	money = 100
 }
 ```
 
 Additionally, negation of statments are implicit, in other words:
 ```
 if = {
-  limit = { test == yes }
+	limit = { test == yes }
 } else {
-  limit = { test != yes }
+	limit = { test != yes }
 }
 ```
 

From 8fd66edbe2e61c51fc14647dfa6ca40255d6f85d Mon Sep 17 00:00:00 2001
From: wxwisiasdf <39974089+wxwisiasdf@users.noreply.github.com>
Date: Wed, 6 Dec 2023 20:12:45 +0000
Subject: [PATCH 3/3] oops

---
 docs/extensions.md | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/docs/extensions.md b/docs/extensions.md
index f48682951..56535dabd 100644
--- a/docs/extensions.md
+++ b/docs/extensions.md
@@ -75,9 +75,6 @@ if = {
 	limit = { a = yes b = yes }
 	money = 1
 	money = 50
-} else_if {
-	limit = { a = yes b = no }
-	money = 1
 } else_if {
 	limit = { a = yes }
 	money = 1