Add API documentation for mcl_throwing

mods/ITEMS/mcl_throwing/API.md

@@ -1,3 +1,35 @@
 # mcl_throwing
 
-## mcl_throwing.throw(throw_item, pos, dir, velocity, thrower)
+## mcl_throwing.throw(throw_item, pos, dir, velocity, thrower)
+Throw a throwable item.
+
+* throw_item: itemstring of the throwable item
+* pos: initial position of the entity
+* dir: direction where the throwable item will be thrown
+* velocity: (optional) will overide the default velocity value (can be nil)
+* thrower: (optional) player/entity who throw the object (can be nil)
+
+## mcl_throwing.register_throwable_object(name, entity, velocity)
+Register a throwable item.
+
+* name: itemname of the throwable object
+* entity: entity thrown
+* velocity: initial velocity of the entity
+
+## mcl_throwing.dispense_function(stack, dispenserpos, droppos, dropnode, dropdir)
+Throw throwable item from dispencer.
+
+Shouldn't be called directly.
+
+Must be used in item definition:
+
+`_on_dispense = mcl_throwing.dispense_function,`
+
+## mcl_throwing.get_player_throw_function(entity_name, velocity)
+
+Return a function who handle item throwing (to be used in item definition)
+
+Handle creative mode, and throw params.
+
+* entity_name: the name of the entity to throw
+* velocity: (optional) velocity overide (can be nil)