pioneers(6) [debian man page]

pioneers(6)							   Games Manual 						       pioneers(6)

NAME

       pioneers - network implementation of Settlers of Catan

SYNOPSIS

       pioneers [ --server server ] [ --port port ] [ --name name ]

DESCRIPTION

       This manual page documents briefly the pioneers command.

       Pioneers  is  an  implementation of the popular, award-winning "Settlers of Catan" board game for the GNOME desktop environment.  It uses a
       client/server model for networked play of between two and eight players.  You will need to connect to a machine	running  either  pioneers-
       server-gtk or pioneers-server-console to play.  An AI client, pioneersai, is also available.

OPTIONS

       Pioneers accepts the standard GTK+/GNOME commandline options, and the following options:

       -s, --server server
	      Hostname of the server

       -p, --port port
	      Portname of the server

       -n, --name name
	      Use this name for the player instead of the name in the settings file

       -v, --spectator
	      Connect as spectator instead of as a player

       -m, --meta-server meta-server
	      Connect to this meta-server instead of the meta-server in the settings file

       --debug
	      Turn on debugging mode

       --version
	      Show the version and quit

       When the server and port are both provided, the client automatically quits when the connection is broken.

ENVIRONMENT

       The default settings can be influenced with the following environment variable:

       PIONEERS_META_SERVER
	      The hostname of the meta-server.	If it is not set, the default meta-server will be used.

FILES

       /usr/share/games/pioneers/themes/*
	      Themes for display of the map. Each theme goes in a separate subdirectory.
       /usr/share/pixmaps/pioneers/*
	      Icons
       /usr/share/pixmaps/pioneers.png
	      Main icon
       $XDG_CONFIG_HOME/pioneers
	      Saved settings
       $XDG_DATA_HOME/pioneers/themes
	      Personal themes

AUTHOR

       This  manual page was written by Steve Langasek <vorlon@debian.org>, and updated by Roland Clobus <rclobus@rclobus.nl>.	Pioneers was writ-
       ten by Dave Cole <dave@dccs.com.au>, Andy Heroff <aheroff@mediaone.net>, and Roman Hodek <roman@hodek.net>, with  contributions	from  many
       other developers on the Internet; see the AUTHORS file in the pioneers distribution for a complete list of contributing authors.

SEE ALSO

       More detailed user documentation is available in the online help.

       pioneers-server-gtk(6), pioneers-server-console(6), pioneersai(6)

pioneers							  January 8, 2012						       pioneers(6)

pioneers-meta-server(6) 					   Games Manual 					   pioneers-meta-server(6)

NAME

       pioneers-meta-server - meta game server for Pioneers

SYNOPSIS

       pioneers-meta-server [options]

DESCRIPTION

       Pioneers  is  an  implementation of the popular, award-winning "Settlers of Catan" board game.  It uses a client/server model for networked
       play. This program provides a piece of network infrastructure that helps match pioneers clients to pioneers servers. Casual players of pio-
       neers probably do not need to run this program.

OPTIONS

       -?, --help
	      Print a short help text and exit.

       -d, --daemon
	      Run in daemon mode.

       -P, --pidfile pidfile
	      Write the pid to pidfile (implies -d)

       -r, --redirect location
	      Redirect to another meta-server running at location.

       -s, --servername hostname
	      Use hostname as hostname when creating servers.

       -p, --port-range from-to
	      Use  ports  in  the  range  from-to  (inclusive)	to start servers.  It is advised not to include port 5557 in the range.  (See BUGS
	      below.)  When this range is not specified, the meta-server will not be able to create new games.

       --debug
	      Enable debug messages.

       --syslog-debug
	      Duplicate the messages of the syslog to the console.

       --version
	      Show version information.

ENVIRONMENT

       The default settings of the meta-server can be influenced with the following three environment variables:

       PIONEERS_META_SERVER
	      The hostname the meta-server will use when creating new games. This should be a hostname that can be resolved by	all  clients  that
	      will connect.

       PIONEERS_SERVER_CONSOLE
	      The path to pioneers-server-console.  If it is not set, the default installation path will be used.

       PIONEERS_DIR
	      The path to the game definition files.  If it is not set, the default installation path will be used.

FILES

       /usr/share/games/pioneers/*.game
	      Game definitions

SIGNALS

       USR1
	      Shutdown the meta-server gracefully (can be used to check for memory leaks)

BUGS

       Do not include port 5557 in the --port-range argument because the meta-server uses this port.

AUTHOR

       This  manual  page  was	written  by  Jeff  Breidenbach	<jab@debian.org>, and updated by Roland Clobus <rclobus@rclobus.nl> and Bas Wijnen
       <shevek@fmf.nl>.   Pioneers  was  written  by  Dave  Cole  <dave@dccs.com.au>,  Andy  Heroff  <aheroff@mediaone.net>,   and   Roman   Hodek
       <roman@hodek.net>,  with contributions from many other developers on the Internet; see the AUTHORS file in the pioneers distribution or the
       help->about dialog in one of the graphical programs for a complete list of contributing authors.

SEE ALSO

       pioneers(6), pioneers-server-gtk(6), pioneers-server-console(6)

pioneers							  January 8, 2012					   pioneers-meta-server(6)