]> granicus.if.org Git - nethack/commitdiff
README and dat/history update
authorPatR <rankin@nethack.org>
Tue, 10 Nov 2015 09:49:21 +0000 (01:49 -0800)
committerPatR <rankin@nethack.org>
Tue, 10 Nov 2015 09:49:21 +0000 (01:49 -0800)
README - add VMS back as a tested platform; thanks KevinS!
dat/history - add VMS update, remove trailing whitespace, two spaces;
  instead of just one (recently added stuff) for sentence separation;
sys/vms/Install.vms - minimal update;
Files - reformat the win32 project section to fit within 80 columns.

Files
README
dat/history
sys/vms/Install.vms

diff --git a/Files b/Files
index 5235fa5c0da1921505013ec9fb7133499050ca27..345e0aced2aae941631fba2dabb55c621391b566 100644 (file)
--- a/Files
+++ b/Files
@@ -272,9 +272,10 @@ mnsel.uu        mnselcnt.uu     mnunsel.uu      mswproc.c
 petmark.uu      pilemark.uu     resource.h      rip.uu          splash.uu
 tiles.mak       winMS.h         winhack.c       winhack.rc
 (files for Visual Studio 2010 Express Edition builds)
-dgncomp.vcxproj  dgnstuff.vcxproj dgnstuff.mak     dlb_main.vcxproj levcomp.vcxproj
-levstuff.vcxproj levstuff.mak     makedefs.vcxproj NetHack.sln      uudecode.vcxproj
-NetHackW.vcxproj tile2bmp.vcxproj recover.vcxproj  tilemap.vcxproj  tiles.vcxproj
+dgncomp.vcxproj   dgnstuff.vcxproj  dgnstuff.mak      dlb_main.vcxproj
+levcomp.vcxproj   levstuff.vcxproj  levstuff.mak      makedefs.vcxproj
+NetHack.sln       uudecode.vcxproj  NetHackW.vcxproj  tile2bmp.vcxproj
+recover.vcxproj   tilemap.vcxproj   tiles.vcxproj
 
 This is a list of files produced by auxiliary programs.  They can all be
 regenerated from the files in the distribution.
diff --git a/README b/README
index daa68c33e90d94ced0c8a75443baef82bf062080..eecf978db30e9e45c996bfa261a93e8b741490cc 100644 (file)
--- a/README
+++ b/README
@@ -57,12 +57,14 @@ Please read items (1), (2) and (3) BEFORE doing anything with your new code.
     for particular windowing environments.  Reading them, and the man pages,
     should answer most of your questions.
 
-    At the time of this release, NetHack 3.6 has been tested to run/compile on:
+    At the time of this release, NetHack 3.6 has been tested to run/compile
+    on:
 
         Intel Pentium or better (or clone) running Linux, BSDI, or 
                 Windows (XP through 8.1)
         Intel 80386 or greater (or clone) boxes running Linux, or BSDI
        Mac OS X 10.9
+       OpenVMS (aka VMS) V8.4 on Alpha and on Integrity/Itanium/IA64
 
     Previous versions of NetHack were tested and known to run on the 
     following systems, but it is unknown if they can still build and 
@@ -107,8 +109,8 @@ Please read items (1), (2) and (3) BEFORE doing anything with your new code.
         Sun SPARC based machine running SunOS 4.x, Solaris 2.x, or Solaris 7
         Valid Logic Systems SCALD-System
 
-    Previous versions, using a cross-compiler hosted on another platform, such as 
-    win32, could also build the following from source:
+    Previous versions, using a cross-compiler hosted on another platform,
+    such as  win32, could also build the following from source:
         Pocket PC devices running Windows CE 3.0 and higher
         H/PC Pro devices running Windows CE 2.11 and higher
         Palm Size PC 1.1 devices running Windows CE 2.11
index 48a2c2b45fbec30d51d95612f8be46129c9c2ee0..6095a1ef286939ffa22669a32465a4814d076554 100644 (file)
@@ -11,7 +11,8 @@ UNIX(tm) machines to the Usenet.
 
 Don G. Kneller ported Hack 1.0.3 to Microsoft(tm) C and MS-DOS(tm), producing
 PC HACK 1.01e, added support for DEC Rainbow graphics in version 1.03g, and
-went on to produce at least four more versions (3.0, 3.2, 3.51, and 3.6).
+went on to produce at least four more versions (3.0, 3.2, 3.51, and 3.6;
+note that these are old Hack version numbers, not contemporary NetHack ones).
 
 R. Black ported PC HACK 3.51 to Lattice(tm) C and the Atari 520/1040ST,
 producing ST Hack 1.03.
@@ -20,7 +21,7 @@ Mike Stephenson merged these various versions back together, incorporating
 many of the added features, and produced NetHack version 1.4 in 1987.  He
 then coordinated a cast of thousands in enhancing and debugging NetHack 1.4
 and released NetHack versions 2.2 and 2.3.
+
 Later, Mike coordinated a major rewrite of the game, heading a team which
 included Ken Arromdee, Jean-Christophe Collet, Steve Creps, Eric Hendrickson,
 Izchak Miller, Eric S. Raymond, John Rupley, Mike Threepoint, and Janet Walz,
@@ -37,7 +38,7 @@ Spackman and Pierre Martineau designed overlay code for PC NetHack 3.0.
 Johnny Lee ported NetHack 3.0 to the Macintosh.  Along with various other
 Dungeoneers, they continued to enhance the PC, Macintosh, and Amiga ports
 through the later revisions of 3.0.
+
 Headed by Mike Stephenson and coordinated by Izchak Miller and Janet Walz,
 the development team which now included Ken Arromdee, David Cohrs,
 Jean-Christophe Collet, Kevin Darcy, Matt Day, Timo Hakulinen, Steve Linhart,
@@ -56,7 +57,7 @@ Spackman, Steve VanDevender, and Paul Winner, ported NetHack 3.1 to the PC.
 Jon W{tte and Hao-yang Wang, with help from Ross Brown, Mike Engber, David
 Hairston, Michael Hamel, Jonathan Handler, Johnny Lee, Tim Lennan, Rob Menke,
 and Andy Swanson developed NetHack 3.1 for the Macintosh, porting it for
-MPW.  Building on their development, Barton House added a Think C port.  
+MPW.  Building on their development, Barton House added a Think C port.
 
 Timo Hakulinen ported NetHack 3.1 to OS/2.  Eric Smith ported NetHack 3.1
 to the Atari.  Pat Rankin, with help from Joshua Delahunty, is responsible
@@ -103,17 +104,17 @@ DevTeam and incorporated the best of these ideas in NetHack 3.3.
 The final update to 3.2 was the bug fix release 3.2.3, which was released
 simultaneously with 3.3.0 in December 1999 just in time for the Year 2000.
 
-The 3.3 development team, consisting of Michael Allison, Ken Arromdee, 
-David Cohrs, Jessie Collet, Steve Creps, Kevin Darcy, Timo Hakulinen, 
-Kevin Hugo, Steve Linhart, Ken Lorber, Dean Luick, Pat Rankin, Eric Smith, 
-Mike Stephenson, Janet Walz, and Paul Winner, released 3.3.0 in 
+The 3.3 development team, consisting of Michael Allison, Ken Arromdee,
+David Cohrs, Jessie Collet, Steve Creps, Kevin Darcy, Timo Hakulinen,
+Kevin Hugo, Steve Linhart, Ken Lorber, Dean Luick, Pat Rankin, Eric Smith,
+Mike Stephenson, Janet Walz, and Paul Winner, released 3.3.0 in
 December 1999 and 3.3.1 in August of 2000.
 
-Version 3.3 offered many firsts. It was the first version to separate race 
-and profession. The Elf class was removed in preference to an elf race, 
-and the races of dwarves, gnomes, and orcs made their first appearance in 
-the game alongside the familiar human race.  Monk and Ranger roles joined 
-Archeologists, Barbarians, Cavemen, Healers, Knights, Priests, Rogues, 
+Version 3.3 offered many firsts. It was the first version to separate race
+and profession. The Elf class was removed in preference to an elf race,
+and the races of dwarves, gnomes, and orcs made their first appearance in
+the game alongside the familiar human race.  Monk and Ranger roles joined
+Archeologists, Barbarians, Cavemen, Healers, Knights, Priests, Rogues,
 Samurai, Tourists, Valkyries and of course, Wizards.  It was also the first
 version to allow you to ride a steed, and was the first version to have a
 publicly available web-site listing all the bugs that had been discovered.
@@ -130,61 +131,61 @@ well as supporting ports on the different platforms that NetHack runs on:
 
 Pat Rankin maintained 3.4 for VMS.
 
-Michael Allison maintained NetHack 3.4 for the MS-DOS platform.  
+Michael Allison maintained NetHack 3.4 for the MS-DOS platform.
 Paul Winner and Yitzhak Sapir provided encouragement.
 
 Dean Luick, Mark Modrall, and Kevin Hugo maintained and enhanced the
 Macintosh port of 3.4.
 
-Michael Allison, David Cohrs, Alex Kompel, Dion Nicolaas, and Yitzhak Sapir 
-maintained and enhanced 3.4 for the Microsoft Windows platform. Alex Kompel 
-contributed a new graphical interface for the Windows port. Alex Kompel also
+Michael Allison, David Cohrs, Alex Kompel, Dion Nicolaas, and Yitzhak Sapir
+maintained and enhanced 3.4 for the Microsoft Windows platform.  Alex Kompel
+contributed a new graphical interface for the Windows port.  Alex Kompel also
 contributed a Windows CE port for 3.4.1.
 
 Ron Van Iwaarden maintained 3.4 for OS/2.
 
-Janne Salmijarvi and Teemu Suikki maintained and enhanced the 
+Janne Salmijarvi and Teemu Suikki maintained and enhanced the
 Amiga port of 3.5 after Janne Salmijarvi resurrected it for 3.3.1.
 
 Christian `Marvin' Bressler maintained 3.5 for the Atari after he
 resurrected it for 3.3.1.
 
-The release of NetHack 3.4.3 in December 2003 marked the beginning of a 
-long release hiatus. 3.4.3 proved to be a remarkably stable version that
-provided continued enjoyment by the community for more than a decade. The 
-devteam slowly and quietly continued to work on the game behind the scenes 
-during the tenure of 3.4.3. It was during that same period that several new 
-variants emerged within the NetHack community. Notably sporkhack by 
-Derek S. Ray, unnethack by Patric Mueller, nitrohack and its successors 
-originally by Daniel Thaler and then by Alex Smith, and 
-Dynahack by Tung Nguyen. Some of those variants continue to be developed, 
+The release of NetHack 3.4.3 in December 2003 marked the beginning of a
+long release hiatus.  3.4.3 proved to be a remarkably stable version that
+provided continued enjoyment by the community for more than a decade.  The
+devteam slowly and quietly continued to work on the game behind the scenes
+during the tenure of 3.4.3.  It was during that same period that several
+new variants emerged within the NetHack community.  Notably sporkhack by
+Derek S. Ray, unnethack by Patric Mueller, nitrohack and its successors
+originally by Daniel Thaler and then by Alex Smith, and
+Dynahack by Tung Nguyen.  Some of those variants continue to be developed,
 maintained, and enjoyed by the community to this day.
 
-In September 2014, an interim snapshot of the code under development was 
-released publicly by other parties. Since that code was a work-in-progress 
-and had not gone through a period of debugging, it was decided that the 
-version numbers present on that code snapshot would be retired and never 
-used in an official NetHack release. An announcement was posted on the 
-devteam's official nethack.org website to that effect, stating that there 
+In September 2014, an interim snapshot of the code under development was
+released publicly by other parties.  Since that code was a work-in-progress
+and had not gone through a period of debugging, it was decided that the
+version numbers present on that code snapshot would be retired and never
+used in an official NetHack release.  An announcement was posted on the
+devteam's official nethack.org website to that effect, stating that there
 would never be a 3.4.4, 3.5, or 3.5.0 official release version.
 
-In January 2015, preparation began for the release of NetHack 3.6. 
+In January 2015, preparation began for the release of NetHack 3.6.
 
 At the beginning of development for what would eventually get released
-as 3.6.0, the development team consisted of Michael Allison, 
-Warwick Allison, Ken Arromdee, David Cohrs, Jessie Collet, Ken Lorber, 
+as 3.6.0, the development team consisted of Michael Allison,
+Warwick Allison, Ken Arromdee, David Cohrs, Jessie Collet, Ken Lorber,
 Dean Luick, Pat Rankin, Mike Stephenson, Janet Walz, and Paul Winner.
-Leading up to the release of 3.6.0 in early 2015, new members Sean Hunt, 
+Leading up to the release of 3.6.0 in early 2015, new members Sean Hunt,
 Pasi Kallinen, and Derek S. Ray joined the NetHack development team.
 
-In January 2015, preparation began for the release of NetHack 3.6. The 3.6
-version merges work done by the development team since the previous release with 
-some of the beloved community patches. Many bugs were fixed and some code was 
-restructured.
+In January 2015, preparation began for the release of NetHack 3.6.  The 3.6
+version merges work done by the development team since the previous release
+with some of the beloved community patches.  Many bugs were fixed and some
+code was restructured.
 
 The development team, as well as Steve VanDevender and Kevin Smolkowski
 ensured that NetHack 3.6.0 continued to operate on various Unix flavors
-as well as maintaining the X11 interface. 
+as well as maintaining the X11 interface.
 
 Ken Lorber, Haoyang Wang, Pat Rankin, and Dean Luick maintained the port
 of NetHack 3.6.0 for Mac.
@@ -192,28 +193,33 @@ of NetHack 3.6.0 for Mac.
 Michael Allison, Derek S. Ray, Yitzhak Sapir, Alex Kompel, Dion Nicolaas,
 and David Cohrs maintained the port of NetHack 3.6.0 for Microsoft Windows.
 
-This version of the game is special in a particular way.  Near the end of 
-the development of 3.6, one of the significant inspirations for many of the 
-humorous and fun features found in the game, author Terry Pratchett, 
+Pat Rankin attempted to keep the VMS port running for NetHack 3.6.0,
+hindered by limited access.  Kevin Smolkowski has updated and tested it
+for the most recent version of OpenVMS (V8.4 as of this writing) on Alpha
+and Integrity (aka Itanium aka IA64) but not VAX.
+
+This version of the game is special in a particular way.  Near the end of
+the development of 3.6, one of the significant inspirations for many of
+the humorous and fun features found in the game, author Terry Pratchett,
 passed away.  This version of the game includes a tribute to him.
 
 
-An official NetHack web site continues to be maintained by Ken Lorber at 
+An official NetHack web site continues to be maintained by Ken Lorber at
 http://www.nethack.org/.
 
 --
 SHOUT-OUTS
 
-The devteam would like to give a special "shout-out" to thank the generous 
-people primarily responsible for the public NetHack servers available for 
-playing the game at nethack.alt.org and devnull.net. In addition to providing 
-a way for the public to play a game of NetHack from almost anywhere, they 
-have hosted annual NetHack tournaments for many, many years. 
+The devteam would like to give a special "shout-out" to thank the generous
+people primarily responsible for the public NetHack servers available for
+playing the game at nethack.alt.org and devnull.net.  In addition to
+providing a way for the public to play a game of NetHack from almost
+anywhere, they have hosted annual NetHack tournaments for many, many years.
 
-On behalf of the NetHack community, thank you very much to 
+On behalf of the NetHack community, thank you very much to
 M. Drew Streib, Pasi Kallinen and Robin Bandy.
 
-                          - - - - - - - - - -
+                           - - - - - - - - - -
 
 From time to time, some depraved individual out there in netland sends a
 particularly intriguing modification to help out with the game.  The Gods of
@@ -258,5 +264,5 @@ in this, the list of Dungeoneers:
     Hao-yang Wang             Mike Engber               Warren Cheung
     Helge Hafting             Mike Gallop               Warwick Allison
     Irina Rempt-Drijfhout     Mike Passaretti           Yitzhak Sapir
-    Izchak Miller             Mike Stephenson           
-    J. Ali Harlow             Mikko Juola               
+    Izchak Miller             Mike Stephenson
+    J. Ali Harlow             Mikko Juola
index 6b45140e1b4ecb3c4f6e887df0a9b8d0b6e72eec..ccdfa31118bafddccfdf12cdd08f04a9047201bd 100644 (file)
@@ -5,18 +5,10 @@
 0.  Please read this entire file before trying to build or install
     NetHack, then read it again!
 
-1.  Building NetHack requires a C compiler (either Compaq C, DEC C,
-    VAX C, or GNU C) and VMS version V4.6 or later (but see note #9).
-    This release has been tested with Compaq C V6.4 on Alpha/VMS V7.3-1
-    and with VAX C V3.2 and GNU C 2.7.1 on VAX/VMS V5.5-2.  The build
-    procedure (vmsbuild.com) should not need to be modified; it accepts
-    an option for selecting the compiler, and it can detect different
-    versions which might require specific command qualifiers.  Versions
-    of VAXC earlier than V2.3 will produce many warning messages (about
-    200 per source file; over to 25,000 total!), but NetHack has been
-    verified to compile, link, and execute correctly when built with VAXC
-    V2.2 using vmsbuild.com.  There is also a set of Makefiles suitable for
-    use with MMS or MMK; they may or may not work with other make utilities.
+1.  Build testing was done using a recent version of HP C (aka Compaq C
+    aka--and more widely known as--DEC C).  Older versions of DEC C will
+    probably work too.  Ancient VAX C probably will not.  The set of
+    Makefiles are known to be out of date; use vmsbuild.com instead.
 
 2.  Make sure all the NetHack files are in the appropriate directory
     structure.  You should set up a directory--referred to as "top" below
@@ -43,6 +35,7 @@
         [.sys   .os2]   -- OS/2
         [.sys   .share   .sounds] -- AIFF format audio files
         [.sys   .unix]  -- guess :-)
+       [.sys   .unit    .hints] -- configuration data for setup.sh
         [.sys   .wince] -- Windows CE
         [.sys   .wince   .ceinc] -- more WinCE
         [.sys   .wince   .ceinc   .sys] -- ditto
 
 Notes:
 
-1.  Save files and bones files from 3.4.x and earlier versions 
-    will not work with 3.5.0. The scoreboard file (RECORD) from 
-    3.4.x or 3.3.x will work; one from version 3.2.x is a slightly different 
-    format but should be compatible.
+0.  Versions 3.5.0 was never publicly released.
+
+1.  Save files and bones files from 3.4.x and earlier versions
+    will not work with 3.6.0. The scoreboard file (RECORD) from
+    3.4.x or 3.3.x will work.
 
 2.  To specify user-preference options in your environment, define the
     logical name NETHACKOPTIONS to have the value of a quoted string
@@ -174,7 +168,9 @@ Notes:
     placed in the playground directory by install.com.  Also, an example
     configuration file can be found in [.win.X11]nethack.rc.)
 
-3.  Instead of using vmsbuild.com to compile and link everything, you can
+3.  [As mentioned above, the set of Makefiles is out of date so disregard
+    this note....]
+    Instead of using vmsbuild.com to compile and link everything, you can
     use the set of Makefiles found in the vms subdirectory, provided you
     have an appropriate and compatible make utility.  They've been tested
     using MMK, a freeware clone of Digital's MMS.  There are five of them,
@@ -477,3 +473,4 @@ Notes:
     and the C compiler used.
 
 20-OCT-2003
+minimally updated 9-NOV-2015...