documentation!

Makefile

@@ -9,7 +9,7 @@ asm_obj := $(patsubst src/arch/$(arch)/%.asm, build/$(arch)/%.o, $(asm_src))
 linker_script := src/arch/$(arch)/linker.ld
 grub_cfg := src/arch/$(arch)/grub.cfg
 
-.PHONY: all clean run iso
+.PHONY: all clean run iso doc
 
 all: $(kernel)
 
@@ -41,3 +41,6 @@ $(rs_kernel):
 build/$(arch)/%.o: src/arch/$(arch)/%.asm
 	@mkdir -p $(shell dirname $@)
 	nasm -felf64 $< -o $@
+
+doc:
+	cargo rustdoc --lib -- --no-defaults --passes collapse-docs --passes unindent-comments --passes strip-priv-imports

src/arch/mod.rs

@@ -1 +1,3 @@
-pub mod x86_64;
+//! Architecture-specific code.
+
+pub mod x86_64;

src/arch/x86_64/device/mod.rs

@@ -1 +1,3 @@
+//! Device drivers for devices that *all x86_64 processors* have.
+
 pub mod vga_console;

src/arch/x86_64/device/vga_console.rs

@@ -1,3 +1,5 @@
+//! A basic console driver, using the VGA text-mode buffer.
+
 use core::fmt;
 use core::ptr::Unique;
 use spin::Mutex;

src/lib.rs

@@ -17,8 +17,8 @@ use arch::x86_64::device::vga_console;
 #[no_mangle]
 pub extern fn kernel_main() {
     //////////// !!! WARNING !!! ////////////
-    // WE HAVE AN EXTREMELY SMALL STACK    //
-    // AND NO GUARD PAGE                   //
+    // THE STACK IS LARGER NOW, BUT        //
+    // WE STILL HAVE NO GUARD PAGE         //
     /////////////////////////////////////////
 
     vga_console::WRITER.lock().clear_screen();

src/macros.rs

@@ -1,3 +1,6 @@
+//! Internal macros used by the kernel
+//! (*e.g.* our implementation of `print!`/`println!`).
+
 use core::fmt;
 
 #[macro_export]