Manual page added.
-adventure
+advent
*.o
adventure.data
-# Makefile for the pen-source release of adventure 2.4
+# Makefile for the open-source release of adventure 2.5
OBJS=main.o init.o actions1.o actions2.o score.o misc.o datime.o
+SOURCES=$(OBJS:.o=.c) COPYING NEWS README adventure.asc
.c.o:
gcc -O $(DBX) -c $<
-adventure: $(OBJS)
- gcc -O $(DBX) -o adventure $(OBJS)
+advent: $(OBJS)
+ gcc -O $(DBX) -o advent $(OBJS)
main.o: misc.h funcs.h
misc.o: misc.h main.h
clean:
- rm -f *.o adventure
+ rm -f *.o advent advent.html advent.6
+
+# Requires asciidoc and xsltproc/docbook stylesheets.
+.asc.6:
+ a2x --doctype manpage --format manpage $<
+.asc.html:
+ a2x --doctype manpage --format xhtml -D . $<
+ rm -f docbook-xsl.css
+
+advent-$(VERS).tar.gz: $(SOURCES) advent.6
+ tar --transform='s:^:advent-$(VERS)/:' --show-transformed-names -cvzf advent-$(VERS).tar.gz $(SOURCES) advent.6
+
+dist: advent-$(VERS).tar.gz
+
+release: advent-$(VERS).tar.gz advent.html
+ shipper version=$(VERS) | sh -e -x
+
+refresh: advent.html
+ shipper -N -w version=$(VERS) | sh -e -x
--- /dev/null
+= OpenAdventure project news =
+
+Repository head::
+ Forward port of Crowther & Woods's 430-point Adventure 2.5.
-= README for Open Adventure =
+= README for Open Advent =
This code is a forward-port of the Crowther/Woods Adventure 2.5 from
1995, last version in the main line of Colossal Cave Adventure
The file history.txt contains a more detailed history of this game
and its ancestors.
-This project is called "Open Adventure" because it's not at all clear
+This project is called "Open Advent" because it's not at all clear
to number Adventure past 2.5 without misleading or causing collisions
-or both. See the history file for discussion.
+or both. See the history file for discussion. The original 6-character
+name on the PDP-10 has been reverted to in order to avoid a collision
+with the BSD games pport of the anecestral 196 version.
+
--- /dev/null
+= advent(6) =
+:doctype: manpage
+
+== NAME ==
+advent - Colossal Cave Adventure
+
+== SYNOPSIS ==
+*advent*
+
+== DESCRIPTION ==
+The original Colossal Cave Adventure from 1976 was the origin of all
+text adventures, dungeon-crawl games, and computer-hosted roleplaying
+games.
+
+This is the last version released by Crowther & Woods, its original
+authors, in 1995. It has been known as "adventure 2.5" and "430-point
+adventure".
+
+This game is released as open source with the permission and encouragement of
+the authors.
+
+== DISAMBIGUATION ==
+There is an 'adventure' in the BSD games package that is a C
+port of the 1976 ancestor of this game. To avoid a name collision,
+this game builds as 'advent', reflecting the fact that the PDP-10
+on which it originally ran limited filenames to 6 characters.
+
+== REPORTING BUGS ==
+Report bugs to Eric S. Raymond <esr@thyrsus.com>. The project page is
+at http://catb.org/~esr/open-advent
+
+== SEE ALSO ==
+wumpus(6), adventure(6), zork(6), rogue(6), nethack(6).
The very first version was released by Crowther in 1976, in FORTRAN on
the PDP-10 at Bolt, Beranek, and Newman. (Crowther was at the time
writing what we could now call firmware for the earliest ARPANET
-routers) It was a maze game based on the Colossal Cave complex in
+routers.) It was a maze game based on the Colossal Cave complex in
Kentucy, lacking the D&D-like elements now associated with the game.
Adventure as we now know it, the ancestor of all later versions, was
== Nomenclature ==
-This project is called "Open Adventure" because it's not at all clear
+This project is called "Open Advent" because it's not at all clear
to number Adventure past 2.5 without misleading or causing
collisions. Various of the non-mainline versions have claimed to be
versions 3, 4, 5, 6, 7 and for all I know higher than that. It seems
best just to start a new numbering series while acknowledging the
-links back.
+links back. I have reverted to "Advent" to avoid a name collision
+with the BSD Games version.
== Sources ==