Small Fixes

kernel/include/drivers/console/serial.h

@@ -13,6 +13,11 @@ namespace MaxOS {
 
   namespace drivers {
 
+
+      /**
+       * @class SerialConsole
+       * @brief A driver for the serial output
+       */
       class SerialConsole : public Driver {
 
         private:

kernel/src/common/kprint.cpp

@@ -11,7 +11,7 @@ using namespace MaxOS::drivers;
  * @brief Converts integer to string
  *
  * @param buffer The buffer to store the converted string
- * @param base The base (d for decimal, x gor hex)
+ * @param base The base of the number (10 for decimal, 16 for hex)
  * @param number The number to convert
  */
 char* itoa(int base, int number)
@@ -44,13 +44,23 @@ char* itoa(int base, int number)
     return &buffer[i + 1];
 }
 
+/**
+ * @brief Gets the length of a string
+ *
+ * @param str The string to get the length of
+ * @return The length of the string
+ */
 int strlen(const char* str)
 {
    int len = 0;
    for (; str[len] != '\0'; len++);
         return len;
 }
 
+/**
+ * @brief Prints a character to the serial output if it is initialized
+ * @param c The character to print
+ */
 static void putchar (int c)
 {
     // Check if the active serial console is null
@@ -61,6 +71,9 @@ static void putchar (int c)
     SerialConsole::s_active_serial_console->put_character(c);
 }
 
+/**
+ * @ brief Prints a debug prefix (in yellow) to the serial output
+ */
 void pre_kprintf()
 {
   // Print the kernel header with yellow text

kernel/src/drivers/console/serial.cpp

@@ -56,6 +56,10 @@ MaxOS::drivers::SerialConsole::~SerialConsole() {
 
 }
 
+/**
+ * @brief Waits for the serial port to be ready, then writes a character to it
+ * @param c The character to write
+ */
 void MaxOS::drivers::SerialConsole::put_character(char c) {
 
     // Wait for the serial port to be ready

toolchain/MaxOS.sh

@@ -0,0 +1,36 @@
+err () {
+  printf "\e[31m[ERROR] $1 \e[39m\n"
+}
+
+msg () {
+  printf "\e[36m[INFO] $1 \e[39m\n"
+}
+
+warn () {
+  printf "\e[33m[WARN] $1 \e[39m\n"
+}
+
+success () {
+  printf "\e[32m[SUCCESS] $1 \e[39m\n"
+}
+
+fail () {
+
+  # Print error message
+  err "$1"
+
+  # If there is something to do on fail, do it (and only once)
+  if [ -z "$FAILING" ]; then
+    FAILING=1
+    if [ ! -z "$ON_FAIL" ]; then
+      $ON_FAIL
+    fi
+  fi
+
+  # Exit with error code
+  if [ $? -eq 0 ]; then
+    exit 1
+  else
+    exit $?
+  fi
+}