some stuff, docs changes

Author: Brainy0789

.gitignore

@@ -0,0 +1 @@
+.DS_Store

README.md

@@ -2,6 +2,6 @@
 
 BScript is a coding language that is terrible.
 
-[Syntax](docs/SYNTAX.md)
+[Read the documentation here.](docs/Basics.md)
 
 All you get is simple variables that can only be added or subtracted to (only one), basic loops, really nothings else. It's probably easier than Brainfuck, though.

__pycache__/compiler.cpython-313.pyc

@@ -48,6 +48,24 @@ def compile(self, code: str) -> str:
                 i += 1
                 continue
 
+            # assignment: a = 123; or a = b;
+            m = re.match(r'([a-zA-Z_]\w*)\s*=\s*([a-zA-Z_]\w*|\d+);', line)
+            if m:
+                var, value = m.groups()
+                if var not in self.vars:
+                    raise Exception(f"Variable '{var}' used before declaration")
+
+                if value.isdigit():
+                    # Assign a constant number
+                    self.c_lines.append(f'{self.indent()}{var} = {int(value)} % 256;')
+                elif value in self.vars:
+                    # Assign from another variable
+                    self.c_lines.append(f'{self.indent()}{var} = {value};')
+                else:
+                    raise Exception(f"Invalid assignment value '{value}'")
+                i += 1
+                continue
+
             # increment/decrement
             m = re.match(r'([a-zA-Z_]\w*)\s*([+-]);', line)
             if m:
@@ -68,7 +86,7 @@ def compile(self, code: str) -> str:
                 if expr == 'str':
                     self.c_lines.append(f'{self.indent()}printf("%s", str);')
                 elif expr in self.vars:
-                    self.c_lines.append(f'{self.indent()}printf("%c", {expr});')
+                    self.c_lines.append(f'{self.indent()}printf("%d", {expr});')
                 else:
                     # assume string literal with quotes
                     literal = expr.strip('"').strip("'")

compiler.py

@@ -0,0 +1,24 @@
+# Advanced
+
+These are advanced functions for speicial use cases.
+
+## Single String to ASCII
+
+Sets the the ASCII value of the index of the string to a variable.
+
+````
+ascii 0,a
+````
+(Do note the indexes start at 0)
+
+## ASCII to Single String
+
+Adds the ASCII value to the String.
+
+````
+revascii a
+````
+
+(Do note the strings do not reset when you call this. You may have to call `string ""` if you want this to work correctly.)
+
+[ < Previous Page](Advanced.md)

docs/Advanced.md

@@ -0,0 +1,60 @@
+# Basics
+
+PLEASE NOTE DOCUMENTATION IS UNDER ACTIVE CONSTRUCTION. COMMANDS MARKED WITH (X) AREN'T SUPPORTED BY THE COMPILER AT THE MOMENT.
+
+## Printing<br>
+````
+print "At least we have support for basic strings!";
+````
+<br>Or a variable:<br>
+````
+print a;
+````
+<br>You can even use the single string! (More on that later.)<br>
+````
+print str;
+````
+
+## Creating Variables:<br>
+````
+var a;
+````
+<br>(always starts at 0)
+
+## Setting Variables
+
+````
+a=5; //Setting to an integer
+a=b; //Setting to another variable
+````
+
+## Adding/subtracting to variables
+
+````
+a +; //Addition by 1
+b -; //Subtraction by 1
+````
+(Do note that if a variables goes above the number 256, it resets to 0)
+
+## Loops
+````
+(a,b) {
+    //loops until the first variable is equal to the second.
+}
+````
+
+## The Single String:
+In BScript, you get access to a single string, `str`. You can set it using:
+````
+str "something";
+````
+
+## Inputs
+
+This simply sets a user input to the Single String
+
+````
+input;
+````
+
+[Next Page >](Functions.md)

docs/Basics.md

@@ -0,0 +1,13 @@
+//Some functions to use in BScript.
+
+//Function that takes two parameters and returns their sum
+func add x, y {
+    var w;
+
+    (w, y) {
+        x +;
+        w +;
+    }
+
+    return x;
+}

docs/ExampleFunctions.bs

@@ -0,0 +1,43 @@
+# Functions
+
+Cool enough, custom functions are possible in this language. You can even return things. Nice, right?
+
+## Defining a function (X)
+
+You can define a function using
+
+````
+func myFunction arg1,arg2 {
+    //Code here
+}
+````
+
+Simple enough, right? After a function has been defined, you can reuse these anywhere, like this.
+
+````
+myFunction 1,2; //Variables, strings, and integers supported as arguments
+````
+
+## Returning a value (X)
+
+You can return value using this.
+
+````
+func addOne number {
+    return number +;
+}
+````
+
+Returned functions can be set to as variables or the Single String.
+
+````
+a=addOne 1; //a equals 2 now.
+
+str someStringFunction str; //This does whatever this string function does
+````
+
+Functions can do a lot, and since I'm nice I'll provide some functions you can put into your own code!
+
+[You can see them here!](ExampleFunctions.bs)
+
+[< Previous Page](Basics.md) | [Next Page >](ScreenFunctions.md) 

docs/Functions.md

@@ -0,0 +1,5 @@
+# Screen Functions
+
+Under construction!
+
+[< Previous Page](Functions.md) | [Next Page >](Advanced.md)