1 files changed, 3 insertions, 3 deletions
diff --git a/x86.h b/x86.h
index 1ef79cb..2ac51e5 100644
--- a/x86.h
+++ b/x86.h
@@ -1,5 +1,4 @@
-// Special assembly routines to access x86-specific
-// hardware instructions.
+// Routines to let C code use special x86 instructions.
 
 static inline uchar
 inb(ushort port)
@@ -131,7 +130,8 @@ sti(void)
   asm volatile("sti");
 }
 
-// Layout of the trap frame on the stack upon entry to trap.
+// Layout of the trap frame built on the stack by the
+// hardware and by trapasm.S, and passed to trap().
 struct trapframe {
   // registers as pushed by pusha
   uint edi;