Add -g flag for source file debugging.
[unix-history] / usr / src / contrib / dungeon / README
CommitLineData
34753252
KB
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