tAll documentation made properly XHTML 1.0 Strict compliant - vaccinewars - be a doctor and try to vaccinate the world
(HTM) git clone git://src.adamsgaard.dk/vaccinewars
(DIR) Log
(DIR) Files
(DIR) Refs
(DIR) README
(DIR) LICENSE
---
(DIR) commit dabd39f0b3982696c48adc233dcd1584056ff1b8
(DIR) parent a9cf309f22940dd0be6f254ef8b80e97c07924c2
(HTM) Author: Ben Webb <ben@salilab.org>
Date: Thu, 25 Oct 2001 22:58:59 +0000
All documentation made properly XHTML 1.0 Strict compliant
Diffstat:
M doc/aiplayer.html | 17 ++++++++++-------
M doc/clientplay.html | 37 +++++++++++++++++--------------
M doc/commandline.html | 86 ++++++++++++++++---------------
M doc/configfile.html | 458 ++++++++++++++++---------------
M doc/credits.html | 13 ++++++++-----
M doc/developer.html | 13 ++++++++-----
M doc/i18n.html | 103 +++++++++++++++++--------------
M doc/index.html | 33 +++++++++++++++++--------------
M doc/installation.html | 79 ++++++++++++++++---------------
M doc/metaserver.html | 38 +++++++++++++++++--------------
M doc/server.html | 23 +++++++++++++----------
M doc/servercommands.html | 43 +++++++++++++++++--------------
M doc/windows.html | 13 ++++++++-----
13 files changed, 509 insertions(+), 447 deletions(-)
---
(DIR) diff --git a/doc/aiplayer.html b/doc/aiplayer.html
t@@ -1,7 +1,10 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
- "http://www.w3.org/TR/html4/strict.dtd">
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
-<html>
<head>
<title>Adding computer-controlled players</title>
</head>
t@@ -17,8 +20,8 @@ they will encounter the cops, you can spy on them, and they will shoot at
you if you give them the chance!</p>
<p>To start a computer-controlled player, all you need is the standard dopewars
-binary. Run it as<br>
-<tt><b>dopewars -c</b></tt><br>
+binary. Run it as<br />
+<tt><b>dopewars -c</b></tt><br />
and it will attempt to connect to the server and port specified in the
<a href="configfile.html">configuration files</a> (or the local host, if none
is specified). Alternatively, you can specify server and port with suitable
t@@ -49,9 +52,9 @@ AI player to give these insults a little more "punch", or
without actually directing the insults themselves at me!) and I'll add them
to the next dopewars release.</p>
-<hr>
+<hr />
<ul>
-<li><a href="index.html">Main index</a>
+<li><a href="index.html">Main index</a></li>
</ul>
<p>Last update: <b>13-05-2001</b></p>
</body>
(DIR) diff --git a/doc/clientplay.html b/doc/clientplay.html
t@@ -1,7 +1,10 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
- "http://www.w3.org/TR/html4/strict.dtd">
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
-<html>
<head>
<title>Playing the game: the dopewars client</title>
</head>
t@@ -28,24 +31,24 @@ described here. It is suggested that you familiarise yourself with the game
using the default settings before getting too adventurous!</p>
<ul>
-<li><a href="#startup">Starting the dopewars client</a>
-<li><a href="#screen">The main game screen</a>
-<li><a href="#server">Connecting to a dopewars server (or not)</a>
-<li><a href="#dealing">Dealing drugs and moving around</a>
-<li><a href="#finance">Your finances: loans and banks</a>
-<li><a href="#cops">Law enforcement and why it's a bad thing</a>
-<li><a href="#multiplayer">Multiplayer: interacting with other players</a>
+<li><a href="#startup">Starting the dopewars client</a></li>
+<li><a href="#screen">The main game screen</a></li>
+<li><a href="#server">Connecting to a dopewars server (or not)</a></li>
+<li><a href="#dealing">Dealing drugs and moving around</a></li>
+<li><a href="#finance">Your finances: loans and banks</a></li>
+<li><a href="#cops">Law enforcement and why it's a bad thing</a></li>
+<li><a href="#multiplayer">Multiplayer: interacting with other players</a></li>
</ul>
<h2><a name="startup">Starting the dopewars client</a></h2>
<ul>
-<li>From the command prompt, run the dopewars client with the command<br>
-<tt><b>dopewars</b></tt><br>
-or to run an <a href="commandline.html#antique">"antique"</a> mode game,<br>
-<tt><b>dopewars -a</b></tt>
+<li>From the command prompt, run the dopewars client with the command<br />
+<tt><b>dopewars</b></tt><br />
+or to run an <a href="commandline.html#antique">"antique"</a> mode game,<br />
+<tt><b>dopewars -a</b></tt></li>
<li>An introduction screen will appear, giving a brief description of the
-game and version and licensing information. Press any key to clear this.
+game and version and licensing information. Press any key to clear this.</li>
</ul>
<h2><a name="screen">The main game screen</a></h2>
t@@ -234,9 +237,9 @@ receive their total assets - their cash and bank balance minus any debt. In
either case you can loot the body and pick up any guns or drugs which the
bitch or player was carrying.</p>
-<hr>
+<hr />
<ul>
-<li><a href="index.html">Main index</a>
+<li><a href="index.html">Main index</a></li>
</ul>
<p>Last update: <b>13-05-2001</b></p>
</body>
(DIR) diff --git a/doc/commandline.html b/doc/commandline.html
t@@ -1,7 +1,10 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
- "http://www.w3.org/TR/html4/strict.dtd">
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
-<html>
<head>
<title>dopewars command line options</title>
</head>
t@@ -10,8 +13,8 @@
<h1>dopewars command line options</h1>
<p>Once you have <a href="installation.html">installed</a> dopewars, you should
-be able to run the binary just by typing<br>
-<tt><b>dopewars</b></tt><br>
+be able to run the binary just by typing<br />
+<tt><b>dopewars</b></tt><br />
(unless you have installed the binary in a directory which is not in your
path, in which case precede it with the path). Run without any options,
the dopewars binary runs as a dopewars client.</p>
t@@ -23,42 +26,42 @@ command line options can be used to override some of these settings (also see
the <b>-g</b> option below).</p>
<p>For a brief description of the command line options, specify the option
-<b>-h</b> with the command<br>
-<tt><b>dopewars -h</b></tt><br>
+<b>-h</b> with the command<br />
+<tt><b>dopewars -h</b></tt><br />
A list of the other command line options is presented below.</p>
<dl>
-<dt><b>-b</b>
+<dt><b>-b</b></dt>
<dd>"Black and white". This tells the dopewars client (if that is what
you're running) not to use coloured text (by default, colour is used if the
-terminal and curses support it).
+terminal and curses support it).</dd>
-<dt><a name="singleplayer"><b>-n</b></a>
+<dt><a name="singleplayer"><b>-n</b></a></dt>
<dd>If running the client, run in single-player mode. Don't try to connect
-to any available dopewars servers.
+to any available dopewars servers.</dd>
-<dt><a name="antique"><b>-a</b></a>
+<dt><a name="antique"><b>-a</b></a></dt>
<dd>Puts the client into "antique" mode; dopewars is derived from the
earlier game for MS-DOS of the same name, which in turn was based on
"Drug Wars" by John E. Dell. "Antique" mode aims to follow the behaviour
of the MS-DOS dopewars closely, and consequently this entails single-player
-mode also.
+mode also.</dd>
-<dt><a name="hiscore"><b>-f <i>file</i></b></a>
+<dt><a name="hiscore"><b>-f <i>file</i></b></a></dt>
<dd>Specifies the path and name of the file used to store the dopewars
high scores in; this can alternatively be specified in the configuration file
with the <a href="configfile.html#HiScoreFile">HiScoreFile=<i>file</i></a>
-option.
+option.</dd>
-<dt><a name="server"><b>-o <i>addr</i></b></a>
+<dt><a name="server"><b>-o <i>addr</i></b></a></dt>
<dd>Gives the name of the machine running a dopewars server, in human
readable (e.g. "nowhere.com") or dotted quad (e.g. 127.0.0.1) form. When the
client is started, if not in single-player mode, it automatically attempts to
connect to this server for a multiplayer game. This can also be specified with
the <a href="configfile.html#Server">Server=<i>addr</i></a> configuration file
-option.
+option.</dd>
-<dt><a name="port"><b>-p <i>port</i></b></a>
+<dt><a name="port"><b>-p <i>port</i></b></a></dt>
<dd>Specifies the numeric port number which the server uses. This is usually
7902, but some servers may use other port numbers to avoid conflicts with
other services running on the machine. If you are running the dopewars client,
t@@ -66,9 +69,10 @@ it will search for a server on this port; if you are running the server, it
will bind to this port and wait for connections from clients (the clients
must also be instructed to use this port, of course). This is equivalent to
setting the port number with the
-<a href="configfile.html#Port">Port=<i>port</i></a> configuration file option.
+<a href="configfile.html#Port">Port=<i>port</i></a> configuration file
+option.</dd>
-<dt><b>-s</b>
+<dt><b>-s</b></dt>
<dd>Runs the <a href="server.html">dopewars server</a>. This mediates
multiplayer games of dopewars, and keeps track of high scores. Any player
wishing to join the game hosted
t@@ -77,9 +81,9 @@ port number which you have chosen, and can then interact with other players
who have done the same thing. By default, a dopewars server will report its
status to the <a href="metaserver.html">metaserver</a>, unless it is set
otherwise in the <a href="configfile.html#MetaServerActive">configuration
-file</a>.
+file</a>.</dd>
-<dt><a name="privateserver"><b>-S</b></a>
+<dt><a name="privateserver"><b>-S</b></a></dt>
<dd>Also runs a dopewars server, but in this case <b>does not</b> report its
status to the metaserver. This does not stop clients from connecting to your
server, of course (unless it is behind a firewall, or the
t@@ -87,62 +91,62 @@ server, of course (unless it is behind a firewall, or the
but it makes it harder to find. The connection to the
<a href="metaserver.html">metaserver</a> can also be disabled by adding
<a href="configfile.html#MetaServerActive">MetaServer.Active=FALSE</a> to the
-configuration files.
+configuration files.</dd>
-<dt><b>-g <i>file</i></b>
+<dt><b>-g <i>file</i></b></dt>
<dd>Instructs dopewars to read setup information from the
<a href="configfile.html">configuration file</a> named by <b><i>file</i></b>.
This file is read immediately - i.e. at the point at which the -g option is
encountered - and so these settings will override any set in the default
configuration files or by previous command line options. Command line options
occurring <b>after</b> the -g option, or for that matter further -g options,
-that change these same settings, will then override them.
+that change these same settings, will then override them.</dd>
-<dt><b>-r <i>file</i></b>
+<dt><b>-r <i>file</i></b></dt>
<dd>Maintains a pid file with the specified name while the server is running.
The file is a one-line text file, containing the process ID of the dopewars
-server process, and is deleted when the server quits.
+server process, and is deleted when the server quits.</dd>
-<dt><a name="computer"><b>-c</b></a>
+<dt><a name="computer"><b>-c</b></a></dt>
<dd>Runs a computerised player. This will connect to the specifed dopewars
server and join in the multiplayer game going on there. When the player
finishes the game (or is eliminated by the other players or the server) the
-program finishes.
+program finishes.</dd>
-<dt><a name="gui-client"><b>-w</b></a>
+<dt><a name="gui-client"><b>-w</b></a></dt>
<dd>If running a dopewars client, then this forces the use of a graphical
user interface. Under Microsoft Windows, this is an "ordinary" window, while
under Unix, this uses GTK+. If a suitable environment is not present (e.g.
the binary was compiled without graphical support, or - in the case of GTK+ -
you are not running X) then dopewars will quit with an error. By default,
if neither -w or -t are specified, then a graphical user interface will be
-used where available, falling back to a text-mode client in case of error.
+used where available, falling back to a text-mode client in case of error.</dd>
-<dt><a name="text-client"><b>-t</b></a>
+<dt><a name="text-client"><b>-t</b></a></dt>
<dd>When running a dopewars client, forces the use of a text-mode (curses
-or console mode) interface, even if graphics are available.
+or console mode) interface, even if graphics are available.</dd>
-<dt><b>-C <i>file</i></b></a>
+<dt><b>-C <i>file</i></b></dt>
<dd>Converts a high score file from an older version of dopewars to the format
used by the current version. The old high score file is replaced with a new
file, and a backup copy of the old file is made. This conversion process is
necessary since older versions of dopewars did not identify the high score
files properly, so they cannot be automatically converted. (Such automatic
conversion would also pose a security risk if the dopewars binary is running
-setgid.)
+setgid.)</dd>
-<dt><b>-h</b>
+<dt><b>-h</b></dt>
<dd>Displays a brief description of the available command line options, and
-contact details.
+contact details.</dd>
-<dt><b>-v</b>
-<dd>Displays the current dopewars version number, and then exits.
+<dt><b>-v</b></dt>
+<dd>Displays the current dopewars version number, and then exits.</dd>
</dl>
-<hr>
+<hr />
<ul>
-<li><a href="index.html">Main index</a>
+<li><a href="index.html">Main index</a></li>
</ul>
<p>Last update: <b>24-09-2001</b></p>
</body>
(DIR) diff --git a/doc/configfile.html b/doc/configfile.html
t@@ -1,7 +1,10 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
- "http://www.w3.org/TR/html4/strict.dtd">
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
-<html>
<head>
<title>dopewars configuration files</title>
</head>
t@@ -18,11 +21,11 @@ location settings <i>Port</i> and <i>Server</i> are still useful).</p>
<p>The order of making dopewars settings is as follows:-</p>
<ol>
-<li>The global configuration file (if present) <b>/etc/dopewars</b>
-<li>The user-specific file (if present) <b>~/.dopewars</b>
+<li>The global configuration file (if present) <b>/etc/dopewars</b></li>
+<li>The user-specific file (if present) <b>~/.dopewars</b></li>
<li><i>(Windows only)</i> The file <b>dopewars-config.txt</b> in the current
-directory
-<li>Options specified on the <a href="commandline.html">command line</a>
+directory</li>
+<li>Options specified on the <a href="commandline.html">command line</a></li>
</ol>
<p>Settings in a configuration file can set numbers, booleans, strings or
t@@ -58,24 +61,25 @@ generally reproduce the default behaviour; obviously you are free to replace
the parts in italics to customise your own server and client.</p>
<ul>
-<li><a href="#fileloc">General configuration: file and server locations</a>
-<li><a href="#metaserver">Metaserver configuration</a>
-<li><a href="#places">Basic configuration: places in the game</a>
-<li><a href="#drugs">Basic configuration: drug prices</a>
-<li><a href="#combat">Basic configuration: guns and fighting</a>
-<li><a href="#advanced">Advanced configuration</a>
+<li><a href="#fileloc">General configuration: file and server
+locations</a></li>
+<li><a href="#metaserver">Metaserver configuration</a></li>
+<li><a href="#places">Basic configuration: places in the game</a></li>
+<li><a href="#drugs">Basic configuration: drug prices</a></li>
+<li><a href="#combat">Basic configuration: guns and fighting</a></li>
+<li><a href="#advanced">Advanced configuration</a></li>
</ul>
<h2><a name="fileloc">General configuration: file and server locations</a></h2>
<dl>
-<dt><a name="Port"><b>Port=<i>7902</i></b></a>
+<dt><a name="Port"><b>Port=<i>7902</i></b></a></dt>
<dd>Tells the dopewars client to look for a server on port <i>7902</i>, and
tells the dopewars server to bind to port <i>7902</i> and wait for connections.
This can be overridden with the -p <a href="commandline.html#port">
-command line option</a>.
+command line option</a>.</dd>
-<dt><a name="Server"><b>Server=<i>"localhost"</i></b></a>
+<dt><a name="Server"><b>Server=<i>"localhost"</i></b></a></dt>
<dd>Tells the dopewars client to look for a server at the address
<i>localhost</i>. Dotted quad (e.g. 127.0.0.1) addresses may also be used here.
If this variable is set to one of the three "special" names
t@@ -85,108 +89,109 @@ list the servers available at the metaserver, prompt the user to enter a
server name and port, or play in single player mode, respectively.
This option can be overridden with the -o <a href="commandline.html#server">
command line option</a> (but be sure to protect the brackets from the shell
-if you use one of the "special" names).
+if you use one of the "special" names).</dd>
-<dt><b>Socks.Active=<i>FALSE</i></b></a>
+<dt><b>Socks.Active=<i>FALSE</i></b></dt>
<dd>Instructs the dopewars client to connect directly to the given server,
without using an intermediate SOCKS server. If this is set to TRUE, all
connections go via. the SOCKS server. By default, SOCKS is not used for
metaserver communications - see the MetaServer.UseSocks variable. N.B. You
cannot run a dopewars server behind a SOCKS server, due to limitations in
-the SOCKS protocol.
+the SOCKS protocol.</dd>
-<dt><b>Socks.NumUID=<i>FALSE</i></b></a>
+<dt><b>Socks.NumUID=<i>FALSE</i></b></dt>
<dd>When connecting to a SOCKS version 4 server, the protocol demands that
the name of the current user be sent for simple authentication; the SOCKS
server then queries identd on your machine to check if you are who you say
you are. dopewars complies with this requirement if this variable is set to
FALSE. However, some Unix implementations of identd send numeric user IDs
rather than user names; dopewars will do the same if you set this variable
-to TRUE. (N.B. Not supported on Windows systems.)
+to TRUE. (N.B. Not supported on Windows systems.)</dd>
-<dt><b>Socks.User=<i>"fred"</i></b></a>
+<dt><b>Socks.User=<i>"fred"</i></b></dt>
<dd>Overrides the username detection (discussed above) completely, and instead
sends the user name <i>"fred"</i> to a SOCKS4 server. If this is set to the
-blank string ("") - the default - this does not happen.
+blank string ("") - the default - this does not happen.</dd>
-<dt><b>Socks.Name=<i>"socks"</i></b></a>
+<dt><b>Socks.Name=<i>"socks"</i></b></dt>
<dd>If using SOCKS, sets the hostname of the SOCKS server to connect to to
-be <i>"socks"</i>.
+be <i>"socks"</i>.</dd>
-<dt><b>Socks.Port=<i>1080</i></b></a>
-<dd>Connects to the SOCKS server on TCP port <i>1080</i>.
+<dt><b>Socks.Port=<i>1080</i></b></dt>
+<dd>Connects to the SOCKS server on TCP port <i>1080</i>.</dd>
-<dt><b>Socks.Version=<i>4</i></b></a>
+<dt><b>Socks.Version=<i>4</i></b></dt>
<dd>Uses SOCKS version <i>4</i>. Version 5 is also supported; SOCKS5 servers
-support username/password authentication, unlike SOCKS4.
+support username/password authentication, unlike SOCKS4.</dd>
-<dt><b>Socks.Auth.User=<i>""</i></b></a>
+<dt><b>Socks.Auth.User=<i>""</i></b></dt>
<dd>If using SOCKS5 with user/password authentication, with the server or AI
player (which can both run unattended) then setting this variable to something
other than "" will enable them to authenticate themselves with the SOCKS
server, provided Socks.Auth.Password is also set. (The game clients prompt
-the user for a username and password on each connect instead.)
+the user for a username and password on each connect instead.)</dd>
-<dt><b>Socks.Auth.Password=<i>""</i></b></a>
-<dd>The corresponding password for Socks.Auth.User, above.
+<dt><b>Socks.Auth.Password=<i>""</i></b></dt>
+<dd>The corresponding password for Socks.Auth.User, above.</dd>
<dt><a name="HiScoreFile"><b>HiScoreFile=<i>"/var/lib/dopewars.sco"</i></b></a>
+</dt>
<dd>Tells the dopewars server (or the client, if running in single-player
mode, not connected to a server) to use the file <i>/var/lib/dopewars.sco</i>
to store high scores. This can be overridden with the -f
-<a href="commandline.html#hiscore">command line option</a>.
+<a href="commandline.html#hiscore">command line option</a>.</dd>
-<dt><b>Pager=<i>"more"</i></b>
+<dt><b>Pager=<i>"more"</i></b></dt>
<dd>Sets the pager used to display multi-page output in an interactive server
-to <i>more</i>. ("less" is a popular alternative)
+to <i>more</i>. ("less" is a popular alternative)</dd>
-<dt><b>ConfigVerbose=<i>FALSE</i></b>
+<dt><b>ConfigVerbose=<i>FALSE</i></b></dt>
<dd>Prints extra feedback information when processing the config. file if set
to TRUE; this only takes affect, of course, after the ConfigVerbose variable is
-set, and then remains in force until it is reset again.
+set, and then remains in force until it is reset again.</dd>
</dl>
<h2><a name="metaserver">Metaserver configuration</a></h2>
<dl>
-<dt><a name="MetaServerActive"><b>MetaServer.Active=<i>TRUE</i></b></a>
+<dt><a name="MetaServerActive"><b>MetaServer.Active=<i>TRUE</i></b></a></dt>
<dd>Tells the dopewars server to report its status to the
<a href="metaserver.html">metaserver</a>. If <i>TRUE</i>
is replaced by <i>FALSE</i> the server will not report to the metaserver.
This setting, if set to TRUE, can be overridden by the -S
-<a href="commandline.html#privateserver">command line option</a>.
+<a href="commandline.html#privateserver">command line option</a>.</dd>
-<dt><b>MetaServer.Name=<i>"dopewars.sourceforge.net"</i></b>
+<dt><b>MetaServer.Name=<i>"dopewars.sourceforge.net"</i></b></dt>
<dd>Tells dopewars that the metaserver is located at
<i>dopewars.sourceforge.net</i>. See the
<a href="metaserver.html">metaserver</a> page, and below, for information
-about connecting to the dopewars metaserver via. a proxy web server.
+about connecting to the dopewars metaserver via. a proxy web server.</dd>
-<dt><b>MetaServer.Port=<i>80</i></b>
+<dt><b>MetaServer.Port=<i>80</i></b></dt>
<dd>Instructs dopewars that the metaserver can be found on TCP port
<i>80</i>. This is the standard HTTP port for Web access. (You shouldn't need
-to change this, even if you connect via. a proxy.)
+to change this, even if you connect via. a proxy.)</dd>
-<dt><b>MetaServer.ProxyName=<i>"proxy.com"</i></b>
+<dt><b>MetaServer.ProxyName=<i>"proxy.com"</i></b></dt>
<dd>Sends all requests to the metaserver via. the web proxy at <i>proxy.com</i>.
If this is set to a blank string (the default) then the connection to the
-metaserver is made directly.
+metaserver is made directly.</dd>
-<dt><b>MetaServer.ProxyPort=<i>8080</i></b>
+<dt><b>MetaServer.ProxyPort=<i>8080</i></b></dt>
<dd>Connects to the web proxy on port <i>8080</i>. (It then connects to the
metaserver on the port specified by MetaServer.Port.) This variable is ignored
-if MetaServer.ProxyName is blank.
+if MetaServer.ProxyName is blank.</dd>
-<dt><b>MetaServer.Path=<i>"/metaserver.php"</i></b>
+<dt><b>MetaServer.Path=<i>"/metaserver.php"</i></b></dt>
<dd>Tells dopewars that the PHP script on the metaserver, for server
registration (server mode) or listing the available servers (client mode) is
-<i>/metaserver.php</i>.
+<i>/metaserver.php</i>.</dd>
<dt><a name="MetaServerComment"><b>MetaServer.Comment=<i>"dopewars
-server"</i></b></a>
+server"</i></b></a></dt>
<dd>Sets the comment for your server, which appears on the list of servers
-maintained by the metaserver, to <i>dopewars server</i>.
+maintained by the metaserver, to <i>dopewars server</i>.</dd>
-<dt><b>MetaServer.LocalName=<i>"dope-serv.com"</i></b>
+<dt><b>MetaServer.LocalName=<i>"dope-serv.com"</i></b></dt>
<dd>Tells the metaserver that the preferred hostname of your dopewars server
machine is <i>dope-serv.com</i>. By default, the metaserver tries to ascertain
your domain name from the connection, and this can fail if you connect via.
t@@ -195,380 +200,389 @@ domain name. You must also set MetaServer.Password to the password given to
you by the <a href="mailto:ben@bellatrix.pcl.ox.ac.uk">metaserver
maintainer</a> for this to work. A blank LocalName can also be used with a
suitable password to identify "your" server, even if its IP changes.
-See the <a href="metaserver.html">metaserver page</a> for more details.
+See the <a href="metaserver.html">metaserver page</a> for more details.</dd>
-<dt><b>MetaServer.Password=<i>"auth"</i></b>
+<dt><b>MetaServer.Password=<i>"auth"</i></b></dt>
<dd>Uses the password <i>auth</i> to authenticate your dopewars server's
-hostname (see MetaServer.LocalName above) with the metaserver.
+hostname (see MetaServer.LocalName above) with the metaserver.</dd>
-<dt><b>MetaServer.UseSocks=<i>FALSE</i></b>
+<dt><b>MetaServer.UseSocks=<i>FALSE</i></b></dt>
<dd>Even if "Socks.Active" is TRUE, do not use SOCKS for metaserver
-communication - connect directly to the metaserver or proxy.
+communication - connect directly to the metaserver or proxy.</dd>
-<dt><b>MetaServer.Auth.User=<i>""</i></b></a>
+<dt><b>MetaServer.Auth.User=<i>""</i></b></dt>
<dd>If the metaserver webpage is on a restricted access server (i.e. it
requires HTTP Basic authentication), and you wish to connect with the server
or AI player (which can both run unattended) then setting this variable to
something other than "" will enable them to authenticate themselves,
provided MetaServer.Auth.Password is also set. (The game clients prompt
-the user for a username and password on each connect instead.)
+the user for a username and password on each connect instead.)</dd>
-<dt><b>MetaServer.Auth.Password=<i>""</i></b></a>
-<dd>The corresponding password for MetaServer.Auth.User, above.
+<dt><b>MetaServer.Auth.Password=<i>""</i></b></dt>
+<dd>The corresponding password for MetaServer.Auth.User, above.</dd>
-<dt><b>MetaServer.Proxy.User=<i>""</i></b></a>
+<dt><b>MetaServer.Proxy.User=<i>""</i></b></dt>
<dd>In a similar way to MetaServer.Auth.User, above, this enables a dopewars
-server or AI player to authenticate itself with a web proxy.
+server or AI player to authenticate itself with a web proxy.</dd>
-<dt><b>MetaServer.Proxy.Password=<i>""</i></b></a>
-<dd>The corresponding password for MetaServer.Proxy.User, above.
+<dt><b>MetaServer.Proxy.Password=<i>""</i></b></dt>
+<dd>The corresponding password for MetaServer.Proxy.User, above.</dd>
</dl>
<h2><a name="places">Basic configuration: places in the game</a></h2>
<dl>
-<dt><b>NumLocation=<i>8</i></b>
+<dt><b>NumLocation=<i>8</i></b></dt>
<dd>Sets the number of locations in the game to <i>8</i>. Note that if too
many locations are specified, the client may not be able to display them
-all!
+all!</dd>
-<dt><b>Location[<i>4</i>].Name=<i>"Manhattan"</i></b>
+<dt><b>Location[<i>4</i>].Name=<i>"Manhattan"</i></b></dt>
<dd>Sets the name of the <i>4th</i> location in the game to <i>Manhattan</i>.
The index within the square brackets can range from 1 to whatever
-NumLocation is set to above, or an error will be reported.
+NumLocation is set to above, or an error will be reported.</dd>
-<dt><b>Location[<i>4</i>].PolicePresence=<i>90</i></b>
+<dt><b>Location[<i>4</i>].PolicePresence=<i>90</i></b></dt>
<dd>Sets the police presence in the <i>4th</i> location to <i>90%</i>. This
affects how likely it is for the police to attack players at each location
-when arriving, dropping drugs, or attacking other players.
+when arriving, dropping drugs, or attacking other players.</dd>
-<dt><b>Location[<i>4</i>].MinDrug=<i>4</i></b>
+<dt><b>Location[<i>4</i>].MinDrug=<i>4</i></b></dt>
<dd>Sets the minimum possible number of different drugs that will be on sale
-to players in location number <i>4</i> to <i>4</i>.
+to players in location number <i>4</i> to <i>4</i>.</dd>
-<dt><b>Location[<i>4</i>].MaxDrug=<i>10</i></b>
+<dt><b>Location[<i>4</i>].MaxDrug=<i>10</i></b></dt>
<dd>Sets the maximum possible number of different drugs that will be on sale
-to players in location number <i>4</i> to <i>10</i>.
+to players in location number <i>4</i> to <i>10</i>.</dd>
-<dt><b>LoanShark=<i>1</i></b>
+<dt><b>LoanShark=<i>1</i></b></dt>
<dd>Makes the loan shark pop up when players visit location number <i>1</i>.
To stop the loan shark from appearing at all (making it rather difficult to
pay off debts) set this number to something which is not a valid location,
-such as 0 (zero).
+such as 0 (zero).</dd>
-<dt><b>Bank=<i>1</i></b>
-<dd>Makes the bank appear when a player visits location <i>1</i> (the Bronx).
+<dt><b>Bank=<i>1</i></b></dt>
+<dd>Makes the bank appear when a player visits location <i>1</i> (the
+Bronx).</dd>
-<dt><b>GunShop=<i>2</i></b>
+<dt><b>GunShop=<i>2</i></b></dt>
<dd>Players can visit the gun shop in location number <i>2</i> (the
-Ghetto).
+Ghetto).</dd>
-<dt><b>RoughPub=<i>2</i></b>
+<dt><b>RoughPub=<i>2</i></b></dt>
<dd>Players can visit the rough pub to hire bitches in location number
-<i>2</i>.
+<i>2</i>.</dd>
-<dt><b>LoanSharkName=<i>"the Loan Shark"</i></b>
-<dd>The loan shark is known by the name <i>"the Loan Shark"</i> during the game.
+<dt><b>LoanSharkName=<i>"the Loan Shark"</i></b></dt>
+<dd>The loan shark is known by the name <i>"the Loan Shark"</i> during the
+game.</dd>
-<dt><b>BankName=<i>"the bank"</i></b>
-<dd>The bank is known by the name <i>"the bank"</i> during the game.
+<dt><b>BankName=<i>"the bank"</i></b></dt>
+<dd>The bank is known by the name <i>"the bank"</i> during the game.</dd>
-<dt><b>GunShopName=<i>"Dan's House of Guns"</i></b>
+<dt><b>GunShopName=<i>"Dan's House of Guns"</i></b></dt>
<dd>The gun shop is known by the name <i>"Dan's House of Guns"</i> during
-the game.
+the game.</dd>
-<dt><b>RoughPubName=<i>"the pub"</i></b>
-<dd>The pub is known by the name <i>"the pub"</i> during the game.
+<dt><b>RoughPubName=<i>"the pub"</i></b></dt>
+<dd>The pub is known by the name <i>"the pub"</i> during the game.</dd>
</dl>
<h2><a name="drugs">Basic configuration: drug prices</a></h2>
<dl>
-<dt><b>NumDrug=<i>12</i></b>
-<dd>Sets there to be <i>12</i> different types of drug in the game.
+<dt><b>NumDrug=<i>12</i></b></dt>
+<dd>Sets there to be <i>12</i> different types of drug in the game.</dd>
-<dt><b>Drug[<i>6</i>].Name=<i>"MDA"</i></b>
-<dd>Sets the name of the <i>6th</i> drug to be <i>MDA</i>.
+<dt><b>Drug[<i>6</i>].Name=<i>"MDA"</i></b></dt>
+<dd>Sets the name of the <i>6th</i> drug to be <i>MDA</i>.</dd>
-<dt><b>Drug[<i>6</i>].MinPrice=<i>1500</i></b>
+<dt><b>Drug[<i>6</i>].MinPrice=<i>1500</i></b></dt>
<dd>Sets the usual minimum price of the <i>6th</i> drug (in the absence of
-"special events" such as drug busts) to be <i>$1,500</i>.
+"special events" such as drug busts) to be <i>$1,500</i>.</dd>
-<dt><b>Drug[<i>6</i>].MaxPrice=<i>4400</i></b>
-<dd>Sets the usual maximum price of drug number <i>6</i> to be <i>$4,400</i>.
+<dt><b>Drug[<i>6</i>].MaxPrice=<i>4400</i></b></dt>
+<dd>Sets the usual maximum price of drug number <i>6</i> to be
+<i>$4,400</i>.</dd>
-<dt><b>Drug[<i>1</i>].Cheap=<i>TRUE</i></b>
+<dt><b>Drug[<i>1</i>].Cheap=<i>TRUE</i></b></dt>
<dd>Tells dopewars that drug <i>1</i> (by default, Acid) can occasionally
-be especially cheap (if this is set to FALSE, this does not happen).
+be especially cheap (if this is set to FALSE, this does not happen).</dd>
<dt><b>Drug[<i>1</i>].CheapStr=<i>"The market is flooded with cheap
-home-made acid!"</i></b>
+home-made acid!"</i></b></dt>
<dd>Sets the message to display to alert players that drug number <i>1</i>
-is especially cheap.
+is especially cheap.</dd>
-<dt><b>Drugs.CheapDivide=<i>4</i></b>
+<dt><b>Drugs.CheapDivide=<i>4</i></b></dt>
<dd>Tells dopewars that whenever a drug is "specially" cheap, divide the
normal price distribution (between Drug[x].MinPrice and Drug[x].MaxPrice) by
-<i>4</i>.
+<i>4</i>.</dd>
-<dt><b>Drug[<i>4</i>].Expensive=<i>TRUE</i></b>
+<dt><b>Drug[<i>4</i>].Expensive=<i>TRUE</i></b></dt>
<dd>Tells dopewars that drug <i>4</i> (normally Heroin) can occasionally be
-particuarly expensive (FALSE cancels this).
+particuarly expensive (FALSE cancels this).</dd>
<dt><b>Drugs.ExpensiveStr1=<i>"Cops made a big %tde bust! Prices are
-outrageous!"</i></b>
+outrageous!"</i></b></dt>
<dd>Sets the string that is displayed when <b>any</b> drug is particularly
expensive. This is similar to a standard C-style format string - i.e. the
%tde is replaced by the name of the drug which is expensive. (See the
<a href="i18n.html">Internationalization page</a> for further information
-on this notation.) This string is displayed 50% of the time for expensive drugs.
+on this notation.) This string is displayed 50% of the time for expensive
+drugs.</dd>
<dt><b>Drugs.ExpensiveStr2=<i>"Addicts are buying %tde at ridiculous
-prices!"</i></b>
+prices!"</i></b></dt>
<dd>Sets the string which is used for expensive drugs the other 50% of the
-time.
+time.</dd>
-<dt><b>Drugs.ExpensiveMultiply=<i>4</i></b>
+<dt><b>Drugs.ExpensiveMultiply=<i>4</i></b></dt>
<dd>Tells dopewars that whenever a drug is "specially" expensive, multiply the
normal price distribution (between Drug[x].MinPrice and Drug[x].MaxPrice) by
-<i>4</i>.
+<i>4</i>.</dd>
</dl>
<h2><a name="combat">Basic configuration: guns and fighting</a></h2>
<dl>
-<dt><b>NumGun=<i>4</i></b>
+<dt><b>NumGun=<i>4</i></b></dt>
<dd>Configures the game to have <i>4</i> guns available to players at the
-gun shop.
+gun shop.</dd>
-<dt><b>Gun[<i>3</i>].Name=<i>"Ruger"</i></b>
-<dd>Sets the name of the <i>3rd</i> gun to <i>Ruger</i>.
+<dt><b>Gun[<i>3</i>].Name=<i>"Ruger"</i></b></dt>
+<dd>Sets the name of the <i>3rd</i> gun to <i>Ruger</i>.</dd>
-<dt><b>Gun[<i>3</i>].Price=<i>2900</i></b>
+<dt><b>Gun[<i>3</i>].Price=<i>2900</i></b></dt>
<dd>Sets the price in the gun shop of the <i>3rd</i> gun to <i>$2,900</i>.
Guns offered "on the street" (i.e. by random events) will be priced at 10%
-of the value set here.
+of the value set here.</dd>
-<dt><b>Gun[<i>3</i>].Space=<i>4</i></b>
+<dt><b>Gun[<i>3</i>].Space=<i>4</i></b></dt>
<dd>Tells dopewars that gun number <i>3</i> uses <i>4</i> spaces in the
-inventory - i.e. carrying one of these guns uses the same spaces as 4 drugs.
+inventory - i.e. carrying one of these guns uses the same spaces as 4
+drugs.</dd>
-<dt><b>Gun[<i>3</i>].Damage=<i>4</i></b>
-<dd>Defines gun number <i>3</i> to do up to <i>4</i> points of damage.
+<dt><b>Gun[<i>3</i>].Damage=<i>4</i></b></dt>
+<dd>Defines gun number <i>3</i> to do up to <i>4</i> points of damage.</dd>
-<dt><b>PlayerArmour=<i>100</i></b>
+<dt><b>PlayerArmour=<i>100</i></b></dt>
<dd>Sets the percentage armour rating of each player to <i>100</i> - this
defines the amount of health that you lose when you are successfully hit.
If 100, you lose the same number of health points as the gun's damage.
If more than 100, you lose fewer health points, and if less than 100, you lose
<b>more</b> health points than the gun's damage. This rating applies only
-when you have no bitches.
+when you have no bitches.</dd>
-<dt><b>BitchArmour=<i>50</i></b>
-<dd>Sets the percentage armour rating of each bitch to <i>50</i>.
+<dt><b>BitchArmour=<i>50</i></b></dt>
+<dd>Sets the percentage armour rating of each bitch to <i>50</i>.</dd>
-<dt><b>NumCop=<i>3</i></b>
+<dt><b>NumCop=<i>3</i></b></dt>
<dd>Configures the game to have <i>3</i> cops. If you kill the first one, you
will later be attacked by the second one, and so on. (The last cop is 'undead'
-and will return even if you kill him.)
+and will return even if you kill him.)</dd>
-<dt><b>Cop[<i>1</i>].Name=<i>Officer Hardass</i></b>
-<dd>Names the first cop to attack you <i>"Officer Hardass"</i>.
+<dt><b>Cop[<i>1</i>].Name=<i>Officer Hardass</i></b></dt>
+<dd>Names the first cop to attack you <i>"Officer Hardass"</i>.</dd>
-<dt><b>Cop[<i>1</i>].DeputyName=<i>deputy</i></b>
-<dd>Names a solitary deputy accompanying the first cop <i>"deputy"</i>.
+<dt><b>Cop[<i>1</i>].DeputyName=<i>deputy</i></b></dt>
+<dd>Names a solitary deputy accompanying the first cop <i>"deputy"</i>.</dd>
-<dt><b>Cop[<i>1</i>].DeputiesName=<i>deputies</i></b>
-<dd>Names more than one deputy accompanying the first cop <i>"deputies"</i>.
+<dt><b>Cop[<i>1</i>].DeputiesName=<i>deputies</i></b></dt>
+<dd>Names more than one deputy accompanying the first cop
+<i>"deputies"</i>.</dd>
-<dt><b>Cop[<i>1</i>].Armour=<i>4</i></b>
-<dd>Sets the armour rating of the first cop to <i>4%</i>.
+<dt><b>Cop[<i>1</i>].Armour=<i>4</i></b></dt>
+<dd>Sets the armour rating of the first cop to <i>4%</i>.</dd>
-<dt><b>Cop[<i>1</i>].DeputyArmour=<i>3</i></b>
-<dd>Sets the armour rating of the first cop's deputies to <i>3%</i>.
+<dt><b>Cop[<i>1</i>].DeputyArmour=<i>3</i></b></dt>
+<dd>Sets the armour rating of the first cop's deputies to <i>3%</i>.</dd>
-<dt><b>Cop[<i>1</i>].AttackPenalty=<i>30</i></b>
+<dt><b>Cop[<i>1</i>].AttackPenalty=<i>30</i></b></dt>
<dd>When attacking another player, whether you successfully hit them depends
on whether your attack rating is greater than their defence rating, which are
generally numbers between 0 and 100 (think of them as percentages). This
-penalises the first cop (and his deputies) by <i>30%</i> when attacking you.
+penalises the first cop (and his deputies) by <i>30%</i> when attacking
+you.</dd>
-<dt><b>Cop[<i>1</i>].DefendPenalty=<i>30</i></b>
+<dt><b>Cop[<i>1</i>].DefendPenalty=<i>30</i></b></dt>
<dd>Penalises the first cop (and his deputies) by <i>30%</i> when defending
-against a player.
+against a player.</dd>
-<dt><b>Cop[<i>1</i>].MinDeputies=<i>2</i></b>
-<dd>The first cop will be accompanied by a minimum of <i>2</i> deputies.
+<dt><b>Cop[<i>1</i>].MinDeputies=<i>2</i></b></dt>
+<dd>The first cop will be accompanied by a minimum of <i>2</i> deputies.</dd>
-<dt><b>Cop[<i>1</i>].MaxDeputies=<i>8</i></b>
-<dd>The first cop will be accompanied by a maximum of <i>8</i> deputies.
+<dt><b>Cop[<i>1</i>].MaxDeputies=<i>8</i></b></dt>
+<dd>The first cop will be accompanied by a maximum of <i>8</i> deputies.</dd>
-<dt><b>Cop[<i>1</i>].GunIndex=<i>0</i></b>
+<dt><b>Cop[<i>1</i>].GunIndex=<i>0</i></b></dt>
<dd>The first cop, and his deputies, will carry gun number <i>0</i>
-(zero-based).
+(zero-based).</dd>
-<dt><b>Cop[<i>1</i>].CopGun=<i>1</i></b>
-<dd>The first cop will carry <i>1</i> gun.
+<dt><b>Cop[<i>1</i>].CopGun=<i>1</i></b></dt>
+<dd>The first cop will carry <i>1</i> gun.</dd>
-<dt><b>Cop[<i>1</i>].DeputyGun=<i>1</i></b>
-<dd>The first cop's deputies will each carry <i>1</i> gun.
+<dt><b>Cop[<i>1</i>].DeputyGun=<i>1</i></b></dt>
+<dd>The first cop's deputies will each carry <i>1</i> gun.</dd>
</dl>
<h2><a name="advanced">Advanced configuration</a></h2>
<dl>
-<dt><b>LogLevel=<i>2</i></b>
+<dt><b>LogLevel=<i>2</i></b></dt>
<dd>Most server log messages are given a priority level, from 0 (most urgent)
to 5 (most verbose). This setting instructs the server only to log messages
-from level 0 up to <i>2</i>, inclusive.
+from level 0 up to <i>2</i>, inclusive.</dd>
-<dt><b>LogTimestamp=<i>"[%H:%M:%S] "</i></b>
+<dt><b>LogTimestamp=<i>"[%H:%M:%S] "</i></b></dt>
<dd>Prefixes all log messages with a timestamp of the form (e.g.)
<i>[16:34:49]</i>. This is a string which is passed as input to the
<tt>strftime(3)</tt> function. If this is set to a blank string, then no
-timestamp is added to log messages.
+timestamp is added to log messages.</dd>
-<dt><b>NumTurns=<i>31</i></b>
+<dt><b>NumTurns=<i>31</i></b></dt>
<dd>Defines the game to end after <i>31</i> "days" or turns. If this is set
-to 0 (zero) the game never ends for a player, unless they quit or are killed.
+to 0 (zero) the game never ends for a player, unless they quit or are
+killed.</dd>
-<dt><b>Sanitized=<i>FALSE</i></b>
+<dt><b>Sanitized=<i>FALSE</i></b></dt>
<dd>If set to TRUE, this "sanitizes" the game by removing all drug references
from the random events. To completely remove drug references, of course, you
-must also alter the drug names above.
+must also alter the drug names above.</dd>
-<dt><b>DrugSortMethod=<i>1</i></b>
+<dt><b>DrugSortMethod=<i>1</i></b></dt>
<dd>Tells the dopewars client how to sort the names of available drugs at
each location for display. The default, <i>1</i>, sorts them in alphabetical
order by their names. The choices are as follows:-
<ul>
-<li><b>1</b>. Sort in forward alphabetical order by name
-<li><b>2</b>. Sort in reverse alphabetical order by name
-<li><b>3</b>. Sort in order of current price, cheapest first
-<li><b>4</b>. Sort in order of current price, most expensive first
+<li><b>1</b>. Sort in forward alphabetical order by name</li>
+<li><b>2</b>. Sort in reverse alphabetical order by name</li>
+<li><b>3</b>. Sort in order of current price, cheapest first</li>
+<li><b>4</b>. Sort in order of current price, most expensive first</li>
</ul>
+</dd>
-<dt><b>FightTimeout=<i>5</i></b>
+<dt><b>FightTimeout=<i>5</i></b></dt>
<dd>If a player in a firefight with another player fails to fire back
within <i>5</i> seconds, lets his/her enemy have another shot. If this
is set to 0 (zero) timeouts are disabled, and players may take as long
-as they like to fire back.
+as they like to fire back.</dd>
-<dt><b>IdleTimeout=<i>14400</i></b>
+<dt><b>IdleTimeout=<i>14400</i></b></dt>
<dd>If a connected player in a game does nothing to interact with the
-server for <i>14400</i> seconds, he/she will be automatically disconnected.
+server for <i>14400</i> seconds, he/she will be automatically disconnected.</dd>
-<dt><b>ConnectTimeout=<i>300</i></b>
+<dt><b>ConnectTimeout=<i>300</i></b></dt>
<dd>If a player takes more than <i>300</i> seconds to complete the process
of connecting or disconnecting to the server, the server will sever the
-connection.
+connection.</dd>
-<dt><a name="MaxClients"><b>MaxClients=<i>20</i></b></a>
+<dt><a name="MaxClients"><b>MaxClients=<i>20</i></b></a></dt>
<dd>Prevents more than <i>20</i> clients from connecting to the server at
-any one time.
+any one time.</dd>
-<dt><a name="AITurnPause"><b>AITurnPause=<i>5</i></b></a>
+<dt><a name="AITurnPause"><b>AITurnPause=<i>5</i></b></a></dt>
<dd>Makes computer-controlled client players run from this machine (not
necessarily AI players that connect to a server run on this machine) wait
<i>5</i> seconds between moving from location to location - i.e. a turn
-takes at least 5 seconds.
+takes at least 5 seconds.</dd>
-<dt><b>StartCash=<i>2000</i></b>
-<dd>Each player will start the game with <i>$2,000</i> in cash.
+<dt><b>StartCash=<i>2000</i></b></dt>
+<dd>Each player will start the game with <i>$2,000</i> in cash.</dd>
-<dt><b>StartDebt=<i>5000</i></b>
+<dt><b>StartDebt=<i>5000</i></b></dt>
<dd>Each player will start the game with a debt to the loan shark of
-<i>$5,000</i>.
+<i>$5,000</i>.</dd>
-<dt><b>Names.Bitch=<i>"bitch"</i></b>
+<dt><b>Names.Bitch=<i>"bitch"</i></b></dt>
<dd>Sets the word used to describe a single "bitch" in the game. Bitch, gun
and drug names are automatically capitalised where necessary by the dopewars
-code.
+code.</dd>
-<dt><b>Names.Bitches=<i>"bitches"</i></b>
-<dd>Sets the word used to describe two or more "bitches".
+<dt><b>Names.Bitches=<i>"bitches"</i></b></dt>
+<dd>Sets the word used to describe two or more "bitches".</dd>
-<dt><b>Names.Gun=<i>"gun"</i></b>
+<dt><b>Names.Gun=<i>"gun"</i></b></dt>
<dd>Sets the word used to describe a single "gun" (for example, it could be
-replaced by "knife").
+replaced by "knife").</dd>
-<dt><b>Names.Guns=<i>"guns"</i></b>
-<dd>Sets the word used to describe two or more "guns".
+<dt><b>Names.Guns=<i>"guns"</i></b></dt>
+<dd>Sets the word used to describe two or more "guns".</dd>
-<dt><b>Names.Drug=<i>"drug"</i></b>
+<dt><b>Names.Drug=<i>"drug"</i></b></dt>
<dd>Sets the word used to describe a single "drug" (for example, it could be
-replaced by "candy bar" or something similarly innocuous).
+replaced by "candy bar" or something similarly innocuous).</dd>
-<dt><b>Names.Drugs=<i>"drugs"</i></b>
-<dd>Sets the word used to describe two or more "drugs".
+<dt><b>Names.Drugs=<i>"drugs"</i></b></dt>
+<dd>Sets the word used to describe two or more "drugs".</dd>
-<dt><b>Names.Month=<i>"12-"</i></b>
+<dt><b>Names.Month=<i>"12-"</i></b></dt>
<dd>Sets the text which is displayed on the client's screen to the immediate
left of the current turn (by default, a "turn" is a day, and so this part
-is the month, in displaying the date in MM-DD-YYYY format)
+is the month, in displaying the date in MM-DD-YYYY format)</dd>
-<dt><b>Names.Year=<i>"-1984"</i></b>
+<dt><b>Names.Year=<i>"-1984"</i></b></dt>
<dd>Sets the text displayed to the immediate right of the current turn (by
-default, the year).
+default, the year).</dd>
-<dt><b>Prices.Spy=<i>20000</i></b>
+<dt><b>Prices.Spy=<i>20000</i></b></dt>
<dd>Sets the price to pay a bitch to spy on another player to be
-<i>$20,000</i>.
+<i>$20,000</i>.</dd>
-<dt><b>Prices.Tipoff=<i>10000</i></b>
+<dt><b>Prices.Tipoff=<i>10000</i></b></dt>
<dd>Sets the price to pay a bitch to tip off the cops to another player to be
-<i>$10,000</i>.
+<i>$10,000</i>.</dd>
-<dt><b>Bitch.MinPrice=<i>50000</i></b>
+<dt><b>Bitch.MinPrice=<i>50000</i></b></dt>
<dd>Sets the minimum price for a bitch at the Rough Pub to be <i>$50,000</i>.
Note that prices for bitches "on the street" (i.e. those that are offered
by random events) are produced by dividing the normal bitch price
-distribution by 10.
+distribution by 10.</dd>
-<dt><b>Bitch.MaxPrice=<i>150000</i></b>
-<dd>Sets the maximum price for a bitch to <i>$150,000</i>.
+<dt><b>Bitch.MaxPrice=<i>150000</i></b></dt>
+<dd>Sets the maximum price for a bitch to <i>$150,000</i>.</dd>
<dt><b>SubwaySaying= <i>{ "First saying", "Second saying",
-"Third saying" }</i></b>
+"Third saying" }</i></b></dt>
<dd>Sets the list of things which the lady you sometimes meet on the subway
says to you; one of <i>"First saying"</i>, <i>"Second saying"</i> and
<i>"Third saying"</i> will be displayed each time. Any previous sayings will
be erased. Note that individual sayings can be overwritten by appending an
array suffix to the variable name - for example, to replace
<i>"Third saying"</i> with <i>"3rd saying"</i> the following command would
-suffice:-<br>
-<b>SubwaySaying[3]="3rd saying"</b>
+suffice:-<br />
+<b>SubwaySaying[3]="3rd saying"</b></dd>
-<dt><b>NumSubwaySaying=<i>5</i></b>
+<dt><b>NumSubwaySaying=<i>5</i></b></dt>
<dd>Sets there to be <i>5</i> distinct things that the lady on the subway
says to you. If this number is greater than the old number of sayings, the
newly added sayings will be blank; if it is smaller, the sayings that are now
-beyond the end of the list will be deleted.
+beyond the end of the list will be deleted.</dd>
-<dt><b>Playing= <i>{ "Song 1", "Song 2", "Song 3" }</i></b>
+<dt><b>Playing= <i>{ "Song 1", "Song 2", "Song 3" }</i></b></dt>
<dd>Sets the list of things which you can sometimes hear playing while
jetting; one of <i>"Song 1"</i>, <i>"Song 2"</i> or <i>"Song 3"</i> will be
-displayed. See the help for <b>SubwaySaying</b> for more details.
+displayed. See the help for <b>SubwaySaying</b> for more details.</dd>
-<dt><b>NumPlaying=<i>4</i></b>
+<dt><b>NumPlaying=<i>4</i></b></dt>
<dd>Sets there to be <i>4</i> distinct things which you can sometimes hear
-playing.
+playing.</dd>
<dt><b>StoppedTo= <i>{ "have a beer", "smoke a joint", "smoke a cigar",
-"smoke a Djarum", "smoke a cigarette" }</i></b>
+"smoke a Djarum", "smoke a cigarette" }</i></b></dt>
<dd>Sets the list of things which you sometimes stop to do while jetting;
-see <b>SubwaySaying</b> for more details.
+see <b>SubwaySaying</b> for more details.</dd>
-<dt><b>NumStoppedTo=<i>5</i></b>
-<dd>Sets there to be <i>5</i> distinct things which you can stop to do.
+<dt><b>NumStoppedTo=<i>5</i></b></dt>
+<dd>Sets there to be <i>5</i> distinct things which you can stop to do.</dd>
-<dt><b>DrugValue=<i>TRUE</i></b>
+<dt><b>DrugValue=<i>TRUE</i></b></dt>
<dd>If TRUE, then the server will keep track of the price you paid for
-any drugs, and clients will display this information if available.
+any drugs, and clients will display this information if available.</dd>
</dl>
-<hr>
+<hr />
<ul>
-<li><a href="index.html">Main index</a>
+<li><a href="index.html">Main index</a></li>
</ul>
<p>Last update: <b>16-10-2001</b></p>
</body>
(DIR) diff --git a/doc/credits.html b/doc/credits.html
t@@ -1,7 +1,10 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
- "http://www.w3.org/TR/html4/strict.dtd">
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
-<html>
<head>
<title>Credits and acknowledgements</title>
</head>
t@@ -53,9 +56,9 @@ proxies.</p>
<p><b>Tobias Mathes</b>, <b>Slawomir Molenda</b> and <b>Hugo Cisneiros</b>
for translating dopewars into other languages.</p>
-<hr>
+<hr />
<ul>
-<li><a href="index.html">Main index</a>
+<li><a href="index.html">Main index</a></li>
</ul>
<p>Last update: <b>17-06-2001</b></p>
</body>
(DIR) diff --git a/doc/developer.html b/doc/developer.html
t@@ -1,7 +1,10 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
- "http://www.w3.org/TR/html4/strict.dtd">
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
-<html>
<head>
<title>Notes for developers</title>
</head>
t@@ -34,9 +37,9 @@ any discussion here of the internal workings, however, may be incomplete, out
of date, and possibly misleading. Feel free to email me at the address above
with questions on this; I might possibly even know the answers!</p>
-<hr>
+<hr />
<ul>
-<li><a href="index.html">Main index</a>
+<li><a href="index.html">Main index</a></li>
</ul>
<p>Last update: <b>25-10-2001</b></p>
</body>
(DIR) diff --git a/doc/i18n.html b/doc/i18n.html
t@@ -1,7 +1,10 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
- "http://www.w3.org/TR/html4/strict.dtd">
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
-<html>
<head>
<title>Internationalization</title>
</head>
t@@ -18,11 +21,12 @@ into each language beforehand, of course, and so native language speakers to
carry out this task are always needed!</p>
<ul>
-<li><a href="#running">Running dopewars with i18n support</a>
-<li><a href="#adding">Adding a new translation</a>
-<li><a href="#dopespec">dopewars specifics</a>
-<li><a href="#updating">Updating a translation for a new dopewars version</a>
-<li><a href="#current">Currently available translations</a>
+<li><a href="#running">Running dopewars with i18n support</a></li>
+<li><a href="#adding">Adding a new translation</a></li>
+<li><a href="#dopespec">dopewars specifics</a></li>
+<li><a href="#updating">Updating a translation for a new dopewars
+version</a></li>
+<li><a href="#current">Currently available translations</a></li>
</ul>
<h2><a name="running">Running dopewars with i18n support</a></h2>
t@@ -39,15 +43,15 @@ automatically and talk to you in your native language. If this does not happen,
the following are some possible explanations:-</p>
<ul>
<li>dopewars cannot find the locale-specific language file - by default, stored
-under /usr/local/share/locale/
-<li>Your language is not yet supported - why not add it yourself?
+under /usr/local/share/locale/</li>
+<li>Your language is not yet supported - why not add it yourself?</li>
<li>Your system does not have locale support (at present i18n only functions
-properly on Unix systems - not Windows)
+properly on Unix systems - not Windows)</li>
<li>You haven't set an environment variable to specify your locale (usually
this is done automatically). For example, if you're using the <tt>bash</tt>
shell and want a German translation, the command "<tt>export LANG=de_DE</tt>"
should ensure that dopewars (and all other i18n-aware programs launched from
-this shell) will use the German language.
+this shell) will use the German language.</li>
</ul>
<h2><a name="adding">Adding a new translation</a></h2>
t@@ -75,15 +79,15 @@ character. These are used in the program code for substituting numbers and
other pieces of text into the string - these substitutions are are performed
using variables which are specified in the <b>same order</b> as the %
characters in the format string. For example, the following format string
-substitutes in a string (%s) and an integer number (%d):-<br>
-<tt>"String '%s' has %d characters"</tt><br>
+substitutes in a string (%s) and an integer number (%d):-<br />
+<tt>"String '%s' has %d characters"</tt><br />
The string and number are specified in order in the code. This is problematic
if your translation changes the order - for example, a valid German translation
-of the string would be<br>
-<tt>"%d Zeichen lang ist die Zeichenkette '%s'"</tt><br>
+of the string would be<br />
+<tt>"%d Zeichen lang ist die Zeichenkette '%s'"</tt><br />
Now the number and string are specified in the wrong order, and this will
-probably crash the program on running! To fix this, use the special notation<br>
-<tt>"%2$d Zeichen lang ist die Zeichenkette '%1$s'"</tt><br>
+probably crash the program on running! To fix this, use the special notation<br />
+<tt>"%2$d Zeichen lang ist die Zeichenkette '%1$s'"</tt><br />
(i.e. replace <b>%x</b> with <b>%n$x</b> where <b>n</b> is the index that the
format specifier "should" have, starting from 1.)</p>
t@@ -93,7 +97,7 @@ format specifier "should" have, starting from 1.)</p>
you are allowed to press in reply are stored in a string. This should be
translated to suitable keys in your language, in the <b>same</b> order as
the original - e.g. "<tt>YN</tt>" (for Yes/No) could be translated in German
-to "<tt>JN</tt>" (for Ja/Nein).<p>
+to "<tt>JN</tt>" (for Ja/Nein).<p /></li>
<li>When a dopewars server asks a client a question, the valid replies are
sent at the start of the message, followed by a "<tt>^</tt>" character. These
t@@ -101,7 +105,7 @@ replies define the dopewars protocol, and so should <b>not</b> be
translated - they will prevent clients and servers from talking to each other
properly. So for example, the string "<tt>YN^Would you like to visit %s?</tt>"
should be translated as you wish, but with the "<tt>YN^</tt>" at the start
-left unchanged.<p>
+left unchanged.<p /></li>
<li>The <tt>%txx</tt> notation is used for "translated strings". This notation
is exactly equivalent to the standard C "<tt>%s</tt>" notation for a string,
t@@ -111,14 +115,14 @@ follows the <tt>%t</tt> is used to select an "alternative form" of the word
on whether the word is the subject or the object of the sentence. You are
free to translate <tt>%txx</tt> to use the most appropriate form of the word.
If you wish to capitalise the first letter of the word (as used in English for
-titles, etc.) then use "<tt>%T</tt>" rather than "<tt>%t</tt>".<p>
+titles, etc.) then use "<tt>%T</tt>" rather than "<tt>%t</tt>".<p />
<p>Obviously dopewars cannot guess what your "alternative forms" are; you must
specify them yourself. Essentially, when setting a string in a dopewars
configuration file (or the defaults, which are set in dopewars.c) alternative
forms can be added by alternating two-letter codes and alternative forms after
-the original word, separating them by _ (underline) symbols. For example,<br>
-<tt>Names.Bitch = "bitch_no_bitcho_ac_bitche"</tt><br>
+the original word, separating them by _ (underline) symbols. For example,<br />
+<tt>Names.Bitch = "bitch_no_bitcho_ac_bitche"</tt><br />
specifies two alternative forms for "bitch", identified by the "<tt>no</tt>"
and "<tt>ac</tt>" codes. You can then use "bitcho" anywhere that "bitch" is
normally used by translating the relevant string as "<tt>%tno</tt>" (and to
t@@ -135,6 +139,7 @@ by means of the %/.../ notation. Everything between the two / characters is
not printed. This is used to "qualify" some strings for translation, and the
%/.../ can be left out of the translated string if desired (the comment does
not need to be translated).</p>
+</li>
</ul>
t@@ -147,12 +152,12 @@ translation, "<tt>make</tt>" the new version of dopewars. This will create
a <tt>dopewars.pot</tt> file listing the strings that need translating. Change
into the <tt>po/</tt> subdirectory, and create a new translation file from
your "old" translation file (we'll assume it's called <tt>de.po</tt>) and
-<tt>dopewars.pot</tt> with the <tt>msgmerge</tt> command:-<br>
-<tt>msgmerge -o newfile de.po dopewars.pot</tt><br>
+<tt>dopewars.pot</tt> with the <tt>msgmerge</tt> command:-<br />
+<tt>msgmerge -o newfile de.po dopewars.pot</tt><br />
Examine this new file <tt>newfile</tt> for translations that need updating
(a search for "fuzzy" should find most of them) and then overwrite your old
-translation with the new one:<br>
-<tt>mv newfile de.po</tt><br>
+translation with the new one:<br />
+<tt>mv newfile de.po</tt><br />
Rebuild and reinstall dopewars, and the new translations should become
available. Again, it is deeply appreciated if such updated files are
contributed to the main dopewars distribution!</p>
t@@ -161,34 +166,40 @@ contributed to the main dopewars distribution!</p>
<ul>
<li>French (<tt>fr.po</tt>)
-<ul>
-<li>Maintained by: <a href="mailto:triton@madchat.org">leonard</a>
-<li>Version required: <b>1.5.2</b> or later
-</ul>
+ <ul>
+ <li>Maintained by: <a href="mailto:triton@madchat.org">leonard</a></li>
+ <li>Version required: <b>1.5.2</b> or later</li>
+ </ul>
+</li>
<li>German (<tt>de.po</tt>)
-<ul>
-<li>Maintained by: <a href="mailto:tobi@radical-linux.de">Tobias Mathes</a>
-<li>Version required: <b>1.5.0</b> or later
-</ul>
+ <ul>
+ <li>Maintained by: <a href="mailto:tobi@radical-linux.de">Tobias
+ Mathes</a></li>
+ <li>Version required: <b>1.5.0</b> or later</li>
+ </ul>
+</li>
<li>Polish (<tt>pl.po</tt>)
-<ul>
-<li>Maintained by: <a href="mailto:jeszua@panda.bg.univ.gda.pl">Slawomir
-Molenda</a>
-<li>Version required: <b>1.5.0</b> or later
-</ul>
+ <ul>
+ <li>Maintained by: <a href="mailto:jeszua@panda.bg.univ.gda.pl">Slawomir
+ Molenda</a></li>
+ <li>Version required: <b>1.5.0</b> or later</li>
+ </ul>
+</li>
<li>Portuguese (Brazil) (<tt>pt_BR.po</tt>)
-<ul>
-<li>Maintained by: <a href="mailto:hugo@netdados.com.br">Hugo Cisneiros</a>
-<li>Version required: <b>1.5.0</b> or later
-</ul>
+ <ul>
+ <li>Maintained by: <a href="mailto:hugo@netdados.com.br">Hugo
+ Cisneiros</a></li>
+ <li>Version required: <b>1.5.0</b> or later</li>
+ </ul>
+</li>
</ul>
-<hr>
+<hr />
<ul>
-<li><a href="index.html">Main index</a>
+<li><a href="index.html">Main index</a></li>
</ul>
<p>Last update: <b>16-10-2001</b></p>
(DIR) diff --git a/doc/index.html b/doc/index.html
t@@ -1,7 +1,10 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
- "http://www.w3.org/TR/html4/strict.dtd">
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
-<html>
<head>
<title>dopewars 1.5.2: Main Index</title>
</head>
t@@ -13,17 +16,17 @@
<tr>
<td>
-<a href="installation.html">Obtaining and installing dopewars</a><br>
-<a href="commandline.html">dopewars command line options</a><br>
-<a href="clientplay.html">Playing the game: the dopewars client</a><br>
-<a href="server.html">Setting up and running a dopewars server</a><br>
-<a href="aiplayer.html">Adding computer-controlled players</a><br>
-<a href="configfile.html">dopewars configuration files</a><br>
-<a href="metaserver.html">The dopewars metaserver</a><br>
-<a href="i18n.html">Internationalization (i18n)</a><br>
-<a href="windows.html">dopewars and Microsoft Windows</a><br>
-<a href="developer.html">Notes for developers</a><br>
-<a href="credits.html">Credits and acknowledgements</a><br>
+<a href="installation.html">Obtaining and installing dopewars</a><br />
+<a href="commandline.html">dopewars command line options</a><br />
+<a href="clientplay.html">Playing the game: the dopewars client</a><br />
+<a href="server.html">Setting up and running a dopewars server</a><br />
+<a href="aiplayer.html">Adding computer-controlled players</a><br />
+<a href="configfile.html">dopewars configuration files</a><br />
+<a href="metaserver.html">The dopewars metaserver</a><br />
+<a href="i18n.html">Internationalization (i18n)</a><br />
+<a href="windows.html">dopewars and Microsoft Windows</a><br />
+<a href="developer.html">Notes for developers</a><br />
+<a href="credits.html">Credits and acknowledgements</a><br />
</td>
<td>
t@@ -50,7 +53,7 @@ freely available under the <a href="LICENCE">GNU General Public License</a>.</p>
</tr>
</table>
-<hr>
+<hr />
<p>Last update: <b>17-06-2001</b></p>
</body>
</html>
(DIR) diff --git a/doc/installation.html b/doc/installation.html
t@@ -1,7 +1,10 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
- "http://www.w3.org/TR/html4/strict.dtd">
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
-<html>
<head>
<title>Obtaining and installing dopewars</title>
</head>
t@@ -29,10 +32,10 @@ equivalent, such as ncurses or cur_colr) for the text-mode client, and the
<a href="http://www.gtk.org/">GTK+</a> libraries for the graphical client.</p>
<ul>
-<li><a href="#win32">Windows installation</a>
-<li><a href="#rpmbinary">RPM binary installation</a>
-<li><a href="#rpmsource">RPM source installation</a>
-<li><a href="#tarball">Tarball installation</a>
+<li><a href="#win32">Windows installation</a></li>
+<li><a href="#rpmbinary">RPM binary installation</a></li>
+<li><a href="#rpmsource">RPM source installation</a></li>
+<li><a href="#tarball">Tarball installation</a></li>
</ul>
<h2><a name="win32">Windows installation</a></h2>
t@@ -44,7 +47,7 @@ or save it to somewhere obvious like the Desktop and then double-click on its
icon later). This should install all relevant files, and set up Start Menu
icons, etc. If, however, you wish to build the program from the source code,
see the <a href="#tarball">tarball installation</a> section below, and also
-see the <a href="windows.html">Windows page</a>.
+see the <a href="windows.html">Windows page</a>.</p>
<h2><a name="rpmbinary">RPM binary installation</a></h2>
<p>The binary RPMs are built for Compaq (formerly DEC) Alpha systems running
t@@ -60,17 +63,17 @@ Alpha</a> or
<a href="http://prdownloads.sourceforge.net/dopewars/dopewars-1.5.2-1.i386.rpm">
i386 (Intel)</a> RPM with your web browser. (If your browser is incorrectly set
up, it may try and display the file, in which case tell it explicitly to save
-the file - Shift+Mouse button 1 in Netscape.)
+the file - Shift+Mouse button 1 in Netscape.)</li>
<li>Become root on your Unix box (if you cannot become root, then you will
probably not be able to use RPM installation, depending on how "rpm" is set
-up).
+up).</li>
<li>Change to the directory containing the dopewars rpm, and install it with
-the command<br>
-<tt><b>rpm -Uvh dopewars-1.5.2-1.<i>xxx</i>.rpm</b></tt><br>
+the command<br />
+<tt><b>rpm -Uvh dopewars-1.5.2-1.<i>xxx</i>.rpm</b></tt><br />
(where <b><i>xxx</i></b> is i386 or alpha). This will replace any
-already-installed earlier version.
+already-installed earlier version.</li>
</ol>
<h2><a name="rpmsource">RPM source installation</a></h2>
t@@ -82,20 +85,20 @@ building the binaries from it on your system.</p>
<ol>
<li>Download the
<a href="http://prdownloads.sourceforge.net/dopewars/dopewars-1.5.2-1.src.rpm">
-source code RPM</a>.
+source code RPM</a>.</li>
-<li>Become root and change to the directory containing the new rpm.
+<li>Become root and change to the directory containing the new rpm.</li>
-<li>Build a binary rpm with the command<br>
-<tt><b>rpm --rebuild dopewars-1.5.2-1.src.rpm</b></tt>
+<li>Build a binary rpm with the command<br />
+<tt><b>rpm --rebuild dopewars-1.5.2-1.src.rpm</b></tt></li>
<li>Change to the directory which the binary rpm has been written to (check
the output of the above - usually /usr/src/redhat/RPMS/<i>xxx</i>, where
<i>xxx</i> is your machine type - for example, "i386" on Intel machines,
-"alpha" on Alphas)
+"alpha" on Alphas)</li>
-<li>Install the binary rpm with the command<br>
-<tt><b>rpm -Uvh dopewars-1.5.2-1.<i>xxx</i>.rpm</b></tt>
+<li>Install the binary rpm with the command<br />
+<tt><b>rpm -Uvh dopewars-1.5.2-1.<i>xxx</i>.rpm</b></tt></li>
</ol>
<h2><a name="tarball">Tarball installation</a></h2>
t@@ -116,39 +119,39 @@ Unix <a href="http://www.gtk.org/download/">here</a> or for Windows
<ol>
<li>Download the
<a href="http://prdownloads.sourceforge.net/dopewars/dopewars-1.5.2.tar.gz">
-source code tarball</a>.
+source code tarball</a>.</li>
<li>Change to the directory containing the tarball and extract the contents
-with the command <br>
-<tt><b>tar -xvzf dopewars-1.5.2.tar.gz</b></tt><br>
-(or similar).
+with the command <br />
+<tt><b>tar -xvzf dopewars-1.5.2.tar.gz</b></tt><br />
+(or similar).</li>
<li>Change into the dopewars-1.5.2 directory, and read all the important
-documentation in there ;)
+documentation in there ;)</li>
-<li>Build the binary with the commands<br>
-<tt><b>./configure</b><br>
-<b>make</b></tt>
+<li>Build the binary with the commands<br />
+<tt><b>./configure</b><br />
+<b>make</b></tt></li>
-<li>Become root and install the dopewars files with<br>
-<tt><b>make install</b></tt><br>
-The configure script will test your system and set up dopewars so that it
+<li>Become root and install the dopewars files with<br />
+<tt><b>make install</b></tt><br />
+<p>The configure script will test your system and set up dopewars so that it
should compile cleanly. If you are running the Cygwin tools under Microsoft
Windows, the script should detect this and allow you to build a native
Windows binary; this will then run on any Win32 system, even one without Cygwin
installed. The configure script supports a number of configurable options; for
-more details, read the INSTALL file in the dopewars-1.5.2 directory.<p>
+more details, read the INSTALL file in the dopewars-1.5.2 directory.</p>
-If you cannot become root, run the configure script specifying directories for
-which you have write access for both the dopewars binary and high score file
-with a command such as<br>
+<p>If you cannot become root, run the configure script specifying directories
+for which you have write access for both the dopewars binary and high score file
+with a command such as<br />
<tt><b>./configure --bindir=/home/user/dopewars
---datadir=/home/user/dopewars</b></tt>
+--datadir=/home/user/dopewars</b></tt></p></li>
</ol>
-<hr>
+<hr />
<ul>
-<li><a href="index.html">Main index</a>
+<li><a href="index.html">Main index</a></li>
</ul>
<p>Last update: <b>14-10-2001</b></p>
</body>
(DIR) diff --git a/doc/metaserver.html b/doc/metaserver.html
t@@ -1,7 +1,10 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
- "http://www.w3.org/TR/html4/strict.dtd">
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
-<html>
<head>
<title>The dopewars metaserver</title>
</head>
t@@ -17,14 +20,15 @@ pick the game that most suits them. This is the function of the dopewars
<b>metaserver</b>.</p>
<ul>
-<li><a href="#location">Metaserver location</a>
-<li><a href="#oldmeta">The "old" metaserver</a>
-<li><a href="#client">Using the metaserver from the client</a>
+<li><a href="#location">Metaserver location</a></li>
+<li><a href="#oldmeta">The "old" metaserver</a></li>
+<li><a href="#client">Using the metaserver from the client</a></li>
<li><a href="#server">Using the metaserver from the server</a>
-<ul>
-<li><a href="#wrongip">But it's displaying the wrong name!</a>
-<li><a href="#dynamicip">But my server has a dynamic IP...</a>
-</ul>
+ <ul>
+ <li><a href="#wrongip">But it's displaying the wrong name!</a></li>
+ <li><a href="#dynamicip">But my server has a dynamic IP...</a></li>
+ </ul>
+</li>
</ul>
<h2><a name="location">Metaserver location</a></h2>
t@@ -57,8 +61,8 @@ port 80 from your machine is blocked by firewall). dopewars can be
configured to connect via. a proxy server without too much difficulty; if
your proxy server is at <i>proxy.com</i> on port <i>8080</i> then you should
add the following lines to your dopewars <a href="configfile.html">
-configuration file</a>:-<br>
-<b>MetaServer.ProxyName="proxy.com"<br>
+configuration file</a>:-<br />
+<b>MetaServer.ProxyName="proxy.com"<br />
MetaServer.ProxyPort=8080</b></p>
<h2><a name="server">Using the metaserver from the server</a></h2>
t@@ -83,7 +87,7 @@ metaserver if you are using a web proxy; see the information
<p>Once connected to the metaserver, you may find that it displays the IP
address of your server and not its domain name. This is usually because your
DNS is not set up to translate your IP into a domain name, and can be
-remedied by <a href="mailto:ben@bellatrix.pcl.ox.ac.uk>mailing</a> the
+remedied by <a href="mailto:ben@bellatrix.pcl.ox.ac.uk">mailing</a> the
metaserver maintainer, who can add a suitable mapping for you.</p>
<p>On other occasions, the metaserver will display a domain name, but it'll
t@@ -103,8 +107,8 @@ variable in the dopewars configuration file.</p>
<p>For example, if you wish your server to be known as <b>dope-serv.com</b> and
you have emailed the maintainer, receiving the password <b>Dope-Auth</b>, then
-add the following to the dopewars configuration file:-<br>
-<b>MetaServer.LocalName="dope-serv.com"<br>
+add the following to the dopewars configuration file:-<br />
+<b>MetaServer.LocalName="dope-serv.com"<br />
MetaServer.Password="Dope-Auth"</b></p>
<p>Restart your dopewars server, or send it a SIGUSR1 signal, for the change to
t@@ -126,9 +130,9 @@ which the metaserver will use to identify "your" server; now, when your
internet connection is restored, the server registration with the "new" IP
will automatically replace the "old" one.</p>
-<hr>
+<hr />
<ul>
-<li><a href="index.html">Main index</a>
+<li><a href="index.html">Main index</a></li>
</ul>
<p>Last update: <b>17-06-2001</b></p>
</body>
(DIR) diff --git a/doc/server.html b/doc/server.html
t@@ -1,7 +1,10 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
- "http://www.w3.org/TR/html4/strict.dtd">
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
-<html>
<head>
<title>Setting up and running a dopewars server</title>
</head>
t@@ -28,9 +31,9 @@ home city rather than New York. Any players that then connect to your
customised server will play this customised game.</p>
<ul>
-<li><a href="#interactive">Running an interactive server</a>
-<li><a href="#noninteractive">Non-interactive servers</a>
-<li><a href="#metaserver">Private and public: the dopewars metaserver</a>
+<li><a href="#interactive">Running an interactive server</a></li>
+<li><a href="#noninteractive">Non-interactive servers</a></li>
+<li><a href="#metaserver">Private and public: the dopewars metaserver</a></li>
</ul>
<h2><a name="interactive">Running an interactive server</a></h2>
t@@ -51,8 +54,8 @@ and so will want a non-interactive server. This will sit in the background
and quietly deal with dopewars games without disturbing you, the user. To
"persuade" the server to be non-interactive, you must redirect standard
input and output, and use your shell's job control to put it in the background,
-with a command similar to the following:-<br>
-<b>dopewars -s < /dev/null >> /var/log/dopewars.log &</b><br>
+with a command similar to the following:-<br />
+<b>dopewars -s < /dev/null >> /var/log/dopewars.log &</b><br />
(this writes server output to the logfile <i>/var/log/dopewars.log</i>.
Alternatively you can redirect this output to <i>/dev/null</i>.)</p>
t@@ -84,9 +87,9 @@ metaserver, or it may register your server with an incorrect name. For
information on getting round these difficulties, see the
<a href="metaserver.html">metaserver</a> page.</p>
-<hr>
+<hr />
<ul>
-<li><a href="index.html">Main index</a>
+<li><a href="index.html">Main index</a></li>
</ul>
<p>Last update: <b>17-06-2001</b></p>
</body>
(DIR) diff --git a/doc/servercommands.html b/doc/servercommands.html
t@@ -1,7 +1,10 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
- "http://www.w3.org/TR/html4/strict.dtd">
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
-<html>
<head>
<title>Interactive server commands</title>
</head>
t@@ -19,41 +22,43 @@ by typing the name of the variable by itself. For example, entering
server sends to the <a href="metaserver.html">metaserver</a>.</p>
<dl>
-<dt><b>help</b>
+<dt><b>help</b></dt>
<dd>Displays a help screen, listing valid server commands and the variables
-which can be set in <a href="configfile.html">configuration files</a>.
+which can be set in <a href="configfile.html">configuration files</a>.</dd>
-<dt><b>list</b>
+<dt><b>list</b></dt>
<dd>Lists the given names of all the players currently logged on to the
-server.
+server.</dd>
-<dt><b>push <i>Bert</i></b>
+<dt><b>push <i>Bert</i></b></dt>
<dd>Politely asks the player with the given name <i>Bert</i> to leave the
server - i.e. sends a message to the client, which should then finish off
-and break the connection at the far end.
+and break the connection at the far end.</dd>
-<dt><b>kill <i>Bert</i></b>
+<dt><b>kill <i>Bert</i></b></dt>
<dd>Abruptly breaks the connection to the player with given name <i>Bert</i>.
This is necessary if, for example, the client refuses to acknowledge a
-"push" message.
+"push" message.</dd>
-<dt><b>msg:<i>Hi all!</i></b>
+<dt><b>msg:<i>Hi all!</i></b></dt>
<dd>Broadcasts the message <i>Hi all!</i> to all players currently connected
-to this server.
+to this server.</dd>
-<dt><b>quit</b>
+<dt><b>quit</b></dt>
<dd>Politely quit, by asking all clients to leave, and then terminating once
they have done so. An "impolite" quit, which is necessary if the clients fail
to respond to this message, is performed on receipt of a SIGINT or SIGTERM
-signal (i.e. pressing Ctrl-C or killing the process with the "kill" command).
+signal (i.e. pressing Ctrl-C or killing the process with the "kill"
+command).</dd>
</dl>
-<hr>
+<hr />
<ul>
<li><a href="index.html">Main index</a>
-<ul>
-<li><a href="server.html">Setting up and running a dopewars server</a>
-</ul>
+ <ul>
+ <li><a href="server.html">Setting up and running a dopewars server</a></li>
+ </ul>
+</li>
</ul>
<p>Last update: <b>13-05-2001</b></p>
</body>
(DIR) diff --git a/doc/windows.html b/doc/windows.html
t@@ -1,7 +1,10 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
- "http://www.w3.org/TR/html4/strict.dtd">
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
-<html>
<head>
<title>dopewars and Microsoft Windows</title>
</head>
t@@ -41,9 +44,9 @@ be read before dopewars-config.txt if they are present, and if you build
the program by hand, you'll need to use --datadir="." as an option to
configure in order to get this behaviour for the high score file.)</p>
-<hr>
+<hr />
<ul>
-<li><a href="index.html">Main index</a>
+<li><a href="index.html">Main index</a></li>
</ul>
<p>Last update: <b>14-10-2001</b></p>