The .NA header promises information on "Clients which communicate well with the Empire4 Server". The page doesn't really deliver. It talks about client support for asynchronous notifications. It stopped listing separate client projects in 4.0.7 (1997). Not mentioning such clients isn't just outdated, it's actively misleading. Perhaps an up-to-date info page on clients would be useful, but I can't write one right now. Delete. Loses a bit of information for client developers that was tacked on in 4.0.7: pointers to dump commands, and an explanation of timestamps. I trust client writers can find "info xdump" without this. Signed-off-by: Markus Armbruster <armbru@pond.sub.org>
80 lines
2.5 KiB
Perl
80 lines
2.5 KiB
Perl
.TH Command SDUMP
|
|
.NA sdump "Dump raw ship information"
|
|
.LV Expert
|
|
.SY "sdump <SHIPS> [<fields>]"
|
|
The sdump command displays all information on
|
|
some or all of your ships.
|
|
sdump is a combination of ship, cargo, and sstat.
|
|
Each ship's information is printed on one very long line.
|
|
Fields are separated by a single space.
|
|
.s1
|
|
This command is designed to be used for input to an empire tool
|
|
such as \*Qve\*U.
|
|
.s1
|
|
In the syntax of the sdump command
|
|
<SHIPS> are the ships on which you wish information,
|
|
[<fields>] are the fields you wish to dump.
|
|
If no fields are specified, all fields are printed.
|
|
(see \*Qinfo Syntax\*U).
|
|
.s1
|
|
An sdump command lists all selected ships headed by:
|
|
.NF
|
|
Sun Feb 9 22:16:37 1997
|
|
DUMP SHIPS 855544597
|
|
<fields>
|
|
.FI
|
|
The first line is the date. The second line is the
|
|
"DUMP SHIPS <timestamp>" where the <timestamp> field is the current
|
|
timestamp. The third line is the columns which are output.
|
|
.s1
|
|
These columns represent the following fields which are also the
|
|
selection criteria for the command.
|
|
.s1
|
|
The following may be used as fields. They must be entered EXACTLY as
|
|
shown here (no partial pattern matching is done.)
|
|
.NF
|
|
type type of ship
|
|
x x location
|
|
y y location
|
|
flt fleet
|
|
eff efficiency
|
|
civ # of civilians on board
|
|
mil # of mil on board
|
|
uw # of uw on board
|
|
food # of food on board
|
|
pln # of planes on board
|
|
he # of helicopters on board
|
|
xl # of x-light planes on board
|
|
land # of land units on board
|
|
mob mobility
|
|
fuel obsolete, retained for backwards compatibility, always zero
|
|
tech technology of ship
|
|
shell # of shells on board
|
|
gun # of guns on board
|
|
petrol # of petrol on board
|
|
iron # of iron on board
|
|
dust # of dust on board
|
|
bar # of bars on board
|
|
oil # of oil on board
|
|
lcm # of lcms on board
|
|
hcm # of hcms on board
|
|
rad # or rads on board
|
|
def defense of ship
|
|
spd speed of ship
|
|
vis visibility of ship
|
|
rng firing range of ship
|
|
fir max # of guns fired by each volley
|
|
name ship name
|
|
origx x origin where trade ship was built
|
|
origy y origin where trade ship was built
|
|
.FI
|
|
.s1
|
|
A typical usage might be:
|
|
.EX sdump #5
|
|
which would list data for all ships in realm #5.
|
|
.s1
|
|
A sdump lists each of your ships in the specified area.
|
|
The header line is a list of fields that correspond
|
|
to the order that sdump prints the ship info.
|
|
.s1
|
|
.SA "ship, cargo, sstat, xdump, Ships"
|