33d0d913f53250dce363aac1021778824b4929ad
[super-star-trek.git] / sst.xml
1 <!DOCTYPE refentry PUBLIC 
2    "-//OASIS//DTD DocBook XML V4.1.2//EN"
3    "docbook/docbookx.dtd">
4 <refentry id='sst.6'>
5 <refmeta>
6 <refentrytitle>sst</refentrytitle>
7 <manvolnum>6</manvolnum>
8 <refmiscinfo class='date'>Nov 1 2004</refmiscinfo>
9 </refmeta>
10 <refnamediv id='name'>
11 <refname>sst</refname>
12 <refpurpose>the classic Super Star Trek game</refpurpose>
13 </refnamediv>
14 <refsynopsisdiv id='synopsis'>
15
16 <cmdsynopsis>
17   <command>sst 
18        <arg choice='opt'>-t </arg> 
19        <arg rep='repeat' ><replaceable>command</replaceable></arg>
20   </command>
21 </cmdsynopsis>
22
23 </refsynopsisdiv>
24
25 <refsect1 id='description'><title>DESCRIPTION</title>
26
27 <para>The Organian Peace Treaty has collapsed, and the Federation is
28 at war with the Klingon Empire. Joining the Klingons against the
29 Federation are the members of the Romulan Star Empire. As commander
30 of the Starship U.S.S. Enterprise, your job is to wipe out the Klingon
31 invasion fleet and make the galaxy safe for democracy.</para>
32
33 <para>This is one of the great early classic computer games from the
34 1970s and still has a remarkable amount of play value. Run
35 <command>sst</command> in a terminal window to start it.  Typing
36 'comands' at the prompt will list all commands; help is available for
37 each one individually as well.  Full documentation is <ulink
38 url='http://sst.berlios.de/sst-doc.html'>browseable</ulink>.  On
39 systems where <filename>/usr/share/doc/sst/</filename> is a legal
40 filename, it will probably be installed there as well.</para>
41
42 <para>There is one option -t, which forces the original pure-tty mode.
43 Normally sst tries to come up in full-screen mode that assumes it is
44 running on a cursor-addressable terminal or terminal emulator.</para>
45
46 <para>Input tokens for the setup prompts will be read from the
47 remainder of the command line before standard input.  Thus, for
48 example, you can invoke the program as</para>
49
50 <programlisting>
51 sst regular medium good
52 </programlisting>
53
54 <para>to start a regular medium game as a good player.</para>
55 </refsect1>
56
57 <refsect1 id='authors'><title>AUTHORS</title> 
58 <para>Super Star Trek was designed and written by David Matuszek, Paul
59 Reynolds, and Don Smith in the 1970s.  It was resurrected by Tom Almy.
60 The screen-oriented interface is by Stas Seergeev. This version has
61 been cleaned up and documented by Eric S. Raymond
62 <email>esr@snark.thyrsus.com</email>.  There is a <ulink
63 url='https://developer.berlios.de/projects/sst/'>project
64 page</ulink>.</para>
65 </refsect1>
66 </refentry>
67