From 49d475d534a11ea27e03c1c6a32c869ae51d6b12 Mon Sep 17 00:00:00 2001
From: Peter Evans <pevans@activecampaign.com>
Date: Mon, 1 Jan 2018 17:41:15 -0600
Subject: [PATCH] Documentation

---
 src/apple2.draw.c | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/src/apple2.draw.c b/src/apple2.draw.c
index 6766177..b68df89 100644
--- a/src/apple2.draw.c
+++ b/src/apple2.draw.c
@@ -4,6 +4,12 @@
 
 #include "apple2.h"
 
+/*
+ * These are the color codes for the lo-res colors that are available.
+ * Each pixel in lo-res indicates one color. These are colors I found
+ * somewhere online -- I'm not sure if they are exact matches, and are
+ * subject to change.
+ */
 static int lores_colors[][3] = {
     { 0x00, 0x00, 0x00 },   // black
     { 0xff, 0x28, 0x97 },   // magenta
@@ -23,6 +29,10 @@ static int lores_colors[][3] = {
     { 0xff, 0xff, 0xff },   // white
 };
 
+/*
+ * Draw a pixel on screen at the given address.
+ * FIXME: we do not draw anything D:
+ */
 void
 apple2_draw_pixel(apple2 *mach, vm_16bit addr)
 {
@@ -72,6 +82,9 @@ apple2_draw_pixel_lores(apple2 *mach, vm_16bit addr)
     vm_screen_draw_rect(mach->screen, &loc);
 }
 
+/*
+ * Draw the character indicated by the given address.
+ */
 void
 apple2_draw_text(apple2 *mach, vm_16bit addr)
 {