xref: /csrg-svn/contrib/dungeon/README (revision 35974)
1*35974SbosticThis is a source file distribution for the game dungeon as implemented
2*35974Sbosticin f77 for Unix(R) systems.  It is based on the game dungeon as
3*35974Sbosticdistributed on a DECUS tape, circa 1980.  It has been converted from
4*35974Sbosticthe original DEC FORTRAN into something that is palatable to Unix f77.
5*35974SbosticSee the file "History" for some revision history and credit to those
6*35974Sbosticwhose efforts have made this possible.
7*35974Sbostic
8*35974SbosticCheckout the Makefile and adjust it to fit your system.  The only
9*35974Sbosticthings that should really need tweaking are the directory definitions
10*35974Sbosticand the "-D" defines.  There is an example for both large address
11*35974Sbosticmachines (e.g. Vax) that get the complete game and small address
12*35974Sbosticmachines (e.g. Pdp-11) that get a modified game with minor functionality
13*35974Sbosticmissing (to get it to fit).  Also edit the include file "files.h" if
14*35974Sbosticnecessary.
15*35974Sbostic
16*35974SbosticAll of the f77 files end in a '.F' extension to force f77 to invoke the
17*35974SbosticC preprocessor for the #include files and #ifdefs.  Most of the #ifdefs
18*35974Sbosticare for the PDP version (default non-pdp) and for debug (default off).
19*35974Sbostic
20*35974SbosticExcept for DTEXT.DAT, all files in the distribution kit are ASCII.
21*35974SbosticDTEXT.DAT is a binary file consisting of 76-byte fixed length records.
22*35974Sbostic
23*35974SbosticThis has been compiled and tested on a PDP-11/44 Version 7, PDP-11/70
24*35974Sbostic2.9bsd Vax-11/785 4.3bsd and Sun-3 before the pdp and Vax sources were
25*35974Sbosticmerged (see the file "History").  After the merge it was again tested on
26*35974Sbosticthe Vax 11-785 4.3bsd.
27*35974Sbostic
28*35974SbosticI/we consider my/our changes to be in the public domain.  The original
29*35974Sbosticsource, however, is copyright.
30*35974Sbostic
31*35974Sbostic	John Gilmore, Nebula Consultants
32*35974Sbostic	hoptoad!gnu
33*35974Sbostic	11 December 1986
34*35974Sbostic
35*35974Sbostic	Bill Randle
36*35974Sbostic	Tektronix, Inc.
37*35974Sbostic	billr@tekred.TEK.COM
38*35974Sbostic	9 February 1987
39*35974Sbostic
40*35974SbosticDungeon consists of the following files:
41*35974Sbostic
42*35974Sbostic	dmain.F			-program root
43*35974Sbostic	dgame.F			-main routine
44*35974Sbostic	dsub.F			-resident subroutines
45*35974Sbostic	dinit.F			-initialization routine
46*35974Sbostic	np.F			-parser, part 0
47*35974Sbostic	np1.F			-parser, part 1
48*35974Sbostic	np2.F			-parser, part 2
49*35974Sbostic	np3.F			-parser, part 3
50*35974Sbostic	gdt.F			-game debugging tool
51*35974Sbostic	verbs.F			-principal verbs
52*35974Sbostic	objcts.F		-principal objects
53*35974Sbostic	sverbs.F		-simple verbs
54*35974Sbostic	dverb1.F		-auxiliary verbs, part 1
55*35974Sbostic	dverb2.F		-auxiliary verbs, part 2
56*35974Sbostic	actors.F		-character processors
57*35974Sbostic	demons.F		-demon processors
58*35974Sbostic	clockr.F		-clock event processors
59*35974Sbostic	rooms.F			-room processors
60*35974Sbostic	nrooms.F		-new room processors
61*35974Sbostic	sobjs.F			-simple objects
62*35974Sbostic	nobjs.F			-new objects
63*35974Sbostic	ballop.F		-balloon processor
64*35974Sbostic	lightp.F		-light processors
65*35974Sbostic	villns.F		-villain processors
66*35974Sbostic	dso1.F			-overlaid subroutines, part 1
67*35974Sbostic	dso2.F			-overlaid subroutines, part 2
68*35974Sbostic	dso3.F			-overlaid subroutines, part 3
69*35974Sbostic	dso4.F			-overlaid subroutines, part 4
70*35974Sbostic	dso5.F			-overlaid subroutines, part 5
71*35974Sbostic	dso6.F			-overlaid subroutines, part 6
72*35974Sbostic	dso7.F			-overlaid subroutines, part 7
73*35974Sbostic	advers.h		-header file
74*35974Sbostic	clock.h			-header file
75*35974Sbostic	curxt.h			-header file
76*35974Sbostic	debug.h			-header file
77*35974Sbostic	exits.h			-header file
78*35974Sbostic	files.h			-header file for directory paths
79*35974Sbostic	flags.h			-header file
80*35974Sbostic	gamestate.h		-header file
81*35974Sbostic	io.h			-header file
82*35974Sbostic	objects.h		-header file
83*35974Sbostic	oflags.h		-header file
84*35974Sbostic	oindex.h		-header file
85*35974Sbostic	parser.h		-header file
86*35974Sbostic	puzzle.h		-header file
87*35974Sbostic	rflag.h			-header file
88*35974Sbostic	rindex.h		-header file
89*35974Sbostic	rooms.h			-header file
90*35974Sbostic	screen.h		-header file
91*35974Sbostic	state.h			-header file
92*35974Sbostic	verbs.h			-header file
93*35974Sbostic	villians.h		-header file
94*35974Sbostic	vocab.h			-header file
95*35974Sbostic	xpars.h			-header file
96*35974Sbostic	xsrch.h			-header file
97*35974Sbostic	cinit.c			-C routine to initialize game [pdp ver]
98*35974Sbostic	cio.c			-C routine for misc i/o [pdp version]
99*35974Sbostic	rtim.c			-C routines for system dependent functions
100*35974Sbostic	listen.c		-C co-process for reading keyboard [pdp]
101*35974Sbostic	cspeak.c		-C co-process for displaying messages [pdp]
102*35974Sbostic	speak.F			-lookup messages for speak process [pdp]
103*35974Sbostic	decode.c		-C routine to decode binary text file [debug]
104*35974Sbostic	dindx.dat		-initialization data base
105*35974Sbostic	dtext.dat		-main data base [binary file]
106*35974Sbostic	rtext.dat		-message index file [pdp version]
107*35974Sbostic	dungeon.sh		-shell script to invoke pdp version
108*35974Sbostic	dungeon.doc		-original documentation file
109*35974Sbostic	dungeon.6		-man page abstracted from dungeon.doc
110*35974Sbostic	Makefile		-Makefile for making pdp or vax versions
111*35974Sbostic	History			-Some revision history notes
112*35974Sbostic	PDP.doc			-Notes on the PDP-11/Unix conversion
113*35974Sbostic	README			-This file
114