From 2b9bf71448b77ca8a18edf4baba59d3658f9a1d0 Mon Sep 17 00:00:00 2001 From: Ross Wilson Date: Tue, 1 Dec 2015 15:31:08 +0700 Subject: [PATCH] Move to RST README files --- README.md => README.rst | 141 ++++++++++++++++++++-------------------- vimlac/CPU.test | 10 +++ 2 files changed, 82 insertions(+), 69 deletions(-) rename README.md => README.rst (59%) diff --git a/README.md b/README.rst similarity index 59% rename from README.md rename to README.rst index e0548a0..0e12c5f 100644 --- a/README.md +++ b/README.rst @@ -1,4 +1,5 @@ -##STATUS +STATUS +====== Development is occurring mainly in the *pymlac* subdirectory. Occasionally the python code is mirrored into the *vimlac* subdirectory (translated to C). @@ -7,10 +8,11 @@ The current state is the CPU testing is nearing completion. That is, all of the pure-CPU instructions are tested and working. I/O instructions and conditionals on device state are being tested at the moment. -##The Imlac +The Imlac +========= When I was doing post-graduate study at Sydney University one fun machine I -worked on was an [Imlac PDS-4](http://en.wikipedia.org/wiki/Imlac_PDS-1). +worked on was an `Imlac PDS-4 `_ . This was a 16 bit vector graphics minicomputer with a general purpose main CPU and a specialised display CPU - all implemented with 7400 series chips. It had @@ -19,7 +21,7 @@ on it acquired 8-inch floppy drives but few people used these as they were too unreliable. Besides, there's just something about papertape! The attraction of the machine was its simplicity, its graphics capability and -that it ran [Spacewar!](http://en.wikipedia.org/wiki/Spacewar!) I have many +that it ran `Spacewar! `_ I have many fond memories of this machine. It was the first machine that I programmed in assembler. @@ -28,12 +30,12 @@ No one knows what happened to it. There is a little information online: -* Tom Uban's [Imlac picture gallery](http://www.ubanproductions.com/imlac.html) and [software library](http://www.ubanproductions.com/imlac_sw.html) -* The [Blinkenlights](http://www.blinkenlights.com/classiccmp/imlac/) archive of Imlac information -* Imlac at [old-computers.com](http://www.old-computers.com/museum/computer.asp?st=1&c=1295) -* Inevitably, there is an [Imlac Facebook page](http://www.facebook.com/pages/Imlac-PDS-1/124593560918139) -* A working Imlac emulator is [here](http://rottedbits.blogspot.com/2013/05/an-introduction-to-imlac-pds-1.html) -* Some information from [chilton-computing.org.uk](http://www.chilton-computing.org.uk/acd/icf/terminals/p008.htm) +* Tom Uban's `Imlac picture gallery `_ and `software library `_ +* The `Blinkenlights `_ archive of Imlac information +* Imlac at `old-computers.com `_ +* Inevitably, there is an `Imlac Facebook page `_ +* A working Imlac emulator is `here `_ +* Some information from `chilton-computing.org.uk `_ It's a little sad to see this machine fade from memory. I wrote an emulator for the Imlac in C with an X display window quite a while ago, but didn't proceed @@ -41,7 +43,8 @@ with it, possibly because it would only run on Linux. Now I would like to experiment with a rewrite in Python and use wxPython or pySide for the graphics. This repository holds the code. -###Overview +Overview +-------- The Imlac was a simple machine that was driven in the old style: the user sat at the screen and loaded a papertape, set the PC address and then pressed the RUN @@ -62,71 +65,63 @@ right. These operations are things such as loading a papertape into the reader, examining memory contents, setting the data switches or setting the machine run address. -###Console usage +Console usage +------------- The console version of pymlac is used: -``` -pymlac [