4 files changed, 13 insertions, 26 deletions
diff --git a/arch/riscv64/gen/asm-offsets.c b/arch/riscv64/gen/asm-offsets.c
index 8251500..fbe2726 100644
--- a/arch/riscv64/gen/asm-offsets.c
+++ b/arch/riscv64/gen/asm-offsets.c
@@ -1,6 +1,6 @@
 /**
  * @file asm-offsets.c
- * riscv64 file used to generate offsets to register slots in stack. See \ref
+ * riscv64 file used to generate offsets to register slots in stack. Used by
  * _save_context.
  */
 
diff --git a/arch/riscv64/include/types.h b/arch/riscv64/include/types.h
index 8cb41bf..de7a85f 100644
--- a/arch/riscv64/include/types.h
+++ b/arch/riscv64/include/types.h
@@ -9,7 +9,10 @@
 
 #include <apos/types.h>
 
+/** Virtual memory address. */
 typedef uintptr_t vm_t;
+
+/** Physical memory address. */
 typedef uintptr_t pm_t;
 
 #endif /* APOS_RISCV_TYPES_H */
diff --git a/arch/riscv64/kernel/pages.h b/arch/riscv64/kernel/pages.h
index 3f4b632..cb7ca88 100644
--- a/arch/riscv64/kernel/pages.h
+++ b/arch/riscv64/kernel/pages.h
@@ -6,44 +6,28 @@
  * riscv64-specific shorthands for some page sizes.
  */
 
-/**
- * riscv64 4KiB page, order 0.
- */
+/** riscv64 4KiB page, order 0. */
 #define MM_KPAGE      MM_O0
 
-/**
- * riscv64 2MiB page, order 1.
- */
+/** riscv64 2MiB page, order 1. */
 #define MM_MPAGE      MM_O1
 
-/**
- * riscv64 1GiB page, order 2.
- */
+/** riscv64 1GiB page, order 2. */
 #define MM_GPAGE      MM_O2
 
-/**
- * riscv64 512GiB page, order 3.
- */
+/** riscv64 512GiB page, order 3. */
 #define MM_TPAGE      MM_O3
 
-/**
- * riscv64 4KiB page size.
- */
+/** riscv64 4KiB page size. */
 #define MM_KPAGE_SIZE SZ_4K
 
-/**
- * riscv64 2MiB page size.
- */
+/** riscv64 2MiB page size. */
 #define MM_MPAGE_SIZE SZ_2M
 
-/**
- * riscv64 1GiB page size.
- */
+/** riscv64 1GiB page size. */
 #define MM_GPAGE_SIZE SZ_1G
 
-/**
- * riscv64 512GiB page size.
- */
+/** riscv64 512GiB page size. */
 #define MM_TPAGE_SIZE SZ_512G
 
 #endif /* APOS_RISCV_PAGES_H */
diff --git a/arch/riscv64/kernel/regs.h b/arch/riscv64/kernel/regs.h
index 511934e..97bb17e 100644
--- a/arch/riscv64/kernel/regs.h
+++ b/arch/riscv64/kernel/regs.h
@@ -3,7 +3,7 @@
 
 /**
  * @file regs.h
- * riscv64 registers, currently only base extension integer regs. Used to \ref
+ * riscv64 registers, currently only base extension integer regs. Used in
  * _save_context. Used in \ref arch/riscv64/gen/asm-offsets.c to generate a list
  * of offsets usable from assembly.
  *