X-Git-Url: https://jxself.org/git/?a=blobdiff_plain;f=doc%2Fsst-doc.xml;h=00a703251e217070792915613da11cddd1d11967;hb=bf3f318f863f844f2446b55731d61c66424e8ff8;hp=f912cb376c9a03804fd2f9a8d7483a6396298779;hpb=bc69fb7fa05669a28d94f087f1eaf3e4a937bad6;p=super-star-trek.git
diff --git a/doc/sst-doc.xml b/doc/sst-doc.xml
index f912cb3..00a7032 100644
--- a/doc/sst-doc.xml
+++ b/doc/sst-doc.xml
@@ -383,12 +383,29 @@ described by an example.
10 . . . . . . . . . . Time Left 3.72
+In fancy mode, the display will use letters for Y coordinates.
+
+
+ 1 2 3 4 5 6 7 8 9 10
+ a * . . . . R . . . . Stardate 2516.3
+ b . . . E . . . . . . Condition RED
+ c . . . . . * . B . . Position e1, b4
+ d . . . S . . . . . . Life Support DAMAGED, Reserves=2.30
+ e . . . . . . . K . . Warp Factor 5.0
+ f . K . . . . . * . Energy 2176.24
+ g . . . . . P . . . . Torpedoes 3
+ h . . . . * . . . . . Shields UP, 42% 1050.0 units
+ i . * . . * . . . C . Klingons Left 12
+ j . . . . . . . . . . Time Left 3.72
+
+
+
The left part is a picture of the quadrant. The E at sector 2 -
-4 represents the Enterprise; the B at sector 3 - 8 is a starbase.
-There are ordinary Klingons (K) at sectors 5 - 8 and 6 - 2, and a
-Klingon Commander (C) at 9 - 9. The (GULP)
-Super-commander
(S) is occupies sector 4 - 4, and a
-Romulan (R) is at 1 - 6. An uninhabited planet (P) is at sector 7 - 6
+4 (or b4) represents the Enterprise; the B at sector 3 - 8 (or c8) is a starbase.
+There are ordinary Klingons (K) at sectors 5 - 8 (e8) and 6 - 2 (f2), and a
+Klingon Commander (C) at 9 - 9 (i9). The (GULP)
+Super-commander
(S) is occupies sector 4 - 4 (d4), and a
+Romulan (R) is at 1 - 6 (a6). An uninhabited planet (P) is at sector 7 - 6 (g6)
(if it were inhabited, it would display as a '@'). There are
also a large number of stars (*). The periods (.) are just empty
space—they are printed to help you get your bearings. Sector 6
@@ -733,6 +750,23 @@ the current quadrant, the shortest command would be
and it will be done. In automatic mode, either two or four numbers
must be supplied.
+ If your game is in "fancy" mode, there ia a way to input
+coordinates that avoids any need to remember thet the Y coordinate
+comes first. Y values may be given as lowercase letters starting with
+a = 1. So for example:
+
+
+ a1 = 1 - 1
+ c5 = 3 - 5
+ f2 = 6 - 2
+
+
+The previous move xommand could be expressed as
+
+
+ m a c7 e8
+
+
Automatic mode utilizes the ship's battle
computer.
If the computer is damaged, manual movement must be
used.
@@ -914,6 +948,51 @@ firing.
Phasers have no effect on starbases (which are shielded) or on
stars.
+
+Cloak
+
+
+ Mnemonic: CLOAK
+ Shortest abbreviation: CLOAK
+ Full commands: CLOAK ON
+ CLOAK OFF
+
+
+The cloaking device prevents your ship from being seen by any enemy
+vessels. When the cloaking device is in use, your subspace radio will
+not receive transmissions, torpedoes will be less accurate, you cannot
+dock, and you cannot use your warp engines. Enemy ships will get a
+chance to attack you when you turn cloaking on.
+
+The Treaty of Algeron with the Romulans in Stardate 2311 prohibits the
+use of cloaking devices. If a Romulan ship observes you cloaking or
+uncloaking after this point in time you will be in violation, which
+will hurt your final score.
+
+The Faerie Queene does not have a cloaking device.
+
+
+Capture
+
+
+Mnemonic: CAPTURE
+Shortest abbreviation: CAPTURE
+Full commands: CAPTURE
+
+
+Ask a Klingon To surrender.
+
+The capture command provides a more humane way to end a battle than
+just destroying the Klingon battleship with the crew aboard. Assuming
+the subspace radio and transporter are working, and there is room in
+the brig, this command will ask the captain of the weakest Klingon
+ship in the quadrant to surrender. If the captain agrees, some of the
+crew will transport to your ship and the Klingon ship will be
+destroyed. This command does take time and you will be attacked by any
+other enemy ships if the surrender occurs.
+
+When you dock, any captured Klingons will be transferred to the base
+and you will be credited with the lives you save.
Report
@@ -1015,6 +1094,14 @@ you can enter
to aim between two sectors. However, sector numbers must be 1 to 10
inclusive.
+In fancy mode, you can write "PHO 3 2 6 1 10 4 7" as
+
+
+ pho 3 b6 a10 d7
+
+
+Fractional Y coordinates are not supported.
+
Dock at Starbase
@@ -1445,6 +1532,31 @@ Full command: HELP <command>
This command reads the appropriate section from the SST.DOC file,
providing the file is in the current directory.
+
+Curses switch
+
+
+Mnemonic: CURSES
+Full command: CURSES
+
+
+Switch from tty to curses interface. Mainly useful for
+debugging, when continuing a replayed game.
+
+
+Option setting
+
+
+Mnemonic: OP
+Full command: OPTIONS
+ OPTIONS SET
+ OPTIONS CLEAR
+
+
+Set or clear feature flags. With no argument, list feature flags. The verbs SET and CLEAR
+are available to set or clear a list of feature flags following on the line. Mainly useful
+for development and improving test coverage.
+
Miscellaneous Notes
@@ -1564,6 +1676,7 @@ orientation.
ABBREV FULL COMMAND DEVICE USED
------ ------------ -----------
ABANDON ABANDON shuttle craft
+ CA CAPTURE subspace radio and transporter
C CHART (none)
CO COMPUTER computer
CR CRYSTALS (none)
@@ -1599,7 +1712,9 @@ orientation.
ST STATUS (none)
T TRANSPORT transporter
W WARP <FACTOR> (none)
-
+ CU CURSES (none)
+ OP OPTIONS (none)
+
L. R. Scan: thousands digit: supernova
hundreds digit: Klingons
tens digit: starbases
@@ -1779,6 +1894,8 @@ the algorithm.
The DECUS version had a Deep Space Probe. Looked like a good idea
so I implemented it based on its description.
+I imported CAPTURE from BSD Trek.
+
Stas Sergeev's story
@@ -2022,11 +2139,8 @@ the Austin crew begin work on the UT FORTRAN version.
things, notably a job change and the birth of his first
child.
-c.1977 — Tom Almy translates the UT FORTAN
-version to PDP-11 FORTRAN.
-
21 September 1978 — This was the date on the
-first version Tom Almy saw, on which he based his later C
+first FORTRAN version Tom Almy saw, on which he based his later C
translation.
1979 — Marc Newman adds Tholians, black holes,
@@ -2056,6 +2170,20 @@ this time.
9 October 2006 — Translation to
Python.
+
+1 March 2017 — Color added.
+Cloaking device and capture command added from BSD (via Almy's
+2013 version)
+
+25 March 2019 — At long last, chart entries are
+uniformly dot-filled. (Suppressed in the plain and almy
+interface styles.)
+
+25 August 2023 — Coordinates optionally in
+alphameric mode, e.g "b3" rather than "2 - 3". (Suppressed in the
+plain and almy interface styles.)
+
+
One as-yet unanswered question is when the code changed from