empserver/info/commodity.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

89 lines
3 KiB
Perl

.TH Command COMMODITY
.NA commodity "Report commodities in sectors"
.LV Basic
.SY "commodity <SECTS>"
The commodity report provides information
pertaining to the various commodities
in some or all of the sectors you occupy.
.s1
In the syntax of the commodity command
<SECTS> is the area on which you wish information,
(see \*Qinfo syntax\*U).
A typical usage might be:
.EX commodity -6:6,-3:3
which would list data for the area extending
three sectors out from the capital in each direction.
.s1
The commodity report lists each of your sectors
with the following heading:
.NF
COMMODITIES deliver-- distribute
sect sgpidbolhr sgpidbolhr sh gun pet iron dust bar oil lcm hcm rad
.FI
These columns represent:
.s1
.in \w'sgpidbolhr\0\0'u
.L sect
the x and y coordinates of the sector
.L sgpidbolhr
Ten delivery columns corresponding to:
shells, guns, petroleum (refined), iron, dust (gold),
bars of gold, oil, light construction materials,
heavy construction materials, and radioactive materials.
.L sgpidbolhr
Ten distribute columns corresponding to:
shells, guns, petroleum (refined), iron, dust (gold),
bars of gold, oil, light construction materials,
heavy construction materials, and radioactive materials.
.L sh
the number of shells in storage
.L gun
the number of guns in storage
.L pet
the number of units of refined petroleum
.L iron
the number of units of iron ore
.L dust
the number of units of gold dust
.L bar
the number of gold bars
.L oil
the amount of crude oil
.L lcm
the number of units of light construction materials
.L hcm
the number of units of heavy construction materials
.L rad
the number of units of radioactive materials
.in
.s1
For example:
.EX commodity -3:3,-2:2
.NF
.ps -1
COMMODITIES deliver-- distribute
sect sgpidbolhr sgpidbolhr sh gun pet iron dust bar oil lcm hcm rad
6,0 k .......... ...1....0. 0 0 0 100 0 0 0 0 1 0
-1,1 j .......... .......0.. 0 0 0 95 0 0 0 1 0 0
1,1 t .......... .......1.. 0 0 0 0 50 0 54 100 0 0
-3,3 g ....g..... .......... 0 0 0 0 43 0 0 0 0 0
-6,4 m ...j...... .......... 0 0 0 65 0 0 0 0 0 0
-4,4 m ...u...... ...0...... 0 0 0 144 0 0 0 0 0 0
-2,4 g .......... .......... 0 0 0 0 23 0 0 0 0 0
2,6 t .......... .......1.. 0 0 0 0 38 0 53 130 0 0
4,6 l .......... .......... 0 0 0 0 0 0 0 100 0 0
4,8 t .......... .......1.. 0 0 0 0 37 0 53 20 0 0
6,8 h .......... .......... 0 0 0 0 0 0 0 35 15 0
11 sectors.
.ps +1
.FI
The direction of delivery is indicated by the same characters
that are used in the \*Qmove\*U, \*Qnavigate\*U,
and other commands to indicate direction.
The presence of a distribution threshold for a particular commodity
is indicated by a digit in the appropriate column
under \*Qdistribute\*U,
representing the hundreds digit of the threshold value.
.s1
.SA "census, Commodities, Sectors"