Updated doxygen documents.

Author: pradosh-arduino

source/includes/memory2.h

@@ -72,4 +72,11 @@ int memcmp(const void *s1, const void *s2, size_t n);
  */
 void memory_dump(const void* start, const void* end);
 
+/**
+ * @brief Allocates memory at an specific address.
+ * 
+ * @param phys_addr Physical address to allocate memory.
+ * @param size Size of the memory to allocate.
+ * @return Pointer to the allocated memory, or NULL if allocation fails.
+ */
 void* allocate_memory_at_address(int64 phys_addr, size_t size);

source/includes/secure-boot.h

@@ -10,4 +10,8 @@
  */
 #include <basics.h>
 
+/**
+ * @brief Declaration of the public key used for secure boot.
+ * 
+ */
 extern cstring public_key;

source/includes/strings2.h

@@ -134,6 +134,15 @@ string strcat(string dest, cstring src);
  */
 void remove_last_char(string str);
 
+/**
+/**
+ * @brief Converts a string to a long integer.
+ * 
+ * @param str The input string to be converted.
+ * @param endptr Reference to a pointer that will be updated to point to the character after the last valid character.
+ * @param base The base of the number.
+ * @return long 
+ */
 long strtol(const char *str, char **endptr, int base);
 
 /**
@@ -159,4 +168,12 @@ char* hex_to_string(signed int num, bool caps);
  */
 char* leading_trailing_trim(const char *str);
 
+/**
+ * @brief Splits a string into tokens based on a delimiter.
+ * 
+ * @param str The input string to be split.
+ * @param delim The delimiter character.
+ * @param num_tokens The number of tokens found.
+ * @return char** Returns an array of strings containing the tokens.
+ */
 char** splitf(const char* str, char delim, int* num_tokens);

source/includes/syscalls.h

@@ -11,8 +11,22 @@
 #include <basics.h>
 #include <isr.h>
 
+/**
+ * @brief Prefix for the syscalls
+ * 
+ */
 #define syscalls_prefix "Syscall Invoked: "
 
+/**
+ * @brief Syscall number for the read syscall
+ * 
+ * @param num Syscall number.
+ */
 void invoke_syscall(int64 num);
 
+/**
+ * @brief Function to handle syscalls.
+ * 
+ * @param frame The interrupt frame.
+ */
 void syscalls_handler(InterruptFrame* frame);

source/includes/unifont.h

@@ -14,6 +14,10 @@
 #define UNIFONT_WIDTH 8
 #define UNIFONT_HEIGHT 16
 
+/**
+ * @brief Font used for flanterm.
+ * 
+ */
 static const int8 unifont[] = {
     0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
     0x00, 0x00, 0x00, 0x00, 0x3c, 0x42, 0x81, 0xa5, 0x81, 0xa5, 0x99, 0x42, 0x3c, 0x00, 0x00, 0x00,