EP's fixes to the descriptions of abilities.

changelog

@@ -43,6 +43,7 @@ CVS HEAD:
  * updated unix manpages
  * "," is no longer the column separator, it does not have to be escaped
    anymore in some translations, "=" is the new separator
+ * clarify some ability descriptions
  * fix pathfinding bug (#11196)
  * fix untranslatable strings
  * fix "damage inflicted" statistic (incorrectly computed when defending)

data/help.cfg

@@ -169,12 +169,12 @@ id=healing
 title= _ "Healing"
 text= _ "In combat, your units will inevitably take damage. Wesnoth offers several ways for your units to heal, all of which take place at the beginning of your turn, before you take action." + _"
 
-Resting: A unit which neither moves nor attacks will heal 2HP in its next turn." + _"
+Resting: A unit which neither moves, attacks, nor is attacked will heal 2HP in its next turn." + _"
 Villages: A unit which starts a turn in a village will heal 8HP." + _"
 <ref>dst=ability_regeneration text=Regeneration</ref>: Certain units (such as trolls) will automatically heal 8HP every turn." + _"
-Healing units: Units with the <ref>dst=ability_heals text=Heals</ref> ability will heal all friendly units immediately beside them for 4HP each turn, or prevent Poison from dealing damage." + _"
+Healing units: Units with the <ref>dst=ability_heals text=Heals</ref> ability will heal all friendly units immediately beside them for 4HP each turn, to a total maximum of 8 points healed, or prevent Poison from dealing damage." + _"
 
-Curing units: Units with the <ref>dst=ability_cures text=Cures</ref> ability will heal all friendly units immediately beside them for 8HP each turn, or cure a unit of Poison." + _"
+Curing units: Units with the <ref>dst=ability_cures text=Cures</ref> ability will heal all friendly units immediately beside them for 8HP each turn, to a total maximum of 18 points healed, or cure a unit of Poison." + _"
 
 Keep in mind that while Resting can be combined with other forms of healing, villages, regeneration, and healing/curing cannot combine with each other. Also, units heal fully between scenarios."
 [/topic]

data/translations/english.cfg

@@ -51,7 +51,7 @@ ability_illuminates= _ "illuminates"
 leadership_description= _ "Leadership:
 This unit can lead friendly units that are next to it, making them fight better.
 
-Adjacent friendly units of lower level will do more damage in battle."
+Adjacent friendly units of lower level will do more damage in battle. When a unit adjacent to, of a lower level than, and on the same side as a unit with Leadership engages in combat, its attacks do 25% more damage times the difference in their levels."
 
 ability_leadership= _ "leadership"
 
@@ -61,7 +61,9 @@ Never more than 1 upkeep."
 ability_loyal= _ "loyal"
 
 nightstalk_description= _ "Nightstalk:
-The unit becomes invisible during night."
+The unit becomes invisible during night.
+
+Enemy units cannot see or attack this unit at night, except for any turn immediately after this unit has attacked, or if there are enemy units next to this unit."
 
 ability_nightstalk= _ "nightstalk"
 
@@ -81,14 +83,14 @@ This unit takes half normal damage when it did not initiate the attack."
 ability_steadfast= _ "steadfast"
 
 teleport_description= _ "Teleport:
-This unit may teleport between any two friendly villages instantly."
+This unit may teleport between any two friendly villages using one of its moves."
 
 ability_teleport= _ "teleport"
 
 # Weapon special effect descriptions
 
 weapon_special_backstab_description= _ "Backstab:
-This attack deals double damage if a friendly unit is on the opposite side of the target."
+This attack deals double damage if a friendly unit is on the opposite side of the target. (This doesn't work with allied units.)"
 
 weapon_special_berserk_description= _ "Berserk:
 Whether used offensively or defensively, this attack presses the engagement until one of the combatants is slain."
@@ -109,13 +111,13 @@ weapon_special_marksman_description= _ "Marksman:
 When used offensively, this attack always has at least a 60% chance to hit."
 
 weapon_special_plague_description= _ "Plague:
-If this unit kills a living target and that unit was not stationed in a village, the dead target's corpse will rise up and fight for you."
+When a unit is killed by a Plague attack, that unit is replaced with a unit identical to and on the same side as the unit with the Plague attack. (This doesn't work on Undead or units in villages.)"
 
 weapon_special_poison_description= _ "Poison:
 This attack poisons the target. Poisoned units lose 8 HP every turn until they are cured or are reduced to 1 HP."
 
 weapon_special_slow_description= _ "Slow:
-This attack slows the target. Slowed units move at half normal speed and receive one less attack than normal in combat for the duration of one turn."
+This attack slows the target. Slowed units move at half normal speed and receive one less attack than normal in combat until the end of their controllers' turn."
 
 weapon_special_stone_description= _ "Stone:
 This attack turns the target to stone. Units that have been turned to stone may not move or attack."