Markup fix.
[vms-empire.git] / vms-empire.xml
1 <?xml version="1.0" encoding="ISO-8859-1"?>
2 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3                    "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
4 <refentry id='vmsempire6'>
5 <!--  See the file COPYING, distributed with empire, for restriction
6  and warranty information. -->
7
8 <refmeta>
9 <refentrytitle>Empire</refentrytitle>
10 <manvolnum>6</manvolnum>
11 <refmiscinfo class='date'>March 29, 1990</refmiscinfo>
12 <refmiscinfo class='productname'>empire</refmiscinfo>
13 <refmiscinfo class='source'>empire</refmiscinfo>
14 <refmiscinfo class='manual'>Games</refmiscinfo>
15 </refmeta>
16 <refnamediv>
17 <refname>empire</refname>
18 <refpurpose>the wargame of the century</refpurpose>
19 </refnamediv>
20 <refsynopsisdiv id='synopsis'>
21 <cmdsynopsis>
22   <command>empire</command>
23     <arg choice='opt'>-w <replaceable>water</replaceable></arg>
24     <arg choice='opt'>-s <replaceable>smooth</replaceable></arg>
25     <arg choice='opt'>-d <replaceable>delay</replaceable></arg>
26     <arg choice='opt'>-S <replaceable>save-interval</replaceable></arg>
27     <arg choice='opt'>-f <replaceable>savefile</replaceable></arg>
28 </cmdsynopsis>
29 </refsynopsisdiv>
30
31 <refsect1 id='description'><title>DESCRIPTION</title>
32 <para>Empire is a simulation of a full-scale war between two
33 emperors, the computer and you.  Naturally, there is only
34 room for one, so the object of the game is to destroy
35 the other.  The computer plays by the same rules that you
36 do.</para>
37
38 <variablelist>
39   <varlistentry>
40   <term><option>-w</option><replaceable>water</replaceable></term>
41   <listitem>
42 <para>This option controls the amount of water on the map.
43 This is given as the percentage of the map which should
44 be water.  The default is 70% water.  <emphasis remap='I'>water</emphasis>
45 must be an integer in the between 10 and 90 inclusive.</para>
46   </listitem>
47   </varlistentry>
48   <varlistentry>
49   <term><option>-s</option><replaceable>smooth</replaceable></term>
50   <listitem>
51 <para>This controls the smoothness of the map.  A low value
52 will produce a highly chaotic map with lots of small
53 islands or lakes.  A high value will produce a map
54 with a few scattered continents.  Be forewarned that
55 a high value will cause the program to take a long
56 time to start up.  The default value is 5.</para>
57   </listitem>
58   </varlistentry>
59   <varlistentry>
60   <term><option>-d</option><replaceable>delay</replaceable></term>
61   <listitem>
62 <para>This option controls the length of time the computer will
63 delay after printing informational messages at the top of
64 the screen.  <emphasis remap='I'>delay</emphasis> is specified in milliseconds.  The
65 default value is 2000 which allows the user two seconds to
66 read a message.</para>
67   </listitem>
68   </varlistentry>
69 </variablelist>
70 </refsect1>
71
72 <refsect1 id='examples'><title>EXAMPLES</title>
73 <para>empire -w90 -s2</para>
74 <para>This produces a map with many islands.</para>
75 <para>empire -w50 -s0</para>
76 <para>This produces a really strange map.  These values
77 are not recommended for the faint at heart.</para>
78 <para>empire -w10</para>
79 <para>This produces a map with lots of land and a few lakes.
80 The computer will have a hard time on this sort of map
81 as it will try and produce lots of troop transports,
82 which are fairly useless.</para>
83 <para>There are two other option.</para>
84 <variablelist>
85   <varlistentry>
86   <term><option>-S</option><replaceable>interval</replaceable></term>
87   <listitem>
88 <para>sets the <emphasis remap='I'>save interval</emphasis> for the game (default is 10). Once per
89 <emphasis remap='I'>interval</emphasis> turns the game state will be automatically saved after
90 your move. It will be saved in any case when you change modes or
91 do various special things from command mode, such as `M' or `N'.</para>
92   </listitem>
93   </varlistentry>
94   <varlistentry>
95   <term><option>-f</option><replaceable>savefile</replaceable></term>
96   <listitem>
97 <para>Set the save file name (normally empsave.dat).</para>
98   </listitem>
99   </varlistentry>
100 </variablelist>
101 </refsect1>
102
103 <refsect1 id='introduction'><title>INTRODUCTION</title>
104 <para>Empire is a war game played between you and the user.  The world
105 on which the game takes place is a square rectangle containing cities,
106 land, and water.  Cities are used to build armies, planes, and ships
107 which can move across the world destroying enemy pieces, exploring,
108 and capturing more cities.  The objective of the game is to destroy
109 all the enemy pieces, and capture all the cities.</para>
110 <para>The world is a rectangle 60 by 100 squares on a side.  The world
111 consists of sea (.), land (+), uncontrolled
112 cities (*), computer-controlled cities (X), and cities that you
113 control (O).</para>
114 <para>The world is displayed on the player's screen during
115 movement.  (On terminals with small screens, only a portion of
116 the world is shown at any one time.)
117 Each piece is represented by a unique
118 character on the map.  With a few exceptions, you can
119 only have one piece on a given location.  On the map, you
120 are shown only the 8 squares adjacent to your units.
121 This information is updated before and during each of your moves.
122 The map displays the most recent information known.</para>
123 <para>The game starts by assigning you one city and the
124 computer one city.  Cities can produce new pieces.  Every
125 city that you own produces more pieces for you according
126 to the cost of the desired piece.  The typical play of the
127 game is to issue the Automove command until you decide
128 to do something special.  During movement in each round,
129 the player is prompted to move each piece that does not
130 otherwise have an assigned function.</para>
131 <para>Map coordinates are 4-digit numbers.  The first two
132 digits are the row, the second two digits are the
133 column.</para>
134 </refsect1>
135
136 <refsect1 id='pieces'><title>PIECES</title>
137 <para>The pieces are as follows:</para>
138
139 <informaltable pgwide='0' frame='all'>
140   <tgroup cols='7' align='center'>
141     <colspec colname='c1'/>
142     <colspec colname='c2'/>
143     <colspec colname='c3'/>
144     <colspec colname='c4'/>
145     <colspec colname='c5'/>
146     <colspec colname='c6'/>
147     <colspec colname='c7'/>
148     <tbody>
149       <row rowsep='1'>
150         <entry align='left' colsep='1'>Piece</entry>
151         <entry align='center' colsep='1'>You</entry>
152         <entry align='center' colsep='1'>Enemy</entry>
153         <entry align='right' colsep='1'>Moves</entry>
154         <entry align='right' colsep='1'>Hits</entry>
155         <entry align='right' colsep='1'>Str</entry>
156         <entry align='center'>Cost</entry>
157       </row>
158       <row>
159         <entry align='left' colsep='1'>Army</entry>
160         <entry align='center' colsep='1'>A</entry>
161         <entry align='center' colsep='1'>a</entry>
162         <entry align='right' colsep='1'>1</entry>
163         <entry align='right' colsep='1'>1</entry>
164         <entry align='right' colsep='1'>1</entry>
165         <entry align='center'>5(6)</entry>
166       </row>
167       <row>
168         <entry align='left' colsep='1'>Fighter</entry>
169         <entry align='center' colsep='1'>F</entry>
170         <entry align='center' colsep='1'>f</entry>
171         <entry align='right' colsep='1'>8</entry>
172         <entry align='right' colsep='1'>1</entry>
173         <entry align='right' colsep='1'>1</entry>
174         <entry align='center'>10(12)</entry>
175       </row>
176       <row>
177         <entry align='left' colsep='1'>Patrol Boat</entry>
178         <entry align='center' colsep='1'>P</entry>
179         <entry align='center' colsep='1'>p</entry>
180         <entry align='right' colsep='1'>4</entry>
181         <entry align='right' colsep='1'>1</entry>
182         <entry align='right' colsep='1'>1</entry>
183         <entry align='center'>15(18)</entry>
184       </row>
185       <row>
186         <entry align='left' colsep='1'>Destroyer</entry>
187         <entry align='center' colsep='1'>D</entry>
188         <entry align='center' colsep='1'>d</entry>
189         <entry align='right' colsep='1'>2</entry>
190         <entry align='right' colsep='1'>3</entry>
191         <entry align='right' colsep='1'>1</entry>
192         <entry align='center'>20(24)</entry>
193       </row>
194       <row>
195         <entry align='left' colsep='1'>Submarine</entry>
196         <entry align='center' colsep='1'>S</entry>
197         <entry align='center' colsep='1'>s</entry>
198         <entry align='right' colsep='1'>2</entry>
199         <entry align='right' colsep='1'>2</entry>
200         <entry align='right' colsep='1'>3</entry>
201         <entry align='center'>20(24)</entry>
202       </row>
203       <row>
204         <entry align='left' colsep='1'>Troop Transport</entry>
205         <entry align='center' colsep='1'>T</entry>
206         <entry align='center' colsep='1'>t</entry>
207         <entry align='right' colsep='1'>2</entry>
208         <entry align='right' colsep='1'>1</entry>
209         <entry align='right' colsep='1'>1</entry>
210         <entry align='center'>30(36)</entry>
211       </row>
212       <row>
213         <entry align='left' colsep='1'>Aircraft Carrier</entry>
214         <entry align='center' colsep='1'>C</entry>
215         <entry align='center' colsep='1'>c</entry>
216         <entry align='right' colsep='1'>2</entry>
217         <entry align='right' colsep='1'>8</entry>
218         <entry align='right' colsep='1'>1</entry>
219         <entry align='center'>30(36)</entry>
220       </row>
221       <row>
222         <entry align='left' colsep='1'>Battleship</entry>
223         <entry align='center' colsep='1'>B</entry>
224         <entry align='center' colsep='1'>b</entry>
225         <entry align='right' colsep='1'>2</entry>
226         <entry align='right' colsep='1'>10</entry>
227         <entry align='right' colsep='1'>2</entry>
228         <entry align='center'>40(48)</entry>
229       </row>
230       <row>
231         <entry align='left' colsep='1'>Satellite</entry>
232         <entry align='center' colsep='1'>Z</entry>
233         <entry align='center' colsep='1'>z</entry>
234         <entry align='right' colsep='1'>10</entry>
235         <entry align='right' colsep='1'>--</entry>
236         <entry align='right' colsep='1'>--</entry>
237         <entry align='center'>50(60)</entry>
238       </row>
239     </tbody>
240   </tgroup>
241 </informaltable>
242
243 <para>The second column shows the map representation for your
244 units.</para>
245 <para>The third shows the representations of enemy units.</para>
246 <para>Moves is the number of squares that the unit can move in a
247 single round.</para>
248 <para>Hits is the amount of damage a unit can take before it
249 is destroyed.</para>
250 <para>Strength is the amount of damage a unit can inflict upon an
251 enemy during each round of an attack.</para>
252 <para>Cost is the number of rounds needed for a city to produce
253 the piece.</para>
254 <para>The number in parenthesis is the cost for a city to
255 produce the first unit.</para>
256 <para>Each piece has certain advantages associated with it that
257 can make it useful.  One of the primary strategic aspects
258 of this game is deciding which pieces will be produced
259 and in what quantities.</para>
260 <para><emphasis remap='B'>Armies</emphasis> can only move on land, and are the only piece that can
261 move on land.  Only armies can capture cities.
262 This means that you must produce armies in order to win the
263 game.  Armies have a 50% chance of capturing a city when they
264 attack.  (Attacking one's own city results in the army's
265 destruction.  Armies that move onto the sea will drown.
266 Armies can attack objects at sea, but even if they win, they
267 will drown.)  Armies can be carried by troop transports.
268 If an army is moved onto a troop transport, then whenever
269 the transport is moved, the army will be moved with the
270 transport.  You cannot attack any piece at sea while on a
271 transport.</para>
272 <para><emphasis remap='B'>Fighters</emphasis> move over both land and sea, and they move 8 squares
273 per round.  Their high speed and great mobility make fighters
274 ideal for exploring.  However, fighters must periodically land
275 at user-owned cities for refueling.  A fighter can travel 32
276 squares without refeuling.  Fighters are also shot down if they
277 attempt to fly over a city which is not owned by the user.</para>
278 <para><emphasis remap='B'>Patrol boats</emphasis> are fast but lightly armored.  Therefore
279 they are useful for patrolling ocean waters and exploring.
280 In an attack against a stronger boat, however, patrol boats
281 will suffer heavy casulties.</para>
282 <para><emphasis remap='B'>Destroyers</emphasis> are fairly heavily armored and reasonably quick
283 to produce.  Thus they are useful for destroying enemy transports
284 which may be trying to spread the enemy across the face of the
285 world.</para>
286 <para>When a <emphasis remap='B'>submarine</emphasis> scores a hit, 3 hits are exacted instead of 1.
287 Thus submarines can inflict heavy damage in a fight against
288 heavily armored boats.  Notice that healthy submarines will
289 typically defeat healthy destroyers two-thirds of the time.
290 However, a submarine will defeat a fighter about two-thirds
291 of the time, while a destroyer will defeat a fighter three-fourths
292 of the time.</para>
293 <para><emphasis remap='B'>Troop transports</emphasis> are the only pieces that can carry armies.
294 A maximum of six armies can be carried by a transport.
295 On any world containing a reasonable amount of water,
296 transports will be a critical resource in winning the game.
297 Notice that the weakness of transports implies they need
298 protection from stronger ships.</para>
299 <para><emphasis remap='B'>Aircraft carriers</emphasis> are the only ships that can
300 carry fighters.  Carriers carry a maximum of the number
301 of hits left of fighters.  Fighters are refueled when they
302 land on a carrier.</para>
303 <para><emphasis remap='B'>Battleships</emphasis> are similar to destroyers except that they are
304 much stronger.</para>
305 <para><emphasis remap='B'>Satellites</emphasis> are only useful for reconaissance.  They can not
306 be attacked.  They are launched in a random diagonal orbit, and
307 stay up for 50 turns.  They can see one square farther than other
308 objects.</para>
309 <para>All ships can move only on sea.  Ships can also dock in a
310 user-owned city.  Docked ships have damage repaired at the
311 rate of 1 hit per turn.  Ships which have suffered a lot
312 of damage will move more slowly.</para>
313 <para>Because of their ability
314 to be repaired, ships with lots of hits such as Carriers and
315 Battleships have an additional advantage.
316 After suffering minor damage while destroying enemy shipping,
317 these ships can sail back to port and be quickly repaired before
318 the enemy has time to replenish her destroyed shipping.</para>
319 <para>The following table gives the probability that the piece listed
320 on the side will defeat the piece listed at the top in a battle.
321 (The table assumes that both pieces are undamaged.)</para>
322
323 <informaltable pgwide='0' frame='all'>
324   <tgroup cols='6' align='center'>
325     <colspec colname='c1'/>
326     <colspec colname='c2'/>
327     <colspec colname='c3'/>
328     <colspec colname='c4'/>
329     <colspec colname='c5'/>
330     <colspec colname='c6'/>
331     <tbody>
332       <row rowsep='1'>
333         <entry align='left' colsep='1'>AFPT</entry>
334         <entry align='center' colsep='1'>D</entry>
335         <entry align='center' colsep='1'>S</entry>
336         <entry align='center' colsep='1'>C</entry>
337         <entry align='center' colsep='1'>B</entry>
338         <entry align='center'></entry>
339       </row>
340       <row>
341         <entry align='left' colsep='1'>AFPT</entry>
342         <entry align='center' colsep='1'>50.0%</entry>
343         <entry align='center' colsep='1'>12.5%</entry>
344         <entry align='center' colsep='1'>25.0%</entry>
345         <entry align='center' colsep='1'>00.391%</entry>
346         <entry align='center'>00.0977%</entry>
347       </row>
348       <row>
349         <entry align='left' colsep='1'>D</entry>
350         <entry align='center' colsep='1'>87.5%</entry>
351         <entry align='center' colsep='1'>50.0%</entry>
352         <entry align='center' colsep='1'>25.0%</entry>
353         <entry align='center' colsep='1'>05.47%</entry>
354         <entry align='center'>00.537%</entry>
355       </row>
356       <row>
357         <entry align='left' colsep='1'>S</entry>
358         <entry align='center' colsep='1'>75.0%</entry>
359         <entry align='center' colsep='1'>75.0%</entry>
360         <entry align='center' colsep='1'>50.0%</entry>
361         <entry align='center' colsep='1'>31.3%</entry>
362         <entry align='center'>06.25%</entry>
363       </row>
364       <row>
365         <entry align='left' colsep='1'>C</entry>
366         <entry align='center' colsep='1'>99.6%</entry>
367         <entry align='center' colsep='1'>94.5%</entry>
368         <entry align='center' colsep='1'>68.7%</entry>
369         <entry align='center' colsep='1'>50.0%</entry>
370         <entry align='center'>04.61%</entry>
371       </row>
372       <row>
373         <entry align='left' colsep='1'>B</entry>
374         <entry align='center' colsep='1'>99.9%</entry>
375         <entry align='center' colsep='1'>99.5%</entry>
376         <entry align='center' colsep='1'>93.8%</entry>
377         <entry align='center' colsep='1'>95.4%</entry>
378         <entry align='center'>50.0%</entry>
379       </row>
380     </tbody>
381   </tgroup>
382 </informaltable>
383
384 <para>Notice, however, that when a ship has been damaged, the odds of
385 being defeated can go up quite a bit.  For example, a healthy
386 submarine has a 25% chance of defeating a battleship that has
387 had one hit of damage done to it, and a healthy submarine has
388 a 50% chance of defeating a carrier which has suffered two hits
389 of damage.</para>
390 </refsect1>
391
392 <refsect1 id='movement_functions'><title>MOVEMENT FUNCTIONS</title>
393 <para>There are a variety of movement functions.  The movement functions
394 of pieces can be specified in user mode and edit mode.
395 Cities can have movement functions set for each type of piece.
396 When a movement function for a type of pieces is set for a city,
397 then every time that type of piece appears in the city, the piece
398 will acquire that movement function.  Be forewarned that moving
399 loaded transports or loaded carriers into a city can have undesirable
400 side effects.</para>
401 <para>Normally, when a movement
402 function has been specified, the piece will continue moving according to
403 that function until one of the following happen:</para>
404 <variablelist>
405   <varlistentry>
406   <term><emphasis remap='B'>*</emphasis></term>
407   <listitem>
408 <para>An enemy piece or unowned city appears next to the piece.  In this case
409 the piece will be completely awoken, unless its movement function has
410 been set to a specific destination.
411 Armies on ships and pieces inside
412 cities will not be awoken if the enemy piece is gone by the time it is
413 their turn to move.</para>
414   </listitem>
415   </varlistentry>
416   <varlistentry>
417   <term><emphasis remap='B'>*</emphasis></term>
418   <listitem>
419 <para>You explicitly awaken the piece.</para>
420   </listitem>
421   </varlistentry>
422   <varlistentry>
423   <term><emphasis remap='B'>*</emphasis></term>
424   <listitem>
425 <para>The piece can no longer move in accordance with its programmed function.
426 In this case, the piece will awaken <emphasis remap='I'>temporarily</emphasis>.  You will be asked
427 to move the piece at which time you may awaken it.</para>
428   </listitem>
429   </varlistentry>
430   <varlistentry>
431   <term><emphasis remap='B'>*</emphasis></term>
432   <listitem>
433 <para>The piece is a fighter which has just enough fuel (plus a small reserve)
434 to get to the nearest city.
435 In this case,
436 the piece will awaken completely, unless its movement function has
437 been set to a specific destination, or its movement function has been
438 set to <emphasis remap='I'>land</emphasis>.</para>
439   </listitem>
440   </varlistentry>
441 </variablelist>
442 <para>The rationale behind this complexity is that fighters must be awoken
443 completely before they are out of range of a city
444 to prevent one from accidentally forgetting to waken the
445 fighter and then watching it fly off to its doom.  However, it is presumed
446 that when a path is set for the fighter, the fighter is not in danger of
447 running out of fuel.</para>
448 <para>Pieces do not completely awaken when their function has been set to a
449 destination because it is slightly time consuming to reset the destination,
450 but very simple (one keystroke) to wake the piece.</para>
451 <para>The movement functions are:</para>
452 <variablelist>
453   <varlistentry>
454   <term><emphasis remap='B'>Attack</emphasis></term>
455   <listitem>
456 <para>This function applies only to armies.  When this function is set,
457 the army will move toward the nearest enemy city, unowned city, or
458 enemy army.  This is useful when fighting off an invading enemy or
459 taking over a new continent.  When an army is set to this mode,
460 it will also explore nearby territory.  This tends to make
461 the "grope" movement mode pretty useless.</para>
462   </listitem>
463   </varlistentry>
464   <varlistentry>
465   <term><emphasis remap='B'>Awake</emphasis></term>
466   <listitem>
467 <para>When pieces are awake, you will be asked for the direction in which
468 the piece should move on each turn.</para>
469   </listitem>
470   </varlistentry>
471   <varlistentry>
472   <term><emphasis remap='B'>Fill</emphasis></term>
473   <listitem>
474 <para>This function applies to carriers and transports.  When this function is
475 specified, these ships sleep until they have been filled with fighters or
476 armies respectively.</para>
477   </listitem>
478   </varlistentry>
479   <varlistentry>
480   <term><emphasis remap='B'>Grope</emphasis></term>
481   <listitem>
482 <para>This function causes a piece to explore.  The piece heads toward the nearest
483 unseen square of the map on each of its moves.  Some attempt is made to 
484 explore in an optimal fashion.</para>
485   </listitem>
486   </varlistentry>
487   <varlistentry>
488   <term><emphasis remap='B'>Land</emphasis></term>
489   <listitem>
490 <para>This function applies to fighters and causes the fighter to head toward
491 the nearest transport or carrier.</para>
492   </listitem>
493   </varlistentry>
494   <varlistentry>
495   <term><emphasis remap='B'>Random</emphasis></term>
496   <listitem>
497 <para>This movement function causes a piece to move at random to an adjacent
498 empty square.</para>
499   </listitem>
500   </varlistentry>
501   <varlistentry>
502   <term><emphasis remap='B'>Sentry</emphasis></term>
503   <listitem>
504 <para>This movement function puts a piece to sleep.
505 The function of a city cannot be set to 'sleep'.</para>
506   </listitem>
507   </varlistentry>
508   <varlistentry>
509   <term><emphasis remap='B'>Transport</emphasis></term>
510   <listitem>
511 <para>This movement function only works on armies.  The army sleeps until
512 an unfull transport passes by, at which point the army wakes up and
513 boards the transport.</para>
514   </listitem>
515   </varlistentry>
516   <varlistentry>
517   <term><emphasis remap='B'>Upgrade</emphasis></term>
518   <listitem>
519 <para>This movement function only works with ships.  The ship will move
520 to the nearest owned city and remain there until it is repaired.</para>
521   </listitem>
522   </varlistentry>
523   <varlistentry>
524   <term><emphasis remap='B'>&lt;dir&gt;</emphasis></term>
525   <listitem>
526 <para>Pieces can be set to move in a specified direction.</para>
527   </listitem>
528   </varlistentry>
529   <varlistentry>
530   <term><emphasis remap='B'>&lt;dest&gt;</emphasis></term>
531   <listitem>
532 <para>Pieces can be set to move toward a specified square.  In this movement
533 mode, pieces take a shortest path toward the destination.  Pieces moving
534 in accordance with this function prefer diagonal moves that explore
535 territory.  Because of this, the movement of the piece may be
536 non-intuitive.</para>
537   </listitem>
538   </varlistentry>
539 </variablelist>
540 <para>As examples of how to use these movement functions, typically
541 when I have a new city on a continent, I set the Army function of the
542 city to <emphasis remap='I'>attack</emphasis>.  Whenever an army is produced, it merrily goes off
543 on its way exploring the continent and moving towards unowned cities
544 or enemy armies or cities.</para>
545 <para>I frequently set the ship functions for cities that are far from the
546 front to automatically move ships towards the front.</para>
547 <para>When I have armies on a continent, but there is nothing to explore
548 or attack, I move the army to the shore and use the <emphasis remap='I'>transport</emphasis>
549 function to have that army hop aboard the first passing transport.</para>
550 </refsect1>
551
552 <refsect1 id='commands'><title>COMMANDS</title>
553 <para>There are three command modes.  The first of these is "command mode".
554 In this mode, you give commands that affect the game as a whole.
555 In the second mode, "move mode", you give commands to move your
556 pieces.  The third mode is "edit mode", and in this mode you can
557 edit the functions of your pieces and examine various portions of
558 the map.</para>
559 <para>All commands are one character long.  The full mnemonic names are
560 listed below as a memorization aid.
561 The mnemonics are somewhat contrived because there are so few
562 characters in the English language.  Too bad this program isn't
563 written in Japanese, neh?</para>
564 <para>In all command modes, typing "H" will print out a screen of help
565 information, and typing &lt;ctrl-L&gt; will redraw the screen.</para>
566 </refsect1>
567
568 <refsect1 id='command_mode'><title>COMMAND MODE</title>
569 <para>In command mode, the computer will prompt you for your orders.
570 The following commands can be given at this time:</para>
571 <variablelist>
572   <varlistentry>
573   <term><emphasis remap='B'>Automove</emphasis></term>
574   <listitem>
575 <para>Enter automove mode.  This command begins a new round of movement.
576 You will remain in move mode after each of the computer's turns.
577 (In move mode, the "O" command will return you to command mode
578 after the computer finishes its next turn.</para>
579   </listitem>
580   </varlistentry>
581   <varlistentry>
582   <term><emphasis remap='B'>City</emphasis></term>
583   <listitem>
584 <para>Give the computer a random unowned city.  This command is useful if you
585 find that the computer is getting too easy to beat.</para>
586   </listitem>
587   </varlistentry>
588   <varlistentry>
589   <term><emphasis remap='B'>Date</emphasis></term>
590   <listitem>
591 <para>The current round is displayed.</para>
592   </listitem>
593   </varlistentry>
594   <varlistentry>
595   <term><emphasis remap='B'>Examine</emphasis></term>
596   <listitem>
597 <para>Examine the enemy's map.  This command is only valid after the computer
598 has resigned.</para>
599   </listitem>
600   </varlistentry>
601   <varlistentry>
602   <term><emphasis remap='B'>File</emphasis></term>
603   <listitem>
604 <para>Print a copy of the map to the specified file.</para>
605   </listitem>
606   </varlistentry>
607   <varlistentry>
608   <term><emphasis remap='B'>Give</emphasis></term>
609   <listitem>
610 <para>This command gives the computer a free move.</para>
611   </listitem>
612   </varlistentry>
613   <varlistentry>
614   <term><emphasis remap='B'>J</emphasis></term>
615   <listitem>
616 <para>Enter edit mode where you can examine and change the functions
617 associated with your pieces and cities.</para>
618   </listitem>
619   </varlistentry>
620   <varlistentry>
621   <term><emphasis remap='B'>Move</emphasis></term>
622   <listitem>
623 <para>Enter move mode for a single round.</para>
624   </listitem>
625   </varlistentry>
626   <varlistentry>
627   <term><emphasis remap='B'>N</emphasis></term>
628   <listitem>
629 <para>Give the computer the number of free moves you specify.</para>
630   </listitem>
631   </varlistentry>
632   <varlistentry>
633   <term><emphasis remap='B'>Print</emphasis></term>
634   <listitem>
635 <para>Display a sector on the screen.</para>
636   </listitem>
637   </varlistentry>
638   <varlistentry>
639   <term><emphasis remap='B'>Quit</emphasis></term>
640   <listitem>
641 <para>Quit the game.</para>
642   </listitem>
643   </varlistentry>
644   <varlistentry>
645   <term><emphasis remap='B'>Restore</emphasis></term>
646   <listitem>
647 <para>Restore the game from empsave.dat.</para>
648   </listitem>
649   </varlistentry>
650   <varlistentry>
651   <term><emphasis remap='B'>Save</emphasis></term>
652   <listitem>
653 <para>Save the game in empsave.dat.</para>
654   </listitem>
655   </varlistentry>
656   <varlistentry>
657   <term><emphasis remap='B'>Trace</emphasis></term>
658   <listitem>
659 <para>This command toggles a flag.  When the flag is set,
660 after each move, either yours or the computer's,
661 a picture of the world is written out to the file
662 'empmovie.dat'.  <emphasis remap='B'>Watch out!  This command produces lots of
663 output.</emphasis></para>
664   </listitem>
665   </varlistentry>
666   <varlistentry>
667   <term><emphasis remap='B'>Watch</emphasis></term>
668   <listitem>
669 <para>This command allows you to watch a saved movie.
670 The movie is displayed in a condensed version so that
671 it will fit on a single screen, so the output may be
672 a little confusing.  This command is only legal if the
673 computer resigns.  If you lose the game, you cannot replay
674 a movie to learn the secrets of how the computer beat you.
675 Nor can you replay a movie to find out the current positions
676 of the computer's pieces.  When replaying a movie, it is
677 recommended that you use the <option>-d</option> option to set the delay
678 to around 2000 milliseconds or so.  Otherwise the screen will be
679 updated too quickly for you to really grasp what is going on.</para>
680   </listitem>
681   </varlistentry>
682   <varlistentry>
683   <term><emphasis remap='B'>Zoom</emphasis></term>
684   <listitem>
685 <para>Display a condensed version of the map on the screen.  The user map is
686 divided into small rectangles.  Each rectangle is displayed as one square
687 on the screen.  If there is a city in a rectangle, then it
688 is displayed.  Otherwise enemy pieces are displayed, then user pieces,
689 then land, then water, and then unexplored territory.  When pieces are
690 displayed, ships are preferred to fighters and armies.</para>
691   </listitem>
692   </varlistentry>
693 </variablelist>
694 </refsect1>
695
696 <refsect1 id='move_mode'><title>MOVE MODE</title>
697 <para>In move mode, the cursor will appear on the screen at the position
698 of each piece that needs to be moved.  You can then give commands
699 to move the piece.  Directions to move are specified by the
700 following keys:</para>
701 <literallayout>
702 <emphasis remap='5'>
703         QWE
704         A D
705         ZXC
706 </emphasis>
707 </literallayout>
708 <para>The arrow and keypad keys on your terminal, if any, should also work.</para>
709 <para>These keys move in the direction of the key from S.  The
710 characters are not echoed and only 1 character is
711 accepted, so there is no need for a &lt;Return&gt;.  Hit the &lt;Space&gt;
712 bar if you want the piece to stay put.</para>
713 <para>Other commands are:</para>
714 <variablelist>
715   <varlistentry>
716   <term><emphasis remap='B'>Build</emphasis></term>
717   <listitem>
718 <para>Change the production of a city.</para>
719   </listitem>
720   </varlistentry>
721   <varlistentry>
722   <term><emphasis remap='B'>Fill</emphasis></term>
723   <listitem>
724 <para>Set the function of a troop transport or aircraft carrier to
725 <emphasis remap='I'>fill</emphasis>.</para>
726   </listitem>
727   </varlistentry>
728   <varlistentry>
729   <term><emphasis remap='B'>Grope</emphasis></term>
730   <listitem>
731 <para>Set the function of a piece to <emphasis remap='I'>grope</emphasis>.</para>
732   </listitem>
733   </varlistentry>
734   <varlistentry>
735   <term><emphasis remap='B'>I</emphasis><emphasis remap='I'>dir</emphasis></term>
736   <listitem>
737 <para>Set the direction for a piece to move.</para>
738   </listitem>
739   </varlistentry>
740   <varlistentry>
741   <term><emphasis remap='B'>J</emphasis></term>
742   <listitem>
743 <para>Enter edit mode.</para>
744   </listitem>
745   </varlistentry>
746   <varlistentry>
747   <term><emphasis remap='B'>Kill</emphasis></term>
748   <listitem>
749 <para>Wake up the piece.  If the piece is a transport or carrier,
750 pieces on board will not be awoken.</para>
751   </listitem>
752   </varlistentry>
753   <varlistentry>
754   <term><emphasis remap='B'>Land</emphasis></term>
755   <listitem>
756 <para>Set a fighter's function to <emphasis remap='I'>land</emphasis>.</para>
757   </listitem>
758   </varlistentry>
759   <varlistentry>
760   <term><emphasis remap='B'>Out</emphasis></term>
761   <listitem>
762 <para>Cancel automove mode.  At the end of the round, you will
763 be placed in command mode.</para>
764   </listitem>
765   </varlistentry>
766   <varlistentry>
767   <term><emphasis remap='B'>Print</emphasis></term>
768   <listitem>
769 <para>Redraw the screen.</para>
770   </listitem>
771   </varlistentry>
772   <varlistentry>
773   <term><emphasis remap='B'>Random</emphasis></term>
774   <listitem>
775 <para>Set a piece's function to <emphasis remap='I'>random</emphasis>.</para>
776   </listitem>
777   </varlistentry>
778   <varlistentry>
779   <term><emphasis remap='B'>Sentry</emphasis></term>
780   <listitem>
781 <para>Set a piece's function to <emphasis remap='I'>sentry</emphasis>.</para>
782   </listitem>
783   </varlistentry>
784   <varlistentry>
785   <term><emphasis remap='B'>Transport</emphasis></term>
786   <listitem>
787 <para>Set an army's function to <emphasis remap='I'>transport</emphasis>.</para>
788   </listitem>
789   </varlistentry>
790   <varlistentry>
791   <term><emphasis remap='B'>Upgrade</emphasis></term>
792   <listitem>
793 <para>Set a ship's function to <emphasis remap='I'>upgrade</emphasis>.</para>
794   </listitem>
795   </varlistentry>
796   <varlistentry>
797   <term><emphasis remap='B'>V</emphasis><emphasis remap='I'>piece func</emphasis></term>
798   <listitem>
799 <para>Set the city movement function for the specified piece
800 to the specified function.  For example, typing "VAY" would
801 set the city movement function for armies to <emphasis remap='I'>attack</emphasis>.  Whenever
802 an army is produced in the city (or whenever a loaded transport
803 enters the city), the army's movement function
804 would be set to <emphasis remap='I'>attack</emphasis>.</para>
805   </listitem>
806   </varlistentry>
807   <varlistentry>
808   <term><emphasis remap='B'>Y</emphasis></term>
809   <listitem>
810 <para>Set an army's function to <emphasis remap='I'>attack</emphasis>.</para>
811   </listitem>
812   </varlistentry>
813   <varlistentry>
814   <term><emphasis remap='B'>?</emphasis></term>
815   <listitem>
816 <para>Display information about the piece.  The
817 function, hits left, range, and number of items on board are
818 displayed.</para>
819   </listitem>
820   </varlistentry>
821 </variablelist>
822 <para>Attacking something is accomplished by  moving  onto  the
823 square of the unit you wish to attack.  Hits are traded
824 off at 50% probability of a hit landing on one or the
825 other units until one unit is totally destroyed.  There
826 is only 1 possible winner.</para>
827 <para>You are "allowed" to do <emphasis remap='B'>fatal</emphasis> things like attack your
828 own cities or other pieces.  If you try to make a fatal
829 move, the computer will warn you and give you a chance to
830 change your mind.</para>
831 <para>You cannot move onto the edge of the world.</para>
832 </refsect1>
833
834 <refsect1 id='edit_mode'><title>EDIT MODE</title>
835 <para>In edit mode, you can move around the world and examine pieces
836 or assign them new functions.
837 To move the cursor around, use the standard direction
838 keys.
839 Other commands are:</para>
840 <variablelist>
841   <varlistentry>
842   <term><emphasis remap='B'>Build</emphasis></term>
843   <listitem>
844 <para>Change the production of the city under the cursor.
845 The program will prompt for the new production, and you
846 should respond with the key corresponding to the letter of the piece
847 that you want produced.</para>
848   </listitem>
849   </varlistentry>
850   <varlistentry>
851   <term><emphasis remap='B'>Fill</emphasis></term>
852   <listitem>
853 <para>Set a transport's or carrier's function to <emphasis remap='I'>fill</emphasis>.</para>
854   </listitem>
855   </varlistentry>
856   <varlistentry>
857   <term><emphasis remap='B'>Grope</emphasis></term>
858   <listitem>
859 <para>Set a piece's function to <emphasis remap='I'>grope</emphasis>.</para>
860   </listitem>
861   </varlistentry>
862   <varlistentry>
863   <term><emphasis remap='B'>I</emphasis><emphasis remap='I'>dir</emphasis></term>
864   <listitem>
865 <para>Set the function of a piece (or city) to the specified direction.</para>
866   </listitem>
867   </varlistentry>
868   <varlistentry>
869   <term><emphasis remap='B'>Kill</emphasis></term>
870   <listitem>
871 <para>Wake all pieces at the current location.  If the location is a city,
872 the fighter path will also be canceled.</para>
873   </listitem>
874   </varlistentry>
875   <varlistentry>
876   <term><emphasis remap='B'>Mark</emphasis></term>
877   <listitem>
878 <para>Select the piece or city at the current location.  This command
879 is used with the "N" command.</para>
880   </listitem>
881   </varlistentry>
882   <varlistentry>
883   <term><emphasis remap='B'>N</emphasis></term>
884   <listitem>
885 <para>Set the destination of the piece previously selected with the "M"
886 command to the current square.</para>
887   </listitem>
888   </varlistentry>
889   <varlistentry>
890   <term><emphasis remap='B'>Out</emphasis></term>
891   <listitem>
892 <para>Exit edit mode.</para>
893   </listitem>
894   </varlistentry>
895   <varlistentry>
896   <term><emphasis remap='B'>Print</emphasis><emphasis remap='I'>sector</emphasis></term>
897   <listitem>
898 <para>Display a new sector of the map.  The map is divided into
899 ten sectors of size 20 by 70.  Sector zero is in the upper-left
900 corner of the map.  Sector four is in the lower-left corner of
901 the map.  Sector five is in the upper-right corner, and sector
902 nine is in the lower-right corner.</para>
903   </listitem>
904   </varlistentry>
905   <varlistentry>
906   <term><emphasis remap='B'>Random</emphasis></term>
907   <listitem>
908 <para>Set a piece to move randomly.</para>
909   </listitem>
910   </varlistentry>
911   <varlistentry>
912   <term><emphasis remap='B'>Sentry</emphasis></term>
913   <listitem>
914 <para>Put a piece to sleep.</para>
915   </listitem>
916   </varlistentry>
917   <varlistentry>
918   <term><emphasis remap='B'>Transport</emphasis></term>
919   <listitem>
920 <para>Set an army's function to <emphasis remap='I'>transport</emphasis>.</para>
921   </listitem>
922   </varlistentry>
923   <varlistentry>
924   <term><emphasis remap='B'>Upgrade</emphasis></term>
925   <listitem>
926 <para>Set a ship's function to <emphasis remap='I'>upgrade</emphasis>.</para>
927   </listitem>
928   </varlistentry>
929   <varlistentry>
930   <term><emphasis remap='B'>V</emphasis><emphasis remap='I'>piece func</emphasis></term>
931   <listitem>
932 <para>Set the city movement function for a piece.</para>
933   </listitem>
934   </varlistentry>
935   <varlistentry>
936   <term><emphasis remap='B'>Y</emphasis></term>
937   <listitem>
938 <para>Set an army's function to <emphasis remap='I'>attack</emphasis>.</para>
939   </listitem>
940   </varlistentry>
941   <varlistentry>
942   <term><emphasis remap='B'>?</emphasis></term>
943   <listitem>
944 <para>Display information about a piece or city.
945 For a city, the production, time of completion of
946 the next piece, movement functions, and the number of fighters and ships
947 in the city are displayed.</para>
948   </listitem>
949   </varlistentry>
950 </variablelist>
951 <para>Note that you cannot directly affect anything inside a city with
952 the editor.</para>
953 </refsect1>
954
955 <refsect1 id='hints'><title>HINTS</title>
956 <para>After you have played this game for a while, you will probably
957 find that the computer is immensely easy to beat.  Here are some
958 ideas you can try that may make the game more interesting.</para>
959 <variablelist>
960   <varlistentry>
961   <term><emphasis remap='B'>*</emphasis></term>
962   <listitem>
963 <para>Give the computer one or more extra cities before starting the game.</para>
964   </listitem>
965   </varlistentry>
966   <varlistentry>
967   <term><emphasis remap='B'>*</emphasis></term>
968   <listitem>
969 <para>Try playing the game with a low smoothness value (try using the
970 -s2 or even -s0 option).</para>
971   </listitem>
972   </varlistentry>
973   <varlistentry>
974   <term><emphasis remap='B'>*</emphasis></term>
975   <listitem>
976 <para>When starting the game, the program will ask you what difficulty
977 level you want.  Here "difficulty level" is a misnomer.  To compute
978 a difficulty level, the program looks at each continent and counts
979 the number of cities on the continents.  A high "difficulty level"
980 gives the computer a large continent with many cities, while the
981 user gets a small continent with few cities.  A low "difficulty level"
982 has the opposite effect.  It may be the case that the computer will
983 play better when the "difficulty level" is low.  The reason for this
984 is that the computer is forced to move armies to multiple continents
985 early in the game.</para>
986   </listitem>
987   </varlistentry>
988 </variablelist>
989 </refsect1>
990
991 <refsect1 id='history'><title>HISTORY</title>
992 <para>According to 
993 <ulink url='http://www.classicempire.com/history.html'>
994 A Brief History of Empire
995 </ulink>
996 The amcestral game was written by Walter Bright sometime in the early 1970s
997 while he was a student at Caltech.  A copy leaked out of Caltech and
998 was ported to DEC's VAX/VMS from the TOPS-10/20 FORTRAN sources
999 available around fall 1979.  Support for different terminal types 
1000 was added by Craig Leres.</para>
1001
1002 <para>Ed James got hold of the sources at Berkeley and converted
1003 portions of the code to C, mostly to use curses for the screen
1004 handling.  He published his modified sources on the net in December
1005 1986.  Because this game ran on VMS machines for so long, it has been
1006 known as VMS Empire.</para>
1007
1008 <para>In 1987 Chuck Simmons at Amdahl reverse-engineered the program
1009 and wrote a version completely in C.  In doing so, he modified the
1010 computer strategy, the commands, the piece types, many of the piece
1011 attributes, and the algorithm for creating maps.</para>
1012
1013 <para>The various versions of this game were ancestral to later and
1014 better-known 4X (expand/explore/exploit/exterminate) games, including
1015 Civilization (1990) and Master of Orion (1993).</para>
1016
1017 <para>In 1994 Eric Raymond colorized the game.</para>
1018 </refsect1>
1019
1020 <refsect1 id='files'><title>FILES</title>
1021 <variablelist>
1022   <varlistentry>
1023   <term><emphasis remap='I'>empsave.dat</emphasis></term>
1024   <listitem>
1025 <para>holds a backup of the game.  Whenever empire is run,
1026 it will reload any game in this file.</para>
1027   </listitem>
1028   </varlistentry>
1029   <varlistentry>
1030   <term><emphasis remap='I'>empmovie.dat</emphasis></term>
1031   <listitem>
1032 <para>holds a history of the game so that the game can be replayed as
1033 a "movie".</para>
1034   </listitem>
1035   </varlistentry>
1036 </variablelist>
1037 </refsect1>
1038
1039 <refsect1 id='bugs'><title>BUGS</title>
1040 <para>No doubt numerous.</para>
1041 <para>Satellites are not completely implemented.  You should be able to
1042 move to a square that contains a satellite, but the program won't
1043 let you.  Enemy satellites should not cause your pieces to awaken.</para>
1044 </refsect1>
1045
1046 <refsect1 id='authors'><title>AUTHORS</title>
1047 Original game by Walter Bright.
1048 Support for different terminal types added by Craig Leres.
1049 Curses support added by Ed James.
1050 C/Unix version written by Chuck Simmons
1051 Colorization by Eric S. Raymond.
1052 Probability table corrected by Michael Self.
1053 </refsect1>
1054
1055 <refsect1 id='copyleft'><title>COPYLEFT</title>
1056 <para>Copyright (C) 1987, 1988 Chuck Simmons</para>
1057 <para>See the file COPYING, distributed with empire, for restriction
1058 and warranty information.</para>
1059 </refsect1>
1060 </refentry>
1061