dungeon.doc

早期freebsd实现

To:	Dungeon Players
From:	"The Translator"
Subj:	Game Information
Date:	8-OCT-80, 6-dec-85


This is the first (and last) source release of the PDP-11 version of 
Dungeon.

Please note that Dungeon has been superceded by the game ZORK(tm).
The following is an extract from the new product announcement for
ZORK in the September, 1980 issue of the RT-11 SIG newsletter:

  "'ZORK:  The Great Underground Empire - Part I' ...was developed
   by the original authors based on their ZORK (Dungeon) game for
   the PDP-10.  It features a greatly improved parser;  command
   input and transcript output files;  SAVEs to any device and
   file name;  and adaptation to different terminal types,
   including a status line on VT100s.  Note:  this is not the
   FORTRAN version that has been available through DECUS.  This
   version has been completely rewritten to run efficiently on
   small machines - up to 10 times as fast as the DECUS version.

   ...ZORK runs under RT-ll, HT-ll, or RSTS/E and requires as
   little as 20K words of memory and a single floppy disk drive.
   The game package, consisting of an RX01-format diskette and
   an instruction booklet, is available from Infocom, Inc.,
   P.O. Box 120, Kendall Station, Cambridge, Ma. 02142."

ZORK(tm) is a trademark of Infocom, Inc.  It is available for several
popular personal computers as well as for the PDP-ll.


1.  Components

Dungeon is a maze-solving game for solitaire play.  It runs on any PDP-11
(with 28KW of memory or more) or VAX-11.

The following compile and run information does not apply to the
f77/Unix implementation.  See the README file for information on
compilation.

Dungeon consists of the following files:


	all operating systems
	---------------------

	DMAIN.FTN			-program root
	DGAME.FTN			-main routine
	DSUB.FTN			-resident subroutines
	DINIT.FTN			-initialization routine
	NP.FOR				-parser, part 0
	NP1.FOR				-parser, part 1
	NP2.FOR				-parser, part 2
	NP3.FOR				-parser, part 3
	GDT.FTN				-game debugging tool
	VERBS.FTN			-principal verbs
	OBJCTS.FTN			-principal objects
	SVERBS.FTN			-simple verbs
	DVERB1.FTN			-auxiliary verbs, part 1
	DVERB2.FTN			-auxiliary verbs, part 2
	all operating systems (continued)
	---------------------------------

	ACTORS.FTN			-character processors
	DEMONS.FTN			-demon processors
	CLOCKR.FTN			-clock event processors
	ROOMS.FOR			-room processors
	NROOMS.FOR			-new room processors
	SOBJS.FOR			-simple objects
	NOBJS.FOR			-new objects
	BALLOP.FOR			-balloon processor
	LIGHTP.FOR			-light processors
	VILLNS.FOR			-villain processors
	DSO1.FOR			-overlaid subroutines, part 1
	DSO2.FOR			-overlaid subroutines, part 2
	DSO3.FOR			-overlaid subroutines, part 3
	DSO4.FOR			-overlaid subroutines, part 4
	DSO5.FOR			-overlaid subroutines, part 5
	DSO6.FOR			-overlaid subroutines, part 6
	DSO7.FOR			-overlaid subroutines, part 7
	DINDX.DAT			-initialization data base
	DTEXT.DAT			-main data base [binary file]
	DUNGEO.DOC			-this file


	RT11 only
	---------

	RTTIM.FOR			-time subroutine
	RRND.MAC			-random number generator
	RTCMP.COM			-compile command file
	RTBLD.COM			-link command file


	RSTS/E only
	-----------

	RTTIM.FOR			-time subroutine
	RRND.MAC			-random number generator
	RSTSCB.CTL			-compile/build batch file


	RSX11M, RSX11M+ only
	--------------------

	RSXTIM.MAC			-time subroutine
	RRND.MAC			-random number generator
	RSXCMP.CMD			-compile command file
	RSXBLD.CMD			-task build command file
	D.ODL				-overlay descriptor file


	VMS only
	--------

	VMSTIM.FOR			-time subroutine
	VMSRND.MAC			-random number generator
	VMSCMP.COM			-compile command file
	VMSBLD.COM			-link command file
2.  Installation Instructions, RT11

Before starting, please note that:

  - Dungeon requires RT11 V3 or later.

  - Dungeon requires Fortran-IV V2 or later, threaded code option.

  - Dungeon requires 26KW of user memory (runs under SJ monitor only).

  - All files (source and object) must reside on the same disk
    (at least 2500 disk blocks are needed).

  - Dungeon does not require EIS or floating point.

Except for DTEXT.DAT, all files in the distribution kit are ASCII.
DTEXT.DAT is a binary file consisting of 76-byte fixed length records.
If the distribution kit consists of RT11-compatible media, then PIP
can be used to transfer the files.  If the distribution kit consists
of DOS-compatible media, then FILEX must be used to transfer the files.
The /I switch (image binary) must be used to transfer DTEXT.DAT;  the
/A (ASCII) switch should be used to transfer the other files.

To compile Dungeon, issue the following command:

  .@RTCMP(cr)

Several of the compilations will produce warning messages, but none
should produce a fatal error.

To link the compiled sources, issue the following command:

  .@RTBLD(cr)

The command file assumes that the Fortran-IV object time library has
been merged into the system library.  If this is not the case, edit
RTBLD.COM and add switch /LINKLIBRARY:FORLIB.OBJ to the first command
line.

It is now possible to run Dungeon:

  .R DUNGEO(cr)

When invoked, Dungeon takes no more than 5-10 seconds to start up.

Notes on the executable program:

  - The only files needed to execute Dungeon are DUNGEO.SAV,
    DINDX.DAT, and DTEXT.DAT.  All other files can be deleted.

  - Files DINDX.DAT and DTEXT.DAT must reside on logical device SY:
    (this can be changed with a source edit, see section 8).
3.  Installation Instructions, RSTS/E

Before starting, please note that:

  - Dungeon requires RSTS/E V6C or later.

  - Dungeon requires Fortran-IV V2 or later, threaded code option
    (operation under Fortran-IV-Plus V2.5 or later will probably
    work but is not supported).

  - Dungeon requires 28KW of user memory.

  - All files (source and object) must reside in the same user area
    (at least 2500 disk blocks are needed).

  - Dungeon does not require EIS or floating point.

Except for DTEXT.DAT, all files in the distribution kit are ASCII.
DTEXT.DAT is a binary file consisting of 76-byte fixed length records.
If the distribution kit consists of RT11- or DOS-compatible disks,
then FIT can be used to transfer the files.  For example (RT11 disk):

  RUN $FIT(cr)
  FIT>*.*/RSTS=DK:*.*/RT11(cr)
  FIT>^Z

If the distribution kit consists of DOS-compatible magtape, then PIP
can be used to transfer the files, providing that the magtape is
assigned as a DOS-label device.  For example:

  ASSIGN MM0:.DOS(cr)
  RUN $PIP(cr)
  **.*/AS=MM:*.FTN,*.FOR,*.MAC,*.DOC,*.CTL(cr)
  **.*/AS=MM:*.CMD,*.COM,*.ODL,DINDX.DAT(cr)
  **.*/BL=MM:DTEXT.DAT(cr)
  *^C
  DEASS MM0:(cr)

To compile and link Dungeon, submit control file RSTSCB.CTL to the
batch processor:

  SUBMIT RSTSCB.CTL(cr)

Several of the compilations will produce warning messages, but none
should produce a fatal error.

It is now possible to run Dungeon:

  RUN DUNGEO(cr)

When invoked, Dungeon takes no more than 5-10 seconds to start up.

Notes on the executable program:

  - The only files needed to execute Dungeon are DUNGEO.SAV,
    DINDX.DAT, and DTEXT.DAT.  All other files can be deleted.

  - Files DINDX.DAT and DTEXT.DAT must reside in the user's area on
    logical device SY: (this can be changed with a source edit, see
    section 8).
4.  Installation Instructions, RSX11M and RSX11M+

Before starting, please note that:

  - Dungeon requires RSX11M V3 (RSX11M+ V1) or later.

  - Dungeon requires Fortran-IV-Plus V2.5 or later (operation under
    Fortran-IV V2 or later will probably work but is not supported).

  - Dungeon requires a 32KW user partition (mapped systems only).

  - All files (source and object) must reside in the same user area
    (at least 2500 disk blocks are needed).

  - TKB should invoke BIGTKB.TSK with a large memory increment.

  - The Fortran-IV-Plus object time library must be merged into
    the system library (SYSLIB.OLB).  Further, the library must
    be set up to invoke the short error text module ($SHORT) as
    the default.  Task building with a separate object time library
    produces numerous errors;  task building with a resident library
    or the normal error text module produces an oversize task image.

  - Dungeon requires EIS but not floating point.

Except for DTEXT.DAT, all files in the distribution kit are ASCII.
DTEXT.DAT is a binary file consisting of 76-byte fixed length records.
If the distribution kit consists of Files-11 compatible media, then
PIP can be used to transfer the files.  For example:

  >PIP SY:*.*=MM:*.*(cr)            -requires ANSI magtape support

If the distribution kit consists of DOS- or RT11-compatible media,
then FLX must be used to transfer the files.  The /IM:76. switch
(image binary fixed length) must be used to transfer DTEXT.DAT;
the /FA switch (formatted ASCII) should be used to transfer the
other files.  For example (DOS magtape):

  >FLX(cr)
  FLX>SY:/RS/FA=MM:*.FTN,*.FOR,*.MAC,*.DOC/DO(cr)
  FLX>SY:/RS/FA=MM:*.CMD,*.COM,*.ODL,DINDX.DAT/DO(cr)
  FLX>SY:/RS/IM:76.=MM:DTEXT.DAT/DO(cr)
  FLX>^Z

To compile Dungeon, issue the following command:

  >@RSXCMP(cr)

There should be no error messages.

To task build the compiled sources, issue the following command:

  >TKB @RSXBLD(cr)

It is now possible to run Dungeon:

  >RUN DUNGEON(cr)

When invoked, Dungeon takes no more than 5-10 seconds to start up.
If your system maintains a separate Fortran-IV-Plus object time
library (F4POTS.OLB), then you must create a local copy of the
system library with the Fortran-IV-Plus object time library
merged in and the short error text as the default.  The following
commands are an example of how such a local copy could be built:

  >PIP SY:*.*=LB:[1,1]SYSLIB.OLB,F4POTS.OLB(cr)	-copy libraries
  >LBR(cr)					-invoke LBR
  LBR>SHORT.OBJ=F4POTS.OLB/EX:$SHORT(cr)	-extract $SHORT
  LBR>F4POTS.OLB/DE:$SHORT(cr)			-delete $SHORT
  LBR>F4POTS.OBJ=F4POTS.OLB/EX(cr)		-extract other modules
  LBR>SYSLIB.OLB=F4POTS.OBJ(cr)			-insert other modules
  LBR>SYSLIB.OLB/DG:$ERTXT(cr)			-delete dup entry
  LBR>SYSLIB.OLB=SHORT.OBJ/RP(cr)		-insert $SHORT
  LBR>^Z