global: Corrected absolute paths in bin/ symbolic links

[h316.git] / README

diff --git a/README b/README
index 43412cc2e220d9051cf12e5254f0236e9dd55154..6fef93bc3605db19463f2c079795b0c62550fd36 100644 (file)
--- a/README
+++ b/README
@@ -10,18 +10,19 @@ How to use:
 This is approved working on my two Linux PCs.
 You need a "normal" gcc and gnumake etc. bla bla.
 
 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.
+Bob Supnik's SIMH simulator must be installed and the
+h316 executable must be in the path.

 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
 
 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
 

+What to do:

 - 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
 - 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.
 - 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.


@@ -29,18 +30,18 @@ You get SIMH at http://simh.trailing.edge.com
 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)
 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.
+stuff is found in directories called "original" or "obj".
+Most other stuff is rebuilt by a make run.

 The IO library works with my private line printer interface. 
 So don't get frustrated when you try the routines in SIMH - they
 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. 
+**won't** work! 

 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....
 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>".
+Try to compile it with the  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!
 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!


@@ -49,6 +50,17 @@ 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!
 
 subdirectories. There's a kind of receipe file for every 
 library to build. Works fine, try it out!
 

+And don't forget to try out the ldc program.
+ldc <obj-file>|<library-file>
+It's an object checker. A bit like nm on unix machines.
+If you have unknown or unchecked library or 
+object tapes - you will LOVE it!!!
+
+An important hint: There's a PAL-AP replacement flying around here.
+It's called binal. The super3.slst contains binal, not PAL-AP.
+Binal stores information in binary code, no silent code.
+It also ONLY supports the PTR and PTP devices, no ASR booting!
+

 So, if there are questions, please ask me.
 
 Best regards,
 So, if there are questions, please ask me.
 
 Best regards,


@@ -56,7 +68,7 @@ Best regards,
 Philipp :-)
 
 
 Philipp :-)
 
 

-
+... make clean works, too.