Make inhabited worlds display as '@'. Document this.
[super-star-trek.git] / doc / sst-doc.xml
index 8510e6db783968e80a07aba275a2dc6d2d05866f..a57278d05eb9fb5ca5c35b124c64b3f4bf458a02 100644 (file)
@@ -95,7 +95,7 @@ respect the copyrights of the originators of Star Trek.</para>
                          Curses Interface By
                               Stas Sergeev 
 
-               SST 2K polishing and historical research by
+               SST2K polishing and historical research by
                             Eric S. Raymond
 </literallayout>
 </dedication>
@@ -221,7 +221,7 @@ important, and the detailed command descriptions which follow will be
 a lot more meaningful to you.</para>
 
 <para>You have weapons: phasers and photon torpedoes. You have a defense:
-deflector shields.  You can look at things: long-range scaners,
+deflector shields.  You can look at things: long-range scanners,
 short-range scanners, and a star chart.  You can move about, under
 warp drive or impulse power.  You can also dock at a starbase, rest
 while repairs are being made, abandon ship, self destruct, or give up
@@ -231,6 +231,7 @@ and start a new game.</para>
 
 </chapter>
 <chapter><title>Starting the Game</title>
+<!-- This chapter is new in SST 2K --> 
 
 <para>The program will ask you some setup questions.  You can give it 
 command-line arguments that will be treated as answers.  Any token
@@ -252,13 +253,14 @@ The Emeritus game is strictly for masochists.</para>
 
 <para>The fourth question, new in SST2K, sets your game options.  A
 blank answer or 'fancy' enables all SST2K features.  The option
-'plain' disables a number of features (Tholians, planets &amp;
-dilithium, Thingies shooting back, deep-space-probes, Klingon ramming
-and movement, time-warping through black holes, death-ray upgrade),
-approximating the original CDC 6600 FORTRAN game from UT Austin.  The
-option 'almy' approximates Tom Almy's C translation from 1979,
-disabling Thingies shooting back, base shields, and time-warping
-through black holes.</para>
+'plain' approximated the original CDC 6600 FORTRAN game from UT Austin
+and disables a number of features: Tholians, planets &amp; dilithium,
+Thingies shooting back, deep-space-probes, Klingon ramming and
+movement, time-warping through black holes, death-ray
+upgrade. inhabited worlds.  The option 'almy' approximates Tom Almy's
+C translation from 1979, disabling Thingies shooting back, base
+shields, time-warping through black holes, and inhabited
+worlds.</para>
 
 </chapter>
 <chapter><title>How To Issue Commands</title>
@@ -328,7 +330,7 @@ abandon ship) must be written out in full.  Also, in a few cases two
 or more commands begin with the same letter, and in this case that
 letter refers to a particular one of the commands; to get the other,
 your abbreviation must be two or more characters long.  This sounds
-complicated, but you will learn the abbreviations qGuickly enough.</para>
+complicated, but you will learn the abbreviations quickly enough.</para>
 
 <para>What this all boils down to is:</para>
 
@@ -386,7 +388,8 @@ described by an example.</para>
 There are ordinary Klingons (K) at sectors 5 - 8 and 6 - 2, and a
 Klingon Commander (C) at 9 - 9.  The (GULP)
 <quote>Super-commander</quote> (S) is occupies sector 4 - 4, and a
-Romulan (R) is at 1 - 6.  A planet (P) is at sector 7 - 6.  There are
+Romulan (R) is at 1 - 6.  An uninhabited planet (P) is at sector 7 - 6
+(if it were inhabited, it would display as a '@').  There are
 also a large number of stars (*). The periods (.) are just empty
 space&mdash;they are printed to help you get your bearings.  Sector 6
 - 4 contains a black hole ( ).</para>
@@ -406,6 +409,7 @@ short-range scan anytime you like.</para>
 
 <para>If your short-range sensors are damaged, this command will only show
 the contents of adjacent sectors.</para>
+
 </sect1>
 <sect1><title>Status Report</title>
 
@@ -460,12 +464,12 @@ starship as follows:</para>
 </listitem>
 </varlistentry>
 <varlistentry>
-<term>LIFE SUPPOR</term>
+<term>LIFE SUPPORT</term>
 <listitem>
 <para>If <quote>ACTIVE</quote> then life support systems are functioning
 normally. If on <quote>RESERVES</quote> the number is how many stardates your
 reserve food, air, etc. will last&mdash;you must get repairs made or get to
-starbase before your reserves run out.</para>
+starbase before your reserves run out.</para>
 </listitem>
 </varlistentry>
 <varlistentry>
@@ -595,6 +599,7 @@ galaxy, which you are not permitted to cross.</para>
 
 <para>Long-range scans are free.  They use up no energy or time, and can be
 done safely regardless of battle conditions.</para>
+
 </sect1>
 <sect1><title>Star Chart</title>
 
@@ -604,7 +609,7 @@ Shortest abbreviation:  C
 </literallayout>
 
 <para>As you proceed in the game, you learn more and more about what things
-are where in the galaxy. When ever you first do a scan in a quadrant,
+are where in the galaxy. Whenever you first do a scan in a quadrant,
 telemetry sensors are ejected which will report any changes in the
 quadrant(s) back to your ship, providing the sub-space radio is
 working. Spock will enter this information in the chart. If the radio
@@ -1029,7 +1034,7 @@ star chart if your ask for it while docked and your own radio is dead.</para>
 <literallayout>
 Mnemonic:  REST
 Shortest abbreviation:  R
-Full command:  REST &lt;NUMBER OF STARDATES&gt;
+Full command:  REST &lt;NUMBER-OF-STARDATES&gt;
 </literallayout>
 
 <para>This command simply allows the specified number of stardates to go
@@ -1037,7 +1042,7 @@ by.  This is useful if you have suffered damages and wish to wait
 until repairs are made before you go back into battle.</para>
 
 <para>It is not generally advisable to rest while you are under attack by
-Klingons.</para>
+Klingons or Romulans.</para>
 
 </sect1>
 <sect1><title>Call Starbase for Help</title>
@@ -1048,7 +1053,7 @@ Mnemonic:  MAYDAY
 </literallayout>
 
 <para>[Originally, this command was called <quote>HELP</quote>, but
-these days that might be misconstrued as an attempt to browae built-in
+these days that might be misconstrued as an attempt to browse built-in
 documentation! In some later versions it was CALL.]</para>
 
 <para>When you get into serious trouble, you may call a starbase for
@@ -1246,9 +1251,10 @@ Mnemonic:  PLANETS
 Shortest abbreviation:  PL
 </literallayout>
 
-<para>Mr. Spock presents you a list of the available information on planets
-in the galaxy.  Since planets do not show up on long-range scans, the
-only way to obtain this information is with the <quote>SENSORS</quote> command.</para>
+<para>Mr. Spock presents you a list of the available information on
+planets in the galaxy which are potential dilithium sources.  Since
+planets do not show up on long-range scans, the only way to obtain
+this information is with the <quote>SENSORS</quote> command.</para>
 
 </sect1>
 <sect1 id="freeze"><title>Freeze</title>
@@ -1522,11 +1528,11 @@ Emeritus.</para>
 promotion available if you go beyond the <quote>Expert</quote> range.
 You can also have a certificate of merit printed with your name, date,
 and Klingon kill rate, provided you are promoted from either the
-<quote>Expert</quote> or <quote>Emeritus</quote> levels. This
-<quote>plaque</quote> requires a 132 column printer. You may need
+<quote>Expert</quote> or <quote>Emeritus</quote> levels. You may need
 print the certificate to a file, import it into your word processor,
 selecting Courier 8pt font, and then print in <quote>landscape
 orientation</quote>.</para>
+<!-- The plaque used to require an 132 column printer. Stas changed that. -->
 
 </chapter>
 <chapter><title>Handy Reference Page</title>