Remove Doxygen-style comments, change formatting to wrap comments

kernel/amd64/debug.c

@@ -6,30 +6,33 @@
 #include <sync/spin_lock.h>
 #include <sys/debug.h>
 
-/// Port for printing to serial
+/* Port for printing to serial */
+/* TODO: Make this configurable */
 #define PORT_COM1 0x03F8
-/// \ref debugprintf buffer size
+/* debugprintf buffer size */
 #define BUFFER_SIZE 1024
-/// Lock, which ensures that prints to the serial port are atomic
+/*
+ * Lock, which ensures that prints to the serial port are atomic (ie. one debugprintf is atomic in
+ * itself).
+ */
 static spin_lock_t serial_lock = SPIN_LOCK_INIT;
 
 static bool debug_init = false;
 
-/// Block until TX buffer is empty
+/* Block until TX buffer is empty */
 static bool amd64_debug_serial_tx_empty (void) {
   return (bool)(amd64_io_inb (PORT_COM1 + 5) & 0x20);
 }
 
-/// Write a single character to serial
+/* Write a single character to serial */
 static void amd64_debug_serial_write (char x) {
   while (!amd64_debug_serial_tx_empty ())
     ;
   amd64_io_outb (PORT_COM1, (uint8_t)x);
 }
 
-/**
- * @brief Formatted printing to serial. \ref serial_lock ensures that
- * all prints are atomic.
+/*
+ * Formatted printing to serial. serial_lock ensures that all prints are atomic.
  */
 void debugprintf (const char* fmt, ...) {
   if (!debug_init)
@@ -57,7 +60,7 @@ void debugprintf (const char* fmt, ...) {
   spin_unlock (&serial_lock);
 }
 
-/// Initialize serial
+/* Initialize serial */
 void amd64_debug_init (void) {
   amd64_io_outb (PORT_COM1 + 1, 0x00);
   amd64_io_outb (PORT_COM1 + 3, 0x80);