chmod +x sst.py
[super-star-trek.git] / doc / sst-doc.xml
index ecb52aac0938496331d9ba5d19b6d4eb8b747d5b..c50cd831eb115ead5475dcb40b857ac1b26e49a8 100644 (file)
@@ -961,9 +961,9 @@ calculate travel times and energy usage.</para>
 <sect1><title>Photon Torpedoes</title>
 
 <literallayout>
-Mnemonic:  PHOTONS
-Shortest abbreviation:  PHO
-Full commands:  PHOTONS &lt;NUMBER&gt; &lt;TARG1&gt; &lt;TARG2&gt; &lt;TARG3&gt;
+Mnemonic:  TORPEDO
+Shortest abbreviation:  TO
+Full commands:  TORPEDO &lt;NUMBER&gt; &lt;TARG1&gt; &lt;TARG2&gt; &lt;TARG3&gt;
 </literallayout>
 
 <para>Photon torpedoes are projectile weapons&mdash;you either hit what you aim
@@ -1584,7 +1584,7 @@ orientation</quote>.</para>
  P         PHASERS &lt;TOTAL AMOUNT&gt;                 phasers and computer
            PHASERS AUTOMATIC &lt;TOTAL AMOUNT&gt;       phasers, computer, sr sensors
            PHASERS MANUAL &lt;AMT1&gt; &lt;AMT2&gt; ...       phasers
PHO       PHOTONS &lt;NUMBER&gt; &lt;TARGETS&gt;             torpedo tubes 
TOR       TORPEDO &lt;NUMBER&gt; &lt;TARGETS&gt;             torpedo tubes 
  PL        PLANETS                                (none)
  PR        PROBE &lt;ARMED&gt; &lt;MANUAL&gt; &lt;DISPLACEMENT&gt;  probe launcher, radio 
            PROBE &lt;ARMED&gt; AUTOMATIC &lt;DESTINATION&gt;  launcher, radio, computer
@@ -1633,10 +1633,8 @@ Impulse engines require 20 units to warm up, plus 100 units per
 <para>The original Star Trek seems to have been written by Mike
 Mayfield at the beginning of the 1970s.  His first version was in
 BASIC for a Sigma 7 in 1971; in 1972 he rewrote it in Hewlett Packard
-BASIC. The source is <ulink
-url="&sst-site;www/historic/mayfield.basic">available</ulink> on the
-SST2K website. In January 1975 it became part of the DECUS library
-under the name <ulink
+BASIC. The source is inckuded in the SST2K repository.  In January
+1975 it became part of the DECUS library under the name <ulink
 url='http://www.trailing-edge.com/~shoppa/decus/110174.html'>SPACWR</ulink>.</para>
 
 <para>While some people claim to have recollections of playing Trek
@@ -1662,9 +1660,8 @@ Hicks dated 5 April 1973. This does not appear to have been derived
 from Ahl's SPACWR. The header says "GENERAL IDEA STOLEN FROM
 PENN. U.", and the game has several features not present in SPACEWR:
 notably, the Death Ray, ramming, and the Klingon summons to surrender.
-And, of course, it predates Ahl's book.  The source is <ulink
-url="&sst-site;www/historic/UT-Trek.basic">available</ulink> on the
-SST2K website.</para>
+And, of course, it predates Ahl's book.  The source is included in the
+SST2K repository.</para>
 
 <para>Dave Matuszek, Paul Reynolds et. al. at UT Austin played the
 Hicks version on a CDC6600, but disliked the long load time and
@@ -1826,8 +1823,8 @@ is alive.</para>
 <para>Planets are auto-scanned when you enter the quadrant.</para>
 </listitem>
 <listitem>
-<para>Mining or using crystals in presense of enemy now yields an attack.
-There are other minor adjustments to what yields an attack
+<para>Mining or using crystals in the presence of the enemy now yields
+an attack.  There are other minor adjustments to what yields an attack
 and what does not.</para>
 </listitem>
 <listitem>
@@ -2004,7 +2001,7 @@ shops.</para></listitem>
 
 <appendix><title>Setting the Wayback Machine</title>
 
-<para>SSTK and its ancestors have a long history.  One of the
+<para>SST2K and its ancestors have a long history.  One of the
 objectives of this project is to make that history available.
 Accordingly, here is a timeline of the development of SST2K and
 its ancestors, as closely as we can reconstruct it.  Someday this
@@ -2029,7 +2026,7 @@ child.</para></listitem>
 version to PDP-11 FORTRAN.</para></listitem>
 
 <listitem><para>21 September 1978 &mdash; This was the date on the
-first version Tom Almy saw, on which he based his C
+first version Tom Almy saw, on which he based his later C
 translation.</para></listitem>
 
 <listitem><para>1979 &mdash; Marc Newman adds Tholians, black holes,
@@ -2038,7 +2035,7 @@ super-commanders, and Emeritus mode.</para></listitem>
 <listitem><para>1995-1996 &mdash; Tom Almy translates his FORTRAN
 port to ANSI C.</para></listitem>
 
-<listitem><para>1997 &mdash; Tom Almy finds the sources for the UT
+<listitem><para>1997 &mdash; Tom Almy finds the sources for UT
 FORTRAN on the Web and merges in features new since the 1978 version:
 EMEXIT, Tholian Web, improved death ray.  He adds deep-space probes
 from the DECUS version.</para></listitem>
@@ -2056,6 +2053,9 @@ Sergeev. The curses interface is added.</para></listitem>
 <listitem><para>September 2006 &mdash; BSD features merged
 in. Inhabited-worlds features and weighted critical hits date from
 this time.</para></listitem>
+
+<listitem><para>9 October 2006 &mdash; Translation to
+Python.</para></listitem>
 </itemizedlist>
 
 <para>One as-yet unanswered question is when the code changed from