wesnoth/data/core/macros/special-notes.cfg
Steve Cotton b9e4fdffb4 Update deprecation but postpone removal of the SPECIAL_NOTES macro
Units still using this in their descriptions will have the player-visible
header change from "Special Notes:" to "Special Notes (1.14-style, please
update to the new list format)".

The SPECIAL_NOTES macro was originally removed early in the 1.17 dev cycle.
That removal was reverted and postponed in the roadmap until Jan 2023, on the
grounds that it's a lot easier to test 1.17 when the big add-ons from 1.16 can
run on it.

In 1.16, UMC that hasn't upgraded yet already has a cosmetic bug - the help
pages of units still using the {SPECIAL_NOTES} macro will include duplicate
notes (assuming the expected usage of {SPECIAL_NOTES} as a heading in
[unit_type]description=, which is followed by old-style notes). These are minor
cosmetic bugs, which are expected to be removed as UMC gets updated.

That leaves the issue of what to do with the deprecated macro in 1.18. My
feeling is that we can easily continue to support the macro, albeit with the
cosmetic bug, so we should keep it for 1.18. However we could make it clearer
that the duplicated notes should be removed from the UMC.

This also removes some docs about NOTE_*s, those macros have already been
removed after being deprecated in 3568b5ff66ece00ec09f40059e552123f356d962.
2022-12-29 16:53:13 +01:00

245 lines
9.6 KiB
INI
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

#textdomain wesnoth-help
# The SPECIAL_NOTES macro and ability-specific SPECIAL_NOTES_* macros are deprecated, they are strings that were historically included directly in [unit_type]description.
# Since 1.16 these special notes are found in the abilities, movetypes and weapon specials themselves, and in [language]special_note_damage_type_arcane.
#
# The INTERNAL:SPECIAL_NOTES_* macros contain the strings shared by the deprecated macros and the non-deprecated uses. They aren't intended to be reused outside mainline.
#define INTERNAL:SPECIAL_NOTES_SPIRIT
_"Spirits have very unusual resistances to damage, and move quite slowly over open water."#enddef
#define INTERNAL:SPECIAL_NOTES_ARCANE
_"This units arcane attack deals tremendous damage to magical creatures, and even some to mundane creatures."#enddef
[language]
special_note_damage_type_arcane={INTERNAL:SPECIAL_NOTES_ARCANE}
[/language]
#define INTERNAL:SPECIAL_NOTES_HEALS
_"This unit is capable of basic healing."#enddef
#define INTERNAL:SPECIAL_NOTES_EXTRA_HEAL
_"This unit is capable of rapid healing."#enddef
#define INTERNAL:SPECIAL_NOTES_CURES
_"This unit is capable of healing those around it, and curing them of poison."#enddef
#define INTERNAL:SPECIAL_NOTES_UNPOISON
_"This unit is capable of neutralizing the effects of poison in units around it."#enddef
#define INTERNAL:SPECIAL_NOTES_REGENERATES
_"This unit regenerates, which allows it to heal as though always stationed in a village."#enddef
#define INTERNAL:SPECIAL_NOTES_STEADFAST
_"The steadiness of this unit reduces damage from some attacks, but only while defending."#enddef
#define INTERNAL:SPECIAL_NOTES_LEADERSHIP
_"The leadership of this unit enables adjacent units of the same side to deal more damage in combat, though this only applies to units of lower level."#enddef
#define INTERNAL:SPECIAL_NOTES_SKIRMISHER
_"This units skill at skirmishing allows it to ignore enemies zones of control and thus move unhindered around them."#enddef
#define INTERNAL:SPECIAL_NOTES_ILLUMINATES
_"Illumination increases the lighting level in adjacent areas."#enddef
#define INTERNAL:SPECIAL_NOTES_TELEPORT
_"This unit can use one move to teleport between any two empty villages controlled by its side."#enddef
#define INTERNAL:SPECIAL_NOTES_AMBUSH
_"In woodlands, this units ambush skill renders it invisible to enemies unless it is immediately adjacent or has revealed itself by attacking."#enddef
#define INTERNAL:SPECIAL_NOTES_NIGHTSTALK
_"This unit is able to hide at night, leaving no trace of its presence."#enddef
#define INTERNAL:SPECIAL_NOTES_CONCEALMENT
_"This unit can hide in villages (with the exception of water villages), and remain undetected by its enemies, except by those standing next to it."#enddef
#define INTERNAL:SPECIAL_NOTES_SUBMERGE
_"This unit can move unseen in deep water, requiring no air from the surface."#enddef
#define INTERNAL:SPECIAL_NOTES_FEEDING
_"This unit gains 1 hitpoint added to its maximum whenever it kills a living unit."#enddef
#define INTERNAL:SPECIAL_NOTES_BERSERK
_"Whenever its berserk attack is used, this unit continues to push the attack until either it or its enemy lies dead."#enddef
#define INTERNAL:SPECIAL_NOTES_BACKSTAB
_"If there is an enemy of the target on the opposite side of the target while attacking it, this unit may backstab, inflicting double damage by creeping around behind that enemy."#enddef
#define INTERNAL:SPECIAL_NOTES_PLAGUE
_"Foes who lose their life to the plague will rise again in unlife, unless they are standing on a village."#enddef
#define INTERNAL:SPECIAL_NOTES_SLOW
_"This unit is able to slow its enemies, halving their movement speed and attack damage until they end a turn."#enddef
#define INTERNAL:SPECIAL_NOTES_PETRIFY
_"The ability to turn the living to stone makes this unit extremely dangerous."#enddef
#define INTERNAL:SPECIAL_NOTES_MARKSMAN
_"This units marksmanship gives it a high chance of hitting targeted enemies, but only on the attack."#enddef
#define INTERNAL:SPECIAL_NOTES_MAGICAL
_"This unit has magical attacks, which always have a high chance of hitting an opponent."#enddef
#define INTERNAL:SPECIAL_NOTES_SWARM
_"The swarming attacks of this unit become less deadly whenever its members are wounded."#enddef
#define INTERNAL:SPECIAL_NOTES_CHARGE
_"Using a charging attack doubles both damage dealt and received; this does not affect defensive retaliation."#enddef
#define INTERNAL:SPECIAL_NOTES_DRAIN
_"During battle, this unit can drain life from victims to renew its own health."#enddef
#define INTERNAL:SPECIAL_NOTES_FIRSTSTRIKE
_"The length of this units weapon allows it to strike first in melee, even in defense."#enddef
#define INTERNAL:SPECIAL_NOTES_POISON
_"The victims of this units poison will continually take damage until they can be cured in town or by a unit which cures."#enddef
#define INTERNAL:SPECIAL_NOTES_DEFENSE_CAP
_"This unit has a defense cap on certain terrain types — it cannot achieve a higher defense rating on mixed terrains with such terrain types."#enddef
#define NOTE_REMOVE
#deprecated 4 This does not work on notes added by abilities, weapon specials or damage types
[+special_note]
remove=yes
[/special_note]
#enddef
# Deprecated versions here
# wmlindent: start ignoring
#define SPECIAL_NOTES
#deprecated 4 Use [special_note]note= tags and special_note= attributes instead.
"
"+
# po: User-visible string, but only shown in the help pages of UMC units that haven't yet been updated to the 1.16 special notes format.
# Don't use markup in this, because it's shown by both Pango (in the sidebar's tooltips) and the GUI1 help browser (for unit descriptions).
_"Special Notes (1.14-style, please update to the new list format to avoid duplicates):"#enddef
# wmlindent: stop ignoring
#define SPECIAL_NOTES_SPIRIT
#deprecated 2 1.19 This note is now added automatically.
{INTERNAL:SPECIAL_NOTES_SPIRIT}#enddef
#define SPECIAL_NOTES_ARCANE
#deprecated 2 1.19 This note is now added automatically.
{INTERNAL:SPECIAL_NOTES_ARCANE}#enddef
#define SPECIAL_NOTES_HEALS
#deprecated 2 1.19 This note is now added automatically.
{INTERNAL:SPECIAL_NOTES_HEALS}#enddef
#define SPECIAL_NOTES_EXTRA_HEAL
#deprecated 2 1.19 This note is now added automatically.
{INTERNAL:SPECIAL_NOTES_EXTRA_HEAL}#enddef
#define SPECIAL_NOTES_CURES
#deprecated 2 1.19 This note is now added automatically.
{INTERNAL:SPECIAL_NOTES_CURES}#enddef
#define SPECIAL_NOTES_UNPOISON
#deprecated 2 1.19 This note is now added automatically.
{INTERNAL:SPECIAL_NOTES_UNPOISON}#enddef
#define SPECIAL_NOTES_REGENERATES
#deprecated 2 1.19 This note is now added automatically.
{INTERNAL:SPECIAL_NOTES_REGENERATES}#enddef
#define SPECIAL_NOTES_STEADFAST
#deprecated 2 1.19 This note is now added automatically.
{INTERNAL:SPECIAL_NOTES_STEADFAST}#enddef
#define SPECIAL_NOTES_LEADERSHIP
#deprecated 2 1.19 This note is now added automatically.
{INTERNAL:SPECIAL_NOTES_LEADERSHIP}#enddef
#define SPECIAL_NOTES_SKIRMISHER
#deprecated 2 1.19 This note is now added automatically.
{INTERNAL:SPECIAL_NOTES_SKIRMISHER}#enddef
#define SPECIAL_NOTES_ILLUMINATES
#deprecated 2 1.19 This note is now added automatically.
{INTERNAL:SPECIAL_NOTES_ILLUMINATES}#enddef
#define SPECIAL_NOTES_TELEPORT
#deprecated 2 1.19 This note is now added automatically.
{INTERNAL:SPECIAL_NOTES_TELEPORT}#enddef
#define SPECIAL_NOTES_AMBUSH
#deprecated 2 1.19 This note is now added automatically.
{INTERNAL:SPECIAL_NOTES_AMBUSH}#enddef
#define SPECIAL_NOTES_NIGHTSTALK
#deprecated 2 1.19 This note is now added automatically.
{INTERNAL:SPECIAL_NOTES_NIGHTSTALK}#enddef
#define SPECIAL_NOTES_CONCEALMENT
#deprecated 2 1.19 This note is now added automatically.
{INTERNAL:SPECIAL_NOTES_CONCEALMENT}#enddef
#define SPECIAL_NOTES_SUBMERGE
#deprecated 2 1.19 This note is now added automatically.
{INTERNAL:SPECIAL_NOTES_SUBMERGE}#enddef
#define SPECIAL_NOTES_FEEDING
#deprecated 2 1.19 This note is now added automatically.
{INTERNAL:SPECIAL_NOTES_FEEDING}#enddef
#define SPECIAL_NOTES_BERSERK
#deprecated 2 1.19 This note is now added automatically.
{INTERNAL:SPECIAL_NOTES_BERSERK}#enddef
#define SPECIAL_NOTES_BACKSTAB
#deprecated 2 1.19 This note is now added automatically.
{INTERNAL:SPECIAL_NOTES_BACKSTAB}#enddef
#define SPECIAL_NOTES_PLAGUE
#deprecated 2 1.19 This note is now added automatically.
{INTERNAL:SPECIAL_NOTES_PLAGUE}#enddef
#define SPECIAL_NOTES_SLOW
#deprecated 2 1.19 This note is now added automatically.
{INTERNAL:SPECIAL_NOTES_SLOW}#enddef
#define SPECIAL_NOTES_PETRIFY
#deprecated 2 1.19 This note is now added automatically.
{INTERNAL:SPECIAL_NOTES_PETRIFY}#enddef
#define SPECIAL_NOTES_STONE
#deprecated 2 1.19 This note is now added automatically.
{INTERNAL:SPECIAL_NOTES_PETRIFY}#enddef
#define SPECIAL_NOTES_MARKSMAN
#deprecated 2 1.19 This note is now added automatically.
{INTERNAL:SPECIAL_NOTES_MARKSMAN}#enddef
#define SPECIAL_NOTES_MAGICAL
#deprecated 2 1.19 This note is now added automatically.
{INTERNAL:SPECIAL_NOTES_MAGICAL}#enddef
#define SPECIAL_NOTES_SWARM
#deprecated 2 1.19 This note is now added automatically.
{INTERNAL:SPECIAL_NOTES_SWARM}#enddef
#define SPECIAL_NOTES_CHARGE
#deprecated 2 1.19 This note is now added automatically.
{INTERNAL:SPECIAL_NOTES_CHARGE}#enddef
#define SPECIAL_NOTES_DRAIN
#deprecated 2 1.19 This note is now added automatically.
{INTERNAL:SPECIAL_NOTES_DRAIN}#enddef
#define SPECIAL_NOTES_FIRSTSTRIKE
#deprecated 2 1.19 This note is now added automatically.
{INTERNAL:SPECIAL_NOTES_FIRSTSTRIKE}#enddef
#define SPECIAL_NOTES_POISON
#deprecated 2 1.19 This note is now added automatically.
{INTERNAL:SPECIAL_NOTES_POISON}#enddef
#define SPECIAL_NOTES_DEFENSE_CAP
#deprecated 2 1.19 This note is now added automatically.
{INTERNAL:SPECIAL_NOTES_DEFENSE_CAP}#enddef