tAll documentation made properly XHTML 1.0 Strict compliant - vaccinewars - be … | |
git clone git://src.adamsgaard.dk/vaccinewars | |
Log | |
Files | |
Refs | |
README | |
LICENSE | |
--- | |
commit dabd39f0b3982696c48adc233dcd1584056ff1b8 | |
parent a9cf309f22940dd0be6f254ef8b80e97c07924c2 | |
Author: Ben Webb <[email protected]> | |
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(-) | |
--- | |
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 … | |
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> | |
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 yours… | |
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 m… | |
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> | |
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… | |
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 runnin… | |
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 wit… | |
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> | |
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 … | |
<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 a… | |
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… | |
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 … | |
you by the <a href="mailto:[email protected]">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 gam… | |
+<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 drug… | |
+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.</d… | |
-<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> | |
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> | |
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 b… | |
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> | |
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 la… | |
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 … | |
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 substitu… | |
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<b… | |
-<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<b… | |
+<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… | |
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 "alternativ… | |
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 tw… | |
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… | |
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:[email protected]">leonard</a> | |
-<li>Version required: <b>1.5.2</b> or later | |
-</ul> | |
+ <ul> | |
+ <li>Maintained by: <a href="mailto:[email protected]">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:[email protected]">Tobias Mathes</a> | |
-<li>Version required: <b>1.5.0</b> or later | |
-</ul> | |
+ <ul> | |
+ <li>Maintained by: <a href="mailto:[email protected]">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:[email protected]">Slawomir | |
-Molenda</a> | |
-<li>Version required: <b>1.5.0</b> or later | |
-</ul> | |
+ <ul> | |
+ <li>Maintained by: <a href="mailto:[email protected]">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:[email protected]">Hugo Cisneiros</a> | |
-<li>Version required: <b>1.5.0</b> or later | |
-</ul> | |
+ <ul> | |
+ <li>Maintained by: <a href="mailto:[email protected]">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> | |
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 Pub… | |
</tr> | |
</table> | |
-<hr> | |
+<hr /> | |
<p>Last update: <b>17-06-2001</b></p> | |
</body> | |
</html> | |
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… | |
<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 do… | |
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 … | |
<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 fi… | |
+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> | |
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 o… | |
<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 … | |
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:[email protected]>mailing</a> the | |
+remedied by <a href="mailto:[email protected]">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; n… | |
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> | |
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 connec… | |
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 … | |
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… | |
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> | |
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,… | |
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> | |
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 … | |
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> | |