adventure: Initial commit
[pdp8.git] / sw / adventure / ADVENT.DC
diff --git a/sw/adventure/ADVENT.DC b/sw/adventure/ADVENT.DC
new file mode 100644 (file)
index 0000000..b22f793
--- /dev/null
@@ -0,0 +1,86 @@
+   This version of adventure is based on the RT-11 version\r
+by Bob Supnik. It is essentially a recoding of the FORTRAN-IV\r
+sources into RALF code. The RALF code has been  optimized\r
+to fit into 32K. Also, many modifications were made to\r
+the code to increase execution speed.\r
+\r
+   Because it is based on the RT-11 version of ADVENTURE,\r
+the following features of the FORTRAN-10 version are not\r
+supported:\r
+\r
+1) MAGIC mode was removed\r
+2) The SUSPEND and HOURS commands were deleted\r
+\r
+\r
+   The program requires a secondary storage device with\r
+at least 250 blocks of free space for working storage.\r
+Included with the sources are batch stream files for\r
+compiling and loading the program.\r
+\r
+COMPILATION:\r
+\r
+.SUBMIT COMPILE\r
+\r
+LOADING:\r
+\r
+.SUBMIT LOAD   (this creates a load map - LOAD.LS)\r
+\r
+EXECUTION:\r
+\r
+.R FRTS\r
+*ADVENT.ld     (the ".LD" is optional)\r
+*$             (altmode or escape)\r
+\r
+       execution proceeds.\r
+\r
+   When the program is first started, it prompts for the\r
+locations of database files:\r
+Location of text database (ATEXT.DA) >\r
+Location of text index    (AINDX.DA) >\r
+Location of saved games   (ASAVE.DA) >\r
+Location of text input   (ADVENT.TX) >\r
+\r
+   The value in parenthesis is the default values for those files.\r
+You can place files on other than the current SYS device by giving\r
+the device name and filename, such as RKB0:ADVENT.TX, etc. See\r
+the section below on the ADVENT.IN file for more information on how\r
+to place the database files.\r
+\r
+   When first started, the program will take approximately\r
+two to three minutes to set up its data base (ATEXT and AINDX).\r
+Initialization and execution can be optimized by placing\r
+the data file (DATA) on a different device from the text\r
+file (ADVENT.TX). Also, it is more efficient to have the\r
+load module (ADVENT.LD) on a different device than the\r
+data file (DATA). For a two-drive DECtape system, for\r
+example, put ADVENT.LD and ADVENT.TX on SYS:, and have the\r
+database files written on DTA1:.\r
+i.e.\r
+.R FRTS\r
+*ADVENT\r
+Location of text database (ATEXT.DA) > DTA1:ATEXT.DA\r
+Location of text index    (AINDX.DA) > DTA1:AINDX.DA\r
+Location of saved games   (ASAVE.DA) > ASAVE.DA\r
+Location of text input   (ADVENT.TX) > ADVENT.TX\r
+\r
+\r
+   The ADVENT.TX file is only used to set up the text database.\r
+Once the ATEXT.DA and AINDX.DA files have been built, you can \r
+delete this file as it is not needed for normal program operation.\r
+The file locataion values given during this startup dialog are\r
+stored in a file called ADVENT.IN, which is a simple text file\r
+with KEYWORD=VALUE lines for the four filenames. You can edit\r
+this later to move the files to other devices, or delete the\r
+ADVENT.IN file to completely restart the dialog.\r
+\r
+   To run the program, only the files ADVENT.LD and\r
+ADVENT.TX need to be copied from the distribution tape.\r
+These are the load module and the text file. The rest\r
+of the files are sources.\r
+\r
+\r
+   The SAVE command in Adventure writes the ASAVE.DA file. If the\r
+file already exists, it is overwritten by subsequent SAVE operations.\r
+A saved game is restored using the RESTORE command.\r
+\r
+Good luck and happy adventuring!\r