Sophie: xconq-7.5.0-1.20050612.5mdv2009.1 i586

xconq-7.5.0-1.20050612.5mdv2009.1.i586.rpm

<HTML>
<HEAD>
<!-- This HTML file has been created by texi2html 1.39
     from ./xconq.texi on 12 June 2005 -->

<TITLE>Xconq - X11 Xconq Command Options</TITLE>
</HEAD>
<BODY>
Go to the <A HREF="xconq_1.html">first</A>, <A HREF="xconq_46.html">previous</A>, <A HREF="xconq_48.html">next</A>, <A HREF="xconq_66.html">last</A> section, <A HREF="xconq_toc.html">table of contents</A>.
<HR>


<H2><A NAME="SEC102" HREF="xconq_toc.html#SEC102">X11 Xconq Command Options</A></H2>

<P>
The arguments to an X11 <I>Xconq</I> command consist of a list of player
specifications and possibly some additional options.

</P>
<DL COMPACT>

<DT><CODE>[<VAR>name</VAR>[,<VAR>ai</VAR>][/<VAR>config</VAR>]@]<VAR>display</VAR>[+<VAR>adv</VAR>]</CODE>
<DD>
Attempt to open a display on <VAR>display</VAR> and assign a player/side to
it.  Options include naming the player <VAR>name</VAR>, adding an AI of type
<VAR>ai</VAR>, using the side config file <I>config</I> and asking for an
advantage of <VAR>adv</VAR>.  <VAR>adv</VAR> defaults to 1.  If <VAR>name</VAR> is not
supplied, then <VAR>name</VAR> is assumed to be the display name.  A display
named just <CODE>"_"</CODE> is equivalent to the default display, as in the
value of the environment variable <CODE>DISPLAY</CODE>.

</DL>

<P>
You can get a variety of uses out of player specs.  For instance, the
player spec <CODE>,ai+4</CODE> asks for an AI, of a default type appropriate
to its side, with a starting advantage of 4.  If you want to give
yourself an advantage, just specify <CODE>+4</CODE> anywhere on the command
line.

</P>
<P>
The following options are always available:

</P>
<DL COMPACT>

<DT><CODE>-c <VAR>n</VAR></CODE>
<DD>
Write a checkpoint every <VAR>n</VAR> turns.

<DT><CODE>-design</CODE>
<DD>
Make every side in the game be a designer.

<DT><CODE>-e[,<VAR>ai</VAR>][+<VAR>adv</VAR>] <VAR>n</VAR></CODE>
<DD>
Create <VAR>n</VAR> sides and AIs to play them, using the optional <VAR>ai</VAR>
and <VAR>adv</VAR> to set the AI type and advantage of each.

<DT><CODE>-f <VAR>filename</VAR></CODE>
<DD>
Play the game found in <VAR>filename</VAR>.

<DT><CODE>-g <VAR>gamename</VAR></CODE>
<DD>
Play the game <VAR>gamename</VAR>, if one by that name exists in the library
(the default, or the location specified with <CODE>-L</CODE>.

<DT><CODE>-h <VAR>n</VAR></CODE>
<DD>
Wait for <VAR>n</VAR> human players to join.

<DT><CODE>-help, --help</CODE>
<DD>
List all of the options.  If a game was loaded using <CODE>-g</CODE> or
<CODE>-f</CODE>, also list all of the variants for the game.

<DT><CODE>-host <VAR>name</VAR></CODE>
<DD>
Set up a network game named <VAR>name</VAR>.  <VAR>name</VAR> must currently have
the form <VAR>host</VAR>:<VAR>port</VAR>, where <VAR>host</VAR> is the name of a host,
and <VAR>port</VAR> is a TCP port number.  The port number should not already
be in use; good choices are 4-digit numbers like 1539 (<CODE>'^X' &#60;&#60; 6 +
'^C'</CODE>) or 3075.

<DT><CODE>-join <VAR>name</VAR></CODE>
<DD>
Connect to an existing game named <VAR>name</VAR>.  <VAR>name</VAR> must currently
have the form <VAR>host</VAR>:<VAR>port</VAR>, where <VAR>host</VAR> is the name of a
host, and <VAR>port</VAR> is a TCP port number.

<DT><CODE>-L <VAR>directory</VAR></CODE>
<DD>
Search in <VAR>directory</VAR> for game modules.

<DT><CODE>-noai</CODE>
<DD>
Suppress all AI creation during game setup.

<DT><CODE>-pre <VAR>form</VAR></CODE>
<DD>
<DT><CODE>-post <VAR>form</VAR></CODE>
<DD>
Evaluate the GDL form <VAR>form</VAR> before or after all game modules have
been read in.  These are primarily of interest to game designers and
testers.

<DT><CODE>-r</CODE>
<DD>
Do not automatically add a player with a display set to <CODE>$DISPLAY</CODE>.
If you use this option, you must specify all players on the command line
explicitly.

<DT><CODE>--version</CODE>
<DD>
Display version information.

<DT><CODE>-w</CODE>
<DD>
Suppress all warnings, both during startup and during the game.

<DT><CODE>-x</CODE>
<DD>
Bring up a set of new game, variant, and player setup dialogs.  This
is necessary if you want to both use setup dialogs and to supply
command arguments.

</DL>

<P>
The following options only work if the game design allows for the
corresponding variants.  In each case, the option corresponds to a
particular setting of a particular variant, as seen in the online help
info.

</P>
<DL COMPACT>

<DT><CODE>-M <VAR>width</VAR>[x<VAR>height</VAR>][W<VAR>circumf</VAR>][+<VAR>lat</VAR>][+<VAR>long</VAR>]</CODE>
<DD>
Set the size and position of the game area.  If only <VAR>width</VAR> is
given, then the <VAR>height</VAR> defaults to the same as <VAR>width</VAR>.
Circumference (<VAR>circumf</VAR>) defaults to 360, <VAR>lat</VAR> and <VAR>long</VAR>
default to 0.  The name of the variant is <CODE>world-size</CODE>.

<DT><CODE>-seq</CODE>
<DD>
Set sides to move in sequence, one at a time.  This is equivalent to
<CODE>-vsequential=1</CODE>.

<DT><CODE>-sim</CODE>
<DD>
Set sides to all move simultaneously.  This is equivalent to
<CODE>-vsequential=0</CODE>.

<DT><CODE>-tgame <VAR>mins</VAR></CODE>
<DD>
Set the maximum total number of real minutes that a game may last.
The variant is <CODE>real-time</CODE>.

<DT><CODE>-tside <VAR>mins</VAR></CODE>
<DD>
Set the maximum total number of real minutes allowed for each side's
play.  (This is like a chess clock.)  The variant is <CODE>real-time</CODE>.

<DT><CODE>-tturn <VAR>mins</VAR></CODE>
<DD>
Set the maximum numbers of real minutes for each turn.  When the maximum
is reached, each side automatically finishes, as per the command, and
the next turn begins.  The variant is <CODE>real-time</CODE>.

<DT><CODE>-v</CODE>
<DD>
Set the world to have been seen already.  This is equivalent to
<CODE>-vworld-seen=1</CODE>.

<DT><CODE>-v[<VAR>name</VAR>][=<VAR>value</VAR>]</CODE>
<DD>
Set the variant named <VAR>name</VAR> to have the value <VAR>value</VAR>.  If the
<VAR>value</VAR> is not supplied, it defaults to 1 (<CODE>true</CODE>).

<DT><CODE>-vhelp</CODE>
<DD>
Display variant help info only.  This lists the available variants as
<CODE>-help</CODE> does, but without all the other help info.

<DT><CODE>-V</CODE>
<DD>
Set everything to be seen all the time.  This is equivalent to
<CODE>-vsee-all=1</CODE>.

<DT><CODE>-V0, -Vfalse</CODE>
<DD>
Set everything not to be seen all the time.  This is equivalent to
<CODE>-vsee-all=0</CODE>.

</DL>

<P>
If debugging has been compiled in, then the options <CODE>-D</CODE> and
<CODE>-R</CODE> are also available.  See the <I>Xconq</I> hacking manual for more
detail.

</P>
<P>
The following options apply only to the default X11 display:

</P>
<DL COMPACT>

<DT><CODE>-bg <VAR>color</VAR></CODE>
<DD>
Set the background color for each window.

<DT><CODE>-display <VAR>displayname</VAR></CODE>
<DD>
Open the given display for the default player.

<DT><CODE>-fg <VAR>color</VAR></CODE>
<DD>
Set the foreground color for each window.

<DT><CODE>-geometry <VAR>geometry</VAR></CODE>
<DD>
Set the geometry of the initial window.

<DT><CODE>-name <VAR>name</VAR></CODE>
<DD>
Set the name of the application to use when looking up resources.

</DL>

<HR>
Go to the <A HREF="xconq_1.html">first</A>, <A HREF="xconq_46.html">previous</A>, <A HREF="xconq_48.html">next</A>, <A HREF="xconq_66.html">last</A> section, <A HREF="xconq_toc.html">table of contents</A>.
</BODY>
</HTML>