InterfaceCompiler: More code generation stuff, Documentation: Start expading documentation

Author: fido2020

.gitignore

@@ -27,4 +27,4 @@ Ports/*
 Toolchain/*
 !Toolchain/*.sh
 !Toolchain/*.patch
-InterfaceCompiler/a.out
+InterfaceCompiler/lic

Documentation/Build/README.md

@@ -0,0 +1,5 @@
+# Building Lemon OS and the Lemon OS Toolchain
+
+### Building Lemon OS
+[Building Lemon OS with Docker (Recommended)](https://github.com/fido2020/Lemon-OS/wiki/Building-Lemon-OS-with-Docker)
+[Building Lemon OS with Docker (Requires building an LLVM toolchain which will take a decent amount of time)](https://github.com/fido2020/Lemon-OS/wiki/Building-Lemon-OS)

Documentation/Build/lic.md

@@ -0,0 +1,6 @@
+# LIC (Lemon Interface Compiler)
+
+See [Inter-process Communication in Lemon OS](../System/IPC/README.md)
+
+Usage: \
+`lic <source file>`

Documentation/Kernel/Network.md

@@ -0,0 +1 @@
+# Kernel Network Configuration Interface

Documentation/README.md

@@ -0,0 +1,11 @@
+# Lemon OS Documentation
+
+[Kernel/](Kernel/README.md) Lemon Kernel
+
+[System/](System/README.md) System Interfaces and Design
+
+[API/](API/README.md) System APIs
+
+[Userspace/](Userspace/README.md) Userspace applications (CLI and GUI) 
+
+[Build/](Build/README.md) Building Lemon OS and Lemon OS toolchain 

Documentation/System/IPC/IPC.md

@@ -0,0 +1,46 @@
+# Inter-process Communication in Lemon OS 
+
+## Kernel-Level IPC interfaces
+### Services
+A service is a container allowing a single application to host multiple interfaces. Services also allow clients to identify and connect to an interface. An example of a service/interface pair is `lemon.lemonwm/Instance`.
+
+### Interfaces
+An interface is a way for clients to open a connection to a server. Two operations can be performed on an interface.
+- ```SysInterfaceAccept``` - Accept incoming connections on an interface
+- ```SysInterfaceConnect``` - Connect to an interface 
+
+### Endpoints
+An endpoint can recieve from an send messages to a peer. Each endpoint has its own queue which can be read from and has a peer in which messages can be sent to.
+
+## LibLemon IPC API
+
+## Interface Description Language
+See [LIC (Lemon Interface Compiler)](../../Build/lic.md)
+
+### Interfaces
+The `interface` keyword defines an interface. An interface consists of a server and a client. Clients can send *requests*, servers can reply with *responses*. Each request and response is given a unique ID starting from 100.
+
+For each interface lic will generate the following:
+- A *server* class containing:
+    - An enum with all request and response IDs (public)
+    - A struct containing response data for each response (public)
+    - Pure virtual callbacks for each request (protected)
+- A *client* class (inheriting from `Lemon::Endpoint`) containing:
+    - A function for each request (public)
+
+### Types
+`s8, s16, s32, s64` Signed integer \
+`u8. u16, u32. u64` Unsigned integer \
+`bool` boolean \
+`string` string \
+
+### Requests
+
+`AsynchronousRequest(string firstParameter, ...)` \
+`SynchronousRequest(bool firstParameter, ...) -> (s64 firstReturnParameter, ...)` \
+
+Asynchronous requests do not wait for a reply (known as 'fire and forget'), these may be used in situation where there is no response needed from the server and that in the event that the server mishandles the message, the client will not have any issues.
+
+Synchronous requests are useful when a reply is necessary or it is crucial that the server handles the message correctly.
+
+The buffer for each request and response is stored on the stack and passed over to the endpoint.

Documentation/System/IPC/README.md

@@ -0,0 +1,5 @@
+# Lemon OS System
+
+[LemonWM/](LemonWM/README.md) LemonWM Interface
+
+[IPC/](IPC/README.md) Inter-process communication in Lemon OS

Documentation/System/README.md

@@ -0,0 +1 @@
+g++ -o lic -std=c++17 main.cpp -Wall -Wextra