From 470b873f34de0c625bfb1942a90a69bb527dac13 Mon Sep 17 00:00:00 2001
From: medvecky <alexey.medvecky@gmail.com>
Date: Tue, 2 Apr 2024 20:12:11 +0300
Subject: [PATCH] add_initial_documentation: * update Readme.md

---
 Readme.md | 58 ++++++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 57 insertions(+), 1 deletion(-)

diff --git a/Readme.md b/Readme.md
index 1cb9219..b02e357 100644
--- a/Readme.md
+++ b/Readme.md
@@ -1,3 +1,59 @@
 # C64-multi-functional-calculator
 
-Multi-functional text-based calculator for the Commodore 64.
+Multi-functional, text-based RPN (Reverse Polish Notation) calculator designed specifically for the Commodore 64. This project brings a robust set of mathematical capabilities to the iconic Commodore 64, leveraging its unique architecture to deliver a fast, efficient, and user-friendly calculator experience
+
+## Description
+
+- addition '+'
+- subtraction '-'
+- division '/'
+- multiplication '*'
+- power '↑'
+
+Additionally, it accommodates floating-point numbers up to nine digits in both decimal (e.g., 3.14) and scientific (e.g., 8.9e-5) notations.
+
+## App development setup
+
+### Prerequisites
+
+- Installed [cc65](https://www.cc65.org/)
+
+### Build binary app
+
+- Clone the project:
+
+```bash
+git clone https://github.com/medvecky/C64-multi-functional-calculator.git
+```
+
+- Navigate to the project directory.
+- Execute the following command:
+
+```bash
+make multicalc
+```
+
+The calculator binary, named multicalc.prg, is located in the /bin directory.
+
+
+## Operating Manual
+
+### Simple Operations in RPN Format
+
+```bash
+# 9 * 4
+9 4 * <return>
+# 9 + 4
+9 4 + <return>
+# 9  / 4 
+9 4 / <return>
+# 9 ^ 4
+9 4 ↑ <return>
+```
+
+### Complex Operations in RPN Format
+
+```bash
+#√( 2 * 300.51 / 9.8 )
+300.51 2 * 9.8 / 0.5 ↑
+```