git.pond.sub.org Git - empserver/blob - man/empire.6

   1 .TH EMPIRE 6
   2 .SH NAME
   3 empire \- Empire client
   4 .SH SYNOPSIS
   5 .B empire
   6 [\fB\-hkruv\fP]
   7 [\fB\-2\fP \fIoutfile\fP]
   8 [\fB\-H\fP \fIhistfile\fP]
   9 [\fB\-s\fP \fI[host:]port\fP]
  10 [\fIcountry\fP
  11 [\fIpassword\fP]]
  12 .br
  13 .SH DESCRIPTION
  14 .B empire
  15 is a bare bones client to connect to the Empire server.  Empire is a
  16 global economic/political/military simulation game wherein players,
  17 representing national governments, make "real-time" decisions
  18 concerning resource allocation, national goals, international
  19 diplomatic efforts, etc.  Extensive records are kept for all players.
  20 .PP
  21 WARNING -- This game is not only addictive but often peels back
  22 the thin veneer of civilization that hides the maniac within.
  23 .SH OPTIONS
  24 .TP
  25 .B \-h
  26 Help.  Print brief usage information and exit.
  27 .TP
  28 .BI \-H " histfile"
  29 Load command history from \fIhistfile\fP, and save it back.  Default
  30 is '~/.empire_history' without \fB\-r\fP, and none with \fB-r\fP.  You
  31 might want to protect your history file from prying eyes.
  32 .IP
  33 Only available when compiled the GNU \fBreadline\fP library.
  34 .TP
  35 .B \-k
  36 If someone else is connected to your country, kill their connection.
  37 .TP
  38 .B \-r
  39 Restricted mode: disable redirections and execute command.
  40 .TP
  41 .BI \-s " [host:]port"
  42 Specify server \fIhost\fR and \fIport\fR.
  43 .TP
  44 .B \-u
  45 Use UTF-8 rather than ASCII character set.
  46 .IP
  47 This requires server version 4.2.21 or later, and a terminal that
  48 understands UTF-8.
  49 .TP
  50 .B \-v
  51 Print version information and exit.
  52 .TP
  53 .BI \-2 " outfile"
  54 Append log of session to \fIoutfile\fR.
  55 .SH OPERANDS
  56 .TP
  57 .I country
  58 The name of your country in the game.
  59 .TP
  60 .I password
  61 The password for your country in the game.
  62 \fIWarning:\fR the password passed here is visible to other users on
  63 the same machine!
  64 .SH ENVIRONMENT VARIABLES
  65 The following environment variables affect the execution of the
  66 client:
  67 .TP
  68 .I EMPIREHOST
  69 Specifies the host to connect to, i.e. where the server runs.
  70 Only effective if no host specified via \-s.
  71 .TP
  72 .I EMPIREPORT
  73 Specifies the port number or service name to connect to.
  74 Only effective if no port specified via \-s.
  75 .TP
  76 .I COUNTRY
  77 The name of your country in the game.
  78 .TP
  79 .I PLAYER
  80 The password for your country in the game, also known as your
  81 representative.
  82 .TP
  83 .I LOGNAME
  84 Your user name.
  85 .TP
  86 .I INPUTRC
  87 The filename for the \fBreadline\fP startup file, overriding the
  88 default of \fI~/.inputrc\fP (see \fBREADLINE\fP below).
  89 .SH READLINE
  90 When compiled with the GNU \fBreadline\fP library, the client supports
  91 fancy line editing and persistent history.  See the readline
  92 documentation for details.
  93 .SH "SEE ALSO"
  94 \fIemp_server\fR(6), \fIreadline\fR(3).
  95 .SH FILES
  96 .TP
  97 .I ~/.inputrc
  98 Individual \fBreadline\fP initialization file
  99 .SH AUTHORS
 100 .nf
 101 Primary Author is Dave Pare <mr-frog@scam.berkeley.edu>
 102 Secondary authors/contributors may include:
 103 James Anderson <jwa@k.cs.cmu.edu>
 104 Jeff Anton <anton@postgres.berkeley.edu>
 105 Markus Armbruster <armbru@pond.sub.org>
 106 Phill Everson <everson@compsci.bristol.ac.uk>
 107 Steven Grimm <koreth@ucscb.UCSC.EDU>
 108 Martin Haukeli <martin.haukeli@gmail.com>
 109 Lewis R. Jansen <lrj@helios.tn.cornell.edu>
 110 Mike St. Johns <stjohns@edn-vax.arpa>
 111 Ron Koenderink <rkoenderink@yahoo.ca>
 112 Nick Lai <lai@cs.ucla.edu>
 113 Shelley Louie <slouie@cory.berekely.edu>
 114 Steve McClure <ionica@empire.cx>
 115 Chris Metcalf <metcalf-christopher@yale.arpa>
 116 Dave Muir Sharnoff <muir@cogsci.berkeley.edu>
 117 Keith Muller <muller@sdcc7.ucsd.edu>
 118 Chuck Musciano <chuck@trantor.harris-atd.com>
 119 Jeff Okamoto <okamoto%hpccc@hplabs.hp.com>
 120 Julian Onions <jpo@computer-science.nottingham.ac.uk>
 121 Kurt Pires <kjpires@ic.berkeley.edu>
 122 Jim Reuter <reuter@decwrl.dec.com>
 123 Peter Vukovich <peterv@monet.berkeley.edu>
 124 Jeff Wallace <jeffw@scam.berkeley.edu>
 125 John Yockey <johny@verinet.com>