A large commit.
[pdp8.git] / sw / adventure / 0906 / ADVENT.DC
CommitLineData
84b5715c
PH
1 This version of adventure is based on the RT-11 version\r
2by Bob Supnik. It is essentially a recoding of the FORTRAN-IV\r
3sources into RALF code. The RALF code has been optimized\r
4to fit into 32K. Also, many modifications were made to\r
5the code to increase execution speed.\r
6\r
7 Because it is based on the RT-11 version of ADVENTURE,\r
8the following features of the FORTRAN-10 version are not\r
9supported:\r
10\r
111) MAGIC mode was removed\r
122) The SUSPEND and HOURS commands were deleted\r
13\r
14\r
15 The program requires a secondary storage device with\r
16at least 250 blocks of free space for working storage.\r
17Included with the sources are batch stream files for\r
18compiling and loading the program.\r
19\r
20COMPILATION:\r
21\r
22.SUBMIT COMPILE\r
23\r
24LOADING:\r
25\r
26.SUBMIT LOAD (this creates a load map - LOAD.LS)\r
27\r
28EXECUTION:\r
29\r
30.R FRTS\r
31*ADVENT.ld (the ".LD" is optional)\r
32*$ (altmode or escape)\r
33\r
34 execution proceeds.\r
35\r
36 When the program is first started, it prompts for the\r
37locations of database files:\r
38Location of text database (ATEXT.DA) >\r
39Location of text index (AINDX.DA) >\r
40Location of saved games (ASAVE.DA) >\r
41Location of text input (ADVENT.TX) >\r
42\r
43 The value in parenthesis is the default values for those files.\r
44You can place files on other than the current SYS device by giving\r
45the device name and filename, such as RKB0:ADVENT.TX, etc. See\r
46the section below on the ADVENT.IN file for more information on how\r
47to place the database files.\r
48\r
49 When first started, the program will take approximately\r
50two to three minutes to set up its data base (ATEXT and AINDX).\r
51Initialization and execution can be optimized by placing\r
52the data file (DATA) on a different device from the text\r
53file (ADVENT.TX). Also, it is more efficient to have the\r
54load module (ADVENT.LD) on a different device than the\r
55data file (DATA). For a two-drive DECtape system, for\r
56example, put ADVENT.LD and ADVENT.TX on SYS:, and have the\r
57database files written on DTA1:.\r
58i.e.\r
59.R FRTS\r
60*ADVENT\r
61Location of text database (ATEXT.DA) > DTA1:ATEXT.DA\r
62Location of text index (AINDX.DA) > DTA1:AINDX.DA\r
63Location of saved games (ASAVE.DA) > ASAVE.DA\r
64Location of text input (ADVENT.TX) > ADVENT.TX\r
65\r
66\r
67 The ADVENT.TX file is only used to set up the text database.\r
68Once the ATEXT.DA and AINDX.DA files have been built, you can \r
69delete this file as it is not needed for normal program operation.\r
70The file locataion values given during this startup dialog are\r
71stored in a file called ADVENT.IN, which is a simple text file\r
72with KEYWORD=VALUE lines for the four filenames. You can edit\r
73this later to move the files to other devices, or delete the\r
74ADVENT.IN file to completely restart the dialog.\r
75\r
76 To run the program, only the files ADVENT.LD and\r
77ADVENT.TX need to be copied from the distribution tape.\r
78These are the load module and the text file. The rest\r
79of the files are sources.\r
80\r
81\r
82 The SAVE command in Adventure writes the ASAVE.DA file. If the\r
83file already exists, it is overwritten by subsequent SAVE operations.\r
84A saved game is restored using the RESTORE command.\r
85\r
86Good luck and happy adventuring!\r