Comments.

diff --git a/src/devices/disk.c b/src/devices/disk.c
index baf120864399f11a8c33ae27f37a41992b413cab..a3f26cfd8a4a2d5d7ade593e07db6d2c73111af7 100644 (file)
--- a/src/devices/disk.c
+++ b/src/devices/disk.c
@@ -8,6 +8,9 @@
 #include "threads/interrupt.h"
 #include "threads/synch.h"
 
+/* The code in this file is an interface to an ATA (IDE)
+   controller.  It attempts to comply to [ATA-3]. */
+
 /* ATA command block port addresses. */
 #define reg_data(CHANNEL) ((CHANNEL)->reg_base + 0)     /* Data. */
 #define reg_error(CHANNEL) ((CHANNEL)->reg_base + 1)    /* Error. */

diff --git a/src/devices/serial.c b/src/devices/serial.c
index 1d0607ba0006b91f3d93770136d596bb3e969e59..8dc7f18cfbd0272b630e0d85c87abf119be23173 100644 (file)
--- a/src/devices/serial.c
+++ b/src/devices/serial.c
@@ -9,7 +9,9 @@
 \f
 /* Register definitions for the 16550A UART used in PCs.
    The 16550A has a lot more going on than shown here, but this
-   is all we need. */
+   is all we need.
+
+   Refer to [PC16650D] for hardware information. */
 
 /* I/O port base address for the first serial port. */
 #define IO_BASE 0x3f8