git.pond.sub.org Git - empserver/blob - info/territory.t

   1 .TH Command TERRITORY
   2 .NA territory "Assign various sectors to a specific territory"
   3 .LV Expert
   4 .SY "territory <SECTS> <NUMBER> [<FIELD>]"
   5 In Empire, sectors may be given a territory id number.
   6 This number may be used in conditional statements as in:
   7 .EX census # ?terr=27
   8 The program will then give you a census report for all the
   9 sectors that have been assigned the territory number \*Q27\*U.
  10 .s1
  11 In this sense it is essentially an extended \*Qrealm\*U.
  12 However, you are not limited to rectangular regions and you have
  13 99 values to choose from.
  14 .s1
  15 There are four independent territory fields terr, terr1, terr2, terr3
  16 selected by field arguments 0, 1, 2, 3, respectively.  Deities can use
  17 an additional territory field dterr, selected by -1.  If the optional
  18 field argument is empty, terr is assumed for mortals and dterr for
  19 deities.
  20 .s1
  21 .EX territory #1 5 1
  22 .s1
  23 Would set terr1 to 5 for all sectors in realm 1.
  24 .s1
  25 .EX sect * ?terr1=6&terr2=12
  26 .s1
  27 If terr1 was used to mark different islands and terr2=12 indicated
  28 productive sectors, this would highlight all the productive sectors
  29 on island number 6.
  30 .s1
  31 Some possible uses include;
  32 all sectors distributing to a particular sector;
  33 all coastal sectors;
  34 all sectors that have armed missiles in them.
  35 And probably thousands that I haven't thought of. ;-)
  36 .s1
  37 To \*Qunset\*U a territory, set its value to zero.
  38 .s1
  39 Note: terr and terr0 are the same.
  40 .s1
  41 .SA "realm, distribute, Sectors"