doc/sst.xml

   1 <!DOCTYPE refentry PUBLIC
   2    "-//OASIS//DTD DocBook XML V4.1.2//EN"
   3 "docbook/docbookx.dtd" [
   4 <!ENTITY projecthome      'http://www.catb.org/~esr/super-star-trek'>
   5 ]>
   6 <!--
   7 Copyright by Eric S. Raymond
   8 SPDX-License-Identifier: BSD-2-clause
   9 -->
  10 <refentry id='sst.6'>
  11 <refmeta>
  12 <refentrytitle>sst</refentrytitle>
  13 <manvolnum>6</manvolnum>
  14 <refmiscinfo class='date'>Nov 1 2004</refmiscinfo>
  15 <refmiscinfo class='productname'>SST2K</refmiscinfo>
  16 <refmiscinfo class='source'>SST2K</refmiscinfo>
  17 <refmiscinfo class='manual'>Games</refmiscinfo>
  18 </refmeta>
  19 <refnamediv id='name'>
  20 <refname>sst</refname>
  21 <refpurpose>the classic Super Star Trek game</refpurpose>
  22 </refnamediv>
  23 <refsynopsisdiv id='synopsis'>
  24
  25 <cmdsynopsis>
  26 <command>sst</command>
  27       <arg choice='opt'>-r <replaceable>filename</replaceable></arg>
  28       <arg choice='opt'>-t </arg>
  29       <arg choice='opt'>-x </arg>
  30       <arg choice='opt'>-V </arg>
  31       <arg rep='repeat' ><replaceable>command</replaceable></arg>
  32 </cmdsynopsis>
  33
  34 </refsynopsisdiv>
  35
  36 <refsect1 id='description'><title>DESCRIPTION</title>
  37
  38 <para>The Organian Peace Treaty has collapsed, and the Federation is
  39 at war with the Klingon Empire. Joining the Klingons against the
  40 Federation are the members of the Romulan Star Empire. As commander
  41 of the Starship U.S.S. Enterprise, your job is to wipe out the Klingon
  42 invasion fleet and make the galaxy safe for democracy.</para>
  43
  44 <para>This is one of the great early classic computer games from the
  45 1970s and still has a remarkable amount of play value. Run
  46 <command>sst</command> in a terminal window to start it.  Typing
  47 'commands' at the prompt will list all commands; help is available for
  48 each one individually as well.  Full documentation is <ulink
  49 url='&projecthome;/sst-doc.html'>browseable</ulink>.  On
  50 systems where <filename>/usr/share/doc/sst/</filename> is a legal
  51 filename, it will probably be installed there as well.</para>
  52
  53 <para>The option -t forces the original pure-tty mode.
  54 Normally sst tries to come up in full-screen mode that assumes it is
  55 running on a cursor-addressable terminal or terminal emulator.</para>
  56
  57 <para>The option -r sets up replay of a session logfile.  Commands
  58 in the logfile are executed, then additional commands are taken
  59 from stdin as normal.  The -r option forces -t mode.</para>
  60
  61 <para>The option -x enables some debugging features of interest
  62 probably only to sst2k developers.</para>
  63
  64 <para>With -V, the program emits its version and exits.</para>
  65
  66 <para>Input tokens for the setup prompts will be read from the
  67 remainder of the command line before standard input.  Thus, for
  68 example, you can invoke the program as</para>
  69
  70 <programlisting>
  71 sst regular medium good fancy
  72 </programlisting>
  73
  74 <para>to start a regular medium game as a good player in 'fancy'
  75 mode (all features enabled).</para>
  76 </refsect1>
  77
  78 <refsect1 id='files'><title>FILES</title>
  79 <variablelist>
  80 <varlistentry>
  81 <term><filename>/usr/share/doc/sst/sst.doc</filename></term>
  82 <listitem>
  83 <para>Documentation file.</para>
  84 </listitem>
  85 </varlistentry>
  86 <varlistentry>
  87 <term><filename>$TMPDIR/sst-input.log</filename></term>
  88 <listitem>
  89 <para>Where user input is saved to (send this with your bug reports).
  90 If TMPDIR is not set is defaults to <filename>/tmp</filename>.</para>
  91 </listitem>
  92 </varlistentry>
  93 <varlistentry>
  94 <term><filename>emsave.trk</filename></term>
  95 <listitem>
  96 <para>Save file produced by EMEXIT command.</para>
  97 </listitem>
  98 </varlistentry>
  99 </variablelist>
 100 </refsect1>
 101
 102 <refsect1 id='authors'><title>AUTHORS</title>
 103 <para>Super Star Trek was designed and written by David Matuszek, Paul
 104 Reynolds, and Don Smith beginning in 1973; at that time it was called
 105 simply 'Trek'.  It was resurrected by Tom Almy.  The screen-oriented
 106 interface is by Stas Sergeev. This version has been improved, cleaned
 107 up and documented by Eric S. Raymond
 108 <email>esr@snark.thyrsus.com</email>.  There is a <ulink
 109 url='&projecthome;'>project
 110 page</ulink>.</para>
 111 </refsect1>
 112 </refentry>
 113