[docs/caffeine] General improvements

Author: iiPythonx

docs/caffeine.md

@@ -8,11 +8,53 @@
 - [Python API](python-api.md)
 - **Caffeine ▾**
     - [Introduction](#introduction)
+    - [Basic Usage](#basic-usage)
+    - [Notice](#notice)
 - [Standard Library](stdlib.md)
 
 ## Introduction
 
-This document is coming soon.
+Caffeine is a x++ to Python conversion module and CLI. It converts your existing code to Python for performance improvements or just general codebase migration.  
+It's included with x++ since version 3.1.2 and is available globally as the Python package `caffeine`.  
+
+It implements **all** features available in xpp except for imports.
+
+## Basic Usage
+
+If you had a file called `main.xpp` and wanted to convert it to Python, you could do something like this:
+
+```sh
+caffeine main.xpp
+```
+
+This will give you a  `main.py` file in the same directory.
+
+---
+
+Another feature is auto minification of the resulting Python code via the `-1` flag.  
+To convert `main.xpp` to minified Python, you would run:
+
+```sh
+caffeine -o -1 main.xpp
+```
+
+Notice the `-o` in there? That stands for `overwrite`, so caffeine will write over the existing `main.py` file (if it exists).
+
+---
+
+Lastly, Caffeine supports automatic building via [pyinstaller](https://pyinstaller.org).  
+To convert `main.xpp` to an exe (or binary, depending on your OS) and then run it automatically, you can do something like this:
+
+```sh
+caffeine -o -r -b main.xpp
+```
+
+This will give you a `main` file and will run it automatically after pyinstaller builds it.  
+However, this obviouslly requires that you have pyinstaller installed and added to system PATH.
+
+## Notice
+
+Run `caffeine --help` for more up to date and accurate information then these docs can provide.  
 
 ---
 

docs/documents/datatypes.md

@@ -134,8 +134,8 @@ prt myInteger  :: 5
 In vanilla x++, it can also be used as a boolean value, where `1` represents `true` and `0` represents `false`:
 
 ```xpp
-psh hamburgerIsEaten 1
-if (hamburgerIsEaten == 1) "prt 'Someone ate my hamburger'"
+var hamburgerIsEaten 1
+if (hamburgerIsEaten == 1) { prt "Someone ate my hamburger" }
 ```
 
 ---
@@ -154,7 +154,7 @@ It cannot be modified using any operators, and it cannot be used as a source or
 
 ```xpp
 :: This will throw a parsing exception
-if (nonexistingVariable == anotherNonExistingVariable) "prt 'true'"
+if (nonexistingVariable == anotherNonExistingVariable) { prt "true" }
 ```
 
 ---
@@ -218,15 +218,15 @@ prt ("Hello, " + secondString)  :: "Hello, world!"
 
 :: If you have other datatypes:
 var myInteger 5
-prt "My favorite integer: " (myInteger)
+prt "My favorite integer:" (myInteger)
 ```
 
 Any non-string data type within a string interpolation will require the use of `()`.
 
 When being compared against using mathematical comparators, it is compared lexicographically:
 
 ```xpp
-if "abc" < "cba" "prt 'true'"
+if ("abc" < "cba") { prt "true" }
 ```
 
 ---

src/caffeine/__main__.py

@@ -18,9 +18,6 @@
 except ImportError:
     minify = None
 
-# Locate GCC
-GCC_PATH = which("gcc")
-
 # Initialization
 def do_run(file: str) -> None:
     file = str(file)

src/caffeine/modules/operators/math.py

@@ -43,13 +43,14 @@ def operator_pow(func: object, args: list) -> None:
 @operator("rnd")
 def operator_rnd(func: object, args: list) -> None:
     if len(args) == 3:
-        return func.append(f"{args[2]} = round({convert_value(args[0])}, {convert_value(args[1])})")
+        return func.append(f"{args[2].lstrip('?')} = round({convert_value(args[0])}, {convert_value(args[1])})")
 
-    func.append(f"{args[1]} = round({convert_value(args[0])})")
+    func.append(f"{args[1].lstrip('?')} = round({convert_value(args[0])})")
 
 @operator("rng")
 def operator_rng(func: object, args: list) -> None:
-    func.append(f"{args[2]} = random.randint({convert_value(args[0])}, {convert_value(args[1])})")
+    func.prepend("import random")
+    func.append(f"{args[2].lstrip('?')} = random.randint({convert_value(args[0])}, {convert_value(args[1])})")
 
 @operator("sub")
 def operator_sub(func: object, args: list) -> None: