First round of changes from Stas Sergeev.
[super-star-trek.git] / sst.xml
diff --git a/sst.xml b/sst.xml
index 608b3232b41a276c4ffc167853b143f6950ad7fb..f838a1fcf249d3f0415e2aefe508d14323e2c6f8 100644 (file)
--- a/sst.xml
+++ b/sst.xml
 <refsynopsisdiv id='synopsis'>
 
 <cmdsynopsis>
-  <command>sst</command>
+  <command>sst 
+       <arg choice='opt'>-t </arg> 
+       <arg rep='repeat' ><replaceable>command</replaceable></arg>
+  </command>
 </cmdsynopsis>
 
 </refsynopsisdiv>
@@ -32,14 +35,31 @@ invasion fleet and make the galaxy safe for democracy.</para>
 <command>sst</command> in a terminal window to start it.  Typing
 'comands' at the prompt will list all commands; help is available for
 each one individually as well.  Full documentation is <ulink
-url='http://sst.berlios.de/sst-doc.html'>browseable</ulink>.</para>
+url='http://sst.berlios.de/sst-doc.html'>browseable</ulink>.  On
+systems where <filename>/usr/share/doc/sst/</filename> is a legal
+filename, it will probably be installed there as well.</para>
+
+<para>There is one option -t, which forces the original pure-tty mode.
+Normally sst tries to come up in full-screen mode that assumes it is
+running on a cursor-addressable terminal or terminal emulator.</para>
+
+<para>Input tokens for the setup prompts will be read from the
+remainder of the command line before standard input.  Thus, for
+example, you can invoke the program as</para>
+
+<programlisting>
+sst regular medium good foobar
+</programlisting>
+
+<para>to start a regular medium game as a good player 
+with password "foobar".</para>
 </refsect1>
 
 <refsect1 id='authors'><title>AUTHORS</title> <para>Super Star Trek
 was designed and written by David Matuszek, Paul Reynolds, and Don
 Smith in the 1970s.  It was resurrected by Tom Almy.  This version has
 been cleaned up and documented by Eric S. Raymond
-&lt;esr@snark.thyrsus.com&gt;.  There is a <ulink
+<email>esr@snark.thyrsus.com</email>.  There is a <ulink
 url='https://developer.berlios.de/projects/sst/'>project
 page</ulink>.</para>
 </refsect1>