# HG changeset patch
# User nemo
# Date 1510783735 18000
# Node ID 6c9c95f5163860b245f8326123e9bf04b5ac20c4
# Parent  befdf6748279b0c8e2da6a1aff637da960a4fcea
remove the annoying ????

diff -r befdf6748279 -r 6c9c95f51638 GearMessages.wiki
--- a/GearMessages.wiki	Tue Oct 31 20:44:27 2017 +0000
+++ b/GearMessages.wiki	Wed Nov 15 17:08:55 2017 -0500
@@ -12,15 +12,17 @@
 || `gmSwitch` || Switch hedgehog || _Not used._ ||
 || `gmLJump` || Long jump || _Not used._ ||
 || `gmHJump` || High jump || _Not used._ ||
-|| `gmDestroy` || ??? || _Not used._ ||
+|| `gmDestroy` || Request gear kill itself || _Not used._ ||
 || `gmSlot` || Weapons slot selected. || Used. ||
 || `gmWeapon` || Weapon seleced. || Used. ||
 || `gmTimer` || Timer set. || Used. ||
-|| `gmAnimate` || ??? || Used. ||
+|| `gmAnimate` || Start animation || Used. ||
 || `gmPrecise` || Precise || _Not used._ ||
-|| `gmRemoveFromList` || ??? || _Not used._ ||
-|| `gmAddToList` || ??? || _Not used._ ||
-|| `gmDelete` || ??? || _Not used._ ||
+|| `gmRemoveFromList` || Remove from gear list || _Not used._ ||
+|| `gmAddToList` || Insert in gear list || _Not used._ ||
+|| `gmDelete` || Delete gear || _Not used._ ||
 || `gmAllStoppable` || Bitwise OR of `gmLeft`, `gmRight`, `gmUp`, `gmDown` `gmAttack` and `gmPrecise` ||_Not used._ ||
 
+gmAddToList and gmRemoveFromList are intended for use by the engine when changing order of gears in the list.  It is not recommended that lua change these, and at present they are used together when changing a gear's Z.  For example, if lua set gmRemoveFromList, it would cause a leak of the gear, since lua would no longer be able to restore it.  Setting both together would have no effect since lua cannot at present change Z.
+
 See https://hg.hedgewars.org/hedgewars/file/default/hedgewars/uConsts.pas (search for "gear messages") for a current list.