Comments now conform to PasDoc specifications.

git-svn-id: https://spexeah.com:8443/svn/Asuro@749 6dbc8c32-bb84-406f-8558-d1cf31a0ab0c

src/console.pas

@@ -1,12 +1,8 @@
-{ ************************************************
+{ 
-  * Asuro
+	Console - Provides Screen/Window management & drawing.
-  * Unit: console
+	
-  * Description: Basic Console Output
+	@author(Kieron Morris <kjm@kieronmorris.me>)
-  ************************************************
+}
-  * Author: K Morris
-  * Contributors: 
-  ************************************************ }
-
 unit console;
 
 interface
@@ -19,6 +15,7 @@ uses
      tracer;
 
 type
+	{ 4-bit nibble representing a color. }
     TColor = ( Black   = $0,
                Blue    = $1,
                Green   = $2,
@@ -36,6 +33,7 @@ type
                lYellow = $E,
                lWhite  = $F );
 
+	{ Window Manager Events. }
     TEventType = ( EVENT_DRAW,
                    EVENT_MOUSE_CLICK,
                    EVENT_MOUSE_MOVE,
@@ -47,62 +45,269 @@ type
                    EVENT_FOCUS,
                    EVENT_LOSE_FOCUS );
 
+
+
+
+{ Default Buffer Specific }
+
+{ 
+	Initialize the Frame Buffer & Window Manager ready for use.
+}
 procedure init();
+
+{ 
+	Clear the Frame Buffer. 
+}
 procedure clear();
+
+{ 
+	Set the default set of attributes to be used when drawing to the screen.
+	@param(attribute A 32-bit value representing the Foreground & Background colors.) 
+}
 procedure setdefaultattribute(attribute : uint32);
 
+{
+	@bold(Text mode only!) - Disable the cursor/text-caret. 
+	@deprecated
+}
 procedure disable_cursor;
 
+{ 
+	Write a single 8-bit character to the screen.
+	@param(character An 8-bit value representing an ASCII character.) 
+}
 procedure writechar(character : char);
+
+{ 
+	Write a single 8-bit character to the screen, followed by starting a new line.
+	@param(character An 8-bit value representing an ASCII character.) 
+}
 procedure writecharln(character : char);
+
+{ 
+	Write a single 8-bit character to the screen, specifying custom color attributes.
+	@param(character An 8-bit value representing an ASCII character.)
+	@param(attributes A 32-bit value representing the colors for the background and foreground.)
+}
 procedure writecharex(character : char; attributes: uint32);
+
+{ 
+	Write a single 8-bit character to the screen, followed by starting a new line, specifying custom color attributes.
+	@param(character An 8-bit value representing an ASCII character.)
+	@param(attributes A 32-bit value representing the colors for the background and foreground.)
+}
 procedure writecharlnex(character : char; attributes: uint32);
 
+{ 
+	Simple console write for debugging.
+	@param(identifier A NULL terminated string with the name of the module printing the output.)
+	@param(str A NULL terminated string with the debug message.)
+}
 procedure Output(identifier : PChar; str : PChar);
+
+{ 
+	Simple console writeln for debugging.
+	@param(identifier A NULL terminated string with the name of the module printing the output.)
+	@param(str A NULL terminated string with the debug message.)
+}
 procedure Outputln(identifier : PChar; str : PChar);
 
+{ 
+	Write a NULL terminated string to the console.
+	@param(str A NULL terminated string with the debug message.)
+}
 procedure writestring(str: PChar);
+
+{ 
+	Write a NULL terminated string to the console, followed by a new-line.
+	@param(str A NULL terminated string with the debug message.)
+}
 procedure writestringln(str: PChar);
+
+{ 
+	Write a NULL terminated string to the console, with the specified attributes.
+	@param(str A NULL terminated string with the debug message.)
+	@param(attributes A 32-bit representation of the background/foreground colors.)
+}
 procedure writestringex(str: PChar; attributes: uint32);
+
+{ 
+	Write a NULL terminated string + new-line to the console, with the specified attributes.
+	@param(str A NULL terminated string with the debug message.)
+	@param(attributes A 32-bit representation of the background/foreground colors.)
+}
 procedure writestringlnex(str: PChar; attributes: uint32);
 
+{ 
+	Write a 32-bit value to the console.
+	@param(i A 32-bit value.)
+}
 procedure writeint(i: Integer);
+
+{ 
+	Write a 32-bit value to the console followed by a new-line.
+	@param(i A 32-bit value.)
+}
 procedure writeintln(i: Integer);
+
+{ 
+	Write a 32-bit value to the console, with the specified attributes.
+	@param(i A 32-bit value.)
+	@param(attributes A 32-bit representation of the background/foreground colors.)
+}
 procedure writeintex(i: Integer; attributes: uint32);
+
+{ 
+	Write a 32-bit value + new-line to the console, with the specified attributes.
+	@param(i A 32-bit value.)
+	@param(attributes A 32-bit representation of the background/foreground colors.)
+}
 procedure writeintlnex(i: Integer; attributes: uint32);
 
+{ 
+	Write an 8-bit Hex Pair to the console.
+	@param(b An 8-bit value.)
+}
 procedure writehexpair(b : uint8);
+
+{ 
+	Write a 32-bit value as Hex Pairs to the console.
+	@param(i A 32-bit value.)
+}
 procedure writehex(i: DWORD);
+
+{ 
+	Write a 32-bit value as Hex Pairs to the console, followed by a new-line.
+	@param(i A 32-bit value.)
+}
 procedure writehexln(i: DWORD);
+
+{ 
+	Write a 32-bit value as Hex Pairs to the console, with the specified attributes.
+	@param(b A 32-bit value.)
+	@param(attributes A 32-bit representation of the background/foreground colors.)
+}
 procedure writehexex(i : DWORD; attributes: uint32);
+
+{ 
+	Write a 32-bit value as Hex Pairs + new-line to the console, with the specified attributes.
+	@param(b A 32-bit value.)
+	@param(attributes A 32-bit representation of the background/foreground colors.)
+}
 procedure writehexlnex(i: DWORD; attributes: uint32);
 
+{ 
+	Write an 8-bit value as binary to the console.
+	@param(b An 8-bit value.)
+}
 procedure writebin8(b : uint8);
+
+{ 
+	Write an 8-bit value as binary to the console, followed by a new-line.
+	@param(b An 8-bit value.)
+}
 procedure writebin8ln(b : uint8);
+
+{ 
+	Write an 8-bit value as binary to the console, with the specified attributes.
+	@param(b An 8-bit value.)
+	@param(attributes A 32-bit representation of the background/foreground colors.)
+}
 procedure writebin8ex(b : uint8; attributes: uint32);
+
+{ 
+	Write an 8-bit value as binary + new-line to the console, with the specified attributes.
+	@param(b An 8-bit value.)
+	@param(attributes A 32-bit representation of the background/foreground colors.)
+}
 procedure writebin8lnex(b : uint8; attributes: uint32);
 
+{ 
+	Write a 16-bit value as binary to the console.
+	@param(b A 16-bit value.)
+}
 procedure writebin16(b : uint16);
+
+{ 
+	Write an 16-bit value as binary to the console, followed by a new-line.
+	@param(b A 16-bit value.)
+}
 procedure writebin16ln(b : uint16);
+
+{
+	Write a 16-bit value as binary to the console, with the specified attributes.
+	@param(b A 16-bit value.)
+	@param(attributes A 32-bit representation of the background/foreground colors.)
+}
 procedure writebin16ex(b : uint16; attributes: uint32);
+
+{
+	Write a 16-bit value as binary + new-line to the console, with the specified attributes.
+	@param(b A 16-bit value.)
+	@param(attributes A 32-bit representation of the background/foreground colors.)
+}
 procedure writebin16lnex(b : uint16; attributes: uint32);
 
+{ 
+	Write a 32-bit value as binary to the console.
+	@param(b A 32-bit value.)
+}
 procedure writebin32(b : uint32);
+
+{ 
+	Write an 32-bit value as binary to the console, followed by a new-line.
+	@param(b A 32-bit value.)
+}
 procedure writebin32ln(b : uint32);
+
+{
+	Write a 32-bit value as binary to the console, with the specified attributes.
+	@param(b A 32-bit value.)
+	@param(attributes A 32-bit representation of the background/foreground colors.)
+}
 procedure writebin32ex(b : uint32; attributes: uint32);
+
+{
+	Write a 32-bit value as binary + new-line to the console, with the specified attributes.
+	@param(b A 32-bit value.)
+	@param(attributes A 32-bit representation of the background/foreground colors.)
+}
 procedure writebin32lnex(b : uint32; attributes: uint32);
 
+{ 
+	Move the caret back 1 position and remove the character within the cell the caret occupies.
+}
 procedure backspace;
 
+{
+	Combine two 16-bit values representing Foreground and Background respectively, into a 32-bit value representing an attribute. 
+	@param(Foreground A 16-bit value representing the foreground color.)
+	@param(Background A 16-bit value representing the background color.)
+	@returns(A 32-bit value representing an attribute set. (uint32) )
+}
 function combinecolors(Foreground, Background : uint16) : uint32;
 
+{ Increment the cursor one cell to the right (x+1). }
 procedure _increment_x();
+
+{ Increment the cursor one cell down (y+1). }
 procedure _increment_y();
-procedure _safeincrement_y();
+
+{ Increment the cursor one cell to the right (x+1), wrapping to the next line and performing a Y-Axis scroll when when needed. }
 procedure _safeincrement_x();
+
+{ Increment the cursor one cell down (y+1), performing a Y-Axis roll when when needed. }
+procedure _safeincrement_y();
+
+{ Increment the cursor one cell down and reposition it at the first X Cell (y+1, x=0),performing a Y-Axis scroll when needed. }
 procedure _newline();
 
-{ WND Specific }
+
+
+
+
+{ Window Specific }
+
 
 procedure clearWND(WND : uint32);
 procedure clearWNDEx(WND : uint32; attributes : uint32);
@@ -193,20 +398,19 @@ procedure _MouseClick(left : boolean);
 procedure setWindowColors(colors : uint32);
 function getWindowColorPtr : puint32;
 
+const
+	MAX_WINDOWS = 255; //<Maximum number of Windows open.
+    DefaultWND  = 0;   //<The Window assigned for output when no Window is specified. (Default).
+
 implementation
 
-uses
-    lmemorymanager, strings, keyboard, serial, terminal;
-
-const
-    MAX_WINDOWS = 255;
-    DefaultWND  = 0;
-
 type
+	{ Properties pertaining to the raw screen matrix.}
     TConsoleProperties = record
-      Default_Attribute : uint32;
+      Default_Attribute : uint32; //Attribute (Colors) to use when no override defined.
     end;
 
+	{ Unrasterized representation of a character.}
     TCharacter = bitpacked record
       Character  : Char;
       attributes : uint32;
@@ -214,6 +418,7 @@ type
     end;
     PCharacter = ^TCharacter;
 
+	{ Unrasterized screen matrix. }
     TVideoMemory = Array[0..1999] of TCharacter;
     PVideoMemory = ^TVideoMemory;
 
@@ -314,6 +519,9 @@ var
    MouseCursorEnabled : Boolean = true;
    OpenTerminal       : Boolean = false;
 
+uses
+    lmemorymanager, strings, keyboard, serial, terminal;
+
 function getWindowColorPtr : puint32;
 begin
     getWindowColorPtr:= @Window_Border.Attributes;

src/contextswitcher.pas

@@ -1,12 +1,8 @@
-{ ************************************************
+{ 
-  * Asuro
+	ContextSwitcher - Switch Process Contexts when preempted.
-  * Unit: ContextSwitcher
+	
-  * Description: Switches context between processes
+	@author(Kieron Morris <kjm@kieronmorris.me>)
-  *              when preempted by the scheduler.
+}
-  ************************************************
-  * Author: K Morris
-  * Contributors:
-  ************************************************ }
 unit contextswitcher;
 
 interface

src/cpu.pas

@@ -1,3 +1,8 @@
+{ 
+	CPU - CPU Structures & Utility/Capabilities Functions.
+	
+	@author(Kieron Morris <kjm@kieronmorris.me>)
+}
 unit cpu;
 
 interface

src/driver/bus/EHCI.pas

@@ -1,3 +1,8 @@
+{ 
+	Driver->Bus->EHCI - Enhanced Host Controller Interface Driver.
+	
+	@author(Kieron Morris <kjm@kieronmorris.me>)
+}
 unit EHCI;
 
 interface

src/driver/bus/OHCI.pas

@@ -1,3 +1,8 @@
+{ 
+	Driver->Bus->OHCI - Open Host Controller Interface Driver.
+	
+	@author(Kieron Morris <kjm@kieronmorris.me>)
+}
 unit OHCI;
 
 interface

src/driver/bus/PCI.pas

@@ -1,12 +1,9 @@
-{ ************************************************
+{ 
-  * Asuro
+	Driver->Bus->PCI - Peripheral Component Interconnect Driver.
-  * Unit: Drivers/PCI
+	
-  * Description: PCI Driver
+	@author(Aaron Hance <ah@aaronhance.me>)
-  ************************************************
+	@author(Kieron Morris <kjm@kieronmorris.me>)
-  * Author: Aaron Hance
+}
-  * Contributors: Kieron Morris
-  ************************************************ }
-
 unit PCI;
 
 interface

src/driver/bus/UHCI.pas

@@ -1,3 +1,8 @@
+{ 
+	Driver->Bus->UHCI - Universal Host Controller Interface Driver.
+	
+	@author(Kieron Morris <kjm@kieronmorris.me>)
+}
 unit UHCI;
 
 interface

src/driver/bus/USB.pas

@@ -1,3 +1,8 @@
+{ 
+	Driver->Bus->USB - Universal Serial Bus Driver/Interface.
+	
+	@author(Kieron Morris <kjm@kieronmorris.me>)
+}
 unit USB;
 
 interface

src/driver/bus/XHCI.pas

@@ -1,3 +1,8 @@
+{ 
+	Driver->Bus->XHCI - eXtensible Host Controller Interface Driver.
+	
+	@author(Kieron Morris <kjm@kieronmorris.me>)
+}
 unit XHCI;
 
 interface

src/driver/exp/testdriver.pas

@@ -1,3 +1,8 @@
+{ 
+	Driver->Exp->TestDriver - Dummy Driver For Testing.
+	
+	@author(Kieron Morris <kjm@kieronmorris.me>)
+}
 unit testdriver;
 
 interface

src/driver/hid/PS2_KEYBOARD_ISR.pas

@@ -1,12 +1,9 @@
-{ ************************************************
+{ 
-  * Asuro
+	Driver->HID->PS2_KEYBAORD_ISR - PS2 ISR Hook & Driver.
-  * Unit: Drivers/isr33
+	
-  * Description: Keyboard interrupt
+	@author(Aaron Hance <ah@aaronhance.me>)
-  ************************************************
+	@author(Kieron Morris <kjm@kieronmorris.me>)
-  * Author: Aaron Hance
+}
-  * Contributors: K Morris
-  ************************************************ }
-
 unit PS2_KEYBOARD_ISR;
 
 interface

src/driver/hid/keyboard.pas

@@ -1,12 +1,8 @@
-{ ************************************************
+{ 
-  * Asuro
+	Driver->HID->Keyboard - Keyboard Driver.
-  * Unit: Drivers/keyboard
+	
-  * Description: Keyboard driver
+	@author(Aaron Hance <ah@aaronhance.me>)
-  ************************************************
+}
-  * Author: Aaron Hance
-  * Contributors: 
-  ************************************************ }
-
 unit keyboard;
 
 interface

src/driver/hid/mouse.pas

@@ -1,12 +1,8 @@
-{ ************************************************
+{ 
-  * Asuro
+	Driver->HID->Mouse - Mouse Driver.
-  * Unit: Drivers/mouse
+	
-  * Description: Mouse Driver
+	@author(Kieron Morris <kjm@kieronmorris.me>)
-  ************************************************
+}
-  * Author: K Morris
-  * Contributors: 
-  ************************************************ }
-
 unit mouse;
 
 interface

src/driver/include/drivertypes.pas

@@ -1,11 +1,8 @@
-{ ************************************************
+{ 
-  * Asuro
+	Driver->Include->DriverTypes - Structs & Data Shared Across Drivers.
-  * Unit: Drivers/drivertypes
+	
-  * Description: types shared between drivers
+	@author(Aaron Hance <ah@aaronhance.me>)
-  ************************************************
+}
-  * Author: Aaron Hance
-  * Contributors: 
-  ************************************************ }
 unit drivertypes;
 
 interface

src/driver/interface/serial.pas

@@ -1,3 +1,8 @@
+{ 
+	Driver->Interface->Serial - Serial Driver.
+	
+	@author(Kieron Morris <kjm@kieronmorris.me>)
+}
 unit serial;
 
 interface

src/driver/net/include/nettypes.pas

@@ -1,3 +1,8 @@
+{ 
+	Driver->Net->NetTypes - Structures & Types Shared Across Network Drivers.
+	
+	@author(Kieron Morris <kjm@kieronmorris.me>)
+}
 unit nettypes;
 
 interface

src/driver/net/include/netutils.pas

@@ -1,3 +1,8 @@
+{ 
+	Driver->Net->NetUtils - Helper Functions For Network Drivers. 
+	
+	@author(Kieron Morris <kjm@kieronmorris.me>)
+}
 unit netutils;
 
 interface

src/driver/net/l1/net.pas

@@ -1,3 +1,8 @@
+{ 
+	Driver->Net->L1->Net - Network Card<->Driver Interface.
+	
+	@author(Kieron Morris <kjm@kieronmorris.me>)
+}
 unit net;
 
 interface

src/driver/net/l2/eth2.pas

@@ -1,3 +1,8 @@
+{ 
+	Driver->Net->L2->Eth2 - Ethernet Driver.
+	
+	@author(Kieron Morris <kjm@kieronmorris.me>)
+}
 unit eth2;
 
 interface

src/driver/net/l3/arp.pas

@@ -1,3 +1,8 @@
+{ 
+	Driver->Net->L3->ARP - Address Resolution Protocol Driver.
+	
+	@author(Kieron Morris <kjm@kieronmorris.me>)
+}
 unit arp;
 
 interface

src/driver/net/l3/ipv4.pas

@@ -1,3 +1,8 @@
+{ 
+	Driver->Net->L3->IPv4 - Internet Protocol Version 4 Driver.
+	
+	@author(Kieron Morris <kjm@kieronmorris.me>)
+}
 unit ipv4;
 
 interface

src/driver/net/l4/icmp.pas

@@ -1,3 +1,8 @@
+{ 
+	Driver->Net->L4->ICMP - Internet Control Message Protocol Driver,
+	
+	@author(Kieron Morris <kjm@kieronmorris.me>)
+}
 unit icmp;
 
 interface

src/driver/net/l4/tcp.pas

@@ -1,3 +1,8 @@
+{ 
+	Driver->Net->L4->TCP - Transmission Control Protocol Driver.
+	
+	@author(Kieron Morris <kjm@kieronmorris.me>)
+}
 unit tcp;
 
 interface

src/driver/net/l4/udp.pas

@@ -1,3 +1,8 @@
+{ 
+	Driver->Net->L4->UDP - User Datagram Protocol Driver.
+	
+	@author(Kieron Morris <kjm@kieronmorris.me>)
+}
 unit udp;
 
 interface

src/driver/netdev/E1000.pas

@@ -1,3 +1,8 @@
+{ 
+	Driver->NetDev->E1000 - Intel E1000/I217/82577LM Network Card Driver.
+	
+	@author(Kieron Morris <kjm@kieronmorris.me>)
+}
 unit E1000;
 
 interface

src/driver/timers/RTC.pas

@@ -1,3 +1,8 @@
+{ 
+	Driver->Timers->RTC - Real Time Clock Driver.
+	
+	@author(Kieron Morris <kjm@kieronmorris.me>)
+}
 unit RTC;
 
 interface

src/driver/timers/TMR_0_ISR.pas

@@ -1,12 +1,8 @@
-{ ************************************************
+{ 
-  * Asuro
+	Driver->Timer->TMR_0_ISR - 1024hz Timer Driver.
-  * Unit: Drivers/isr32
+	
-  * Description: 1024hz Timer interrupt
+	@author(Kieron Morris <kjm@kieronmorris.me>)
-  ************************************************
+}
-  * Author: Aaron Hance
-  * Contributors: K Morris
-  ************************************************ }
-
 unit TMR_0_ISR;
 
 interface

src/driver/timers/TMR_1_ISR.pas

@@ -1,12 +1,8 @@
-{ ************************************************
+{ 
-  * Asuro
+	Driver->Timer->TMR_1_ISR - 1024/s Timer Driver.
-  * Unit: Drivers/isr40
+	
-  * Description: 1024/s Timer interrupt
+	@author(Kieron Morris <kjm@kieronmorris.me>)
-  ************************************************
+}
-  * Author: Aaron Hance
-  * Contributors: K Morris
-  ************************************************ }
-
 unit TMR_1_ISR;
 
 interface

src/drivermanagement.pas

@@ -1,11 +1,8 @@
-{ ************************************************
+{ 
-  * Asuro
+	DriverManagement - Driver Initialization & Management Interface.
-  * Unit: Driver_Management
+	
-  * Description: Manages Driver Loading
+	@author(Kieron Morris <kjm@kieronmorris.me>)
-  ************************************************
+}
-  * Author: K Morris
-  * Contributors:
-  ************************************************ }
 unit drivermanagement;
 
 interface

src/fault/ACE.pas

@@ -1,12 +1,8 @@
-{ ************************************************
+{ 
-  * Asuro
+	Fault->ACE - Alignment Check Exception.
-  * Unit: Drivers/ISR17
+	
-  * Description: Alignment Check Exception
+	@author(Kieron Morris <kjm@kieronmorris.me>)
-  ************************************************
+}
-  * Author: K Morris
-  * Contributors: 
-  ************************************************ }
-
 unit ACE;
 
 interface

src/fault/BPE.pas

@@ -1,12 +1,8 @@
-{ ************************************************
+{ 
-  * Asuro
+	Fault->BPE - Break Point Exception.
-  * Unit: Drivers/ISR3
+	
-  * Description: Breakpoint Exception
+	@author(Kieron Morris <kjm@kieronmorris.me>)
-  ************************************************
+}
-  * Author: K Morris
-  * Contributors: 
-  ************************************************ }
-
 unit BPE;
 
 interface

src/fault/BTSSE.pas

@@ -1,12 +1,8 @@
-{ ************************************************
+{ 
-  * Asuro
+	Fault->BTSSE - Bad TSS Exception.
-  * Unit: Drivers/ISR10
+	
-  * Description: Bad TSS Exception
+	@author(Kieron Morris <kjm@kieronmorris.me>)
-  ************************************************
+}
-  * Author: K Morris
-  * Contributors: 
-  ************************************************ }
-
 unit BTSSE;
 
 interface

src/fault/CFE.pas

@@ -1,12 +1,8 @@
-{ ************************************************
+{ 
-  * Asuro
+	Fault->CFE - Coprocessor Fault Exception.
-  * Unit: Drivers/ISR11
+	
-  * Description: Coprocessor Fault Exception
+	@author(Kieron Morris <kjm@kieronmorris.me>)
-  ************************************************
+}
-  * Author: K Morris
-  * Contributors: 
-  ************************************************ }
-
 unit CFE;
 
 interface

src/fault/CSOE.pas

@@ -1,12 +1,8 @@
-{ ************************************************
+{ 
-  * Asuro
+	Fault->CSOE - Coprocessor Seg Overruun Exception.
-  * Unit: Drivers/ISR9
+	
-  * Description: Coprocessor Seg Overrun Exception
+	@author(Kieron Morris <kjm@kieronmorris.me>)
-  ************************************************
+}
-  * Author: K Morris
-  * Contributors: 
-  ************************************************ }
-
 unit CSOE;
 
 interface

src/fault/DBGE.pas

@@ -1,12 +1,8 @@
-{ ************************************************
+{ 
-  * Asuro
+	Fault->DBGE - Debug Exception.
-  * Unit: Drivers/ISR1
+	
-  * Description: Debug Exception
+	@author(Kieron Morris <kjm@kieronmorris.me>)
-  ************************************************
+}
-  * Author: K Morris
-  * Contributors: 
-  ************************************************ }
-
 unit DBGE;
 
 interface

src/fault/DBZ.pas

@@ -1,12 +1,8 @@
-{ ************************************************
+{ 
-  * Asuro
+	Fault->DBZ - Divide By Zero Exception.
-  * Unit: Drivers/ISR0
+	
-  * Description: Divide-By-Zero Exception
+	@author(Kieron Morris <kjm@kieronmorris.me>)
-  ************************************************
+}
-  * Author: K Morris
-  * Contributors: 
-  ************************************************ }
-
 unit DBZ;
 
 interface

src/fault/DFE.pas

@@ -1,12 +1,8 @@
-{ ************************************************
+{ 
-  * Asuro
+	Fault->DFE - Double Fault Exception.
-  * Unit: Drivers/ISR8
+	
-  * Description: Double Fault Exception
+	@author(Kieron Morris <kjm@kieronmorris.me>)
-  ************************************************
+}
-  * Author: K Morris
-  * Contributors: 
-  ************************************************ }
-
 unit DFE;
 
 interface

src/fault/GPF.pas

@@ -1,12 +1,8 @@
-{ ************************************************
+{ 
-  * Asuro
+	Fault->GPF - General Protection Fault.
-  * Unit: Drivers/ISR13
+	
-  * Description: General Protection Fault
+	@author(Kieron Morris <kjm@kieronmorris.me>)
-  ************************************************
+}
-  * Author: K Morris
-  * Contributors: 
-  ************************************************ }
-
 unit GPF;
 
 interface

src/fault/IDOE.pas

@@ -1,12 +1,8 @@
-{ ************************************************
+{ 
-  * Asuro
+	Fault->IDO - Into Detected Overflow Exception.
-  * Unit: Drivers/ISR4
+	
-  * Description: Into Detected Overflow Exception
+	@author(Kieron Morris <kjm@kieronmorris.me>)
-  ************************************************
+}
-  * Author: K Morris
-  * Contributors: 
-  ************************************************ }
-
 unit IDOE;
 
 interface

src/fault/IOPE.pas

@@ -1,12 +1,8 @@
-{ ************************************************
+{ 
-  * Asuro
+	Fault->IOPE - Invalid OPCode Exception.
-  * Unit: Drivers/ISR6
+	
-  * Description: Invalid OPCode Exception
+	@author(Kieron Morris <kjm@kieronmorris.me>)
-  ************************************************
+}
-  * Author: K Morris
-  * Contributors: 
-  ************************************************ }
-
 unit IOPE;
 
 interface

src/fault/MCE.pas

@@ -1,12 +1,8 @@
-{ ************************************************
+{ 
-  * Asuro
+	Fault->MCE - Machine Check Exception.
-  * Unit: Drivers/ISR18
+	
-  * Description: Machine Check Exception
+	@author(Kieron Morris <kjm@kieronmorris.me>)
-  ************************************************
+}
-  * Author: K Morris
-  * Contributors: 
-  ************************************************ }
-
 unit MCE;
 
 interface

src/fault/NCE.pas

@@ -1,12 +1,8 @@
-{ ************************************************
+{ 
-  * Asuro
+	Fault->NCE - No Coprocessor Exception.
-  * Unit: Drivers/ISR7
+	
-  * Description: No Coprocessor Exception
+	@author(Kieron Morris <kjm@kieronmorris.me>)
-  ************************************************
+}
-  * Author: K Morris
-  * Contributors: 
-  ************************************************ }
-
 unit NCE;
 
 interface

src/fault/NMIE.pas

@@ -1,12 +1,8 @@
-{ ************************************************
+{ 
-  * Asuro
+	Fault->NMIE - Non-Maskable Interrupt Exception.
-  * Unit: Drivers/ISR2
+	
-  * Description: Non-Maskable Interrupt Exception
+	@author(Kieron Morris <kjm@kieronmorris.me>)
-  ************************************************
+}
-  * Author: K Morris
-  * Contributors: 
-  ************************************************ }
-
 unit NMIE;
 
 interface

src/fault/OOBE.pas

@@ -1,12 +1,8 @@
-{ ************************************************
+{ 
-  * Asuro
+	Fault->OOBE - Out Of Bounds Exception.
-  * Unit: Drivers/ISR5
+	
-  * Description: Out of Bounds Exception
+	@author(Kieron Morris <kjm@kieronmorris.me>)
-  ************************************************
+}
-  * Author: K Morris
-  * Contributors: 
-  ************************************************ }
-
 unit OOBE;
 
 interface

src/fault/PF.pas

@@ -1,12 +1,8 @@
-{ ************************************************
+{ 
-  * Asuro
+	Fault->PF - Page Fault.
-  * Unit: Drivers/ISR14
+	
-  * Description: Page Fault
+	@author(Kieron Morris <kjm@kieronmorris.me>)
-  ************************************************
+}
-  * Author: K Morris
-  * Contributors: 
-  ************************************************ }
-
 unit PF;
 
 interface

src/fault/SFE.pas

@@ -1,12 +1,8 @@
-{ ************************************************
+{ 
-  * Asuro
+	Fault->SFE - Stack Fault Exception.
-  * Unit: Drivers/ISR12
+	
-  * Description: Stack Fault Exception
+	@author(Kieron Morris <kjm@kieronmorris.me>)
-  ************************************************
+}
-  * Author: K Morris
-  * Contributors: 
-  ************************************************ }
-
 unit SFE;
 
 interface

src/fault/SNPE.pas

@@ -1,12 +1,8 @@
-{ ************************************************
+{ 
-  * Asuro
+	Fault->SNPE - Segment Not Present Exception.
-  * Unit: Drivers/ISR11
+	
-  * Description: Segment Not Present Exception
+	@author(Kieron Morris <kjm@kieronmorris.me>)
-  ************************************************
+}
-  * Author: K Morris
-  * Contributors: 
-  ************************************************ }
-
 unit SNPE;
 
 interface

src/fault/UIE.pas

@@ -1,12 +1,8 @@
-{ ************************************************
+{ 
-  * Asuro
+	Fault->UIE - Unknown Interrupt Exception.
-  * Unit: Drivers/ISR15
+	
-  * Description: Unknown Interrupt Exception
+	@author(Kieron Morris <kjm@kieronmorris.me>)
-  ************************************************
+}
-  * Author: K Morris
-  * Contributors: 
-  ************************************************ }
-
 unit UIE;
 
 interface

src/faults.pas

@@ -1,3 +1,8 @@
+{ 
+	Faults - Fault Registration & Detouring.
+	
+	@author(Kieron Morris <kjm@kieronmorris.me>)
+}
 unit faults;
 
 interface

src/gdt.pas

@@ -1,12 +1,8 @@
-{ ************************************************
+{ 
-  * Asuro
+	Global Descriptor Table - Data Structures & Interface.
-  * Unit: GDT
+	
-  * Description: GDT Structure and Implementation
+	@author(Kieron Morris <kjm@kieronmorris.me>)
-  ************************************************
+}
-  * Author: K Morris
-  * Contributors: A Hance
-  ************************************************ }
-
 unit gdt;
 
 interface

src/idt.pas

@@ -1,12 +1,8 @@
-{ ************************************************
+{ 
-  * Asuro
+	Interrupt Descriptor Table - Structures & Interface.
-  * Unit: IDT
+	
-  * Description: IDT Structure and Implementation
+	@author(Kieron Morris <kjm@kieronmorris.me>)
-  ************************************************
+}
-  * Author: K Morris
-  * Contributors: 
-  ************************************************ }
-
 unit idt;
 
 interface

src/include/asuro.pas

@@ -1,3 +1,8 @@
+{ 
+	Include->Asuro - Auto-Generated Version & Compilation Information
+	
+	@author(Asuro Compilation Script)
+}
 unit asuro;
  
 interface

src/include/bios_data_area.pas

@@ -1,13 +1,8 @@
-{ ************************************************
+{ 
-  * Asuro
+	Include->BIOS_Data_Area - Data Structures Controlled by the BIOS.
-  * Unit: bios_data_area
+	
-  * Description: Data Structures controlled by
+	@author(Kieron Morris <kjm@kieronmorris.me>)
-  *              the BIOS.
+}
-  ************************************************
-  * Author: K Morris
-  * Contributors: 
-  ************************************************ }
-
 unit bios_data_area;
 
 interface

src/include/crc.pas

@@ -1,3 +1,8 @@
+{ 
+	Include->CRC - CRC32 Implementation.
+	
+	@author(Kieron Morris <kjm@kieronmorris.me>)
+}
 unit crc;
 
 interface

src/include/fonts.pas

@@ -1,3 +1,8 @@
+{ 
+	Include->Fonts - Standard Fonts & Font Masks.
+	
+	@author(Kieron Morris <kjm@kieronmorris.me>)
+}
 unit fonts;
 
 interface

src/include/lists.pas

@@ -1,3 +1,8 @@
+{ 
+	Include->Lists - Linked List Data Structures & Helpers.
+	
+	@author(Kieron Morris <kjm@kieronmorris.me>)
+}
 unit lists;
 
 interface

src/include/multiboot.pas

@@ -1,12 +1,8 @@
-{ ************************************************
+{ 
-  * Asuro
+	Include->Multiboot - Multiboot Structures & Access.
-  * Unit: Multiboot
+	
-  * Description: Mutliboot (GRUB) Structures.
+	@author(Kieron Morris <kjm@kieronmorris.me>)
-  ************************************************
+}
-  * Author: K Morris
-  * Contributors: 
-  ************************************************ }
-
 unit multiboot;
  
 interface

src/include/strings.pas

@@ -1,12 +1,8 @@
-{ ************************************************
+{ 
-  * Asuro
+	Include->Strings - String Manipulation.
-  * Unit: Strings
+	
-  * Description: Collection of function for string manipulation.
+	@author(Kieron Morris <kjm@kieronmorris.me>)
-  ************************************************
+}
-  * Author: K Morris
-  * Contributors: 
-  ************************************************ }
-
 unit strings;
 
 interface

src/include/system.pas

@@ -1,12 +1,9 @@
-{ ************************************************
+{ 
-  * Asuro
+	Include->System - Base Types & Structures.
-  * Unit: system
+	
-  * Description: Standard System Types
+	@author(Kieron Morris <kjm@kieronmorris.me>)
-  ************************************************
+	@author(Aaron Hance <ah@aaronhance.me>)
-  * Author: K Morris
+}
-  * Contributors: 
-  ************************************************ }
-
 unit system;
 
 interface

src/include/types.pas

@@ -1,3 +1,8 @@
+{ 
+	Include->Types - Dummy Unit For VM Compatability.
+	
+	@author(Kieron Morris <kjm@kieronmorris.me>)
+}
 unit types;
 
 interface

src/include/util.pas

@@ -1,12 +1,8 @@
-{ ************************************************
+{ 
-  * Asuro
+	Include->Util - Data Manipulation Utlities.
-  * Unit: util
+	
-  * Description: Utilities for data manipulation
+	@author(Kieron Morris <kjm@kieronmorris.me>)
-  ************************************************
+}
-  * Author: K Morris
-  * Contributors: 
-  ************************************************ }
-
 unit util;
 
 {$ASMMODE intel}

src/irq.pas

@@ -1,12 +1,8 @@
-{ ************************************************
+{ 
-  * Asuro
+	Interrupt Request Line - Initialization & Remapping.
-  * Unit: irq
+	
-  * Description: mapping IRQs
+	@author(Aaron Hance <ah@aaronhance.me>)
-  ************************************************
+}
-  * Author: Aaron Hance
-  * Contributors:
-  ************************************************ }
-
 unit irq;
 
 interface

src/isr.pas

@@ -1,12 +1,8 @@
-{ ************************************************
+{ 
-  * Asuro
+	ISR Driver - Initialization (stub).
-  * Unit: isr
+	
-  * Description: Stub for ISR Driver Initialization
+	@author(Kieron Morris <kjm@kieronmorris.me>)
-  ************************************************
+}
-  * Author: K Morris
-  * Contributors: A Hance
-  ************************************************ }
-
 unit isr;
 
 interface

src/isr/isr_types.pas

@@ -1,11 +1,8 @@
-{ ************************************************
+{ 
-  * Asuro
+	ISR->ISR_Types - Interrupt Service Routine Structures.
-  * Unit: Drivers/isr_types
+	
-  * Description: Defines for ISRs (WIP)
+	@author(Kieron Morris <kjm@kieronmorris.me>)
-  ************************************************
+}
-  * Author: K Morris
-  * Contributors: 
-  ************************************************ }
 
 unit isr_types;
 

src/isr/isrmanager.pas

@@ -1,3 +1,8 @@
+{ 
+	ISR->ISRManager - Interrupt Service Routine Registration, Dispatch & Management.
+	
+	@author(Kieron Morris <kjm@kieronmorris.me>)
+}
 unit isrmanager;
 
 interface

src/kernel.pas

@@ -1,12 +1,9 @@
-{ ************************************************
+{ 
-  * Asuro
+	Kernel Main - Main Kernel Entry Point.
-  * Unit: Kernel
+	
-  * Description: Main Entry Point for Asuro
+	@author(Kieron Morris <kjm@kieronmorris.me>)
-  ************************************************
+	@author(Aaron Hance <ah@aaronhance.me>)
-  * Author: K Morris
+}
-  * Contributors: A Hance
-  ************************************************ }
-
 unit kernel;
  
 interface

src/lmemorymanager.pas

@@ -1,12 +1,8 @@
-{ ************************************************
+{ 
-  * Asuro
+	LMemoryManager - Logical Memory Management
-  * Unit: LMemoryManager
+	
-  * Description: Logical Virtual Memory Management
+	@author(Kieron Morris <kjm@kieronmorris.me>)
-  ************************************************
+}
-  * Author: K Morris
-  * Contributors: 
-  ************************************************ }
-
 unit lmemorymanager;
 
 interface

src/pmemorymanager.pas

@@ -1,12 +1,8 @@
-{ ************************************************
+{ 
-  * Asuro
+	PMemoryManager - Physical Memory Management
-  * Unit: PMemoryManager
+	
-  * Description: Physical Memory Management
+	@author(Kieron Morris <kjm@kieronmorris.me>)
-  ************************************************
+}
-  * Author: K Morris
-  * Contributors: 
-  ************************************************ }
-
 unit pmemorymanager;
 
 interface

src/processloader.pas

@@ -1,13 +1,8 @@
-{ ************************************************
+{ 
-  * Asuro
+	ProcessLoader - Process Initialization & Tasking (stub).
-  * Unit: ProcessLoader
+	
-  * Description: Loads a Process and any related
+	@author(Kieron Morris <kjm@kieronmorris.me>)
-  *              structers into memory ready for
+}
-  *              execution.
-  ************************************************
-  * Author: K Morris
-  * Contributors:
-  ************************************************ }
 unit processloader;
 
 interface

src/prog/memview.pas

@@ -1,3 +1,8 @@
+{ 
+	Prog->MemView - Live Memory View.
+	
+	@author(Kieron Morris <kjm@kieronmorris.me>)
+}
 unit memview;
 
 interface

src/prog/netlog.pas

@@ -1,3 +1,8 @@
+{ 
+	Prog->NetLog - Network Driver Logs.
+	
+	@author(Kieron Morris <kjm@kieronmorris.me>)
+}
 unit netlog;
 
 interface

src/prog/shell.pas

@@ -1,3 +1,8 @@
+{ 
+	Prog->Shell - Main Desktop UI.
+	
+	@author(Kieron Morris <kjm@kieronmorris.me>)
+}
 unit shell;
 
 interface

src/prog/splash.pas

@@ -1,3 +1,8 @@
+{ 
+	Prog->Splash - Asuro Splash Screen.
+	
+	@author(Kieron Morris <kjm@kieronmorris.me>)
+}
 unit splash;
 
 interface

src/prog/terminal.pas

@@ -1,12 +1,8 @@
-{ ************************************************
+{ 
-  * Asuro
+	Prog->Terminal - Interactive Command Line Environment.
-  * Unit: Terminal
+	
-  * Description: Interactive shell for the user
+	@author(Kieron Morris <kjm@kieronmorris.me>)
-  ************************************************
+}
-  * Author: K Morris
-  * Contributors: 
-  ************************************************ }
-
 unit terminal;
 
 interface

src/prog/themer.pas

@@ -1,3 +1,8 @@
+{ 
+	Prog->Themer - Live Desktop Color Picker.
+	
+	@author(Kieron Morris <kjm@kieronmorris.me>)
+}
 unit themer;
 
 interface

src/prog/vmlog.pas

@@ -1,3 +1,8 @@
+{ 
+	Prog->VMLog - Virtual Machine Event Log.
+	
+	@author(Kieron Morris <kjm@kieronmorris.me>)
+}
 unit vmlog;
 
 interface

src/prog/vmstate.pas

@@ -1,3 +1,8 @@
+{ 
+	Prog->VMState - Live MINJ Virtual Machine State Information.
+	
+	@author(Kieron Morris <kjm@kieronmorris.me>)
+}
 unit vmstate;
 
 interface

src/scheduler.pas

@@ -1,11 +1,8 @@
-{ ************************************************
+{ 
-  * Asuro
+	Scheduler - Schedules Context Switches.
-  * Unit: Scheduler
+	
-  * Description: Schedules Context Switches
+	@author(Kieron Morris <kjm@kieronmorris.me>)
-  ************************************************
+}
-  * Author: K Morris
-  * Contributors: 
-  ************************************************ }
 
 unit scheduler;
 

src/tracer.pas

@@ -1,3 +1,8 @@
+{ 
+	Tracer - Trace stack for debugging method calls.
+	
+	@author(Kieron Morris <kjm@kieronmorris.me>)
+}
 unit tracer;
 
 interface

src/tss.pas

@@ -1,12 +1,8 @@
-{ ************************************************
+{ 
-  * Asuro
+	TSS - Task State Segment (stub).
-  * Unit: tss
+	
-  * Description: Representation of Kernel Space to
+	@author(Kieron Morris <kjm@kieronmorris.me>)
-  *              Enable System Calls Via Interrupts.
+}
-  ************************************************
-  * Author: K Morris
-  * Contributors:
-  ************************************************ }
 unit tss;
 
 interface

src/vmemorymanager.pas

@@ -1,11 +1,8 @@
-{ ************************************************
+{ 
-  * Asuro
+	VMemoryManager - Virtual Memory Management.
-  * Unit: VMemoryManager
+	
-  * Description: Manages Pages of Virtual Memory
+	@author(Kieron Morris <kjm@kieronmorris.me>)
-  ************************************************
+}
-  * Author: K Morris
-  * Contributors: 
-  ************************************************ }
 
 unit vmemorymanager;