From 37289cfad8b7d7994a7f85248b7e9eddfab15b05 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Rafa=C5=82?= <rafal.grodzinski@gmail.com>
Date: Sun, 22 Jun 2025 14:01:03 +0900
Subject: [PATCH] Updated readme

---
 README.md | 32 ++++++++++++++++++++++++++++++--
 1 file changed, 30 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index c016eb8..dcd5886 100644
--- a/README.md
+++ b/README.md
@@ -7,8 +7,36 @@ It has been been built on top of LLVM.
 
 ## Show me the code!
 
-### Data
+### Comments
+Like in C, comments can specified using either `\\` which will run until the end of the line or through `/* */` block. However, unlike C, the `/* bla bla /* bla */ */` comments can be also embeded inside each other.
+
+### Literals
+**Number literals** can be specified as decimal, hexadecimal, and binary numbers. Digits can be separated by an '_' but it cannot be the first or the last character (otherwise it will get interpreted as and identifier).
+
+```
+// Valid examples:
+1024
+1_024
+1.245
+
+1_000.
+
+0xffa
+0xffaa_42bb
+
+0b1101
+0b1010_0101
+
+// Invalid examples:
+_100
+1000_.100
+
+0x_fa
+
+0b10_
+_0b1101
+```
 
 ### Control flow
 
-### Functions
\ No newline at end of file
+### Functions