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