--- a/LuaLibraryTracker.wiki	Wed May 02 23:32:42 2018 +0100
+++ b/LuaLibraryTracker.wiki	Wed May 02 23:42:11 2018 +0100
@@ -24,6 +24,8 @@
 [https://hg.hedgewars.org/hedgewars/file/default/share/hedgewars/Data/Scripts/Multiplayer/Random_Weapon.lua Random Weapons].
 
 == Tracking functions ==
+These functions must be called to start tracking stuff. *IMPORTANT:* The other functions will only work on tracked objects. So make sure you track the things you care about.
+
 === `trackGear(gear)` ===
 Will keep track of the gear.
 
@@ -40,6 +42,8 @@
 Will keep track of the given hedgehog gear when it is un-hidden.
 
 == “`runOn`” functions ==
+These functions are used to run a function on tracked gears, teams and clans.
+
 === `runOnGears(func)` ===
 Runs the function `func` on all gears.
 
@@ -58,20 +62,24 @@
 === `runOnHogsInOtherClans(func, clan)` ===
 Runs the function `func` on all hedgehogs but those in the specified clan (`clan` = clan ID).
 
+== Helper functions ==
+=== `getFirstHogOfClan(clan)` ===
+Returns the first hedgehog (alive or not) in the clan with clan ID `clan`.
+
 == Key-value storage ==
-For tracked gears, teams and clans, you can assign an arbitrary number of values. Each tracked object will have a simple key-value storage. Any data type (besides `nil`) can be used for keys and values.
+For tracked gears, teams and clans, you can assign an arbitrary number of values. Each tracked object will have a simple key-value storage. Any data type (besides `nil`) can be used for keys and values. Initially, all keys have the value `nil`.
 
 === `getGearValue(gear, key)` ===
-Returns the gear value of the given gear and key.
+Returns the gear value of the given `gear` for `key`.
 
 === `setGearValue(gear, key, value)` ===
-Sets the gear value with given `key` to `value`.
+Sets the gear value for given `key` to `value`.
 
-=== `increaseGearValue(gear, value)` ===
-Increase a gear value by 1. This function *must not* be called if the current value is not a number.
+=== `increaseGearValue(gear, key)` ===
+Increases the gear value for `key` by 1. This function *must not* be called if the current value is not a number.
 
-=== `decreaseGearValue(gear, value)` ===
-Decrease a gear value by 1. This function *must not* be called if the current value is not a number.
+=== `decreaseGearValue(gear, key)` ===
+Decreases the gear value for `key` by 1. This function *must not* be called if the current value is not a number.
 
 === `getTeamValue(team, key)` ===
 Returns the value of the given team (`team` is the team name) for the specified `key`.
@@ -80,23 +88,19 @@
 Sets the team value with given `key` to `value`. `team` is the team name.
 
 === `increaseTeamValue(team, key)` ===
-Increase a team value by 1. `team` is the team name. This function *must not* be called if the current value is not a number.
+Increases the team value for `key` by 1. `team` is the team name. This function *must not* be called if the current value is not a number.
 
 === `decreaseTeamValue(team, key)` ===
-Decrease a team value by 1. `team` is the team name. This function *must not* be called if the current value is not a number.
+Decreases the team value for `key` by 1. `team` is the team name. This function *must not* be called if the current value is not a number.
 
-=== `getClanValue(team, key)` ===
+=== `getClanValue(clan, key)` ===
 Returns the value of the given clan (`clan` is the clan ID) for the specified `key`.
 
-=== `setClanalue(team, key, value)` ===
+=== `setClanValue(clan, key, value)` ===
 Sets the clan value with given `key` to `value`. `clan` is the clan ID.
 
-=== `increaseClanValue(team, key)` ===
-Increase a clan value by 1. `clan` is the clan ID. This function *must not* be called if the current value is not a number.
+=== `increaseClanValue(clan, key)` ===
+Increases the clan value for `key` by 1. `clan` is the clan ID. This function *must not* be called if the current value is not a number.
 
-=== `decreaseClanValue(team, key)` ===
-Decrease a clan value by 1. `clan` is the clan ID. This function *must not* be called if the current value is not a number.
-
-== Convenience functions ==
-=== `getFirstHogOfClan(clan)` ===
-Returns the first hedgehog (alive or not) in the clan with clan ID `clan`.
\ No newline at end of file
+=== `decreaseClanValue(clan, key)` ===
+Decreases the clan value for `key` by 1. `clan` is the clan ID. This function *must not* be called if the current value is not a number.