2 .NA lretreat "Set retreat conditions/paths for units or armies"
4 .SY "retreat [<SHIP/FLEET> | <SECTS>] [<PATH>] [<CONDITIONS>]"
5 .SY "lretreat [<UNIT/ARMY> | <SECTS>] [<PATH>] [<CONDITIONS>]"
6 The retreat command allows you to examine or modify the retreat
7 paths and conditions of your ships or units. The following description
8 is for ships. Land units are exactly the same, except of course that
9 some of the retreat conditions (being sonared, depth charged, etc) don't apply.
11 The <SHIP/FLEET> and <SECTS> arguments are provided to specify which
12 ships to view or give orders for. If a fleet designation is given when
13 specifying orders, the orders apply to all ships within that fleet.
15 Retreat expects an argument. To see every ship you own, give it
16 the argument '*', or type "retreat *".
18 The report format contains the following fields:
24 the type of ship; \*Qpatrol boat\*U, \*Qsubmarine\*U, etc,
26 the ship's current location (relative to your capital),
28 the fleet designation letter (set by \*Qfleetadd\*U command),
30 the ship's current retreat path.
32 whether or not the ship's retreat path is a fleet retreat path
34 what conditions the ship will retreat under
40 shp# ship type x,y fl path as flt? flags
41 0 battleship 4 2,0 jjuuj I
47 A player may give retreat orders for a ship or a fleet. Retreat
48 orders include a set of conditions that determine when the fleet/ship
49 will retreat, and a path that the fleet/ship will follow. When a condition
50 is met for a particular ship, the \*Qas flt?\*U field is checked. If it
51 is Yes, then every ship in that fleet with fleet retreat orders retreats
52 along the specified path. If it is no, then the retreat orders apply to
53 that ship only, and only that ship retreats.
55 When a ship is added to a fleet, it is given the retreat orders of that
58 Retreat orders are wiped when a ship navigates.
60 Retreat conditions at present include:
64 I Retreat when the ship is injured,
65 i.e. whenever the ship is damaged
66 by fire, bombs, or torping.
67 T Retreat when a sub torpedos or tries
69 B Retreat when a plane bombs or tries
71 S Retreat when the ship detects a sonar
73 D Retreat when the ship is depth-charged.
74 H Retreat when helpless. A ship is helpless
75 when it is fired upon, and no friendly
76 ships/sectors (including the ship itself)
77 are able to fire back at the aggressor.
81 For example, if the battleship above was fired at, it would attempt to
82 retreat 2 sectors, jj, using the normal amount of mobility for moving
83 2 sectors. It would then look like:
85 shp# ship type x,y fl path as flt? flags
86 0 battleship 4 2,0 uuj I
90 .SA "ship, fleetadd, LandUnits"