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