]> git.pond.sub.org Git - empserver/blobdiff - info/power.t
show: Extend show item to show the power value
[empserver] / info / power.t
index 56eff3c4d939529ecd9480e4fde188eb325ef63d..bb5d0820116775602aeb01fb82fc2214911b4bcb 100644 (file)
@@ -1,27 +1,27 @@
 .TH Command POWER
 .NA power "Display arbitrarily measured strengths of countries"
 .LV Basic
-.SY "power [num]"
-.SY "power new [num]"
-.SY "power country <NATS>"
+.SY "power [new|update] [<NUM>|country <NATS>]"
 The power report provides one view of national strengths.
-It can be particularly helpful in planning defense strategies
-and treaty voting.
+It can be particularly helpful in planning defense strategies.
 .s1
-If the optional \*Qnum\*U argument is given, only the
-top num entries in the power chart will be displayed.  Note that for
-deities, if you give a negative number, only the top num entries in
-the power chart will be displayed, and the power number rating will
-not be displayed.
-.s1
-If the optional \*Qnew\*U argument is given,
-the program will generate a new power report based on up-to-date
-information.
+Normally, the last saved power report is shown.
+The optional arguments \*Qnew\*U and \*Qupdate\*U request a new power
+report based on up-to-date information.
 This costs 10 BTUs.
+The new report is saved for use by future power commands, except when
+a deity uses \*Qupdate\*U.  This lets deities examine up-to-date power
+reports without affecting what players get to see.
 .s1
-If the optional \*Qnew\*U argument is not given,
-the program will show you the report generated
-the last time someone asked for new data.
+If option AUTO_POWER is enabled, the command doesn't let you save new
+power reports.  Instead, the power report is updated automatically
+right before the update.
+.s1
+If the optional \*QNUM\*U argument is given, only the
+top NUM entries in the power chart will be displayed.  Note that for
+deities, if you give a negative number, only the top NUM entries in
+the power chart will be displayed, and the power number rating will
+not be displayed.
 .s1
 If the optional \*Qcountry\*U argument is given, then the information
 is given for those particular countries.
@@ -67,24 +67,28 @@ cash on hand
 The \*Qpower factor\*U is determined by the following equation:
 .s1
 .NF
-power factor = for each land unit calculate and add the following
-                ((((land unit lcm cost / 10) * (land unit effic / 100)) +
-                  ((land unit hcm cost / 10) * (land unit effic / 100))) * 2)
-power factor += for each ship calculate and add the following:
-                ((((ship lcm cost / 10) * (ship effic / 100)) +
-                  ((ship hcm cost / 10) * (ship effic / 100))) * 2)
-power factor += for each plane calculate and add the following:
-                (20 * (plane effic / 100) * (nation tech level / 500))
-power factor += ((nation money / 100) + (petrol / 500) +
-                 ((civilians + military) / 10) + (shells / 12.5) +
-                 (iron / 100) + (dust / 5) + (oil / 10) + bars +
-                 (guns / 2.5) + (lcms / 10) + (hcms / 5))
-power factor += ((number of sectors * (average sector effic / 100)) * 10)
-power factor = ((power factor) * (nation tech level / 500))
-power factor = ((power factor) * (research factor))
+power factor = (  power value of money
+                + power value of sectors
+                + power value of commodities in sectors
+                + power value of commodities loaded on ships and land units)
+               * (20 + nation tech level) / 500
+             + power value of ships, planes and land units
+               * (20 + their tech level) / 500
 .FI
 .s1
-The research factor is either 1, if RES_POP is not being used, or 1+(max 
-pop in a sector)/10000, if it is being used.
+The power value of money is dollars / 100.
+.s1
+The power value of a sector is efficiency / 10.
+.s1
+The power value of a ship or land unit is (lcm cost / 10 + hcm cost +
+10) * efficiency / 100 * 2.
+.s1
+The power value of a plane is 20 * efficiency / 100 * (20 + nation
+tech level) / 500.
+.s1
+The power value of commodities is amount * type factor.  \*Qshow
+item\*U shows the type factor in column \*Qpower\*U.
+.s1
+Efficiency is in percent.
 .s1
 .SA "census, nation, Communication, Nations, Diplomacy"