From 369efaec2ee1695c5a52e6d46a7fcaf74a070c8a Mon Sep 17 00:00:00 2001
From: kamkow1 <kamkow256@gmail.com>
Date: Fri, 13 Feb 2026 00:59:42 +0100
Subject: [PATCH] Doc comment libmsl m/system.h

---
 init/init.c            |  6 +++---
 liballoc/.gitignore    |  1 +
 libmsl/.gitignore      |  1 +
 libmsl/amd64/syscall.h |  1 +
 libmsl/m/system.h      | 23 +++++++++++++++++++++++
 libprocess/.gitignore  |  1 +
 libstring/.gitignore   |  1 +
 libterminal/.gitignore |  1 +
 8 files changed, 32 insertions(+), 3 deletions(-)

diff --git a/init/init.c b/init/init.c
index 5713c79..8be1150 100644
--- a/init/init.c
+++ b/init/init.c
@@ -20,7 +20,7 @@ void app_proc (void) {
     for (int i = 0; i < 3; i++)
       terminal_print (&letter, 1);
 
-    for (volatile int i = 0; i < 1000*1000; i++)
+    for (volatile int i = 0; i < 1000 * 1000; i++)
       ;
 
     mutex_unlock (MUTEX);
@@ -43,8 +43,8 @@ void app_main (void) {
 
     for (int i = 0; i < 3; i++)
       terminal_print (&letter, 1);
-    
-    for (volatile int i = 0; i < 1000*1000; i++)
+
+    for (volatile int i = 0; i < 1000 * 1000; i++)
       ;
 
     mutex_unlock (MUTEX);
diff --git a/liballoc/.gitignore b/liballoc/.gitignore
index 2a3afcd..de276e3 100644
--- a/liballoc/.gitignore
+++ b/liballoc/.gitignore
@@ -1,3 +1,4 @@
 *.o
 *.json
 docs/
+.cache/
diff --git a/libmsl/.gitignore b/libmsl/.gitignore
index 5bd58db..aa2c101 100644
--- a/libmsl/.gitignore
+++ b/libmsl/.gitignore
@@ -1,2 +1,3 @@
 *.json
 docs/
+.cache/
diff --git a/libmsl/amd64/syscall.h b/libmsl/amd64/syscall.h
index fd97103..daac5a1 100644
--- a/libmsl/amd64/syscall.h
+++ b/libmsl/amd64/syscall.h
@@ -3,6 +3,7 @@
 
 #include <stdint.h>
 
+/* Performs a syscall for the AMD64  */
 uintptr_t amd64_syscall (int syscall_num, uintptr_t a1, uintptr_t a2, uintptr_t a3, uintptr_t a4,
                          uintptr_t a5, uintptr_t a6);
 
diff --git a/libmsl/m/system.h b/libmsl/m/system.h
index 7461b2a..d6404d1 100644
--- a/libmsl/m/system.h
+++ b/libmsl/m/system.h
@@ -13,17 +13,40 @@
 #define MAP_USER    (1 << 2)
 #define MAP_FLAGS   (MAP_PRESENT | MAP_USER)
 
+/* Quit the current running process */
 int quit (void);
+
+/* Test syscall */
 int test (char c);
+
+/* Give the CPU to another process */
 int sched (void);
+
+/* map memory into this procgrou[ */
 void* map (uintptr_t vaddr, size_t pages, uint32_t flags);
+
+/* unmap memory from this procgrou[ */
 int unmap (uintptr_t vaddr, size_t pages);
+
+/* Clone process with argument and entry point */
 int clone (uintptr_t vstack_top, void (*entry) (void), void* argument_ptr);
+
+/* Create a mutex */
 int mutex_create (int mutex_rid);
+
+/* Delete a mutex. Will wake up waiters */
 int mutex_delete (int mutex_rid);
+
+/* Lock a mutex */
 int mutex_lock (int mutex_rid);
+
+/* Unlock a mutex */
 int mutex_unlock (int mutex_rid);
+
+/* get current process argument pointer */
 void* argument_ptr (void);
+
+/* Call a device command */
 int device_do (int device_id, int cmd, void* a1, void* a2, void* a3, void* a4);
 
 #endif // _LIBMSL_M_SYSTEM_H
diff --git a/libprocess/.gitignore b/libprocess/.gitignore
index 2a3afcd..de276e3 100644
--- a/libprocess/.gitignore
+++ b/libprocess/.gitignore
@@ -1,3 +1,4 @@
 *.o
 *.json
 docs/
+.cache/
diff --git a/libstring/.gitignore b/libstring/.gitignore
index 2a3afcd..de276e3 100644
--- a/libstring/.gitignore
+++ b/libstring/.gitignore
@@ -1,3 +1,4 @@
 *.o
 *.json
 docs/
+.cache/
diff --git a/libterminal/.gitignore b/libterminal/.gitignore
index 2a3afcd..de276e3 100644
--- a/libterminal/.gitignore
+++ b/libterminal/.gitignore
@@ -1,3 +1,4 @@
 *.o
 *.json
 docs/
+.cache/