From dab82edfc8db4f9d50d154d599aadebc412c1e7c Mon Sep 17 00:00:00 2001
From: Paul Gardner-Stephen <paul@servalproject.org>
Date: Wed, 17 Apr 2019 05:03:13 +0930
Subject: [PATCH] add more routine descriptions, begin documenting why each is
 needed

---
 c64/kernal/ffe7.s       | 3 +++
 c64/kernal/ffea.s       | 4 ++++
 c64/kernal/ffed.s       | 4 ++++
 c64/kernal/fff0.s       | 6 ++++++
 c64/kernal/fffa.interop | 2 ++
 c64/kernal/fffc.interop | 2 ++
 c64/kernal/fffe.interop | 2 ++
 7 files changed, 23 insertions(+)
 create mode 100644 c64/kernal/ffe7.s
 create mode 100644 c64/kernal/ffea.s
 create mode 100644 c64/kernal/ffed.s
 create mode 100644 c64/kernal/fff0.s
 create mode 100644 c64/kernal/fffa.interop
 create mode 100644 c64/kernal/fffc.interop
 create mode 100644 c64/kernal/fffe.interop

diff --git a/c64/kernal/ffe7.s b/c64/kernal/ffe7.s
new file mode 100644
index 00000000..bc592967
--- /dev/null
+++ b/c64/kernal/ffe7.s
@@ -0,0 +1,3 @@
+; $FFE7 - Close all files vector
+; (http://codebase64.org/doku.php?id=base:kernalreference)
+	.word close_all_files
diff --git a/c64/kernal/ffea.s b/c64/kernal/ffea.s
new file mode 100644
index 00000000..e8fae8ab
--- /dev/null
+++ b/c64/kernal/ffea.s
@@ -0,0 +1,4 @@
+; $FFEA - Update jiffy clock vector
+; (http://codebase64.org/doku.php?id=base:kernalreference)
+
+	.word update_jiffy_clock
diff --git a/c64/kernal/ffed.s b/c64/kernal/ffed.s
new file mode 100644
index 00000000..ec5ee7e4
--- /dev/null
+++ b/c64/kernal/ffed.s
@@ -0,0 +1,4 @@
+; $FFED - Return screen size (X=columns, Y=rows)
+; (http://codebase64.org/doku.php?id=base:kernalreference)
+
+	.word get_screen_size
diff --git a/c64/kernal/fff0.s b/c64/kernal/fff0.s
new file mode 100644
index 00000000..099d6a18
--- /dev/null
+++ b/c64/kernal/fff0.s
@@ -0,0 +1,6 @@
+; $FFF0 - Get/Set cursor location vector
+; (http://codebase64.org/doku.php?id=base:kernalreference)
+; To set: C=0, to get, C=1
+; X=row, Y=column
+
+	.word plot
diff --git a/c64/kernal/fffa.interop b/c64/kernal/fffa.interop
new file mode 100644
index 00000000..e843b09c
--- /dev/null
+++ b/c64/kernal/fffa.interop
@@ -0,0 +1,2 @@
+# Find a programm that requires working NMIs / RESTORE key use
+
diff --git a/c64/kernal/fffc.interop b/c64/kernal/fffc.interop
new file mode 100644
index 00000000..b9d3335b
--- /dev/null
+++ b/c64/kernal/fffc.interop
@@ -0,0 +1,2 @@
+# No program will work without a working CPU reset vector
+*
diff --git a/c64/kernal/fffe.interop b/c64/kernal/fffe.interop
new file mode 100644
index 00000000..78244bad
--- /dev/null
+++ b/c64/kernal/fffe.interop
@@ -0,0 +1,2 @@
+# No program will work without a working CPU IRQ vector
+*