                              Command : LRETREAT

NAME
   lretreat - Set retreat conditions/paths for units or armies

Level: Expert

SYNTAX
   [##:##] Command : retreat [<SHIP/FLEET> | <SECTS>] [<PATH>] [<CONDITIONS>]

SYNTAX
   [##:##] Command : lretreat [<UNIT/ARMY> | <SECTS>] [<PATH>] [<CONDITIONS>]

The retreat command allows you to examine or modify the retreat paths and con-
ditions of your ships or units. The following description is for  ships.  Land
units  are  exactly the same, except of course that some of the retreat condi-
tions (being sonared, depth charged, etc) don't apply.

The <SHIP/FLEET> and <SECTS> arguments are provided to specify which ships  to
view  or  give  orders  for.  If  a fleet designation is given when specifying
orders, the orders apply to all ships within that fleet.

Retreat expects an argument.  To see every ship you own, give it the  argument
'*', or type "retreat *".

The report format contains the following fields:

    shp#  the ship number
shiptype  the type of ship; "patrol boat", "submarine", etc,
     x,y  the ship's current location (relative to your capital),
     flt  the fleet designation letter (set by "fleetadd" command),
    path  the ship's current retreat path.
 as_flt?  whether or not the ship's retreat path is a fleet retreat path
   flags  what conditions the ship will retreat under

For example:
   [##:##] Command : retreat *

   shp#     ship type       x,y   fl path       as flt? flags
      0 battleship 4        2,0      jjuuj              I
   1 ship

Overview

A player may give retreat orders for a ship or a fleet. Retreat orders include
a set of conditions that determine when the fleet/ship  will  retreat,  and  a
path that the fleet/ship will follow. When a condition is met for a particular
ship, the "as flt?" field is checked. If it is Yes, then every  ship  in  that
fleet  with  fleet  retreat orders retreats along the specified path. If it is
no, then the retreat orders apply to  that  ship  only,  and  only  that  ship
retreats.

When a ship is added to a fleet, it is given the retreat orders of that fleet,
if any exist.

Retreat orders are wiped when a ship navigates.

Retreat conditions at present include:

                Condition       Meaning
                I               Retreat when the ship is injured,
                                i.e. whenever the ship is damaged
                                by fire, bombs, or torping.
                T               Retreat when a sub torpedos or tries
                                to torpedo the ship.
                B               Retreat when a plane bombs or tries
                                to bomb the ship.
                S               Retreat when the ship detects a sonar
                                ping.
                D               Retreat when the ship is depth-charged.
                H               Retreat when helpless. A ship is helpless
                                when it is fired upon, and no friendly
                                ships/sectors (including the ship itself)
                                are able to fire back at the aggressor.
                C               Clear the flags

For example, if the battleship above was fired at, it would attempt to retreat
2  sectors,  jj,  using the normal amount of mobility for moving 2 sectors. It
would then look like:

   shp#     ship type       x,y   fl path       as flt? flags
      0 battleship 4        2,0      uuj                I
   1 ship

SEE ALSO
   ship, fleetadd, LandUnits

