empserver/info/territory.t
Markus Armbruster 4ea4a01fd5 (info, html): Implement.
(all): Depend on info.

Flatten info directory.  This undoes the move to one subdirectory per
chapter, which was done during Empire 2.  The structure doesn't buy us
much, as the info name space is flat, and it complicates makefiles.

Overhaul info.pl:
- It now wants to run in the root of the build tree.
- Information on source files and subjects is now stored in makefiles,
  thus info.pl no longer picks up random junk from the file system.
- Clean up Perl anachronisms, in particular use subroutine arguments and
  results rather than global variables where convenient.
- Change format of diagnostics to the common format used by GNU tools,
  so that Emacs and the like can parse it.
- Catch missing .SA.
- When creating a new subject file, cowardly refuse to overwrite an
  existing file.
- Subject files contain topics sorted by chapter, then by name.  The
  order of chapters used to depend on how Perl sorts hash keys.  Fix
  it.
2005-12-22 10:09:17 +00:00

38 lines
1.2 KiB
Perl

.TH Command TERRITORY
.NA territory "Assign various sectors to a specific territory"
.LV Expert
.SY "territory <SECTS> <NUMBER> [<FIELD>]"
In Empire, sectors may be given a territory id number.
This number may be used in conditional statements as in:
.EX census # ?terr=27
The program will then give you a census report for all the
sectors that have been assigned the territory number \*Q27\*U.
.s1
In this sense it is essentially an extended \*Qrealm\*U.
However, you are not limited to rectangular regions and you have
99 values to choose from.
.s1
There are four independent territory fields. If the optional field
argument is empty, field 0 is used.
.s1
.EX territory #1 5 1
.s1
Would set terr1 field to 5 for all sectors in realm 1.
.s1
.EX sect * ?terr1=6&terr2=12
.s1
If terr1 was used to mark different islands and terr2=12 indicated
productive sectors, this would highlight all the productive sectors
on island number 6.
.s1
Some possible uses include;
all sectors distributing to a particular sector;
all coastal sectors;
all sectors that have armed missiles in them.
And probably thousands that I haven't thought of. ;-)
.s1
To \*Qunset\*U a territory, set its value to zero.
.s1
Note: terr and terr0 are the same.
.s1
.SA "realm, distribute, Sectors"