Consistent use of 'advent' to avoid collision with BSD Games.
authorEric S. Raymond <esr@thyrsus.com>
Thu, 18 May 2017 11:18:53 +0000 (07:18 -0400)
committerEric S. Raymond <esr@thyrsus.com>
Thu, 18 May 2017 11:18:53 +0000 (07:18 -0400)
Manual page added.

.gitignore
Makefile
NEWS [new file with mode: 0644]
README
advent.txt [new file with mode: 0644]
history.txt

index aa818f61a7530d9e709bf807701f4a95f798be50..babef263261cf211207991568d961827c8135a6d 100644 (file)
@@ -1,3 +1,3 @@
-adventure
+advent
 *.o
 adventure.data
 *.o
 adventure.data
index 9aa8f61f554e100369b6828b3399372916c0fb95..ca6e670287417852c4e6c6688cdf7d45684ff6e1 100644 (file)
--- a/Makefile
+++ b/Makefile
@@ -1,12 +1,13 @@
-# 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
 
 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 $<
 
 
 .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
 
 
 main.o:                misc.h funcs.h
 
@@ -21,4 +22,22 @@ score.o:     misc.h main.h share.h
 misc.o:                misc.h main.h
 
 clean:
 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
diff --git a/NEWS b/NEWS
new file mode 100644 (file)
index 0000000..5688644
--- /dev/null
+++ b/NEWS
@@ -0,0 +1,4 @@
+= OpenAdventure project news =
+
+Repository head::
+  Forward port of Crowther & Woods's 430-point Adventure 2.5.
diff --git a/README b/README
index c73e6b072b0883edecc1547fcdaf14e143a723ba..222746beb73d46b5b03f0f345c5cc129d4d7ea05 100644 (file)
--- a/README
+++ b/README
@@ -1,4 +1,4 @@
-= 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
 
 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
@@ -8,6 +8,9 @@ permission and encouragement to this release.
 The file history.txt contains a more detailed history of this game
 and its ancestors.
 
 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
 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.
+
diff --git a/advent.txt b/advent.txt
new file mode 100644 (file)
index 0000000..81558b1
--- /dev/null
@@ -0,0 +1,33 @@
+= 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).
index e392f528d3e7b3e65221bd83628853e698f45029..3a38faca089beac75d5b3bed1d6e6dd596827a02 100644 (file)
@@ -8,7 +8,7 @@ of hacker folklore.
 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
 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
 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
@@ -66,12 +66,13 @@ he replied on 15 May giving both permission and encouragement.
 
 == Nomenclature ==
 
 
 == 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
 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 ==
 
 
 == Sources ==