From f900647c762154f5c502b14e0288d06b8dc022da Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Mateusz=20Pi=C4=85tkowski?= <matpia1@st.amu.edu.pl>
Date: Mon, 19 Sep 2022 23:34:25 +0200
Subject: [PATCH] Include vector aspect of operators

---
 doc/operators.md | 56 +++++++++++++++++++++++++++++++++++++++++++++---
 1 file changed, 53 insertions(+), 3 deletions(-)

diff --git a/doc/operators.md b/doc/operators.md
index 0eab006..37ec926 100644
--- a/doc/operators.md
+++ b/doc/operators.md
@@ -9,8 +9,12 @@
 5
 > (1/3) + (1/4)
 7/12
+> 1 + (up 10)
+[1; 2; 3; 4; 5; 6; 7; 8; 9; 10]
 ```
+
 	- inkrementacji zmiennej (liczby lub akordu, w tym w szczególności pojedynczeń nuty):
+
 ```
 > c + 1
 c#
@@ -27,15 +31,19 @@ chord[d; f#]
 10
 > (1/3) * (1/4)
 1/12
+> 2 * (up 10)
+[0; 2; 4; 6; 8; 10; 12; 14; 16; 18]
 ```
 	- powtarzania – zwraca określoną liczbę powtórzeń danego dźwięku:
+```
 > a * 4
 [a; a; a; a]
 > a3 * 4
 [chord[a; c]; chord[a; c]; chord[a; c]; chord[a; c]]
 ```
 
-- `/` – operator dzielenia:
+- `/` – operator dzielenia – *wektor może być wyłącznie dzielną*:
+
 ```
 > 4 / 2
 2
@@ -43,39 +51,60 @@ chord[d; f#]
 5/7
 > (2/3) / (3/5)
 10/9
+> (up 10) / 2
+[0; 1/2; 1; 3/2; 2; 5/2; 3; 7/2; 4; 9/2]
 ```
-- `%` – operator działania modulo (wynikiem jest reszta z dzielenia) – *nie działa dla ułamków*:
+
+- `%` – operator działania modulo (wynikiem jest reszta z dzielenia) – *nie działa dla ułamków*, *wektor może być wyłącznie dzielną*:
+
 ```
 > 3 % 3
 0
 > 6 % 5
 1
+> (up 10) % 2
+[0; 1; 0; 1; 0; 1; 0; 1; 0; 1]
 ```
+
 - `**` – operator potęgowania – *wykładnikiem nie może być ułamek*:
+
 ```
 > 2 ** 8
 256
 > (2/3) ** 3
 8/27
+> (up 10) ** 2
+[0; 1; 4; 9; 16; 25; 36; 49; 64; 81]
+> 2 ** (up 10)
+[1; 2; 4; 8; 16; 32; 64; 128; 256; 512]
 ```
 
 ## Operatory porównawcze
 
 - `!=` – operator "nie równa się":
+
 ```
 > 2 != 3
 true
 > a != a
 false
+> 3 != (up 5)
+[true; true; true; false; true]
 ```
+
 - `<` – operator "mniejsze niż":
+
 ```
 > 2 < 3
 true
 > a < a
 false
+> 3 < (up 5)
+[true; true; true; false; false]
 ```
+
 - `<=` – operator "mniejsze lub równe":
+
 ```
 > 2 <= 3
 true
@@ -83,22 +112,34 @@ true
 true
 > 3 <= 2
 false
+> 3 <= (up 5)
+[true; true; true; true; false]
 ```
+
 - `==` – operator "równe":
+
 ```
 > 2 == 3
 false
 > a == a
 true
+> 3 == (up 5)
+[false; false; false; true; false]
 ```
+
 - `>` – operator "większe niż":
+
 ```
 > 2 > 3
 false
 > a > a
 true
+> 3 > (up 5)
+[false; false; false; false; true]
 ```
+
 - `>=` – operator "większe lub równe":
+
 ```
 > 2 >= 3
 false
@@ -106,20 +147,29 @@ false
 true
 > 3 >= 2
 true
+> 3 >= (up 5)
+[false; false; false; true; true]
 ```
+
 ## Pozostałe operatory
 
 - `.` – operator indeksu (zwraca wskazany element, liczone od 0):
+
 ```
 > A:=[1; 3; 5]
 > A . 1
 3
+> (up 7).4
+3
 ```
-	- indeksu
+
 - `&` – operator łączenia:
+
 ```
 > c & a
 chord[c; a]
 > [1;3;5] & [2;4;6]
 [1; 3; 5; 2; 4; 6]
+> (up 7) & (down 9)
+[0; 1; 2; 3; 4; 5; 6; 8; 7; 6; 5; 4; 3; 2; 1; 0]
 ```