From 35b34979dad36299723c5279def446e3f07a3ca3 Mon Sep 17 00:00:00 2001
From: Loic GUEGAN <loic.guegan@yahoo.fr>
Date: Mon, 3 Sep 2018 13:29:20 +0200
Subject: [PATCH] Update README

---
 MicSim/ram.txt |  4 ++--
 README.md      | 55 ++++++++++++++++++++++++++++++++++++++------------
 2 files changed, 44 insertions(+), 15 deletions(-)

diff --git a/MicSim/ram.txt b/MicSim/ram.txt
index 2707f4a..c47f112 100644
--- a/MicSim/ram.txt
+++ b/MicSim/ram.txt
@@ -1,5 +1,5 @@
 BIPUSH
-9
+12
 BIPUSH
-8
+5
 IADD
diff --git a/README.md b/README.md
index cf281fd..0f250f0 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
 # MicSim
 
-Hi! Welcome to MicSim project repo. MicSim is a Mic-1 architecture simulator written in python. It is specially design for studying purpose. 
+Hi! Welcome to MicSim project repository. MicSim is a Mic-1 architecture simulator written in python. It is specially designed for studying purpose. 
 
 ### How it works ?
 It is simple, you have to:
@@ -9,18 +9,47 @@ It is simple, you have to:
  3. Enjoy !
 
 ### I want to know more about it....
-Source code is located in _MicSim_ folder. All the components used for the Mic-1 architecture are 
-located in _MicSim/components_ folder:
- - **ijvm.py** Contains standard IJVM constant
- - **microprogram.py** Contains IJVM implementation that use Mic-1 architecture
- - **caretaker.py** Hold all the Mic-1 architecture components (registers, ram etc..)
- - **ram.py** Contains a simple RAM implementation
+Source code is located in `MicSim/` directory. All the components used for the Mic-1 architecture are located in `MicSim/components/` directory:
+ - `ijvm.py` Contains standard IJVM constant
+ - `microprogram.py` Contains IJVM implementation that use Mic-1 architecture
+ - `caretaker.py` Hold all the Mic-1 architecture components (registers, ram etc..)
+ - `ram.py` Contains a simple RAM implementation
 
 ### How to load code in memory ?
-Simply by editing **ram.txt**. Each line corresponding to a byte entry starting from address 0x0 to whatever to $+\infty$ . Each line can be an IJVM _opcode_ or a random byte. Here is an example of how to add two number:
+Simply by editing `ram.txt`. Each line corresponding to a byte entry starting from address 0x0 to whatever. Each line can be an **IJVM opcode** or a random **byte**. Here is an example of how to add two numbers:
+
+   
+
+>  BIPUSH<br />
+>     12<br />
+>     BIPUSH<br />
+>     5<br />
+>     IADD<br />
+
+Kind of output:
+
+    ---------- Ram Before Execution ----------
+    0    : 0x10  (16)
+    1    : 0xc   (12)
+    2    : 0x10  (16)
+    3    : 0x5   (5)
+    4    : 0x60  (96)
+    ------------------------------------------
+    ---------- Ram After Execution ----------
+    0    : 0x10  (16)
+    1    : 0xc   (12)
+    2    : 0x10  (16)
+    3    : 0x5   (5)
+    4    : 0x60  (96)
+    4099 : 0x0   (0)
+    4098 : 0x0   (0)
+    4097 : 0x0   (0)
+    4096 : 0x11  (17)
+    4103 : 0x0   (0)
+    4102 : 0x0   (0)
+    4101 : 0x0   (0)
+    4100 : 0x5   (5)
+    -----------------------------------------
+
+
 
-> BIPUSH<br />
-> 12<br />
-> BIPUSH<br />
-> 5<br />
-> IADD<br />