<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN">

<!--
	``MakeMan'' SGML Template for a man page
	For more Information, please see http://mama.sourceforge.net

	$Author: Jan Schaumann <jschauma@netmeister.org> $
	$Id: template.sgml, v 0.2 2001/08/24 11:18:34 jschauma Exp $
-->

<refentry id="gnobots2">
	<refmeta>
		<refentrytitle>GNOBOTS</refentrytitle>
		<manvolnum>6</manvolnum>
		<refmiscinfo class="date">August 26th, 2001</refmiscinfo>
		<refmiscinfo class="source">gnome-games</refmiscinfo>
		<refmiscinfo class="title">GNOME User's Manual</refmiscinfo>
	</refmeta>

	<refnamediv>
		<refname>gnobots2</refname>
		<refpurpose>the GNOME robots game</refpurpose>
	</refnamediv>

	<refsynopsisdiv>
		<cmdsynopsis>
			<command>gnobots2</command>
				<arg choice="opt" rep="repeat">OPTION</arg>
		</cmdsynopsis>
	</refsynopsisdiv>

	<refsect1>
		<title>DESCRIPTION</title>
		<para>
			<command>gnobots2</command>, part of the
			<emphasis>gnome-games</emphasis> package, is a development of the
			original Gnome Robots game which was itself based on the text
			based robots game   which can be found on a number of UNIX
			systems, and comes with the BSD games package on Linux systems.
		</para>
		<para>
			This new version includes two types of robots, movable junkheaps,
			multiple game configurations, user definable keyboard layouts,
			sound using ESD if you have it, as well as all of the other
			features which were present in the original Gnome Robots game. 
		</para>
	</refsect1>

	<refsect1>
		<title>USAGE</title>
		<para>
			To run GNOME Robots II, select "games-&gt;GnobotsII" from the Main
			Menu, or type <command>gnobots2</command> on the command line.
		</para>
	</refsect1>

	<refsect1>
		<title>OPTIONS</title>
		<para>
			This program follows the usual GNU command line syntax,
            with long options starting with two dashes (`--'). A
            summary of the options supported by <command>gnobots2</command>
            is included below.
		</para>
		<refsect2>
			<title>GNOME options</title>
			<variablelist>
				<varlistentry>
					<term>--disable-sound</term>
					<listitem>
						<para>Disable sound server usage</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--enable-sound</term>
					<listitem>
						<para>Enable sound server usage</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--espeaker=<replaceable>HOSTNAME:PORT</replaceable></term>
					<listitem>
						<para>
							Host:port on which the sound server to use is running
						</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--version</term>
					<listitem>
						<para>Display version information and exit</para>
					</listitem>
				</varlistentry>
			</variablelist>
		</refsect2>
		<refsect2>
			<title>Help options</title>
			<variablelist>
				<varlistentry>
					<term>-?, --help</term>
					<listitem>
						<para>Show help and exit</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--usage</term>
					<listitem>
						<para>Display brief usage message</para>
					</listitem>
				</varlistentry>
			</variablelist>
		</refsect2>
		<refsect2>
			<title>GTK options</title>
			<variablelist>
				<varlistentry>
					<term>--gdk-debug=<replaceable>FLAGS</replaceable></term>
					<listitem>
						<para>Gdk debugging flags to set</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--gdk-no-debug=<replaceable>FLAGS</replaceable></term>
					<listitem>
						<para>Gdk debugging flags to unset</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--display=<replaceable>DISPLAY</replaceable></term>
					<listitem>
						<para>X display to use</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--sync</term>
					<listitem>
						<para>Make X calls synchronous</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--no-xshm</term>
					<listitem>
						<para>Don't use X shared memory extension</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--name=<replaceable>NAME</replaceable></term>
					<listitem>
						<para>
							Program name as used by the window manager
						</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--class=<replaceable>CLASS</replaceable></term>
					<listitem>
						<para>Program class as used by the window
						manager</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--gxid_host=<replaceable>HOST</replaceable></term>
					<listitem><para></para></listitem>
				</varlistentry>
				<varlistentry>
					<term>--gxid_port=<replaceable>PORT</replaceable></term>
					<listitem><para></para></listitem>
				</varlistentry>
				<varlistentry>
					<term>--xim-preedit=<replaceable>STYLE</replaceable></term>
					<listitem><para></para></listitem>
				</varlistentry>
				<varlistentry>
					<term>--xim-status=<replaceable>STYLE</replaceable></term>
					<listitem><para></para></listitem>
				</varlistentry>
				<varlistentry>
					<term>--gtk-debug=<replaceable>FLAGS</replaceable></term>
					<listitem>
						<para>Gtk+ debugging flags to set</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--gtk-no-debug=<replaceable>FLAGS</replaceable></term>
					<listitem>
						<para>Gtk+ debugging flags to unset</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--g-fatal-warnings</term>
					<listitem>
						<para>Make all warnings fatal</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--gtk-module=<replaceable>MODULE</replaceable></term>
					<listitem>
						<para>Load an additional Gtk module</para>
					</listitem>
				</varlistentry>
			</variablelist>
		</refsect2>
		<refsect2>
			<title>GNOME GUI options</title>
			<variablelist>
				<varlistentry>
					<term>--disable-crash-dialog</term>
					<listitem><para></para></listitem>
				</varlistentry>
			</variablelist>
		</refsect2>
		<refsect2>
			<title>Session management options</title>
			<variablelist>
				<varlistentry>
					<term>--sm-client-id=<replaceable>ID</replaceable></term>
					<listitem>
						<para>Specify session management ID</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--sm-config-prefix=<replaceable>PREFIX</replaceable></term>
					<listitem>
						<para>Specify prefix of saved configuration</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>--sm-disable</term>
					<listitem>
						<para>Disable connection to session manager</para>
					</listitem>
				</varlistentry>
			</variablelist>
		</refsect2>
		<refsect2>
			<title>gnobots2 options</title>
			<variablelist>
				<varlistentry>
					<term>-s, --scenario=<replaceable>NAME</replaceable></term>
					<listitem><para>Set game scenario</para></listitem>
				</varlistentry>
				<varlistentry>
					<term>-c, --config=<replaceable>NAME</replaceable></term>
					<listitem><para>Set game configuration</para></listitem>
				</varlistentry>
				<varlistentry>
					<term>-x, --x=<replaceable>ARG</replaceable></term>
					<listitem><para></para></listitem>
				</varlistentry>
				<varlistentry>
					<term>-y, --y=<replaceable>ARG</replaceable></term>
					<listitem><para></para></listitem>
				</varlistentry>
			</variablelist>
		</refsect2>
	</refsect1>

	<refsect1>
		<title>FILES</title>
		<variablelist>
			<varlistentry>
				<term><filename>~/.gnome/gnobots2</filename></term>
				<listitem>
					<para>Configuration File</para>
				</listitem>
			</varlistentry>
		</variablelist>
	</refsect1>

	<refsect1>
		<title>BUGS</title>
		<para>
			Please report bugs at <ulink
			url="http://bugs.gnome.org/">http://bugs.gnome.org/</ulink>.
		</para>
	</refsect1>

	<refsect1>
		<title>SEE ALSO</title>
		<para>
			The GNOME Robots II manual:
			<filename>/usr/share/gnome/help/gnobots2/C/index.html</filename>
		</para>
		<para>
			<ulink url="http://www.gnome.org">GNOME</ulink>
		</para>
	</refsect1>

	<refsect1>
		<title>AUTHOR</title>
		<para>
			Mark Rae <email>mrae@inpharmatica.co.uk</email>
		</para>
		<para>
			This man-page was written by Jan Schaumann
			<email>jschauma@netmeister.org</email> as part of "<ulink
			url="http://www.netmeister.org/misc/m2p2/index.html">The Missing
			Man Pages Project</ulink>".
		</para>
	</refsect1>
</refentry>
