home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_disks / 300-399 / ff357.lzh / Empire / Help / syntax < prev    next >
Text File  |  1990-06-03  |  4KB  |  100 lines
  1. Command Syntax
  2.  
  3. All commands will prompt for their needed arguments, so if you are unsure
  4. of how to use one, just give it with no arguments to get prompts.
  5.  
  6. Some syntactic elements:
  7.  
  8.     <country> - a country name (in full, case significant) or number.
  9.  
  10.     <sector> - a sector specified as row,column (e.g. 4,-7)
  11.  
  12.     <sectors> - a region given as toprow:bottomrow,leftcolumn:rightcolumn.
  13.     This specifies a rectangle of sectors. For most commands, only the
  14.     sectors that you own will be affected. E.g.
  15.  
  16.         map -5:5,-5:6
  17.  
  18.     will map the region around your capital. Eg.
  19.  
  20.         designate -3,1:5 f
  21.     
  22.     will designate a row of 5 sectors into fortresses. Using the
  23.     'realm' command, you can set up 6 rectangular regions which you can
  24.     refer to with an abbreviated form. E.g. if you have entered:
  25.  
  26.         realm 3 -8:8,2:5
  27.  
  28.     then the two commands
  29.  
  30.         map #3
  31.         map -8:8,2:5
  32.  
  33.     are equivalent. As a further special case, realm 0 can be referred
  34.     to as just '#'. You can follow a rectangle specification with a
  35.     condition, which will reduce the command to operating on only those
  36.     sectors which match the condition. The condition consists of a
  37.     series of comparisons, using the operators:
  38.  
  39.         < - term on left is less than term on right
  40.         > - term on left is greater than term on right
  41.         = - term on left is equal to term on right
  42.         # - term on left is not equal to term on right
  43.  
  44.     The conditions are separated by '&', implying that all conditions
  45.     must be met in order for that sector to be selected for the
  46.     command. Note that there must be no spaces anywhere in the entire
  47.     <sectors> specification. The terms compared can be simple numbers
  48.     or any unambiguous abbreviation of one of:
  49.  
  50.         designation - the designation character of the sector
  51.         (special case - other value can be a single character)
  52.         efficiency - the sector's efficiency
  53.         mobility - the sector's mobility
  54.         minerals - richness of iron deposit in sector
  55.         gold - richness of gold deposit in sector
  56.         production - production units in sector
  57.         contracted - 1 if sector is contracted, 0 if not
  58.         defended - 1 if sector defended, 0 if not
  59.         checkpoint - the checkpoint code for the sector
  60.         owner - the number of the owning country - only for deitys
  61.         civilians - number of civilians in the sector
  62.         military - number of military in sector
  63.         shells - number of shells in sector
  64.         guns - the number of guns in the sector
  65.         planes - number of planes in sector
  66.         ore - number of tons of iron ore in sector
  67.         bars - the number of gold bars in the sector
  68.  
  69.     E.g.
  70.  
  71.         des -10:10,12?designation=-&minerals>50&civ>99 m
  72.  
  73.     will designate all wildernesses in the region which have a mineral
  74.     sample larger than 50 and more than 99 civilians as a mine. As a
  75.     special case, a '/' followed by a designation code can be used as a
  76.     condition to select all sectors of that designation. E.g.
  77.  
  78.         des #2/- +
  79.  
  80.     will turn all wildernesses in realm 2 into highways.
  81.  
  82.     <ship> - the number of a ship
  83.  
  84.     <fleet> - a fleet letter (a-z, A-Z, or * for the default fleet)
  85.  
  86.     <ships> - a designation of a group of ships. Can be a fleet letter, a
  87.     <sectors> range or a list of ship numbers separated by '/'s. Any
  88.     of the forms can be followed by a condition to be applied to the
  89.     ships, just like the conditions can be applied to sectors. The
  90.     values now refer to the ship, however, and are:
  91.  
  92.         civilians, military, shells, guns, planes, ore, bars,
  93.         designation (ship type), efficiency, mobility, owner
  94.  
  95. It is often desireable to interrupt the actions or output of commands which
  96. process several sectors or ships. This can be done on the Amiga by typing
  97. a control-C. It can be done when connected over a serial port by typing a
  98. control-C, a DEL or by sending a BREAK. The computation done by the 'power'
  99. command can also be stopped this way.
  100.