]> git.pond.sub.org Git - empserver/blob - info/satellite.t
m4: Refresh macros from autoconf-archive commit fd1d25c148
[empserver] / info / satellite.t
1 .TH Command SATELLITE
2 .NA satellite "Download data from a reconnaissance satellite"
3 .LV Expert
4 .SY "satellite <PLANE> [<se|sh|l> [?cond&cond&...]]"
5 The satellite command is how you get information from your satellites.
6 A satellite must be in orbit (launched)
7 before it will begin transmitting.
8 The type of information you get from a satellite
9 depends on what type of satellite it is.
10 .s1
11 An ordinary satellite will return data that looks remarkably like
12 \*Qradar\*U output.
13 If the satellite has \*Qimaging\*U capabilities
14 you will see the sector designations.
15 If not then you will see a '?' for inhabited sectors.
16 .s1
17 A satellite with imaging capabilities
18 will also show ships and land units.
19 .s1
20 Spy satellites provide much more information.
21 Their output is a table that looks remarkably like \*Qspy\*U output
22 followed by another table listing all the ships in the area with
23 their owner, ship type, and efficiency.
24 .s1
25 Spy satellites with \*Qimaging\*U capabilities can also see subs!
26 .s1
27 After launching, a satellite will take a while to come \*Qon line\*U.
28 During this period,
29 (shown by mobility being < 127),
30 you cannot use the satellite.
31 .s1
32 If a satellite has been damaged, then it will only transmit partial
33 data.  For example, a 75% satellite will only display three out of
34 every four sectors.  Note that it will always be the same 75% of
35 sectors which are displayed (i.e. it is not random), so you will gain
36 nothing by repeatedly downloading data from the satellite.
37 .s1
38 You may also filter the information you receive from the satellite
39 using conditionals.  Here are some examples to show you how
40 conditionals work.  In all of the following examples, we will assume
41 that we are using satellite #28.
42 .s1
43 To list all airports:
44 .EX "sat 28 se ?des=*"
45 To list all airports owned by country #7:
46 .EX "sat 28 se ?des=*&own=7"
47 To list all ships in 12,14:
48 .EX "sat 28 sh ?xloc=12&yloc=14"
49 To list all land units:
50 .EX "sat 28 l"
51 To list all cavalry units:
52 .EX "sat 28 l ?type=cavalry"
53 .s1
54 For a complete list of conditionals you can use, see info Syntax.
55 Note that the large radar map is only drawn when the output is not filtered:
56 .EX "sat 28"
57 .s1
58 .SA "launch, radar, spy, census, map, Syntax, Ship-types, Planes, Detection"