*** empty log message ***

[h316.git] / README

diff --git a/README b/README
new file mode 100644 (file)
index 0000000..43412cc
--- /dev/null
+++ b/README
@@ -0,0 +1,67 @@
+Philipp Hachtmann's Honeywell H316 development kit
+
+This package is made by Philipp Hachtmann (hachti@hachti.de)
+A fresh snapshot can always be found on http://h316.hachti.de
+
+
+How to use:
+===========
+
+This is approved working on my two Linux PCs.
+You need a "normal" gcc and gnumake etc. bla bla.
+
+Bob Supnik's SIMH simulator must be installed.
+SIMH from rev. 3.6 works fine.
+Older versions have a severe bug, don't use them.
+If you like SIMH consider compiling it with 
+libreadline support - see the SIMH makefile....
+You get SIMH at http://simh.trailing.edge.com
+
+- Extract the archive (You have already done that...)
+- Set following environment variables:
+    export H316=<full path to the directory containing this file>
+    export PATH=$PATH:$H316/bin
+    And you need to have the SIMH h316 binary in your $PATH.
+- Enter the $H316 directory and run make.
+- If there's no error you can start to look around in the tree. 
+  Everything is fine and ready to use.
+ 
+If there's an error try to correct it or feel free to ask me.
+
+All libraries are built when you run make. Precompiled (original)
+stuff is only found in directories called "original" or "obj".
+Everything else is always rebuilt.
+The IO library works with my private line printer interface. 
+So don't get frustrated when you try the routines in SIMH - they
+won't work as expected. 
+If you have some original library routines from Honeywell - please
+let me know! I am looking for tape drivers, the original line
+printer driver etc.
+
+If you have set up everything look for the mandelbrot program.
+It's somewhere out there....
+Try to compile it with the genious command "frtn <source-file>".
+Then you have a Honeywell Object. Now exec it by calling
+frun <object-file>. There is also an asm command.
+Try it out and read the scripts in $H316/bin for enlightment!
+
+Libraries are built with some scripts contained in the appropriate
+subdirectories. There's a kind of receipe file for every 
+library to build. Works fine, try it out!
+
+So, if there are questions, please ask me.
+
+Best regards,
+
+Philipp :-)
+
+
+
+
+
+
+
+
+
+
+