Rename the files to be more descriptive

Author: mengstr

Makefile

@@ -1,75 +1,35 @@
-# make a PDP-8 emulator
 #
-# Instructions:
-#
-#   1, configure your emulator by editing this file, as directed below.
-#   2, make.
-#   3, make coredump if you want symbolic dumps of saved memory images.
-#   4, make coremake if you want to convert RIM binaries to memory images.
-#   5, make clean to remove compilation temporaries.
-
-
-##########################################################################
-#
-# Machine Configuration Section:
-#
-#   In effect, the skeleton of the emulator is an omnibus, into which you
-#   plug a number of option boards for I/O devices and other machine
-#   components.
-#
-#   RULE:  To select an option, follow the directions.
-#          If, on real hardware, you'd have to jumper something on the
-#          circuit board, then you must edit the source file for the
-#          option and select the jumperable feature there.
-
-
-#---- exactly one of the following definition pairs must be uncommented
-
-# KK8E -- the PDP-8/E CPU, M8300, M8310, M8320
-#cpu =   kk8e.o
-#CPU = -DKK8E
-
 # KK8E with debug support -- the above hardware with an added trace package
-cpu =   kk8e.o debug.o
-CPU = -DKK8E -DDEBUG
-
-
-#---- exactly one of the following definition triplets must be uncommented
-
+#
 # KC8M -- PDP-8/M Simple (non-visual) TTY oriented control panel
-console =   kc8m.o
-CONSOLE = -DKC8M
-conslib =
-
-
-#---- any of the following internal options may be selected by including
-#     their names in the definitions of intern and INTERN.
-
+#
 # KM8E -- Extended Memory and Time Share Option, M837
 #	    without this option, the machine may only address 4K of memory.
 #	    with this option, the machine may address 32K of memory.
-
+#
 # DK8E -- Real-Time Clock, M882 or M8830
 #           the interrupt rate is selectable by editing dk8e.c
-
-intern =  km8e.o dk8e.o
-INTERN = -DKM8E -DDK8E
-
-
-#---- any of the following external options may be selected by including
-#     their names in the defintions of extern and EXTERN.
-
+#
 # KL8E -- Asynchronous Console Interface, M8650
 #           the baud rate is selectable by editing kl8e.c
-
+#
 # PC8E -- Paper-Tape Reader-Punch, M840
+#
+# CR8F -- CR8F Card reader and Control
+#
+# RX8E -- RX01 diskette drive, M8357 interface
+#
 
+cpu = main.o debug.o
+CPU = -DKK8E -DDEBUG
 
-# CR8F -- CR8F Card reader and Control
+console = frontpanel-kc8m.o
+CONSOLE = -DKC8M
 
-# RX8E -- RX01 diskette drive, M8357 interface
+intern =  mem-km8e.o rtc-dk8e.o
+INTERN = -DKM8E -DDK8E
 
-extern = kl8e.o pc8e.o cr8f.o rx8e.o
+extern = tty-kl8e.o hstape-pc8e.o card-cr8f.o floppy-rx8e.o
 EXTERN = -DKL8E -DPC8E -DCR8F -DRX8E
 
 

README.md

@@ -1,7 +1,30 @@
-# Console-based PDP-8 emulator
+# Console-based PDP-8 emulator ![C/C++ CI](https://github.com/SmallRoomLabs/pdp8emu/workflows/C/C++%20CI/badge.svg)
+
 This PDP8 Emulator was originally written by Douglas W. Jones at the University of Iowa back in 1995.
 
 It has now been converted from K&R style real UNIX targeted code into a more modern C99 compatible POSIX codebase with a few bugs and "syntax errors" fixed
 
-![C/C++ CI](https://github.com/SmallRoomLabs/pdp8emu/workflows/C/C++%20CI/badge.svg)
 
+## Files
+```
+original/         - Original files from 1995
+Makefile          - Used by make, contains the emulator configuration
+README.md         - This file
+
+main.c		      - CPU
+mem-km8e.c        - Memory manager
+tty-kl8e.c        - Console interface
+frontpanel-kc8m.c - Front panel (minimal function, dumb terminal)
+rtc-dk8e.c		  - Real time clock option
+hstape-pc8e.c     - Paper-tape reader/punch
+card-cr8f.c       - Card reader
+floppy-rx8e.c     - RX01 floppy disk interface
+bus.h             - Contains definitions all "boards" share
+debug.c           - A makefile-selectable debugging aid
+realtime.c        - Internal mechanisms to keep track of time
+ttyaccess.c       - Internal mechanisms for terminal interface
+utility.c         - Internal mechanisms for command-line interface
+
+coredump.c        - A utility - prints an octal dump of a saved core image.
+coremake.c        - A utility - loads a RIM file into a core image.
+```

cr8f.c renamed to card-cr8f.c

@@ -15,7 +15,7 @@
 #include "realtime.h"
 #include "bus.h"
 #include "utility.h"
-#include "kc8m.h"
+#include "frontpanel-kc8m.h"
 
 
 #define read_time ( 1 * millisecond)

cr8f.h renamed to card-cr8f.h

@@ -17,7 +17,7 @@
 #include "realtime.h"
 #include "bus.h"
 #include "utility.h"
-#include "kc8m.h"
+#include "frontpanel-kc8m.h"
 
 /***********/
 /* formats */

rx8e.c renamed to floppy-rx8e.c

@@ -13,7 +13,7 @@
 #include "realtime.h"
 #include "bus.h"
 #include "utility.h"
-#include "kc8m.h"
+#include "frontpanel-kc8m.h"
 
 /***********/
 /* options */